@adobe/data 0.5.3 → 0.5.5

package/dist/math/line2/intersects.test.js

@@ -0,0 +1,104 @@
+/*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 { Line2 } from '../index.js';
+describe('Line2.intersects', () => {
+    it('should return true for intersecting lines', () => {
+        const line1 = {
+            a: [0, 0],
+            b: [2, 2]
+        };
+        const line2 = {
+            a: [0, 2],
+            b: [2, 0]
+        };
+        expect(Line2.intersects(line1, line2)).toBe(true);
+    });
+    it('should return false for parallel lines', () => {
+        const line1 = {
+            a: [0, 0],
+            b: [2, 2]
+        };
+        const line2 = {
+            a: [0, 1],
+            b: [2, 3]
+        };
+        expect(Line2.intersects(line1, line2)).toBe(false);
+    });
+    it('should return false for non-intersecting lines', () => {
+        const line1 = {
+            a: [0, 0],
+            b: [2, 2]
+        };
+        const line2 = {
+            a: [3, 0],
+            b: [5, 2]
+        };
+        expect(Line2.intersects(line1, line2)).toBe(false);
+    });
+    it('should return true for lines that intersect at endpoints', () => {
+        const line1 = {
+            a: [0, 0],
+            b: [2, 2]
+        };
+        const line2 = {
+            a: [2, 2],
+            b: [4, 4]
+        };
+        expect(Line2.intersects(line1, line2, false)).toBe(false);
+        expect(Line2.intersects(line1, line2, true)).toBe(true);
+    });
+    it('should return false for collinear lines that do not overlap', () => {
+        const line1 = {
+            a: [0, 0],
+            b: [2, 2]
+        };
+        const line2 = {
+            a: [3, 3],
+            b: [5, 5]
+        };
+        expect(Line2.intersects(line1, line2)).toBe(false);
+    });
+    it('should handle vertical and horizontal lines', () => {
+        const vertical = {
+            a: [1, 0],
+            b: [1, 2]
+        };
+        const horizontal = {
+            a: [0, 1],
+            b: [2, 1]
+        };
+        expect(Line2.intersects(vertical, horizontal)).toBe(true);
+    });
+    it('should handle lines with negative coordinates', () => {
+        const line1 = {
+            a: [-2, -2],
+            b: [2, 2]
+        };
+        const line2 = {
+            a: [-2, 2],
+            b: [2, -2]
+        };
+        expect(Line2.intersects(line1, line2)).toBe(true);
+    });
+});
+//# sourceMappingURL=intersects.test.js.map

package/dist/math/line2/intersects.test.js.map

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

package/dist/math/line2/line2.d.ts

@@ -0,0 +1,42 @@
+import { FromSchema } from "../../schema/index.js";
+import { Vec2 } from "../index.js";
+export declare const schema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly a: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 2;
+            readonly maxItems: 2;
+            readonly default: readonly [0, 0];
+        };
+        readonly b: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 2;
+            readonly maxItems: 2;
+            readonly default: readonly [0, 0];
+        };
+    };
+    readonly required: readonly ["a", "b"];
+    readonly additionalProperties: false;
+    readonly default: {
+        readonly a: readonly [0, 0];
+        readonly b: readonly [0, 0];
+    };
+};
+export type Type = FromSchema<typeof schema>;
+type Line2 = Type;
+export declare const layout: import("../../typed-buffer/index.js").StructLayout;
+export declare const interpolate: (line: Line2, alpha: number) => Vec2;
+export declare const intersects: (line1: Line2, line2: Line2, includeEndpoints?: boolean) => boolean;
+export declare const subLine: (line: Line2, alpha: number, beta: number) => Line2;
+export {};

package/dist/math/line2/line2.js

@@ -0,0 +1,78 @@
+/*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 { Vec2 } from "../index.js";
+import { epsilon } from "../constants.js";
+const { schema: Vec2Schema } = Vec2;
+export const schema = {
+    type: 'object',
+    properties: {
+        a: Vec2Schema,
+        b: Vec2Schema,
+    },
+    required: ['a', 'b'],
+    additionalProperties: false,
+    default: {
+        a: Vec2Schema.default,
+        b: Vec2Schema.default,
+    }
+};
+export const layout = getStructLayout(schema);
+// Line2 utility functions
+export const interpolate = (line, alpha) => {
+    const a = line.a;
+    const b = line.b;
+    return [a[0] + alpha * (b[0] - a[0]), a[1] + alpha * (b[1] - a[1])];
+};
+export const intersects = (line1, line2, includeEndpoints = false) => {
+    const a = line1.a;
+    const b = line1.b;
+    const c = line2.a;
+    const d = line2.b;
+    // Check for endpoint intersections
+    if (includeEndpoints && ((Math.abs(a[0] - c[0]) < epsilon && Math.abs(a[1] - c[1]) < epsilon) ||
+        (Math.abs(a[0] - d[0]) < epsilon && Math.abs(a[1] - d[1]) < epsilon) ||
+        (Math.abs(b[0] - c[0]) < epsilon && Math.abs(b[1] - c[1]) < epsilon) ||
+        (Math.abs(b[0] - d[0]) < epsilon && Math.abs(b[1] - d[1]) < epsilon))) {
+        return true;
+    }
+    // Calculate the denominator
+    const denominator = (d[0] - c[0]) * (b[1] - a[1]) - (d[1] - c[1]) * (b[0] - a[0]);
+    // Check if lines are parallel or collinear
+    if (Math.abs(denominator) < epsilon) {
+        return false;
+    }
+    // Calculate intersection parameters
+    const numerator1 = (d[1] - c[1]) * (a[0] - c[0]) - (d[0] - c[0]) * (a[1] - c[1]);
+    const numerator2 = (b[1] - a[1]) * (a[0] - c[0]) - (b[0] - a[0]) * (a[1] - c[1]);
+    const ua = numerator1 / denominator;
+    const ub = numerator2 / denominator;
+    // Check if intersection point lies within both line segments
+    return ua >= -epsilon && ua <= 1 + epsilon && ub >= -epsilon && ub <= 1 + epsilon;
+};
+export const subLine = (line, alpha, beta) => {
+    return {
+        a: interpolate(line, alpha),
+        b: interpolate(line, beta),
+    };
+};
+//# sourceMappingURL=line2.js.map

package/dist/math/line2/line2.js.map

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

package/dist/math/line3/closest-point-on-line.test.d.ts

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

package/dist/math/line3/closest-point-on-line.test.js

@@ -0,0 +1,107 @@
+/*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 { Line3 } from '../index.js';
+describe('Line3.closestPointOnLine', () => {
+    const line = {
+        a: [0, 0, 0],
+        b: [2, 0, 0]
+    };
+    it('should return 0 when point is closest to line start', () => {
+        const point = [0, 0, 0]; // Point exactly at line start
+        expect(Line3.closestPointOnLine(line, point)).toBe(0);
+    });
+    it('should return 1 when point is closest to line end', () => {
+        const point = [2, 0, 0]; // Point exactly at line end
+        expect(Line3.closestPointOnLine(line, point)).toBe(1);
+    });
+    it('should return negative alpha when point is before line start', () => {
+        const point = [-1, 0, 0];
+        expect(Line3.closestPointOnLine(line, point)).toBe(-0.5); // alpha = (-1-0)/(2-0) = -0.5
+    });
+    it('should return alpha > 1 when point is beyond line end', () => {
+        const point = [3, 0, 0];
+        expect(Line3.closestPointOnLine(line, point)).toBe(1.5); // alpha = (3-0)/(2-0) = 1.5
+    });
+    it('should return 0.5 when point is closest to line middle', () => {
+        const point = [1, 0, 0];
+        expect(Line3.closestPointOnLine(line, point)).toBe(0.5);
+    });
+    it('should return 0.25 when point is closest to quarter way along line', () => {
+        const point = [0.5, 0, 0];
+        expect(Line3.closestPointOnLine(line, point)).toBe(0.25);
+    });
+    it('should return 0.75 when point is closest to three quarters way along line', () => {
+        const point = [1.5, 0, 0];
+        expect(Line3.closestPointOnLine(line, point)).toBe(0.75);
+    });
+    it('should handle points perpendicular to line', () => {
+        const point = [1, 5, 0];
+        expect(Line3.closestPointOnLine(line, point)).toBe(0.5);
+    });
+    it('should handle points with z offset', () => {
+        const point = [1, 0, 10];
+        expect(Line3.closestPointOnLine(line, point)).toBe(0.5);
+    });
+    it('should handle diagonal line', () => {
+        const diagonalLine = {
+            a: [0, 0, 0],
+            b: [2, 2, 0]
+        };
+        const point = [1, 1, 0];
+        expect(Line3.closestPointOnLine(diagonalLine, point)).toBe(0.5);
+    });
+    it('should handle zero-length line', () => {
+        const zeroLine = {
+            a: [1, 1, 1],
+            b: [1, 1, 1]
+        };
+        const point = [0, 0, 0];
+        expect(Line3.closestPointOnLine(zeroLine, point)).toBe(0);
+    });
+    it('should not clamp alpha to [0, 1] range', () => {
+        const point = [5, 0, 0];
+        expect(Line3.closestPointOnLine(line, point)).toBe(2.5); // alpha = (5-0)/(2-0) = 2.5
+        const point2 = [-5, 0, 0];
+        expect(Line3.closestPointOnLine(line, point2)).toBe(-2.5); // alpha = (-5-0)/(2-0) = -2.5
+    });
+    it('should prefer lower alpha when distances are equal', () => {
+        // Two points at equal distance from the line but different alpha values
+        const point1 = [0.5, 2, 0]; // alpha = 0.25, distance = 2
+        const point2 = [1.5, 2, 0]; // alpha = 0.75, distance = 2
+        const alpha1 = Line3.closestPointOnLine(line, point1);
+        const alpha2 = Line3.closestPointOnLine(line, point2);
+        expect(alpha1).toBe(0.25);
+        expect(alpha2).toBe(0.75);
+        // The tie-breaking logic in getClosestRowToLine should prefer point1 (lower alpha)
+        // when both have the same distance to the line
+    });
+    it('should handle points beyond line end with unclamped alpha', () => {
+        const point = [10, 0, 0];
+        expect(Line3.closestPointOnLine(line, point)).toBe(5); // alpha = (10-0)/(2-0) = 5
+    });
+    it('should handle points before line start with unclamped alpha', () => {
+        const point = [-10, 0, 0];
+        expect(Line3.closestPointOnLine(line, point)).toBe(-5); // alpha = (-10-0)/(2-0) = -5
+    });
+});
+//# sourceMappingURL=closest-point-on-line.test.js.map

package/dist/math/line3/closest-point-on-line.test.js.map

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

package/dist/math/line3/interpolate.test.d.ts

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

package/dist/math/line3/interpolate.test.js

@@ -0,0 +1,66 @@
+/*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 { Line3 } from '../index.js';
+describe('Line3.interpolate', () => {
+    it('should Line3.interpolate at alpha = 0', () => {
+        const line = {
+            a: [0, 0, 0],
+            b: [2, 4, 6]
+        };
+        const result = Line3.interpolate(line, 0);
+        expect(result).toEqual([0, 0, 0]);
+    });
+    it('should Line3.interpolate at alpha = 1', () => {
+        const line = {
+            a: [0, 0, 0],
+            b: [2, 4, 6]
+        };
+        const result = Line3.interpolate(line, 1);
+        expect(result).toEqual([2, 4, 6]);
+    });
+    it('should Line3.interpolate at alpha = 0.5', () => {
+        const line = {
+            a: [0, 0, 0],
+            b: [2, 4, 6]
+        };
+        const result = Line3.interpolate(line, 0.5);
+        expect(result).toEqual([1, 2, 3]);
+    });
+    it('should Line3.interpolate with negative coordinates', () => {
+        const line = {
+            a: [-2, -4, -6],
+            b: [2, 4, 6]
+        };
+        const result = Line3.interpolate(line, 0.5);
+        expect(result).toEqual([0, 0, 0]);
+    });
+    it('should Line3.interpolate with fractional alpha', () => {
+        const line = {
+            a: [0, 0, 0],
+            b: [10, 20, 30]
+        };
+        const result = Line3.interpolate(line, 0.3);
+        expect(result).toEqual([3, 6, 9]);
+    });
+});
+//# sourceMappingURL=interpolate.test.js.map

package/dist/math/line3/interpolate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.test.js","sourceRoot":"","sources":["../../../src/math/line3/interpolate.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAGX,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC7C,MAAM,IAAI,GAAU;YAChB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACZ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACf,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC7C,MAAM,IAAI,GAAU;YAChB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACZ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACf,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAC/C,MAAM,IAAI,GAAU;YAChB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACZ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACf,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC1D,MAAM,IAAI,GAAU;YAChB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACf,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACf,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACtD,MAAM,IAAI,GAAU;YAChB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACZ,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;SAClB,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/math/line3/line3.d.ts

@@ -0,0 +1,49 @@
+import { FromSchema } from "../../schema/index.js";
+import { Vec3 } from "../index.js";
+export declare const schema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly a: {
+            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 b: {
+            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 required: readonly ["a", "b"];
+    readonly additionalProperties: false;
+    readonly default: {
+        readonly a: readonly [0, 0, 0];
+        readonly b: readonly [0, 0, 0];
+    };
+};
+export type Type = FromSchema<typeof schema>;
+type Line3 = Type;
+export declare const layout: import("../../typed-buffer/index.js").StructLayout;
+export declare const interpolate: (line: Line3, alpha: number) => Vec3;
+/**
+ * Calculates the alpha value (0-1) representing the closest point on a line to a given point.
+ *
+ * @param line - The line segment
+ * @param point - The point in 3D space
+ * @returns Alpha value, usually between 0 and 1, where 0 is line.a and 1 is line.b
+ */
+export declare const closestPointOnLine: (line: Line3, point: Vec3) => number;
+export declare const subLine: (line: Line3, alpha: number, beta: number) => Line3;
+export {};

