@woosh/meep-engine 2.108.0 → 2.108.2

package/build/meep.cjs

@@ -2870,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) {
 
@@ -49540,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) {
@@ -49670,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;
@@ -50290,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);
 }
 
@@ -50299,7 +50299,7 @@ function float2uint8(v) {
  * @param {number} v
  * @returns {number}
  */
-function uint82float(v) {
+function uint8_to_float(v) {
     return v / 255;
 }
 
@@ -51698,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);
         }
     }
 
@@ -51745,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]));
 
         }
 
@@ -53222,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;
     }
 
@@ -53234,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;
     }
 
@@ -53246,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;
     }
 
@@ -53526,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)
     };
 }
 
@@ -53619,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
@@ -53640,7 +53640,7 @@ function rgb_to_luminance(r, g, b) {
     return 0.299 * r + 0.587 * g + 0.114 * b;
 }
 
-function convert(c) {
+function convert_channel_linear_to_sRGB(c) {
     if (c < 0.0031308) {
         return c * 12.92;
     } else {
@@ -53663,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);
 }
 
 /**
@@ -53839,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),
         );
     }
 
@@ -54134,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)
         );
     }
 
@@ -54145,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})`;
     }
 
     /**
@@ -56761,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;
     }
 
 
@@ -63070,72 +63072,137 @@ const ENVIRONMENT_IS_WORKER = typeof importScripts === 'function';
  * @param {string} path
  * @return {string}
  */
-function convertPathToURL(path) {
-
-    if (!isGlobalPath(path)) {
+function localPathToGlobal(path) {
+    /**
+     * @type {Window|DedicatedWorkerGlobalScope}
+     */
+    let scope;
 
-        /**
-         * @type {Window|DedicatedWorkerGlobalScope}
-         */
-        let scope;
+    if (ENVIRONMENT_IS_WEB) {
+        scope = window;
+    } else if (ENVIRONMENT_IS_WORKER) {
+        scope = self;
+    } else if (ENVIRONMENT_IS_NODE) {
 
-        if (ENVIRONMENT_IS_WEB) {
-            scope = window;
-        } else if (ENVIRONMENT_IS_WORKER) {
-            scope = self;
-        } else if (ENVIRONMENT_IS_NODE) {
+        let normalized_path = `${process.cwd()}/`.replace(/\\/g, '/');
 
-            let normalized_path = `${process.cwd()}/`.replace(/\\/g, '/');
+        // remove multiple sequential slashes
+        normalized_path = normalized_path.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 {
@@ -63591,6 +63658,7 @@ class WorkerProxy {
 
 const RxMatchFunctionName = /(function\s*)([a-zA-Z0-9_]+)?(\s*\([^\]]*\)\s*\{.*)/g;
 
+
 class WorkerBuilder {
 
     imports = [];
@@ -63633,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);
     }
 
     /**
@@ -63645,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) {
@@ -63746,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)}`;
-    }
 }
 
 /**
@@ -67691,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
@@ -67712,6 +67748,11 @@ function observeResponseProgress(input, progress) {
         type: "bytes",
         start(controller) {
 
+            /**
+             * @type {ReadableStreamDefaultReader<Uint8Array>}
+             */
+            const reader = response.body.getReader();
+
             pump();
 
             function pump() {
@@ -67729,6 +67770,7 @@ function observeResponseProgress(input, progress) {
                     progress(loaded, total);
 
                     controller.enqueue(value);
+
                     pump();
 
                 });
@@ -67800,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) {
 
-        }
-
-        // Some browsers return HTTP Status 0 when using non-http protocol
-        // e.g. 'file://' or 'data://'. Handle as success.
+            throw Error(`fetch for "${response.url}" responded with ${response_status}: ${response.statusText}`);
 
-        if (response.status === 0) ;
+        }
 
         try {
             response = observeResponseProgress(response, progress);
@@ -75592,6 +75631,9 @@ const TextureAttachmentsByMaterialType = {
         taDisplacement,
         taAlphaMap
     ],
+    MeshBasicMaterial: [
+        taDiffuse
+    ],
     MeshStandardMaterial: [
         taDiffuse,
         taAlphaMap,
@@ -105068,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);
     }
 
@@ -115604,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() {
         /**
@@ -115881,7 +115932,7 @@ class EngineHarness {
                                  ecd = engine.entityManager.dataset,
                                  shadowmapResolution = 1024,
                                  castShadow = true,
-                                 sun = Color.white,
+                                 sun = DEFAULT_SUNLIGHT_COLOR,
                                  sunIntensity = 0.9,
                                  sunDirection = new Vector3$1(0.1, -1, 0.1),
                                  ambient = Color.white,