@onerjs/core 8.25.8 → 8.26.1

package/Maths/math.vector.d.ts

@@ -733,6 +733,11 @@ export declare class Vector2 implements Vector<Tuple<number, 2>, IVector2Like>,
      */
     static DistanceOfPointFromSegment(p: DeepImmutable<Vector2>, segA: DeepImmutable<Vector2>, segB: DeepImmutable<Vector2>): number;
 }
+type VectorInterceptor = (newValue: {
+    x?: number;
+    y?: number;
+    z?: number;
+}) => boolean;
 /**
  * Class used to store (x,y,z) vector representation
  * A Vector3 is the main object used in 3D geometry
@@ -775,6 +780,8 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, IVector3LikeInt
     _z: number;
     /** @internal */
     _isDirty: boolean;
+    /** @internal */
+    private _interceptor?;
     /** Gets or sets the x coordinate */
     get x(): number;
     set x(value: number);
@@ -789,8 +796,9 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, IVector3LikeInt
      * @param x defines the first coordinates (on X axis)
      * @param y defines the second coordinates (on Y axis)
      * @param z defines the third coordinates (on Z axis)
+     * @param interceptor defines intercept the value change function
      */
-    constructor(x?: number, y?: number, z?: number);
+    constructor(x?: number, y?: number, z?: number, interceptor?: VectorInterceptor);
     /**
      * Creates a string representation of the Vector3
      * Example Playground https://playground.babylonjs.com/#R1F8YU#67
@@ -829,6 +837,20 @@ export declare class Vector3 implements Vector<Tuple<number, 3>, IVector3LikeInt
      * @returns the current Vector3
      */
     fromArray(array: DeepImmutable<FloatArray>, offset?: number): this;
+    /**
+     * Intercept the x,y,z value change
+     * @param interceptor
+     */
+    setInterceptor(interceptor: (newValue: {
+        x?: number;
+        y?: number;
+        z?: number;
+    }) => boolean): void;
+    /**
+     * Get the current interceptor
+     * @returns the current vector interceptor
+     */
+    getInterceptor(): Nullable<VectorInterceptor> | undefined;
     /**
      * Converts the current Vector3 into a quaternion (considering that the Vector3 contains Euler angles representation of a rotation)
      * Example Playground https://playground.babylonjs.com/#R1F8YU#66
@@ -4373,3 +4395,4 @@ export declare class TmpVectors {
     /** 8 temp Matrices at once should be enough */
     static Matrix: [Matrix, Matrix, Matrix, Matrix, Matrix, Matrix, Matrix, Matrix];
 }
+export {};

package/Maths/math.vector.js

@@ -967,6 +967,9 @@ export class Vector3 {
         return this._x;
     }
     set x(value) {
+        if (this._interceptor && this._interceptor({ x: value })) {
+            return;
+        }
         this._x = value;
         this._isDirty = true;
     }
@@ -975,6 +978,9 @@ export class Vector3 {
         return this._y;
     }
     set y(value) {
+        if (this._interceptor && this._interceptor({ y: value })) {
+            return;
+        }
         this._y = value;
         this._isDirty = true;
     }
@@ -983,6 +989,9 @@ export class Vector3 {
         return this._z;
     }
     set z(value) {
+        if (this._interceptor && this._interceptor({ z: value })) {
+            return;
+        }
         this._z = value;
         this._isDirty = true;
     }
@@ -991,13 +1000,19 @@ export class Vector3 {
      * @param x defines the first coordinates (on X axis)
      * @param y defines the second coordinates (on Y axis)
      * @param z defines the third coordinates (on Z axis)
+     * @param interceptor defines intercept the value change function
      */
-    constructor(x = 0, y = 0, z = 0) {
+    constructor(x = 0, y = 0, z = 0, interceptor) {
         /** @internal */
         this._isDirty = true;
+        /** @internal */
+        this._interceptor = null;
         this._x = x;
         this._y = y;
         this._z = z;
+        if (interceptor) {
+            this._interceptor = interceptor;
+        }
     }
     /**
      * Creates a string representation of the Vector3
@@ -1060,6 +1075,20 @@ export class Vector3 {
         Vector3.FromArrayToRef(array, offset, this);
         return this;
     }
+    /**
+     * Intercept the x,y,z value change
+     * @param interceptor
+     */
+    setInterceptor(interceptor) {
+        this._interceptor = interceptor;
+    }
+    /**
+     * Get the current interceptor
+     * @returns the current vector interceptor
+     */
+    getInterceptor() {
+        return this._interceptor;
+    }
     /**
      * Converts the current Vector3 into a quaternion (considering that the Vector3 contains Euler angles representation of a rotation)
      * Example Playground https://playground.babylonjs.com/#R1F8YU#66