package/dist/math/line3/line3.js

@@ -0,0 +1,77 @@
+/*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 } from "../index.js";
+const { schema: Vec3Schema } = Vec3;
+export const schema = {
+    type: 'object',
+    properties: {
+        a: Vec3Schema,
+        b: Vec3Schema,
+    },
+    required: ['a', 'b'],
+    additionalProperties: false,
+    default: {
+        a: Vec3Schema.default,
+        b: Vec3Schema.default,
+    }
+};
+export const layout = getStructLayout(schema);
+// Line3 utility functions
+export const interpolate = (line, alpha) => {
+    const a = line.a;
+    const b = line.b;
+    return [a[0] + alpha * (b[0] - a[0]), a[1] + alpha * (b[1] - a[1]), a[2] + alpha * (b[2] - a[2])];
+};
+/**
+ * Calculates the alpha value (0-1) representing the closest point on a line to a given point.
+ *
+ * @param line - The line segment
+ * @param point - The point in 3D space
+ * @returns Alpha value, usually between 0 and 1, where 0 is line.a and 1 is line.b
+ */
+export const closestPointOnLine = (line, point) => {
+    const { a, b } = line;
+    // Calculate the direction vector of the line
+    const lineDirection = Vec3.subtract(b, a);
+    // Calculate the vector from line start to the point
+    const pointToStart = Vec3.subtract(point, a);
+    // Calculate the dot product to find the projection
+    const dotProduct = Vec3.dot(pointToStart, lineDirection);
+    const lineLengthSquared = Vec3.dot(lineDirection, lineDirection);
+    // Avoid division by zero
+    if (lineLengthSquared === 0) {
+        return 0;
+    }
+    // Calculate alpha (projection parameter)
+    const alpha = dotProduct / lineLengthSquared;
+    // Do not clamp alpha, it can be outside of [0, 1]
+    // User can clamp after if they want to.
+    return alpha;
+};
+export const subLine = (line, alpha, beta) => {
+    return {
+        a: interpolate(line, alpha),
+        b: interpolate(line, beta),
+    };
+};
+//# sourceMappingURL=line3.js.map

