@woosh/meep-engine 2.92.22 → 2.92.23

package/build/meep.cjs

@@ -4711,28 +4711,25 @@ const FLAGS_DEFAULT = TransformFlags.AutomaticChangeDetection;
 class Transform {
 
     /**
-     * World-space position
      * @type {Vector3}
      * @readonly
      */
     position = new Vector3$1(0, 0, 0);
 
     /**
-     * World-space rotation
      * @type {Quaternion}
      * @readonly
      */
     rotation = new Quaternion$1(0, 0, 0, 1);
 
     /**
-     * World-space scale
      * @type {Vector3}
      * @readonly
      */
     scale = new Vector3$1(1, 1, 1);
 
     /**
-     * World-space transform matrix, position, rotation and scale must match, but shear can be different
+     * transform matrix, position, rotation and scale must match, but shear can be different
      * @readonly
      * @type {Float32Array}
      */
@@ -4740,22 +4737,18 @@ class Transform {
 
     /**
      * Various bit flags, see {@link TransformFlags}
-     * @protected
+     * This should generally be accessed through getFlag/setFlag instead of modifying the value directly
      * @type {number}
      */
     flags = FLAGS_DEFAULT;
 
-    /**
-     *
-     * @constructor
-     */
     constructor() {
         // watch changes
         this.subscribe(this.#handle_component_change, this);
     }
 
     /**
-     * Current "forward" direction in world-space
+     * Current "forward" direction
      * NOTE that this vector is not live, meaning that if you modify transform, previously-obtained result will no longer be valid
      * @returns {Vector3}
      */
@@ -4767,6 +4760,30 @@ class Transform {
         return result;
     }
 
+    /**
+     * Current "up" direction
+     * @return {Vector3}
+     */
+    get up() {
+        const result = Vector3$1.up.clone();
+
+        result.applyDirectionMatrix4(this.matrix);
+
+        return result;
+    }
+
+    /**
+     * Current "right" direction
+     * @return {Vector3}
+     */
+    get right() {
+        const result = Vector3$1.right.clone();
+
+        result.applyDirectionMatrix4(this.matrix);
+
+        return result;
+    }
+
     /**
      * Attach change listener
      * @param {function} handler
@@ -4982,6 +4999,7 @@ class Transform {
      * @param {mat4|number[]|Float32Array} m
      */
     fromMatrix4(m) {
+        // we know we are changing the matrix, so we're going to need to disable the flag that sets matrix from position/rotation/scale changes
         const ad = this.getFlag(TransformFlags.AutomaticChangeDetection);
 
         this.clearFlag(TransformFlags.AutomaticChangeDetection);
@@ -4990,6 +5008,7 @@ class Transform {
 
         decompose_matrix_4_array(m, this.position, this.rotation, this.scale);
 
+        // restore value of the flag
         this.writeFlag(TransformFlags.AutomaticChangeDetection, ad);
     }