@woosh/meep-engine 2.98.0 → 2.98.2

package/build/meep.cjs

@@ -890,6 +890,13 @@ function m4_multiply(out, a, b) {
     out[15] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;
 }
 
+const SignalFlags = {
+    /**
+     * If set - signal will not invoke handlers when dispatched
+     */
+    Silent: 1
+};
+
 /**
  *
  * @enum {number}
@@ -968,18 +975,6 @@ class SignalHandler {
  */
 SignalHandler.prototype.isSignalHandler = true;
 
-const SignalFlags = {
-    /**
-     * If set - signal will not invoke handlers when dispatched
-     */
-    Silent: 1,
-    /**
-     * Is set at the start of the dispatch and cleared at the end
-     * @deprecated
-     */
-    Dispatching: 2
-};
-
 /**
  *
  * @author Alex Goldring
@@ -989,6 +984,7 @@ const SignalFlags = {
 
 /**
  * Common dispatch stack
+ * @readonly
  * @type {SignalHandler[]}
  */
 const dispatch_stack = [];
@@ -1001,40 +997,17 @@ let dispatch_stack_top = 0;
  */
 class Signal {
     /**
-     * Event dispatcher dedicated to single event type
-     * @constructor
-     */
-    constructor() {
-        /**
-         * @private
-         * @type {SignalHandler[]}
-         */
-        this.handlers = [];
-
-        /**
-         * Internal flag bitmask
-         * @private
-         * @type {number}
-         */
-        this.flags = 0;
-    }
-
-    /**
-     * @deprecated
-     * @returns {boolean}
+     * @private
+     * @type {SignalHandler[]}
      */
-    get dispatching() {
-        return this.getFlag(SignalFlags.Dispatching);
-    }
+    handlers = [];
 
     /**
-     * @deprecated
-     * @param {boolean} v
+     * Internal flag bitmask
+     * @private
+     * @type {number}
      */
-    set dispatching(v) {
-        this.writeFlag(SignalFlags.Dispatching, v);
-    }
-
+    flags = 0;
 
     /**
      *
@@ -1096,14 +1069,15 @@ class Signal {
 
 
     /**
-     *
-     * @param {function} h
+     * Checks if a given signal handler is present or not
+     * @param {function} handler
+     * @param {*} [thisArg] if not present, will not be considered
      * @returns {boolean}
      */
-    contains(h) {
+    contains(handler, thisArg) {
         const handlers = this.handlers;
 
-        const i = findSignalHandlerIndexByHandle(handlers, h);
+        const i = findSignalHandlerIndexByHandle(handlers, handler, thisArg);
 
         return i !== -1;
     }
@@ -1125,7 +1099,7 @@ class Signal {
     }
 
     /**
-     *
+     * Handler will only be run once, it will be removed automatically after the first execution
      * @param {function} h
      * @param {*} [context]
      */
@@ -1172,7 +1146,9 @@ class Signal {
     }
 
     /**
-     * Remove all handlers
+     * Remove all handlers.
+     * Please note that this will remove even all handlers, irrespective of where they were added from.
+     * For most use cases, prefer to use {@link remove} method instead, or make use of {@link SignalBinding} if you need to keep track of multiple handlers
      */
     removeAll() {
         const handlers = this.handlers;
@@ -1180,6 +1156,7 @@ class Signal {
     }
 
     /**
+     * NOTE: because of polymorphic call-site nature of this method, it's always better for performance to use monomorphic methods like `send0`, `send1` etc.
      * @param {...*} args
      */
     dispatch(...args) {
@@ -1188,13 +1165,8 @@ class Signal {
             return;
         }
 
-        //mark dispatch process
-        this.setFlag(SignalFlags.Dispatching);
-
         dispatchViaProxy(this.handlers, args);
 
-        //mark end of dispatch process
-        this.clearFlag(SignalFlags.Dispatching);
     }
 
     /**
@@ -1560,14 +1532,6 @@ class Signal {
         dispatch_stack_top = stack_pointer;
     }
 
-    /**
-     * @deprecated do not use
-     * @returns {boolean}
-     */
-    isDispatching() {
-        return this.getFlag(SignalFlags.Dispatching);
-    }
-
     /**
      *
      * @param {Signal} other
@@ -1598,7 +1562,7 @@ Signal.prototype.isSignal = true;
  *
  * @param {SignalHandler[]} handlers
  * @param {function} f
- * @param thisArg
+ * @param {*} [thisArg]
  * @returns {number} index of the handler, or -1 if not found
  */
 function findSignalHandlerIndexByHandle(handlers, f, thisArg) {
@@ -53633,7 +53597,11 @@ function rgb2uint24(r, g, b) {
 }
 
 function convert(c) {
-    return (c < 0.0031308) ? c * 12.92 : 1.055 * (Math.pow(c, 0.41666)) - 0.055;
+    if (c < 0.0031308) {
+        return c * 12.92;
+    } else {
+        return 1.055 * (Math.pow(c, 0.4166666666666667)) - 0.055;
+    }
 }
 
 /**
@@ -53643,10 +53611,17 @@ function convert(c) {
  * @param {number[]|ArrayLike<number>} input
  * @param {number} input_offset
  */
-function linear_to_sRGB(output, output_offset, input, input_offset) {
-    output[output_offset] = convert(input[input_offset]);
-    output[output_offset + 1] = convert(input[input_offset + 1]);
-    output[output_offset + 2] = convert(input[input_offset + 2]);
+function linear_to_sRGB(
+    output, output_offset,
+    input, input_offset
+) {
+    const r = input[input_offset];
+    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);
 }
 
 /**
@@ -53655,7 +53630,11 @@ function linear_to_sRGB(output, output_offset, input, input_offset) {
  * @return {number|number}
  */
 function convert_channel_sRGB_to_linear(c) {
-    return (c < 0.04045) ? c * 0.0773993808 : Math.pow(c * 0.9478672986 + 0.0521327014, 2.4);
+    if (c < 0.04045) {
+        return c * 0.0773993808;
+    } else {
+        return Math.pow(c * 0.9478672986 + 0.0521327014, 2.4);
+    }
 }
 
 /**
@@ -53665,10 +53644,18 @@ function convert_channel_sRGB_to_linear(c) {
  * @param {number[]} input
  * @param {number} input_offset
  */
-function sRGB_to_linear(output, output_offset, input, input_offset) {
-    output[output_offset] = convert_channel_sRGB_to_linear(input[input_offset]);
-    output[output_offset + 1] = convert_channel_sRGB_to_linear(input[input_offset + 1]);
-    output[output_offset + 2] = convert_channel_sRGB_to_linear(input[input_offset + 2]);
+function sRGB_to_linear(
+    output, output_offset,
+    input, input_offset
+) {
+
+    const sR = input[input_offset];
+    const sG = input[input_offset + 1];
+    const sB = input[input_offset + 2];
+
+    output[output_offset] = convert_channel_sRGB_to_linear(sR);
+    output[output_offset + 1] = convert_channel_sRGB_to_linear(sG);
+    output[output_offset + 2] = convert_channel_sRGB_to_linear(sB);
 }
 
 /**