@adobe/data 0.5.14 → 0.5.17

package/dist/math/picking/pick-from-tables.js

@@ -21,104 +21,12 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.*/
 import { Aabb } from "../index.js";
 import { Line3 } from "../index.js";
-import { Vec3 } from "../index.js";
-/**
- * Determines which face of a cube was hit based on the intersection point
- * @param position World position of the intersection
- * @param aabb Bounding box of the cube
- * @returns Face index: 0=POS_Z, 1=POS_X, 2=NEG_Z, 3=NEG_X, 4=POS_Y, 5=NEG_Y
- */
-function determineFaceFromPosition(position, aabb) {
-    const aabbCenter = Aabb.center(aabb);
-    const localPos = [
-        position[0] - aabbCenter[0],
-        position[1] - aabbCenter[1],
-        position[2] - aabbCenter[2]
-    ];
-    // Find the face with the largest absolute coordinate (closest to cube surface)
-    const absX = Math.abs(localPos[0]);
-    const absY = Math.abs(localPos[1]);
-    const absZ = Math.abs(localPos[2]);
-    if (absX >= absY && absX >= absZ) {
-        // X-axis face (NEG_X or POS_X)
-        return localPos[0] > 0 ? 1 : 3; // 1=POS_X, 3=NEG_X
-    }
-    else if (absY >= absZ) {
-        // Y-axis face (NEG_Y or POS_Y)
-        return localPos[1] > 0 ? 4 : 5; // 4=POS_Y, 5=NEG_Y
-    }
-    else {
-        // Z-axis face (NEG_Z or POS_Z)
-        return localPos[2] > 0 ? 0 : 2; // 0=POS_Z, 2=NEG_Z
-    }
-}
-function getIntersectingEntities(options) {
-    const { tables, line, radius = 0, predicate } = options;
-    const rows = new Map();
-    for (const table of tables) {
-        for (let row = 0; row < table.rowCount; row++) {
-            const boundingBox = table.columns.boundingBox.get(row);
-            if (Aabb.lineIntersection(boundingBox, line, radius) !== -1 && (predicate?.(table, row) ?? true)) {
-                rows.set(table.columns.id.get(row), boundingBox);
-            }
-        }
-    }
-    return rows;
-}
-function getClosestEntityToPoint(rows, point) {
-    let closestRow = -1;
-    let closestDistanceSquared = Infinity;
-    let closestAabb = null;
-    for (const [row, aabb] of rows) {
-        const distSquared = Vec3.distanceSquared(point, Aabb.center(aabb));
-        if (distSquared < closestDistanceSquared) {
-            closestDistanceSquared = distSquared;
-            closestRow = row;
-            closestAabb = aabb;
-        }
-    }
-    if (closestRow !== -1 && closestAabb) {
-        // For direct intersection, use the intersection point if possible
-        // We'll use the intersection alpha from Aabb.lineIntersection
-        // If the line starts inside, alpha=0, so position is line.a
-        // Otherwise, Line3.interpolate at alpha
-        return {
-            entity: closestRow,
-            position: point,
-            face: determineFaceFromPosition(point, closestAabb),
-        };
-    }
-    return null;
-}
-function getClosestEntityToLine(rows, line) {
-    let closestEntity = null;
-    let closestDistanceSquared = Infinity;
-    let closestAlpha = Infinity;
-    let pickedPosition = null;
-    for (const [id, aabb] of rows) {
-        const aabbCenter = Aabb.center(aabb);
-        const alpha = Line3.closestPointOnLine(line, aabbCenter);
-        const closestPointOnLineSegment = Line3.interpolate(line, alpha);
-        const distSquared = Vec3.distanceSquared(aabbCenter, closestPointOnLineSegment);
-        if (distSquared < closestDistanceSquared ||
-            (distSquared === closestDistanceSquared && alpha < closestAlpha)) {
-            closestDistanceSquared = distSquared;
-            closestAlpha = alpha;
-            closestEntity = id;
-            pickedPosition = closestPointOnLineSegment;
-        }
-    }
-    if (closestEntity !== null && pickedPosition) {
-        return {
-            entity: closestEntity,
-            position: pickedPosition,
-            face: determineFaceFromPosition(pickedPosition, rows.get(closestEntity)),
-        };
-    }
-    return null;
-}
+import { getIntersectingEntities } from "./get-intersecting-entities.js";
+import { getClosestEntityToPoint } from "./get-closest-entity-to-point.js";
+import { getClosestEntityToLine } from "./get-closest-entity-to-line.js";
 /**
  * Picks the closest intersecting row from a table.
+ * This would be the broad phase picking step.
  * @returns The entity id and picked position, or null if no entity is found.
  */
 export function pickFromTables(options) {
@@ -136,8 +44,9 @@ export function pickFromTables(options) {
         if (best) {
             return {
                 entity: best.id,
-                position: Line3.interpolate(line, best.alpha),
-                face: determineFaceFromPosition(Line3.interpolate(line, best.alpha), rows.get(best.id)),
+                lineAlpha: best.alpha,
+                entityPosition: Line3.interpolate(line, best.alpha),
+                // face: AabbFace.fromPosition(Line3.interpolate(line, best.alpha), rows.get(best.id)!),
             };
         }
         // fallback (should not happen):

package/dist/math/picking/pick-from-tables.js.map

@@ -1 +1 @@
-{"version":3,"file":"pick-from-tables.js","sourceRoot":"","sources":["../../../src/math/picking/pick-from-tables.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pick-from-tables.js","sourceRoot":"","sources":["../../../src/math/picking/pick-from-tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAGX,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAqD,OAKlF;IACG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACxD,IAAI,IAAI,GAAG,uBAAuB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3E,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAChB,8EAA8E;QAC9E,IAAI,IAAI,GAAyC,IAAI,CAAC;QACtD,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACnD,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,IAAI,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;YACzB,CAAC;QACL,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACP,OAAO;gBACH,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,SAAS,EAAE,IAAI,CAAC,KAAK;gBACrB,cAAc,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;gBACnD,wFAAwF;aAC3F,CAAC;QACN,CAAC;QACD,gCAAgC;QAChC,OAAO,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;SAAM,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,IAAI,GAAG,uBAAuB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAChB,OAAO,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/math/picking/pick-result.d.ts

@@ -1,7 +1,10 @@
 import { Entity } from "../../ecs/index.js";
 import { Vec3 } from "../index.js";
 export interface PickResult {
+    /** The entity that was picked. */
     entity: Entity;
-    position: Vec3;
-    face: number;
+    /** Alpha value (0-1) along the picking line where the intersection/closest point occurs. */
+    lineAlpha: number;
+    /** World-space position of the entity or closest point on the AABB. */
+    entityPosition: Vec3;
 }

package/dist/math/plane/plane.d.ts

@@ -0,0 +1,43 @@
+import { FromSchema } from "../../schema/index.js";
+import { Vec3, Line3 } from "../index.js";
+export type Plane = FromSchema<typeof Plane.schema>;
+export declare namespace Plane {
+    const schema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly normal: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly precision: 1;
+                    readonly default: number;
+                };
+                readonly minItems: 3;
+                readonly maxItems: 3;
+                readonly default: readonly [0, 0, 0];
+            };
+            readonly distance: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+        };
+        readonly layout: "std140";
+        readonly required: readonly ["normal", "distance"];
+        readonly additionalProperties: false;
+    };
+    const layout: import("../../typed-buffer/index.js").StructLayout;
+    function is(value: any): value is Plane;
+    const signedDistance: (plane: Plane, point: Vec3) => number;
+    const distance: (plane: Plane, point: Vec3) => number;
+    const containsPoint: (plane: Plane, point: Vec3) => boolean;
+    const isPointInFront: (plane: Plane, point: Vec3) => boolean;
+    const isPointBehind: (plane: Plane, point: Vec3) => boolean;
+    /**
+     * Find the intersection alpha between a line and a plane.
+     * @param plane The plane to intersect with
+     * @param line The line to intersect
+     * @returns The alpha parameter (0-1 = within segment, <0 or >1 = outside segment), or null if line is parallel to plane
+     */
+    const lineIntersection: (plane: Plane, line: Line3) => number | null;
+}

package/dist/math/plane/plane.js

@@ -0,0 +1,70 @@
+/*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 { getStructLayout } from "../../typed-buffer/index.js";
+import { Vec3, F32, epsilon } from "../index.js";
+export var Plane;
+(function (Plane) {
+    Plane.schema = {
+        type: 'object',
+        properties: {
+            normal: Vec3.schema,
+            distance: F32.schema,
+        },
+        layout: 'std140',
+        required: ['normal', 'distance'],
+        additionalProperties: false,
+    };
+    Plane.layout = getStructLayout(Plane.schema);
+    function is(value) {
+        return value && typeof value === 'object' && 'normal' in value && 'distance' in value;
+    }
+    Plane.is = is;
+    // Plane utility functions
+    Plane.signedDistance = (plane, point) => Vec3.dot(plane.normal, point) - plane.distance;
+    Plane.distance = (plane, point) => Math.abs(Plane.signedDistance(plane, point));
+    Plane.containsPoint = (plane, point) => Math.abs(Plane.signedDistance(plane, point)) < epsilon;
+    Plane.isPointInFront = (plane, point) => Plane.signedDistance(plane, point) > 0;
+    Plane.isPointBehind = (plane, point) => Plane.signedDistance(plane, point) < 0;
+    /**
+     * Find the intersection alpha between a line and a plane.
+     * @param plane The plane to intersect with
+     * @param line The line to intersect
+     * @returns The alpha parameter (0-1 = within segment, <0 or >1 = outside segment), or null if line is parallel to plane
+     */
+    Plane.lineIntersection = (plane, line) => {
+        const { a, b } = line;
+        // Calculate line direction vector
+        const direction = Vec3.subtract(b, a);
+        // Calculate denominator: dot(normal, direction)
+        const denominator = Vec3.dot(plane.normal, direction);
+        // If denominator is close to zero, line is parallel to plane
+        if (Math.abs(denominator) < epsilon) {
+            return null;
+        }
+        // Calculate numerator: dot(normal, a) - distance
+        const numerator = Vec3.dot(plane.normal, a) - plane.distance;
+        // Calculate parameter t (alpha)
+        const alpha = -numerator / denominator;
+        return alpha;
+    };
+})(Plane || (Plane = {}));
+//# sourceMappingURL=plane.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plane.js","sourceRoot":"","sources":["../../../src/math/plane/plane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAGX,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,GAAG,EAAS,OAAO,EAAE,MAAM,aAAa,CAAC;AAIxD,MAAM,KAAW,KAAK,CA8DrB;AA9DD,WAAiB,KAAK;IACL,YAAM,GAAG;QAClB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,GAAG,CAAC,MAAM;SACvB;QACD,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;QAChC,oBAAoB,EAAE,KAAK;KACJ,CAAC;IAEf,YAAM,GAAG,eAAe,CAAC,MAAA,MAAM,CAAC,CAAC;IAE9C,SAAgB,EAAE,CAAC,KAAU;QACzB,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,IAAI,UAAU,IAAI,KAAK,CAAC;IAC1F,CAAC;IAFe,QAAE,KAEjB,CAAA;IAED,0BAA0B;IACb,oBAAc,GAAG,CAAC,KAAY,EAAE,KAAW,EAAU,EAAE,CAChE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;IAEtC,cAAQ,GAAG,CAAC,KAAY,EAAE,KAAW,EAAU,EAAE,CAC1D,IAAI,CAAC,GAAG,CAAC,MAAA,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAE9B,mBAAa,GAAG,CAAC,KAAY,EAAE,KAAW,EAAW,EAAE,CAChE,IAAI,CAAC,GAAG,CAAC,MAAA,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC;IAExC,oBAAc,GAAG,CAAC,KAAY,EAAE,KAAW,EAAW,EAAE,CACjE,MAAA,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAExB,mBAAa,GAAG,CAAC,KAAY,EAAE,KAAW,EAAW,EAAE,CAChE,MAAA,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAErC;;;;;OAKG;IACU,sBAAgB,GAAG,CAAC,KAAY,EAAE,IAAW,EAAiB,EAAE;QACzE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;QAEtB,kCAAkC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEtC,gDAAgD;QAChD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAEtD,6DAA6D;QAC7D,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,OAAO,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,iDAAiD;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;QAE7D,gCAAgC;QAChC,MAAM,KAAK,GAAG,CAAC,SAAS,GAAG,WAAW,CAAC;QAEvC,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC;AACN,CAAC,EA9DgB,KAAK,KAAL,KAAK,QA8DrB"}

package/dist/math/plane/plane.test.d.ts

@@ -0,0 +1 @@
+export {};

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;
+}