@adobe/data 0.5.13 → 0.5.16

package/dist/math/plane/plane.test.js

@@ -0,0 +1,132 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { describe, it, expect } from "vitest";
+import { Plane } from "../index.js";
+describe("Plane", () => {
+    const xyPlane = {
+        normal: [0, 0, 1], // pointing up
+        distance: 0 // plane at origin
+    };
+    const xyPlaneOffset = {
+        normal: [0, 0, 1], // pointing up
+        distance: 5 // plane 5 units above origin
+    };
+    describe("signedDistance", () => {
+        it("should return 0 for points on the plane", () => {
+            expect(Plane.signedDistance(xyPlane, [0, 0, 0])).toBe(0);
+            expect(Plane.signedDistance(xyPlane, [5, 3, 0])).toBe(0);
+        });
+        it("should return positive distance for points in front of plane", () => {
+            expect(Plane.signedDistance(xyPlane, [0, 0, 1])).toBe(1);
+            expect(Plane.signedDistance(xyPlane, [0, 0, 5])).toBe(5);
+        });
+        it("should return negative distance for points behind plane", () => {
+            expect(Plane.signedDistance(xyPlane, [0, 0, -1])).toBe(-1);
+            expect(Plane.signedDistance(xyPlane, [0, 0, -3])).toBe(-3);
+        });
+        it("should work with offset planes", () => {
+            expect(Plane.signedDistance(xyPlaneOffset, [0, 0, 5])).toBe(0); // on plane
+            expect(Plane.signedDistance(xyPlaneOffset, [0, 0, 7])).toBe(2); // 2 units above
+            expect(Plane.signedDistance(xyPlaneOffset, [0, 0, 3])).toBe(-2); // 2 units below
+        });
+    });
+    describe("distance", () => {
+        it("should return absolute distance", () => {
+            expect(Plane.distance(xyPlane, [0, 0, 3])).toBe(3);
+            expect(Plane.distance(xyPlane, [0, 0, -3])).toBe(3);
+            expect(Plane.distance(xyPlane, [0, 0, 0])).toBe(0);
+        });
+    });
+    describe("containsPoint", () => {
+        it("should return true for points on the plane", () => {
+            expect(Plane.containsPoint(xyPlane, [0, 0, 0])).toBe(true);
+            expect(Plane.containsPoint(xyPlane, [5, 3, 0])).toBe(true);
+        });
+        it("should return false for points off the plane", () => {
+            expect(Plane.containsPoint(xyPlane, [0, 0, 0.001])).toBe(false);
+            expect(Plane.containsPoint(xyPlane, [0, 0, -0.001])).toBe(false);
+        });
+    });
+    describe("isPointInFront", () => {
+        it("should return true for points in front of plane", () => {
+            expect(Plane.isPointInFront(xyPlane, [0, 0, 1])).toBe(true);
+            expect(Plane.isPointInFront(xyPlane, [0, 0, 5])).toBe(true);
+        });
+        it("should return false for points behind or on plane", () => {
+            expect(Plane.isPointInFront(xyPlane, [0, 0, 0])).toBe(false);
+            expect(Plane.isPointInFront(xyPlane, [0, 0, -1])).toBe(false);
+        });
+    });
+    describe("isPointBehind", () => {
+        it("should return true for points behind plane", () => {
+            expect(Plane.isPointBehind(xyPlane, [0, 0, -1])).toBe(true);
+            expect(Plane.isPointBehind(xyPlane, [0, 0, -5])).toBe(true);
+        });
+        it("should return false for points in front or on plane", () => {
+            expect(Plane.isPointBehind(xyPlane, [0, 0, 0])).toBe(false);
+            expect(Plane.isPointBehind(xyPlane, [0, 0, 1])).toBe(false);
+        });
+    });
+    describe("lineIntersection", () => {
+        it("should find intersection alpha for line crossing plane", () => {
+            const line = { a: [0, 0, -1], b: [0, 0, 1] }; // vertical line
+            const alpha = Plane.lineIntersection(xyPlane, line);
+            expect(alpha).toBe(0.5); // intersects at midpoint
+        });
+        it("should find intersection alpha for diagonal line", () => {
+            const line = { a: [1, 1, -1], b: [1, 1, 1] }; // diagonal line
+            const alpha = Plane.lineIntersection(xyPlane, line);
+            expect(alpha).toBe(0.5); // intersects at midpoint
+        });
+        it("should find intersection alpha for offset plane", () => {
+            const line = { a: [0, 0, 3], b: [0, 0, 7] }; // line above offset plane
+            const alpha = Plane.lineIntersection(xyPlaneOffset, line);
+            expect(alpha).toBe(0.5); // intersects at midpoint (z=5)
+        });
+        it("should return null for line parallel to plane", () => {
+            const line = { a: [0, 0, 1], b: [1, 0, 1] }; // horizontal line
+            const alpha = Plane.lineIntersection(xyPlane, line);
+            expect(alpha).toBeNull();
+        });
+        it("should return null for line in the plane", () => {
+            const line = { a: [0, 0, 0], b: [1, 0, 0] }; // line in xy plane
+            const alpha = Plane.lineIntersection(xyPlane, line);
+            expect(alpha).toBeNull();
+        });
+        it("should handle line that doesn't intersect within segment", () => {
+            const line = { a: [0, 0, 2], b: [0, 0, 4] }; // line above plane
+            const alpha = Plane.lineIntersection(xyPlane, line);
+            expect(alpha).toBe(-1); // intersection exists but before segment start
+        });
+        it("should handle alpha values outside segment", () => {
+            const line = { a: [0, 0, 2], b: [0, 0, 6] }; // line from z=2 to z=6
+            const alpha = Plane.lineIntersection(xyPlane, line);
+            expect(alpha).toBe(-0.5); // intersects at z=0, which is before segment start
+        });
+        it("should handle alpha values after segment end", () => {
+            const line = { a: [0, 0, -2], b: [0, 0, -1] }; // line from z=-2 to z=-1
+            const alpha = Plane.lineIntersection(xyPlane, line);
+            expect(alpha).toBe(2); // intersects at z=0, which is after segment end
+        });
+    });
+});
+//# sourceMappingURL=plane.test.js.map

