@woosh/meep-engine 2.107.0 → 2.108.2

package/build/meep.cjs

@@ -2,8 +2,8 @@
 
 /**
  *
- * @param {Array} a
- * @param {Array} b
+ * @param {Array|Uint8Array} a
+ * @param {Array|Uint8Array} b
  * @returns {boolean}
  */
 function isArrayEqualStrict(a, b) {
@@ -2049,6 +2049,7 @@ function v3_lerp(
 
 /**
  * Spherical linear interpolation
+ * NOTE: vectors are assumed to be normalized
  * @see https://en.wikipedia.org/wiki/Slerp
  * @param {Vector3} result
  * @param {number} a_x
@@ -2671,6 +2672,7 @@ let Vector3$1 = class Vector3 {
         const y = this.y;
         const z = this.z;
 
+        // This is just 3x3 matrix multiplication
         const _x = m4[0] * x + m4[4] * y + m4[8] * z;
         const _y = m4[1] * x + m4[5] * y + m4[9] * z;
         const _z = m4[2] * x + m4[6] * y + m4[10] * z;
@@ -2868,10 +2870,10 @@ let Vector3$1 = class Vector3 {
     }
 
     /**
-     *
+     * Convert spherical coordinates to cartesian
      * @param {number} radius
-     * @param {number} phi
-     * @param {number} theta
+     * @param {number} phi Also known as Azimuth
+     * @param {number} theta Also known as Elevation
      */
     setFromSphericalCoords(radius, phi, theta) {
 
@@ -49538,7 +49540,7 @@ class Sampler2D {
      *
      * @param {number} u
      * @param {number} v
-     * @param {number[]} result
+     * @param {number[]|Float32Array} result
      * @param {number} result_offset
      */
     sampleBilinearUV(u, v, result, result_offset = 0) {
@@ -49668,7 +49670,7 @@ class Sampler2D {
      *
      * @param {number} u
      * @param {number} v
-     * @param {ArrayLike<number>} result
+     * @param {number[]|ArrayLike<number>} result
      */
     sampleNearestUV(u, v, result) {
         const w = this.width;
@@ -50288,7 +50290,7 @@ const WHITE_PIXEL_DATA_URL = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEA
  * @param {number} v
  * @returns {number}
  */
-function float2uint8(v) {
+function float_to_uint8(v) {
     return Math.round(v * 255);
 }
 
@@ -50297,7 +50299,7 @@ function float2uint8(v) {
  * @param {number} v
  * @returns {number}
  */
-function uint82float(v) {
+function uint8_to_float(v) {
     return v / 255;
 }
 
@@ -51696,7 +51698,7 @@ class TerrainOverlay {
         for (let i = 0; i < 4; i++) {
             const v = this.sampler.readChannel(x, y, i);
 
-            result[i] = uint82float(v);
+            result[i] = uint8_to_float(v);
         }
     }
 
@@ -51743,7 +51745,7 @@ class TerrainOverlay {
     paintPoint(x, y, vec4) {
         for (let i = 0; i < 4; i++) {
 
-            this.sampler.writeChannel(x, y, i, float2uint8(vec4[i]));
+            this.sampler.writeChannel(x, y, i, float_to_uint8(vec4[i]));
 
         }
 
@@ -53220,7 +53222,7 @@ function aabb3_intersects_ray(
     const diff_x = origin_x - center_x;
 
 
-    if (diff_x * direction_x >= 0.0 && abs(diff_x) > extents_x) {
+    if (diff_x * direction_x >= 0 && abs(diff_x) > extents_x) {
         return false;
     }
 
@@ -53232,7 +53234,7 @@ function aabb3_intersects_ray(
     const diff_y = origin_y - center_y;
 
 
-    if (diff_y * direction_y >= 0.0 && abs(diff_y) > extents_y) {
+    if (diff_y * direction_y >= 0 && abs(diff_y) > extents_y) {
         return false;
     }
 
@@ -53244,7 +53246,7 @@ function aabb3_intersects_ray(
     const diff_z = origin_z - center_z;
 
 
-    if (diff_z * direction_z >= 0.0 && abs(diff_z) > extents_z) {
+    if (diff_z * direction_z >= 0 && abs(diff_z) > extents_z) {
         return false;
     }
 
@@ -53400,20 +53402,15 @@ function rgb2hex(r, g, b) {
 
 /**
  *
- * @param {number} r 0 to 255
- * @param {number} g 0 to 255
- * @param {number} b 0 to 255
+ * @param {number} r 0 to 1
+ * @param {number} g 0 to 1
+ * @param {number} b 0 to 1
  * @returns {{h: number, s: number, v: number}}
  */
 function rgb2hsv(r, g, b) {
 
-    const _r = uint82float(r);
-    const _g = uint82float(g);
-    const _b = uint82float(b);
-
-
-    const max = Math.max(_r, _g, _b);
-    const min = Math.min(_r, _g, _b);
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
 
     let h, s, v = max;
 
@@ -53425,14 +53422,14 @@ function rgb2hsv(r, g, b) {
         h = 0; // achromatic
     } else {
         switch (max) {
-            case _r:
-                h = (_g - _b) / d + (_g < _b ? 6 : 0);
+            case r:
+                h = (g - b) / d + (g < b ? 6 : 0);
                 break;
-            case _g:
-                h = (_b - _r) / d + 2;
+            case g:
+                h = (b - r) / d + 2;
                 break;
-            case _b:
-                h = (_r - _g) / d + 4;
+            case b:
+                h = (r - g) / d + 4;
                 break;
         }
 
@@ -53529,9 +53526,9 @@ function hsv2rgb(h, s, v) {
             break;
     }
     return {
-        r: float2uint8(r),
-        g: float2uint8(g),
-        b: float2uint8(b)
+        r: float_to_uint8(r),
+        g: float_to_uint8(g),
+        b: float_to_uint8(b)
     };
 }
 
@@ -53622,9 +53619,9 @@ function parse_color(c) {
  * @returns {number}
  */
 function rgb2uint24(r, g, b) {
-    const _r = float2uint8(r);
-    const _g = float2uint8(g);
-    const _b = float2uint8(b);
+    const _r = float_to_uint8(r);
+    const _g = float_to_uint8(g);
+    const _b = float_to_uint8(b);
 
     return (_b & 0xFF)
         | (_g & 0xFF) << 8
@@ -53632,7 +53629,18 @@ function rgb2uint24(r, g, b) {
         ;
 }
 
-function convert(c) {
+/**
+ *
+ * @param {number} r
+ * @param {number} g
+ * @param {number} b
+ * @return {number}
+ */
+function rgb_to_luminance(r, g, b) {
+    return 0.299 * r + 0.587 * g + 0.114 * b;
+}
+
+function convert_channel_linear_to_sRGB(c) {
     if (c < 0.0031308) {
         return c * 12.92;
     } else {
@@ -53655,9 +53663,9 @@ function linear_to_sRGB(
     const g = input[input_offset + 1];
     const b = input[input_offset + 2];
 
-    output[output_offset] = convert(r);
-    output[output_offset + 1] = convert(g);
-    output[output_offset + 2] = convert(b);
+    output[output_offset] = convert_channel_linear_to_sRGB(r);
+    output[output_offset + 1] = convert_channel_linear_to_sRGB(g);
+    output[output_offset + 2] = convert_channel_linear_to_sRGB(b);
 }
 
 /**
@@ -53831,9 +53839,9 @@ class Color {
      */
     setRGBUint8(r, g, b) {
         this.setRGB(
-            uint82float(r),
-            uint82float(g),
-            uint82float(b),
+            uint8_to_float(r),
+            uint8_to_float(g),
+            uint8_to_float(b),
         );
     }
 
@@ -54086,11 +54094,15 @@ class Color {
      * @return {number}
      */
     computeLuminance() {
-        return 0.299 * this.r + 0.587 * this.g + 0.114 * this.b;
+        return rgb_to_luminance(this.r, this.g, this.b);
     }
 
     getHSV() {
-        return rgb2hsv(this.r * 255, this.g * 255, this.b * 255);
+        return rgb2hsv(
+            this.r,
+            this.g,
+            this.b
+        );
     }
 
     /**
@@ -54122,9 +54134,9 @@ class Color {
      */
     toHex() {
         return '#' + rgb2hex(
-            float2uint8(this.r),
-            float2uint8(this.g),
-            float2uint8(this.b)
+            float_to_uint8(this.r),
+            float_to_uint8(this.g),
+            float_to_uint8(this.b)
         );
     }
 
@@ -54133,7 +54145,7 @@ class Color {
      * @returns {string}
      */
     toCssRGBAString() {
-        return `rgba(${float2uint8(this.r)},${float2uint8(this.g)},${float2uint8(this.b)},${this.a})`;
+        return `rgba(${float_to_uint8(this.r)},${float_to_uint8(this.g)},${float_to_uint8(this.b)},${this.a})`;
     }
 
     /**
@@ -56749,11 +56761,13 @@ class AABB3 {
      * Get center position of the box
      * @param {Vector3} target where to write result
      */
-    getCenter(target) {
+    getCenter(target = new Vector3$1()) {
         const x = this.getCenterX();
         const y = this.getCenterY();
         const z = this.getCenterZ();
         target.set(x, y, z);
+
+        return target;
     }
 
 
@@ -63058,72 +63072,137 @@ const ENVIRONMENT_IS_WORKER = typeof importScripts === 'function';
  * @param {string} path
  * @return {string}
  */
-function convertPathToURL(path) {
+function localPathToGlobal(path) {
+    /**
+     * @type {Window|DedicatedWorkerGlobalScope}
+     */
+    let scope;
 
-    if (!isGlobalPath(path)) {
+    if (ENVIRONMENT_IS_WEB) {
+        scope = window;
+    } else if (ENVIRONMENT_IS_WORKER) {
+        scope = self;
+    } else if (ENVIRONMENT_IS_NODE) {
 
-        /**
-         * @type {Window|DedicatedWorkerGlobalScope}
-         */
-        let scope;
+        let normalized_path = `${process.cwd()}/`.replace(/\\/g, '/');
 
-        if (ENVIRONMENT_IS_WEB) {
-            scope = window;
-        } else if (ENVIRONMENT_IS_WORKER) {
-            scope = self;
-        } else if (ENVIRONMENT_IS_NODE) {
+        // remove multiple sequential slashes
+        normalized_path = normalized_path.replace(/\/+/g, '/');
 
-            let normalized_path = `${process.cwd()}/`.replace(/\\/g, '/');
-
-            // remove multiple sequential slashes
-            normalized_path = normalized_path.replace(/\/+/g, '/');
+        if (normalized_path[0] !== '/') {
+            // Windows drive letter must be prefixed with a slash.
+            normalized_path = `/${normalized_path}`;
+        }
 
-            if (normalized_path[0] !== '/') {
-                // Windows drive letter must be prefixed with a slash.
-                normalized_path = `/${normalized_path}`;
+        scope = {
+            location: {
+                pathname: normalized_path,
+                host: '',
+                protocol: 'file:'
             }
+        };
+    } else {
+        throw new Error('Unknown environment');
+    }
 
-            scope = {
-                location: {
-                    pathname: normalized_path,
-                    host: '',
-                    protocol: 'file:'
-                }
-            };
+    const location = scope.location;
+    const pathname = location.pathname;
+
+    let directoryPath;
+
+    /*
+    path name contains file name also, there are two options here, "a/b" or "a/b/" second is a directory
+    we need to extract directory to load relative path
+    */
+
+    if (pathname.endsWith('/')) {
+        //path is to a directory, strip last slash
+        directoryPath = pathname.substring(0, pathname.length - 1);
+    } else {
+        //path is to a file
+        const i = pathname.lastIndexOf('/');
+
+        if (i === -1) {
+            //root level file
+            directoryPath = "";
         } else {
-            throw new Error('Unknown environment');
+            directoryPath = pathname.substring(0, i);
         }
+    }
 
-        const location = scope.location;
-        const pathname = location.pathname;
+    const urlBase = location.protocol + "//" + location.host + directoryPath + "/";
+    return urlBase + path;
+}
 
-        let directoryPath;
+/**
+ * Given a path, which may be a local path, produce a fully qualified URL
+ * @example '/path' -> 'http://example.com/path'
+ * @example 'some/local/path' -> 'http://example.com/current_path/some/local/path'
+ * @param {string} path
+ * @return {string}
+ */
+function convertPathToURL(path) {
 
-        /*
-        path name contains file name also, there are two options here, "a/b" or "a/b/" second is a directory
-        we need to extract directory to load relative path
-        */
+    const is_global = isGlobalPath(path);
 
-        if (pathname.endsWith('/')) {
-            //path is to a directory, strip last slash
-            directoryPath = pathname.substring(0, pathname.length - 1);
-        } else {
-            //path is to a file
-            const i = pathname.lastIndexOf('/');
+    let result = path;
 
-            if (i === -1) {
-                //root level file
-                directoryPath = "";
-            } else {
-                directoryPath = pathname.substring(0, i);
-            }
+    if (!is_global) {
+        result = localPathToGlobal(path);
+    }
+
+    return result;
+}
+
+/**
+ *
+ * @param {string} code
+ * @param {string} [mime_type]
+ * @return {Blob}
+ */
+function codeToBlob(code, mime_type = 'application/javascript') {
+
+    let blob;
+
+    if (typeof globalThis.Blob !== "undefined") {
+        blob = new Blob([code], { type: mime_type });
+    } else {
+        // Backwards-compatibility
+        const BlobBuilder = globalThis.BlobBuilder
+            || globalThis.BlobBuilder
+            || globalThis.WebKitBlobBuilder
+            || globalThis.MozBlobBuilder;
+
+        if (BlobBuilder !== undefined) {
+            blob = new BlobBuilder();
+            blob.append(code);
+            blob = blob.getBlob();
+        } else {
+            throw new Error(`No BlobBuilder interface supported in current context`);
         }
 
-        const urlBase = location.protocol + "//" + location.host + directoryPath + "/";
-        path = urlBase + path;
     }
 
-    return path;
+
+    return blob;
+}
+
+/**
+ *
+ * @param {string} code
+ * @param {string} [mime_type]
+ * @return {string}
+ */
+function codeToURL(code, mime_type = 'application/javascript') {
+
+    const blob = codeToBlob(code, mime_type);
+
+    if (blob !== undefined && URL.createObjectURL !== undefined) {
+        return URL.createObjectURL(blob);
+    } else {
+        // build data URL in a slowest way possible
+        return `data:${mime_type},${encodeURIComponent(code)}`;
+    }
 }
 
 class Line {
@@ -63579,6 +63658,7 @@ class WorkerProxy {
 
 const RxMatchFunctionName = /(function\s*)([a-zA-Z0-9_]+)?(\s*\([^\]]*\)\s*\{.*)/g;
 
+
 class WorkerBuilder {
 
     imports = [];
@@ -63621,9 +63701,9 @@ class WorkerBuilder {
      * @param {string} path
      */
     importScript(path) {
-        path = convertPathToURL(path);
+        const qualified_path = convertPathToURL(path);
 
-        this.imports.push(path);
+        this.imports.push(qualified_path);
     }
 
     /**
@@ -63633,7 +63713,7 @@ class WorkerBuilder {
     build() {
         const codeLines = [];
 
-        codeLines.push('var globalScope = this;');
+        codeLines.push('var globalScope = globalThis;');
 
         //handle imports
         this.imports.forEach(function (url) {
@@ -63734,37 +63814,6 @@ class WorkerBuilder {
 
         return new WorkerProxy(workerURL, this.methods);
     }
-}
-/**
- *
- * @param {string} code
- * @return {string}
- */
-function codeToURL(code) {
-    const js_mime = 'application/javascript';
-
-    let blob;
-
-    if (typeof window === 'object') {
-        if (typeof window.Blob !== "undefined") {
-            blob = new Blob([code], {type: js_mime});
-        } else {
-            // Backwards-compatibility
-            const BlobBuilder = window.BlobBuilder = window.BlobBuilder || window.WebKitBlobBuilder || window.MozBlobBuilder;
-            if (BlobBuilder !== undefined) {
-                blob = new BlobBuilder();
-                blob.append(code);
-                blob = blob.getBlob();
-            }
-        }
-    }
-
-    if (blob !== undefined && URL.createObjectURL !== undefined) {
-        return URL.createObjectURL(blob);
-    } else {
-        // build data URL in a slowest way possible
-        return `data:${js_mime},${encodeURIComponent(code)}`;
-    }
 }
 
 /**
@@ -67679,20 +67728,19 @@ class AssetLoader {
 function observeResponseProgress(input, progress) {
     let response = input;
 
-
-    if (typeof ReadableStream === 'undefined' || response.body.getReader === undefined) {
+    // Workaround: Checking if response.body === undefined for Alipay browser
+    if (typeof ReadableStream === 'undefined' || response.body === undefined || response.body.getReader === undefined) {
 
         return response;
 
     }
 
-    /**
-     * @type {ReadableStreamDefaultReader<Uint8Array>}
-     */
-    const reader = response.body.getReader();
+    // Nginx needs X-File-Size check
+    // https://serverfault.com/questions/482875/why-does-nginx-remove-content-length-header-for-chunked-content
+    const contentLength = response.headers.get('Content-Length') || response.headers.get('X-File-Size');
 
-    const contentLength = response.headers.get('Content-Length');
     const total = contentLength ? parseInt(contentLength) : 0;
+
     let loaded = 0;
 
     // periodically read data into the new stream tracking while download progress
@@ -67700,6 +67748,11 @@ function observeResponseProgress(input, progress) {
         type: "bytes",
         start(controller) {
 
+            /**
+             * @type {ReadableStreamDefaultReader<Uint8Array>}
+             */
+            const reader = response.body.getReader();
+
             pump();
 
             function pump() {
@@ -67717,6 +67770,7 @@ function observeResponseProgress(input, progress) {
                     progress(loaded, total);
 
                     controller.enqueue(value);
+
                     pump();
 
                 });
@@ -67788,16 +67842,13 @@ class ArrayBufferLoader extends AssetLoader {
 
         let response = await fetch(request);
 
-        if (!(response.status === 200 || response.status === 0)) {
+        const response_status = response.status;
 
-            throw Error(`fetch for "${response.url}" responded with ${response.status}: ${response.statusText}`);
+        if (response_status !== 200 && response_status !== 0) {
 
-        }
+            throw Error(`fetch for "${response.url}" responded with ${response_status}: ${response.statusText}`);
 
-        // Some browsers return HTTP Status 0 when using non-http protocol
-        // e.g. 'file://' or 'data://'. Handle as success.
-
-        if (response.status === 0) ;
+        }
 
         try {
             response = observeResponseProgress(response, progress);
@@ -75580,6 +75631,9 @@ const TextureAttachmentsByMaterialType = {
         taDisplacement,
         taAlphaMap
     ],
+    MeshBasicMaterial: [
+        taDiffuse
+    ],
     MeshStandardMaterial: [
         taDiffuse,
         taAlphaMap,
@@ -75665,7 +75719,9 @@ const TextureAttachmentsByMaterialType = {
             }
         })
     ]
-};
+};
+
+TextureAttachmentsByMaterialType.MeshPhysicalMaterial = TextureAttachmentsByMaterialType.MeshStandardMaterial;
 
 /**
  * Transfer bitmap contents to Sampler2D, effectively moving data to CPU, making it readable
@@ -90632,6 +90688,7 @@ class GraphicsEngine {
         const camera = this.camera;
 
         if (scene.children.indexOf(camera) < 0) {
+            // console.log("added camera");
             scene.add(camera);
         }
 
@@ -105053,6 +105110,9 @@ class TopDownCameraController {
 
         this.distance = eye.distanceTo(target);
 
+        // ensure we can maintain this distance
+        this.distanceMax = max2(this.distance, this.distanceMax);
+
         this.target.copy(target);
     }
 
@@ -112371,6 +112431,27 @@ function scene_object_filter(object3D) {
     return true;
 }
 
+/**
+ *
+ * @param {LightShadow} shadow
+ * @param {number} resolution
+ */
+function three_set_shadow_resolution(shadow, resolution) {
+    const mapSize = shadow.mapSize;
+
+    if (mapSize.width !== resolution || mapSize.height !== resolution) {
+
+        mapSize.width = mapSize.height = resolution;
+
+        //destroy old map
+        if (shadow.map !== null) {
+            shadow.map.dispose(); // important
+            shadow.map = null;
+        }
+
+    }
+}
+
 class ThreeLightBinding extends LightBinding {
 
     constructor() {
@@ -112635,17 +112716,7 @@ class ThreeLightBinding extends LightBinding {
             shadow.radius = 1;
             shadow.blurSamples = 8;
 
-            if (shadow.mapSize.width !== resolution || shadow.mapSize.height !== resolution) {
-
-                shadow.mapSize.width = shadow.mapSize.height = resolution;
-
-                //destroy old map
-                if (shadow.map !== null) {
-                    shadow.map.dispose(); // important
-                    shadow.map = null;
-                }
-
-            }
+            three_set_shadow_resolution(shadow, resolution);
 
         }
     }
@@ -113273,7 +113344,7 @@ class LightSystem extends AbstractContextSystem {
 
                 l.castShadow = true;
 
-                updateShadowMap(this.__camera_object, l, this.__graphics);
+                three_update_shadow_camera_extents(this.__camera_object, l, this.__graphics);
 
             } else {
 
@@ -113324,9 +113395,8 @@ const scratch_aabb3 = new AABB3();
  * @author Alex Goldring 02.06.2016 (Komrade)
  * @param {Camera} camera
  * @param {Light} light
- * @param {GraphicsEngine} graphics
  */
-function updateShadowMap(camera, light, graphics) {
+function three_update_shadow_camera_extents(camera, light) {
 
 
     // Fit shadow camera's ortho frustum to camera frustum
@@ -114548,6 +114618,8 @@ class InputControllerSystem extends System {
 
         this.devices = devices;
 
+        // console.log("Input Controller System started. Devices: ", devices);
+
         const self = this;
 
         this.enabled.onChanged.add(function (v) {
@@ -115577,6 +115649,12 @@ function setLocale(engine) {
     return engine.localization.loadLocale(locale);
 }
 
+/**
+ * Equal to ~ 5500 K light color
+ * @type {Readonly<Color>}
+ */
+const DEFAULT_SUNLIGHT_COLOR = Object.freeze(new Color(1, 0.93, 0.87));
+
 class EngineHarness {
     constructor() {
         /**
@@ -115844,12 +115922,21 @@ class EngineHarness {
      * @param {EntityComponentDataset} [param.ecd]
      * @param {number} [param.shadowmapResolution]
      * @param {boolean} [param.castShadow]
+     * @param {Color} [param.sun]
+     * @param {number} [param.sunIntensity]
+     * @param {Color} [param.ambient]
+     * @param {number} [param.ambientIntensity]
      */
     static async buildLights({
                                  engine,
                                  ecd = engine.entityManager.dataset,
                                  shadowmapResolution = 1024,
-                                 castShadow = true
+                                 castShadow = true,
+                                 sun = DEFAULT_SUNLIGHT_COLOR,
+                                 sunIntensity = 0.9,
+                                 sunDirection = new Vector3$1(0.1, -1, 0.1),
+                                 ambient = Color.white,
+                                 ambientIntensity = 0.1
                              }) {
         const em = engine.entityManager;
 
@@ -115865,18 +115952,13 @@ class EngineHarness {
 
         const key = new Light();
         key.type.set(Light.Type.DIRECTION);
-        key.color.setRGB(1, 1, 1);
-        key.intensity.set(0.8);
+        key.color.copy(sun);
+        key.intensity.set(sunIntensity);
         key.castShadow.set(castShadow);
 
         const transform = new Transform();
         transform.position.set(30, 70, 30);
-        transform.rotation.set(
-            -0.18780341950959473,
-            0.8049745556929917,
-            -0.4533975611897181,
-            -0.3334313787830773
-        );
+        transform.rotation.lookRotation(sunDirection);
 
         new Entity()
             .add(key)
@@ -115887,8 +115969,8 @@ class EngineHarness {
 
         const fill = new Light();
         fill.type.set(Light.Type.AMBIENT);
-        fill.color.setRGB(1, 1, 1);
-        fill.intensity.set(0.1);
+        fill.color.copy(ambient);
+        fill.intensity.set(ambientIntensity);
 
 
         new Entity()
@@ -117692,6 +117774,7 @@ exports.findSignalHandlerIndexByHandle = findSignalHandlerIndexByHandle;
 exports.findSignalHandlerIndexByHandleAndContext = findSignalHandlerIndexByHandleAndContext;
 exports.find_path_on_grid_astar = find_path_on_grid_astar;
 exports.quat3_createFromAxisAngle = quat3_createFromAxisAngle;
+exports.three_update_shadow_camera_extents = three_update_shadow_camera_extents;
 exports.v2_angle_between = v2_angle_between;
 exports.v2_bearing_angle_towards = v2_bearing_angle_towards;
 exports.v2_distance = v2_distance;