@woosh/meep-engine 2.106.0 → 2.107.0

package/src/core/geom/Vector3.d.ts

@@ -1,6 +1,6 @@
+import {Matrix3, Matrix4} from "three";
 import Signal from "../events/signal/Signal";
 import Quaternion from "./Quaternion";
-import {Matrix3, Matrix4} from "three";
 
 interface Vector3Like {
     readonly x: number
@@ -9,9 +9,9 @@ interface Vector3Like {
 }
 
 export default class Vector3 implements Vector3Like {
-    x: number
-    y: number
-    z: number
+    readonly x: number
+    readonly y: number
+    readonly z: number
 
     0: number
     1: number
@@ -87,10 +87,19 @@ export default class Vector3 implements Vector3Like {
 
     applyQuaternion(q: Quaternion): void
 
+    /**
+     * @deprecated
+     */
     applyMatrix4_three(m4: Matrix4): void
 
+    /**
+     * @deprecated
+     */
     applyMatrix3_three(m4: Matrix3): void
 
+    /**
+     * @deprecated
+     */
     transformDirection_three(m4: Matrix4): void
 
     angleTo(other: Vector3Like): number

package/src/core/geom/Vector3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Vector3.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/Vector3.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Vector3.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/Vector3.js"],"names":[],"mappings":"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"}

package/src/core/geom/Vector3.js

@@ -26,10 +26,23 @@ class Vector3 {
      * @constructor
      */
     constructor(x = 0, y = 0, z = 0) {
+        /**
+         * @type {number}
+         */
         this.x = x;
+        /**
+         * @type {number}
+         */
         this.y = y;
+        /**
+         * @type {number}
+         */
         this.z = z;
 
+        /**
+         * @readonly
+         * @type {Signal<number,number,number,number,number,number>}
+         */
         this.onChanged = new Signal();
     }
 
@@ -336,7 +349,11 @@ class Vector3 {
         const ax = first.x, ay = first.y, az = first.z;
         const bx = second.x, by = second.y, bz = second.z;
 
-        this._crossVectors(ax, ay, az, bx, by, bz);
+        this._crossVectors(
+            ax, ay, az,
+            bx, by, bz
+        );
+
     }
 
     /**
@@ -548,6 +565,7 @@ class Vector3 {
     /**
      *
      * @param {THREE.Matrix4} matrix4
+     * @deprecated use {@link @applyMatrix4} directly instead, pass `mat.elements`
      */
     applyMatrix4_three(matrix4) {
         this.applyMatrix4(matrix4.elements);
@@ -576,7 +594,9 @@ class Vector3 {
      * @param {ArrayLike<number>|number[]|Float32Array} m4
      */
     applyDirectionMatrix4(m4) {
-        const x = this.x, y = this.y, z = this.z;
+        const x = this.x;
+        const y = this.y;
+        const z = this.z;
 
         const _x = m4[0] * x + m4[4] * y + m4[8] * z;
         const _y = m4[1] * x + m4[5] * y + m4[9] * z;
@@ -607,25 +627,34 @@ class Vector3 {
     }
 
     /**
-     *
+     * @deprecated use non-three.js version instead
      * @param {THREE.Matrix3} m
      * @returns {Vector3}
      */
     applyMatrix3_three(m) {
+        this.applyMatrix3(m.elements);
 
-        const x = this.x, y = this.y, z = this.z;
-        const e = m.elements;
+        return this;
+    }
 
-        const _x = e[0] * x + e[3] * y + e[6] * z;
-        const _y = e[1] * x + e[4] * y + e[7] * z;
-        const _z = e[2] * x + e[5] * y + e[8] * z;
+    /**
+     *
+     * @param {number[]|Float32Array} mat
+     */
+    applyMatrix3(mat) {
+        const x = this.x;
+        const y = this.y;
+        const z = this.z;
 
-        return this.set(_x, _y, _z);
+        const _x = mat[0] * x + mat[3] * y + mat[6] * z;
+        const _y = mat[1] * x + mat[4] * y + mat[7] * z;
+        const _z = mat[2] * x + mat[5] * y + mat[8] * z;
 
+        this.set(_x, _y, _z);
     }
 
     /**
-     *
+     * @deprecated use non-three.js version instead
      * @param {THREE.Matrix4} matrix4
      */
     threejs_setFromMatrixPosition(matrix4) {
@@ -710,17 +739,7 @@ class Vector3 {
         const y1 = other.y;
         const z1 = other.z;
 
-        const d = v3_dot(x0, y0, z0, x1, y1, z1);
-
-        const mag2 = (x1 * x1 + y1 * y1 + z1 * z1);
-
-        const m = d / mag2;
-
-        const x = x1 * m;
-        const y = y1 * m;
-        const z = z1 * m;
-
-        this.set(x, y, z);
+        this._projectVectors(x0, y0, z0, x1, y1, z1);
     }
 
     /**
@@ -757,7 +776,10 @@ class Vector3 {
      * @param {number} y1
      * @param {number} z1
      */
-    _projectVectors(x0, y0, z0, x1, y1, z1) {
+    _projectVectors(
+        x0, y0, z0,
+        x1, y1, z1
+    ) {
 
         const d = v3_dot(x0, y0, z0, x1, y1, z1);
 
@@ -779,12 +801,24 @@ class Vector3 {
      * @param {number} theta
      */
     setFromSphericalCoords(radius, phi, theta) {
+        assert.isNumber(radius, 'radius');
+        assert.notNaN(radius, 'radius');
+
+        assert.isNumber(phi, 'phi');
+        assert.notNaN(phi, 'phi');
 
-        const sinPhiRadius = Math.sin(phi) * radius;
+        assert.isNumber(theta, 'theta');
+        assert.notNaN(theta, 'theta');
 
-        const _x = sinPhiRadius * Math.sin(theta);
-        const _y = Math.cos(phi) * radius;
-        const _z = sinPhiRadius * Math.cos(theta);
+        const sin_phi = Math.sin(phi);
+        const cos_phi = Math.cos(phi);
+
+        const sin_theta = Math.sin(theta);
+        const cos_theta = Math.cos(theta);
+
+        const _x = radius * sin_phi * sin_theta;
+        const _y = radius * cos_phi;
+        const _z = radius * sin_phi * cos_theta;
 
         this.set(_x, _y, _z);
     }
@@ -792,11 +826,15 @@ class Vector3 {
     /**
      *
      * @param {function} processor
+     * @param {*} [thisArg]
      * @returns {Vector3}
      */
-    process(processor) {
-        processor(this.x, this.y, this.z);
-        this.onChanged.add(processor);
+    process(processor, thisArg) {
+
+        processor.call(thisArg, this.x, this.y, this.z);
+
+        this.onChanged.add(processor, thisArg);
+
         return this;
     }
 
@@ -810,6 +848,7 @@ class Vector3 {
      */
     fromJSON(json) {
         if (typeof json === 'number') {
+            // special case where input is a number
             this.setScalar(json);
         } else {
             this.copy(json);
@@ -823,6 +862,7 @@ class Vector3 {
     /**
      *
      * @param {BinaryBuffer} buffer
+     * @deprecated
      */
     toBinaryBuffer(buffer) {
         buffer.writeFloat64(this.x);
@@ -833,6 +873,7 @@ class Vector3 {
     /**
      *
      * @param {BinaryBuffer} buffer
+     * @deprecated
      */
     fromBinaryBuffer(buffer) {
         const x = buffer.readFloat64();
@@ -845,6 +886,7 @@ class Vector3 {
     /**
      *
      * @param {BinaryBuffer} buffer
+     * @deprecated
      */
     toBinaryBufferFloat32(buffer) {
         buffer.writeFloat32(this.x);
@@ -855,6 +897,7 @@ class Vector3 {
     /**
      *
      * @param {BinaryBuffer} buffer
+     * @deprecated
      */
     fromBinaryBufferFloat32(buffer) {
         const x = buffer.readFloat32();
@@ -974,12 +1017,6 @@ Vector3.prototype.fromArray = Vector3.prototype.readFromArray;
 Vector3.prototype.toArray = Vector3.prototype.writeToArray;
 
 
-/**
- * @readonly
- * @type {boolean}
- */
-Vector3.prototype.isVector3 = true;
-
 /**
  * @readonly
  * @type {Vector3}
@@ -1036,10 +1073,20 @@ Vector3.forward = Object.freeze(new Vector3(0, 0, 1));
  */
 Vector3.back = Object.freeze(new Vector3(0, 0, -1));
 
+/**
+ * @readonly
+ * @type {boolean}
+ */
+Vector3.prototype.isVector3 = true;
+
+/**
+ * @readonly
+ * @type {string}
+ */
 Vector3.typeName = "Vector3";
 
 /**
- *
+ * @deprecated use {@link v3_dot} directly instead
  * @param {number} x0
  * @param {number} y0
  * @param {number} z0

package/src/core/geom/Vector3.spec.js

@@ -7,28 +7,28 @@ test('slerp', () => {
     const v = new Vector3();
 
     v3_slerp(v, 0, 0, 0, 0, 0, 0, 0);
-    expect(v.toJSON()).toEqual({x: 0, y: 0, z: 0});
+    expect(v.toJSON()).toEqual({ x: 0, y: 0, z: 0 });
 
     v3_slerp(v, 0, 0, 0, 0, 0, 0, 1);
-    expect(v.toJSON()).toEqual({x: 0, y: 0, z: 0});
+    expect(v.toJSON()).toEqual({ x: 0, y: 0, z: 0 });
 
     v3_slerp(v, 1, 1, 1, 1, 1, 1, 0);
-    expect(v.toJSON()).toEqual({x: 1, y: 1, z: 1});
+    expect(v.toJSON()).toEqual({ x: 1, y: 1, z: 1 });
 
     v3_slerp(v, 1, 1, 1, 1, 1, 1, 1);
-    expect(v.toJSON()).toEqual({x: 1, y: 1, z: 1});
+    expect(v.toJSON()).toEqual({ x: 1, y: 1, z: 1 });
 
     v3_slerp(v, -1, -1, -1, -1, -1, -1, 0);
-    expect(v.toJSON()).toEqual({x: -1, y: -1, z: -1});
+    expect(v.toJSON()).toEqual({ x: -1, y: -1, z: -1 });
 
     v3_slerp(v, -1, -1, -1, -1, -1, -1, 1);
-    expect(v.toJSON()).toEqual({x: -1, y: -1, z: -1});
+    expect(v.toJSON()).toEqual({ x: -1, y: -1, z: -1 });
 
     v3_slerp(v, 1, 1, 1, -1, -1, -1, 0);
-    expect(v.toJSON()).toEqual({x: 1, y: 1, z: 1});
+    expect(v.toJSON()).toEqual({ x: 1, y: 1, z: 1 });
 
     v3_slerp(v, 1, 1, 1, -1, -1, -1, 1);
-    expect(v.toJSON()).toEqual({x: -1, y: -1, z: -1});
+    expect(v.toJSON()).toEqual({ x: -1, y: -1, z: -1 });
 
 
     v3_slerp(v, 1, 0, 0, 0, 1, 0, 0.5);
@@ -123,10 +123,10 @@ test("iterator symbol", () => {
 
     const iterator = v[Symbol.iterator]();
 
-    expect(iterator.next()).toEqual({value: 5, done: false})
-    expect(iterator.next()).toEqual({value: 7, done: false})
-    expect(iterator.next()).toEqual({value: 11, done: false})
-    expect(iterator.next()).toEqual({done: true})
+    expect(iterator.next()).toEqual({ value: 5, done: false })
+    expect(iterator.next()).toEqual({ value: 7, done: false })
+    expect(iterator.next()).toEqual({ value: 11, done: false })
+    expect(iterator.next()).toEqual({ done: true })
 
 });
 
@@ -181,4 +181,105 @@ test("setFromSphericalCoords", () => {
     expect(v3.x).not.toBeNaN();
     expect(v3.y).not.toBeNaN();
     expect(v3.z).not.toBeNaN();
+});
+
+test("isZero", () => {
+
+    expect(new Vector3(0, 0, 0).isZero()).toBe(true);
+
+    expect(new Vector3(0, 0, 1).isZero()).toBe(false);
+    expect(new Vector3(0, 1, 0).isZero()).toBe(false);
+    expect(new Vector3(1, 0, 0).isZero()).toBe(false);
+
+    expect(new Vector3(0, 0, -1).isZero()).toBe(false);
+    expect(new Vector3(0, -1, 0).isZero()).toBe(false);
+    expect(new Vector3(-1, 0, 0).isZero()).toBe(false);
+
+});
+
+test("multiply", () => {
+
+    const a = new Vector3(1, -3, 5);
+    const b = new Vector3(7, 11, -13);
+
+    a.multiply(b);
+
+    expect(a.x).toEqual(7);
+    expect(a.y).toEqual(-33);
+    expect(a.z).toEqual(-65);
+
+});
+
+test("cross", () => {
+
+    const a = new Vector3(1, -3, 5);
+    const b = new Vector3(7, 11, -13);
+
+    a.cross(b);
+
+    expect(a.x).toEqual(-16);
+    expect(a.y).toEqual(48);
+    expect(a.z).toEqual(32);
+});
+
+test("normalize", () => {
+
+
+    const a = new Vector3(1, 0, 0);
+    a.normalize();
+    expect(a.x).toBeCloseTo(1);
+    expect(a.y).toBeCloseTo(0);
+    expect(a.z).toBeCloseTo(0);
+
+    const b = new Vector3(0, 1, 0);
+
+    b.normalize();
+    expect(b.x).toBeCloseTo(0);
+    expect(b.y).toBeCloseTo(1);
+    expect(b.z).toBeCloseTo(0);
+
+    const c = new Vector3(0, 0, 1);
+
+    c.normalize();
+    expect(c.x).toBeCloseTo(0);
+    expect(c.y).toBeCloseTo(0);
+    expect(c.z).toBeCloseTo(1);
+
+    const d = new Vector3(-1, 0, 0);
+
+    d.normalize();
+    expect(d.x).toBeCloseTo(-1);
+    expect(d.y).toBeCloseTo(0);
+    expect(d.z).toBeCloseTo(0);
+
+    const e = new Vector3(0, -1, 0);
+
+    e.normalize();
+    expect(e.x).toBeCloseTo(0);
+    expect(e.y).toBeCloseTo(-1);
+    expect(e.z).toBeCloseTo(0);
+
+    const f = new Vector3(0, 0, -1);
+
+    f.normalize();
+    expect(f.x).toBeCloseTo(0);
+    expect(f.y).toBeCloseTo(0);
+    expect(f.z).toBeCloseTo(-1);
+
+    // try zero
+    const g = new Vector3(0, 0, 0);
+
+    g.normalize()
+    expect(g.x).toBe(0);
+    expect(g.y).toBe(0);
+    expect(g.z).toBe(0);
+
+    // length resizing
+    const h = new Vector3(-3, -5, -7);
+
+    h.normalize()
+    expect(h.x).toBeCloseTo(-0.329292779969071);
+    expect(h.y).toBeCloseTo(-0.5488212999484517);
+    expect(h.z).toBeCloseTo(-0.7683498199278324);
+
 });

package/src/core/geom/Vector4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Vector4.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/Vector4.js"],"names":[],"mappings":";AAUA;IA2WI;;;;;;OAMG;IACH,gBALW,OAAO,MACP,OAAO,qBAEP,OAAO,QASjB;IAxXD;;;;;;;;OAQG;IACH,4DAOC;IANG,UAAU;IACV,UAAU;IACV,UAAU;IACV,UAAU;IAEV,eAA6B;IAGjC,gBAEC;IAED,gBAEC;IAED,gBAEC;IAED,gBAEC;IAED;;;;OAIG;IACH,qBAHW,MAAM,EAAE,WACR,MAAM,QAShB;IAED;;;;OAIG;IACH,oBAHW,MAAM,EAAE,WACR,MAAM,QAOhB;IAED;;;;;;;OAOG;IACH,iDAFa,OAAO,CAkCnB;IAED;;;OAGG;IACH,mCAMC;IAED;;;;OAIG;IACH,+BAFa,OAAO,CAOnB;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,kBAlBW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,OAAO,CAoBnB;IAED;;;;OAIG;IACH,WAHW,OAAO,GACL,MAAM,CAIlB;IAED;;;;OAIG;IACH,SAHW,UAAQ,OAAO,GACb,OAAO,CASnB;IAED;;;;OAIG;IACH,+BAFa,OAAO,CAUnB;IAED;;;;OAIG;IACH,WAHW,OAAO,GACL,OAAO,CAInB;IAED;;;OAGG;IACH,SAFa,OAAO,CAQnB;IAED;;;OAGG;IACH,qCAuBC;IAED;;;;OAIG;IACH,aAHW,OAAO,GACL,OAAO,CAInB;IAED;;;OAGG;IACH,QAFY,MAAM,CASjB;IAED;;;;OAIG;IACH,gBAJW,OAAO,MACP,OAAO,mBAKjB;IAED;;;OAGG;IACH,gBAFW,MAAM,EAAE,QAOlB;IAED;;OAEG;IACH,WAFa,MAAM,EAAE,CAQpB;IAED;;;;OAIG;IACH,mBAHW,MAAM,EAAE,UACR,MAAM,QAIhB;IAED;;;;;MAOC;IAED,0BAEC;IAED;;;OAGG;IACH,2CAKC;IAED;;;OAGG;IACH,6CAOC;IAED,sDAOC;CAiBJ"}
+{"version":3,"file":"Vector4.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/Vector4.js"],"names":[],"mappings":";AAMA;IA2WI;;;;;;OAMG;IACH,gBALW,OAAO,MACP,OAAO,qBAEP,OAAO,QASjB;IAxXD;;;;;;;;OAQG;IACH,4DAOC;IANG,UAAU;IACV,UAAU;IACV,UAAU;IACV,UAAU;IAEV,eAA6B;IAGjC,gBAEC;IAED,gBAEC;IAED,gBAEC;IAED,gBAEC;IAED;;;;OAIG;IACH,qBAHW,MAAM,EAAE,WACR,MAAM,QAShB;IAED;;;;OAIG;IACH,oBAHW,MAAM,EAAE,WACR,MAAM,QAOhB;IAED;;;;;;;OAOG;IACH,iDAFa,OAAO,CAkCnB;IAED;;;OAGG;IACH,mCAMC;IAED;;;;OAIG;IACH,+BAFa,OAAO,CAOnB;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,kBAlBW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,OAAO,CAoBnB;IAED;;;;OAIG;IACH,WAHW,OAAO,GACL,MAAM,CAIlB;IAED;;;;OAIG;IACH,SAHW,UAAQ,OAAO,GACb,OAAO,CASnB;IAED;;;;OAIG;IACH,+BAFa,OAAO,CAUnB;IAED;;;;OAIG;IACH,WAHW,OAAO,GACL,OAAO,CAInB;IAED;;;OAGG;IACH,SAFa,OAAO,CAQnB;IAED;;;OAGG;IACH,qCAuBC;IAED;;;;OAIG;IACH,aAHW,OAAO,GACL,OAAO,CAInB;IAED;;;OAGG;IACH,QAFY,MAAM,CASjB;IAED;;;;OAIG;IACH,gBAJW,OAAO,MACP,OAAO,mBAKjB;IAED;;;OAGG;IACH,gBAFW,MAAM,EAAE,QAOlB;IAED;;OAEG;IACH,WAFa,MAAM,EAAE,CAQpB;IAED;;;;OAIG;IACH,mBAHW,MAAM,EAAE,UACR,MAAM,QAIhB;IAED;;;;;MAOC;IAED,0BAEC;IAED;;;OAGG;IACH,2CAKC;IAED;;;OAGG;IACH,6CAOC;IAED,sDAOC;CAiBJ"}

package/src/core/geom/Vector4.js

@@ -1,7 +1,3 @@
-/**
- * Created by Alex on 29/12/2015.
- */
-
 import { assert } from "../assert.js";
 import { computeHashIntegerArray } from "../collection/array/computeHashIntegerArray.js";
 import { Signal } from "../events/signal/Signal.js";

package/src/core/graph/Edge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Edge.d.ts","sourceRoot":"","sources":["../../../../src/core/graph/Edge.js"],"names":[],"mappings":"gCASU,MAAM;;;;;;AAQhB;;GAEG;AACH;IACI;;;;;OAKG;IACH,4BAmBC;IAfG;;;OAGG;IACH,WAAc;IACd;;;OAGG;IACH,YAAe;IAEf;;OAEG;IACH,WAFU,iBAAiB,CAEkB;IAGjD;;;;OAIG;IACH,eAHW,CAAC,GACA,OAAO,CAIlB;IAED;;;;;OAKG;IACH,2BAJW,CAAC,UACD,CAAC,GACC,OAAO,CASnB;IAED;;;;OAIG;IACH,YAHW,CAAC,GACC,CAAC,CAIb;IAED;;;OAGG;IACH,sBAFa,OAAO,CAInB;IAED;;;OAGG;IACH,uBAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,wBAHW,CAAC,GACC,OAAO,CAKnB;IAED;;;;OAIG;IACH,yBAHW,CAAC,GACC,OAAO,CAKnB;IAED;;;OAGG;IACH,iBAEC;IAIL;;;OAGG;IACH,QAFU,OAAO,CAEI;CANpB"}
+{"version":3,"file":"Edge.d.ts","sourceRoot":"","sources":["../../../../src/core/graph/Edge.js"],"names":[],"mappings":"gCAIU,MAAM;;;;;;AAQhB;;GAEG;AACH;IACI;;;;;OAKG;IACH,4BAmBC;IAfG;;;OAGG;IACH,WAAc;IACd;;;OAGG;IACH,YAAe;IAEf;;OAEG;IACH,WAFU,iBAAiB,CAEkB;IAGjD;;;;OAIG;IACH,eAHW,CAAC,GACA,OAAO,CAIlB;IAED;;;;;OAKG;IACH,2BAJW,CAAC,UACD,CAAC,GACC,OAAO,CASnB;IAED;;;;OAIG;IACH,YAHW,CAAC,GACC,CAAC,CAIb;IAED;;;OAGG;IACH,sBAFa,OAAO,CAInB;IAED;;;OAGG;IACH,uBAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,wBAHW,CAAC,GACC,OAAO,CAKnB;IAED;;;;OAIG;IACH,yBAHW,CAAC,GACC,OAAO,CAKnB;IAED;;;OAGG;IACH,iBAEC;IAIL;;;OAGG;IACH,QAFU,OAAO,CAEI;CANpB"}

package/src/core/graph/Edge.js

@@ -1,8 +1,3 @@
-/**
- * Created by Alex on 29/01/14.
- */
-
-
 import { assert } from "../assert.js";
 
 /**

package/src/core/graph/WeightedEdge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WeightedEdge.d.ts","sourceRoot":"","sources":["../../../../src/core/graph/WeightedEdge.js"],"names":[],"mappings":"AAEA;IAOI;;;;OAIG;IACH,wBAHW,YAAY,GACV,MAAM,CAIlB;IAED;;;;OAIG;IACH,gCAHW,YAAY,GACV,MAAM,CAIlB;IAVG,wBAYoS;IAxBxS;;;OAGG;IACH,QAFU,MAAM,CAEL;CAmBd;qBA1BoB,WAAW"}
+{"version":3,"file":"WeightedEdge.d.ts","sourceRoot":"","sources":["../../../../src/core/graph/WeightedEdge.js"],"names":[],"mappings":"AAEA;IAOI;;;;OAIG;IACH,wBAHW,YAAY,GACV,MAAM,CAIlB;IAED;;;;OAIG;IACH,gCAHW,YAAY,GACV,MAAM,CAIlB;IAbe,wBAeyO;IAxBzP;;;OAGG;IACH,QAFU,MAAM,CAEL;CAmBd;qBA1BoB,WAAW"}

package/src/core/json/JsonUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JsonUtils.d.ts","sourceRoot":"","sources":["../../../../src/core/json/JsonUtils.js"],"names":[],"mappings":"AAgFA,6CAeC;AAzFD;;;;GAIG;AACH,sCAHW,MAAM,GAAC,MAAM,GAAC,MAAM,GAAC,IAAI,QAAM,+BAsEzC"}
+{"version":3,"file":"JsonUtils.d.ts","sourceRoot":"","sources":["../../../../src/core/json/JsonUtils.js"],"names":[],"mappings":"AA4EA,6CAeC;AAzFD;;;;GAIG;AACH,sCAHW,MAAM,GAAC,MAAM,GAAC,MAAM,GAAC,IAAI,QAAM,+BAsEzC"}

package/src/core/json/JsonUtils.js

@@ -1,7 +1,3 @@
-/**
- * Created by Alex on 03/11/2016.
- */
-
 import { isTypedArray } from "../collection/array/typed/isTypedArray.js";
 
 /**

package/src/core/math/random/MersenneTwister.d.ts

@@ -1,6 +1,5 @@
-export function MersenneTwister(seed: any): void;
 export class MersenneTwister {
-    constructor(seed: any);
+    constructor(seed?: number);
     N: number;
     M: number;
     MATRIX_A: number;

package/src/core/math/random/MersenneTwister.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MersenneTwister.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/random/MersenneTwister.js"],"names":[],"mappings":"AA8DA,iDAoBC;;IApBD,uBAoBC;IAfG,UAAY;IACZ,UAAY;IACZ,iBAA0B;IAE1B,mBAA4B;IAE5B,mBAA4B;IAG5B,UAA2B;IAE3B,YAAqB;IAOzB,2BAaC;IAMD,oDAqCC;IAGD,wBAmCC;IAGD,wBAEC;IAGD,wBAGC;IAGD,iBAGC;IAGD,wBAGC;IAGD,wBAGC"}
+{"version":3,"file":"MersenneTwister.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/random/MersenneTwister.js"],"names":[],"mappings":"AA8DA;IACI,2BAkBC;IAfG,UAAY;IACZ,UAAY;IACZ,iBAA0B;IAE1B,mBAA4B;IAE5B,mBAA4B;IAG5B,UAA2B;IAE3B,YAAqB;IAOzB,2BAaC;IAOD,oDAqCC;IAGD,wBAmCC;IAGD,wBAEC;IAGD,wBAGC;IAGD,iBAGC;IAGD,wBAGC;IAGD,wBAGC;CACJ"}