package/dist/math/plane/plane.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plane.test.js","sourceRoot":"","sources":["../../../src/math/plane/plane.test.ts"],"names":[],"mappings":"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"}

package/dist/math/quat/quat.d.ts

@@ -1,42 +1,52 @@
 import { FromSchema } from "../../schema/index.js";
 import { Vec3, Mat4x4 } from "../index.js";
-export declare const schema: {
-    readonly type: "array";
-    readonly items: {
-        readonly type: "number";
-        readonly precision: 1;
-        readonly default: number;
+export type Quat = FromSchema<typeof Quat.schema>;
+export declare namespace Quat {
+    const schema: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly minItems: 4;
+        readonly maxItems: 4;
+        readonly default: readonly [0, 0, 0, 1];
     };
-    readonly minItems: 4;
-    readonly maxItems: 4;
-    readonly default: readonly [0, 0, 0, 1];
-};
-export type Type = FromSchema<typeof schema>;
-type Quat = Type;
-export declare const layout: import("../../typed-buffer/index.js").StructLayout;
-export declare const add: ([x1, y1, z1, w1]: Quat, [x2, y2, z2, w2]: Quat) => Quat;
-export declare const subtract: ([x1, y1, z1, w1]: Quat, [x2, y2, z2, w2]: Quat) => Quat;
-export declare const scale: ([x, y, z, w]: Quat, s: number) => Quat;
-export declare const negate: ([x, y, z, w]: Quat) => Quat;
-export declare const conjugate: ([x, y, z, w]: Quat) => Quat;
-export declare const multiply: ([x1, y1, z1, w1]: Quat, [x2, y2, z2, w2]: Quat) => Quat;
-export declare const length: ([x, y, z, w]: Quat) => number;
-export declare const lengthSquared: ([x, y, z, w]: Quat) => number;
-export declare const normalize: (q: Quat) => Quat;
-export declare const dot: ([x1, y1, z1, w1]: Quat, [x2, y2, z2, w2]: Quat) => number;
-export declare const distance: (a: Quat, b: Quat) => number;
-export declare const fromAxisAngle: (axis: Vec3, angle: number) => Quat;
-export declare const toAxisAngle: ([x, y, z, w]: Quat) => {
-    axis: Vec3;
-    angle: number;
-};
-export declare const fromEuler: (x: number, y: number, z: number) => Quat;
-export declare const toEuler: ([x, y, z, w]: Quat) => Vec3;
-export declare const rotateVec3: ([x, y, z, w]: Quat, v: Vec3) => Vec3;
-export declare const slerp: (q1: Quat, q2: Quat, t: number) => Quat;
-export declare const lerp: (q1: Quat, q2: Quat, t: number) => Quat;
-export declare const toMat4: ([x, y, z, w]: Quat) => Mat4x4;
-export declare const identity: () => Quat;
-export declare const inverse: (q: Quat) => Quat;
-export declare const lookAt: (forward: Vec3, up: Vec3) => Quat;
-export {};
+    const layout: import("../../typed-buffer/index.js").StructLayout;
+    const add: ([x1, y1, z1, w1]: Quat, [x2, y2, z2, w2]: Quat) => Quat;
+    const subtract: ([x1, y1, z1, w1]: Quat, [x2, y2, z2, w2]: Quat) => Quat;
+    const scale: ([x, y, z, w]: Quat, s: number) => Quat;
+    const negate: ([x, y, z, w]: Quat) => Quat;
+    const conjugate: ([x, y, z, w]: Quat) => Quat;
+    const multiply: ([x1, y1, z1, w1]: Quat, [x2, y2, z2, w2]: Quat) => Quat;
+    const length: ([x, y, z, w]: Quat) => number;
+    const lengthSquared: ([x, y, z, w]: Quat) => number;
+    const normalize: (q: Quat) => Quat;
+    const dot: ([x1, y1, z1, w1]: Quat, [x2, y2, z2, w2]: Quat) => number;
+    const distance: (a: Quat, b: Quat) => number;
+    const fromAxisAngle: (axis: Vec3, angle: number) => Quat;
+    const toAxisAngle: ([x, y, z, w]: Quat) => {
+        axis: Vec3;
+        angle: number;
+    };
+    const fromEuler: (x: number, y: number, z: number) => Quat;
+    const toEuler: ([x, y, z, w]: Quat) => Vec3;
+    const rotateVec3: ([x, y, z, w]: Quat, v: Vec3) => Vec3;
+    const slerp: (q1: Quat, q2: Quat, t: number) => Quat;
+    const lerp: (q1: Quat, q2: Quat, t: number) => Quat;
+    const toMat4: ([x, y, z, w]: Quat) => Mat4x4;
+    const identity: Quat;
+    const inverse: (q: Quat) => Quat;
+    const lookAt: (forward: Vec3, up: Vec3) => Quat;
+    /**
+     * Returns a quaternion that aligns the local Z-axis to the given direction via the shortest arc,
+     * then applies an additional twist around that aligned Z-axis.
+     *
+     * Note: This aligns the Z axis.
+     *
+     * @param direction - Target world-space direction for local Z. If zero-length, returns identity.
+     * @param twistRadians - Extra rotation around the aligned Z-axis, in radians. Defaults to 0.
+     */
+    const alignTo: (direction: Vec3, twistRadians?: number) => Quat;
+}