package/dist/math/line3/line3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line3.js","sourceRoot":"","sources":["../../../src/math/line3/line3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAGX,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;AAEpC,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,CAAC,EAAE,UAAU;QACb,CAAC,EAAE,UAAU;KAChB;IACD,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IACpB,oBAAoB,EAAE,KAAK;IAC3B,OAAO,EAAE;QACL,CAAC,EAAE,UAAU,CAAC,OAAO;QACrB,CAAC,EAAE,UAAU,CAAC,OAAO;KACxB;CACsB,CAAC;AAI5B,MAAM,CAAC,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAE9C,0BAA0B;AAC1B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAW,EAAE,KAAa,EAAQ,EAAE;IAC5D,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACjB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACjB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtG,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAW,EAAE,KAAW,EAAU,EAAE;IACnE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IAEtB,6CAA6C;IAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1C,oDAAoD;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAE7C,mDAAmD;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IACzD,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAEjE,yBAAyB;IACzB,IAAI,iBAAiB,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAC;IACb,CAAC;IAED,yCAAyC;IACzC,MAAM,KAAK,GAAG,UAAU,GAAG,iBAAiB,CAAC;IAE7C,kDAAkD;IAClD,wCAAwC;IACxC,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAW,EAAE,KAAa,EAAE,IAAY,EAAS,EAAE;IACvE,OAAO;QACH,CAAC,EAAE,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC;QAC3B,CAAC,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;KAC7B,CAAC;AACN,CAAC,CAAC"}

package/dist/math/line3/sub-line.test.d.ts

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

package/dist/math/line3/sub-line.test.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 { describe, it, expect } from 'vitest';
+import { Line3 } from '../index.js';
+describe('Line3.subLine', () => {
+    it('should create a sub-line from alpha=0 to beta=1', () => {
+        const line = {
+            a: [0, 0, 0],
+            b: [2, 4, 6]
+        };
+        const result = Line3.subLine(line, 0, 1);
+        expect(result).toEqual({
+            a: [0, 0, 0],
+            b: [2, 4, 6]
+        });
+    });
+    it('should create a sub-line from alpha=0.25 to beta=0.75', () => {
+        const line = {
+            a: [0, 0, 0],
+            b: [4, 8, 12]
+        };
+        const result = Line3.subLine(line, 0.25, 0.75);
+        expect(result).toEqual({
+            a: [1, 2, 3],
+            b: [3, 6, 9]
+        });
+    });
+    it('should create a sub-line with reversed alpha and beta', () => {
+        const line = {
+            a: [0, 0, 0],
+            b: [2, 4, 6]
+        };
+        const result = Line3.subLine(line, 0.75, 0.25);
+        expect(result).toEqual({
+            a: [1.5, 3, 4.5],
+            b: [0.5, 1, 1.5]
+        });
+    });
+    it('should handle negative coordinates', () => {
+        const line = {
+            a: [-2, -4, -6],
+            b: [2, 4, 6]
+        };
+        const result = Line3.subLine(line, 0.25, 0.75);
+        expect(result).toEqual({
+            a: [-1, -2, -3],
+            b: [1, 2, 3]
+        });
+    });
+});
+//# sourceMappingURL=sub-line.test.js.map

package/dist/math/line3/sub-line.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-line.test.js","sourceRoot":"","sources":["../../../src/math/line3/sub-line.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAGX,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACvD,MAAM,IAAI,GAAU;YAChB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACZ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACf,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACnB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACZ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACf,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC7D,MAAM,IAAI,GAAU;YAChB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACZ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;SAChB,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACnB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACZ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACf,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC7D,MAAM,IAAI,GAAU;YAChB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACZ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACf,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACnB,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC;YAChB,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC;SACnB,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,IAAI,GAAU;YAChB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACf,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACf,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACnB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACf,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACf,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}