@aura3d/engine 4.0.3 → 4.0.5

package/dist/math/Sphere.js

@@ -1,18 +1,136 @@
+import { Box3 } from "./Box3.js";
 import { Vector3 } from "./Vector3.js";
+/**
+ * Bounding sphere — three.js `Sphere` parity. A negative `radius` denotes an
+ * "empty" sphere (three uses `radius = -1` as its empty sentinel).
+ */
 export class Sphere {
     center;
     radius;
     constructor(center = Vector3.zero.clone(), radius = 0) {
         this.center = center;
         this.radius = radius;
-        if (!Number.isFinite(radius) || radius < 0)
-            throw new RangeError("Sphere radius must be finite and non-negative.");
+        if (!Number.isFinite(radius))
+            throw new RangeError("Sphere radius must be finite.");
+    }
+    set(center, radius) {
+        return new Sphere(center, radius);
+    }
+    clone() {
+        return new Sphere(this.center, this.radius);
+    }
+    /** three.js `Sphere.isEmpty` — `true` for negative radius. */
+    isEmpty() {
+        return this.radius < 0;
+    }
+    makeEmpty() {
+        return new Sphere(this.center, -1);
+    }
+    /** three.js `Sphere.setFromPoints` — box first, then tighten around center. */
+    static setFromPoints(points, optionalCenter) {
+        let center;
+        if (optionalCenter !== undefined) {
+            center = optionalCenter;
+        }
+        else {
+            // avoid importing Box3 eagerly: compute the AABB inline
+            let minX = Infinity, minY = Infinity, minZ = Infinity;
+            let maxX = -Infinity, maxY = -Infinity, maxZ = -Infinity;
+            for (const p of points) {
+                if (p.x < minX)
+                    minX = p.x;
+                if (p.y < minY)
+                    minY = p.y;
+                if (p.z < minZ)
+                    minZ = p.z;
+                if (p.x > maxX)
+                    maxX = p.x;
+                if (p.y > maxY)
+                    maxY = p.y;
+                if (p.z > maxZ)
+                    maxZ = p.z;
+            }
+            center = new Vector3(minX, minY, minZ).add(new Vector3(maxX, maxY, maxZ)).multiplyScalar(0.5);
+        }
+        let maxRadiusSq = 0;
+        for (const p of points) {
+            maxRadiusSq = Math.max(maxRadiusSq, center.distanceToSquared(p));
+        }
+        return new Sphere(center, Math.sqrt(maxRadiusSq));
+    }
+    static setFromBox3(box) {
+        return box.getBoundingSphere();
     }
     containsPoint(point) {
-        return this.center.distanceTo(point) <= this.radius;
+        return point.distanceToSquared(this.center) <= this.radius * this.radius;
+    }
+    distanceToPoint(point) {
+        return point.distanceTo(this.center) - this.radius;
     }
     intersectsSphere(other) {
-        return this.center.distanceTo(other.center) <= this.radius + other.radius;
+        const radiusSum = this.radius + other.radius;
+        return other.center.distanceToSquared(this.center) <= radiusSum * radiusSum;
+    }
+    intersectsBox(box) {
+        return box.intersectsSphere(this);
+    }
+    intersectsPlane(plane) {
+        return Math.abs(plane.distanceToPoint(this.center)) <= this.radius;
+    }
+    /**
+     * Clamps `point` into the sphere (three.js `Sphere.clampPoint`) — inside
+     * points are returned unchanged; outside points snap onto the surface.
+     */
+    clampPoint(point) {
+        const deltaLengthSq = this.center.distanceToSquared(point);
+        if (deltaLengthSq > this.radius * this.radius) {
+            const delta = point.subtract(this.center).normalize();
+            return this.center.addScaled(delta, this.radius);
+        }
+        return point;
+    }
+    /** three.js `Sphere.getBoundingBox` — empty sphere → empty box. */
+    getBoundingBox() {
+        if (this.isEmpty())
+            return new Box3();
+        const r = new Vector3(this.radius, this.radius, this.radius);
+        return new Box3(this.center.subtract(r), this.center.add(r));
+    }
+    applyMatrix4(matrix) {
+        return new Sphere(this.center.transformMatrix4(matrix), this.radius * matrix.maxScaleOnAxis());
+    }
+    translate(offset) {
+        return new Sphere(this.center.add(offset), this.radius);
+    }
+    /** three.js `Sphere.expandByPoint` — grows the minimal enclosing sphere. */
+    expandByPoint(point) {
+        if (this.isEmpty())
+            return new Sphere(point, 0);
+        const v1 = point.subtract(this.center);
+        const lengthSq = v1.lengthSquared();
+        if (lengthSq > this.radius * this.radius) {
+            const length = Math.sqrt(lengthSq);
+            const delta = (length - this.radius) * 0.5;
+            return new Sphere(this.center.addScaled(v1, delta / length), this.radius + delta);
+        }
+        return this;
+    }
+    /** three.js `Sphere.union`. */
+    union(sphere) {
+        if (sphere.isEmpty())
+            return this;
+        if (this.isEmpty())
+            return sphere;
+        if (this.center.equals(sphere.center)) {
+            return new Sphere(this.center, Math.max(this.radius, sphere.radius));
+        }
+        const v2 = sphere.center.subtract(this.center).normalize().multiplyScalar(sphere.radius);
+        return this
+            .expandByPoint(sphere.center.add(v2))
+            .expandByPoint(sphere.center.subtract(v2));
+    }
+    equals(sphere, epsilon = 0) {
+        return this.center.equals(sphere.center, epsilon) && Math.abs(this.radius - sphere.radius) <= epsilon;
     }
 }
 //# sourceMappingURL=Sphere.js.map

package/dist/math/Sphere.js.map

@@ -1 +1 @@
-{"version":3,"file":"Sphere.js","sourceRoot":"","sources":["../../../../packages/math/src/Sphere.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,OAAO,MAAM;IAEN;IACA;IAFX,YACW,SAAS,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,EAC7B,SAAS,CAAC;QADV,WAAM,GAAN,MAAM,CAAuB;QAC7B,WAAM,GAAN,MAAM,CAAI;QAEnB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,gDAAgD,CAAC,CAAC;IACrH,CAAC;IAED,aAAa,CAAC,KAAc;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC;IACtD,CAAC;IAED,gBAAgB,CAAC,KAAa;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5E,CAAC;CACF"}
+{"version":3,"file":"Sphere.js","sourceRoot":"","sources":["../../../../packages/math/src/Sphere.ts"],"names":[],"mappings":"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"}

package/dist/math/Spherical.d.ts

@@ -0,0 +1,21 @@
+import { Vector3 } from "./Vector3.js";
+/**
+ * Spherical coordinates `(radius, phi, theta)` — three.js `Spherical` parity.
+ * `phi` = polar angle from +Y, `theta` = azimuth around +Y from +Z.
+ */
+export declare class Spherical {
+    readonly radius: number;
+    readonly phi: number;
+    readonly theta: number;
+    constructor(radius?: number, phi?: number, theta?: number);
+    set(radius: number, phi: number, theta: number): Spherical;
+    clone(): Spherical;
+    copy(other: Spherical): Spherical;
+    /** Clamps phi into [EPS, π−EPS], wraps theta into [−π, π] (three `makeSafe`). */
+    makeSafe(): Spherical;
+    setFromVector3(v: Vector3): Spherical;
+    setFromCartesianCoords(x: number, y: number, z: number): Spherical;
+    toVector3(): Vector3;
+    equals(other: Spherical, epsilon?: number): boolean;
+}
+//# sourceMappingURL=Spherical.d.ts.map

package/dist/math/Spherical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Spherical.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Spherical.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;;GAGG;AACH,qBAAa,SAAS;IAElB,QAAQ,CAAC,MAAM;IACf,QAAQ,CAAC,GAAG;IACZ,QAAQ,CAAC,KAAK;gBAFL,MAAM,SAAI,EACV,GAAG,SAAI,EACP,KAAK,SAAI;IAGpB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;IAI1D,KAAK,IAAI,SAAS;IAIlB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS;IAIjC,iFAAiF;IACjF,QAAQ,IAAI,SAAS;IASrB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS;IAIrC,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS;IAQlE,SAAS,IAAI,OAAO;IASpB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,SAAQ,GAAG,OAAO;CAOnD"}

package/dist/math/Spherical.js

@@ -0,0 +1,50 @@
+import { Vector3 } from "./Vector3.js";
+import { clamp, euclideanModulo } from "./MathUtils.js";
+/**
+ * Spherical coordinates `(radius, phi, theta)` — three.js `Spherical` parity.
+ * `phi` = polar angle from +Y, `theta` = azimuth around +Y from +Z.
+ */
+export class Spherical {
+    radius;
+    phi;
+    theta;
+    constructor(radius = 1, phi = 0, theta = 0) {
+        this.radius = radius;
+        this.phi = phi;
+        this.theta = theta;
+    }
+    set(radius, phi, theta) {
+        return new Spherical(radius, phi, theta);
+    }
+    clone() {
+        return new Spherical(this.radius, this.phi, this.theta);
+    }
+    copy(other) {
+        return new Spherical(other.radius, other.phi, other.theta);
+    }
+    /** Clamps phi into [EPS, π−EPS], wraps theta into [−π, π] (three `makeSafe`). */
+    makeSafe() {
+        const EPS = 0.000001;
+        return new Spherical(this.radius, clamp(this.phi, EPS, Math.PI - EPS), euclideanModulo(this.theta + Math.PI, Math.PI * 2) - Math.PI);
+    }
+    setFromVector3(v) {
+        return this.setFromCartesianCoords(v.x, v.y, v.z);
+    }
+    setFromCartesianCoords(x, y, z) {
+        const radius = Math.sqrt(x * x + y * y + z * z);
+        if (radius === 0) {
+            return new Spherical(0, 0, 0);
+        }
+        return new Spherical(radius, Math.acos(clamp(y / radius, -1, 1)), Math.atan2(x, z));
+    }
+    toVector3() {
+        const sinPhiRadius = Math.sin(this.phi) * this.radius;
+        return new Vector3(sinPhiRadius * Math.sin(this.theta), Math.cos(this.phi) * this.radius, sinPhiRadius * Math.cos(this.theta));
+    }
+    equals(other, epsilon = 1e-10) {
+        return (Math.abs(this.radius - other.radius) <= epsilon &&
+            Math.abs(this.phi - other.phi) <= epsilon &&
+            Math.abs(this.theta - other.theta) <= epsilon);
+    }
+}
+//# sourceMappingURL=Spherical.js.map

package/dist/math/Spherical.js.map

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

package/dist/math/SphericalHarmonics3.d.ts

@@ -0,0 +1,35 @@
+import { Vector3 } from "./Vector3.js";
+/**
+ * Third-order spherical harmonics (9 coefficients) —
+ * three.js `SphericalHarmonics3` parity: `getAt`, `getIrradianceAt`,
+ * `getBasisAt`, `add`, `addScaledSH`, `scale`, `lerp`.
+ *
+ * Uses three's basis/sign convention (positive harmonics); this differs from
+ * the rendering package's internal SH9 projection and is intentionally kept
+ * separate — `R/environment/SphericalHarmonics.ts` stays internal.
+ */
+export declare class SphericalHarmonics3 {
+    /** 9 band-0/1/2 coefficients, RGB each (three `coefficients`). */
+    readonly coefficients: Vector3[];
+    constructor(coefficients?: readonly Vector3[]);
+    set(coefficients: readonly Vector3[]): SphericalHarmonics3;
+    zero(): SphericalHarmonics3;
+    clone(): SphericalHarmonics3;
+    copy(sh: SphericalHarmonics3): SphericalHarmonics3;
+    /** Irradiance-free evaluation at unit `normal` (three `getAt`). */
+    getAt(normal: Vector3): Vector3;
+    /** Lambert-convolved evaluation at unit `normal` (three `getIrradianceAt`). */
+    getIrradianceAt(normal: Vector3): Vector3;
+    /** nine basis function values at unit `normal` (three `getBasisAt`). */
+    static getBasisAt(normal: Vector3): number[];
+    getBasisAt(normal: Vector3): number[];
+    add(sh: SphericalHarmonics3): SphericalHarmonics3;
+    addScaledSH(sh: SphericalHarmonics3, s: number): SphericalHarmonics3;
+    scale(s: number): SphericalHarmonics3;
+    lerp(sh: SphericalHarmonics3, alpha: number): SphericalHarmonics3;
+    equals(sh: SphericalHarmonics3, epsilon?: number): boolean;
+    /** `[r0,g0,b0, r1,g1,b1, ...]` (three `fromArray`/`toArray` layout). */
+    static fromArray(array: ArrayLike<number>, offset?: number): SphericalHarmonics3;
+    toArray(offset?: number, array?: number[]): number[];
+}
+//# sourceMappingURL=SphericalHarmonics3.d.ts.map

package/dist/math/SphericalHarmonics3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SphericalHarmonics3.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/SphericalHarmonics3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,YAAY,EAAE,OAAO,EAAE,CAAC;gBAErB,YAAY,CAAC,EAAE,SAAS,OAAO,EAAE;IAO7C,GAAG,CAAC,YAAY,EAAE,SAAS,OAAO,EAAE,GAAG,mBAAmB;IAI1D,IAAI,IAAI,mBAAmB;IAI3B,KAAK,IAAI,mBAAmB;IAI5B,IAAI,CAAC,EAAE,EAAE,mBAAmB,GAAG,mBAAmB;IAIlD,mEAAmE;IACnE,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;IAS/B,+EAA+E;IAC/E,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;IAgBzC,wEAAwE;IACxE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE;IAoB5C,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE;IAIrC,GAAG,CAAC,EAAE,EAAE,mBAAmB,GAAG,mBAAmB;IAKjD,WAAW,CAAC,EAAE,EAAE,mBAAmB,EAAE,CAAC,EAAE,MAAM,GAAG,mBAAmB;IAKpE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,mBAAmB;IAIrC,IAAI,CAAC,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB;IAIjE,MAAM,CAAC,EAAE,EAAE,mBAAmB,EAAE,OAAO,SAAQ,GAAG,OAAO;IAIzD,wEAAwE;IACxE,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,SAAI,GAAG,mBAAmB;IAQ3E,OAAO,CAAC,MAAM,SAAI,EAAE,KAAK,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE;CASpD"}

package/dist/math/SphericalHarmonics3.js

@@ -0,0 +1,115 @@
+import { Vector3 } from "./Vector3.js";
+/**
+ * Third-order spherical harmonics (9 coefficients) —
+ * three.js `SphericalHarmonics3` parity: `getAt`, `getIrradianceAt`,
+ * `getBasisAt`, `add`, `addScaledSH`, `scale`, `lerp`.
+ *
+ * Uses three's basis/sign convention (positive harmonics); this differs from
+ * the rendering package's internal SH9 projection and is intentionally kept
+ * separate — `R/environment/SphericalHarmonics.ts` stays internal.
+ */
+export class SphericalHarmonics3 {
+    /** 9 band-0/1/2 coefficients, RGB each (three `coefficients`). */
+    coefficients;
+    constructor(coefficients) {
+        this.coefficients = [];
+        for (let i = 0; i < 9; i += 1) {
+            this.coefficients.push(coefficients?.[i] ?? new Vector3(0, 0, 0));
+        }
+    }
+    set(coefficients) {
+        return new SphericalHarmonics3(coefficients);
+    }
+    zero() {
+        return new SphericalHarmonics3();
+    }
+    clone() {
+        return new SphericalHarmonics3(this.coefficients);
+    }
+    copy(sh) {
+        return new SphericalHarmonics3(sh.coefficients);
+    }
+    /** Irradiance-free evaluation at unit `normal` (three `getAt`). */
+    getAt(normal) {
+        const basis = SphericalHarmonics3.getBasisAt(normal);
+        let target = new Vector3(0, 0, 0);
+        for (let i = 0; i < 9; i += 1) {
+            target = target.addScaled(this.coefficients[i], basis[i]);
+        }
+        return target;
+    }
+    /** Lambert-convolved evaluation at unit `normal` (three `getIrradianceAt`). */
+    getIrradianceAt(normal) {
+        const x = normal.x;
+        const y = normal.y;
+        const z = normal.z;
+        const coeff = this.coefficients;
+        return coeff[0].multiplyScalar(0.886227) // π * 0.282095
+            .addScaled(coeff[1], 2.0 * 0.511664 * y) // ( 2 * π / 3 ) * 0.488603
+            .addScaled(coeff[2], 2.0 * 0.511664 * z)
+            .addScaled(coeff[3], 2.0 * 0.511664 * x)
+            .addScaled(coeff[4], 2.0 * 0.429043 * x * y) // ( π / 4 ) * 1.092548
+            .addScaled(coeff[5], 2.0 * 0.429043 * y * z)
+            .addScaled(coeff[6], 0.743125 * z * z - 0.247708) // ( π / 4 ) * 0.315392 * 3
+            .addScaled(coeff[7], 2.0 * 0.429043 * x * z)
+            .addScaled(coeff[8], 0.429043 * (x * x - y * y)); // ( π / 4 ) * 0.546274
+    }
+    /** nine basis function values at unit `normal` (three `getBasisAt`). */
+    static getBasisAt(normal) {
+        const x = normal.x;
+        const y = normal.y;
+        const z = normal.z;
+        const shBasis = new Array(9);
+        // band 0
+        shBasis[0] = 0.282095;
+        // band 1
+        shBasis[1] = 0.488603 * y;
+        shBasis[2] = 0.488603 * z;
+        shBasis[3] = 0.488603 * x;
+        // band 2
+        shBasis[4] = 1.092548 * x * y;
+        shBasis[5] = 1.092548 * y * z;
+        shBasis[6] = 0.315392 * (3 * z * z - 1);
+        shBasis[7] = 1.092548 * x * z;
+        shBasis[8] = 0.546274 * (x * x - y * y);
+        return shBasis;
+    }
+    getBasisAt(normal) {
+        return SphericalHarmonics3.getBasisAt(normal);
+    }
+    add(sh) {
+        const coeffs = this.coefficients.map((c, i) => c.add(sh.coefficients[i]));
+        return new SphericalHarmonics3(coeffs);
+    }
+    addScaledSH(sh, s) {
+        const coeffs = this.coefficients.map((c, i) => c.addScaled(sh.coefficients[i], s));
+        return new SphericalHarmonics3(coeffs);
+    }
+    scale(s) {
+        return new SphericalHarmonics3(this.coefficients.map((c) => c.multiplyScalar(s)));
+    }
+    lerp(sh, alpha) {
+        return new SphericalHarmonics3(this.coefficients.map((c, i) => c.lerp(sh.coefficients[i], alpha)));
+    }
+    equals(sh, epsilon = 1e-10) {
+        return this.coefficients.every((c, i) => c.equals(sh.coefficients[i], epsilon));
+    }
+    /** `[r0,g0,b0, r1,g1,b1, ...]` (three `fromArray`/`toArray` layout). */
+    static fromArray(array, offset = 0) {
+        const coeffs = [];
+        for (let i = 0; i < 9; i += 1) {
+            coeffs.push(new Vector3(array[offset + i * 3], array[offset + i * 3 + 1], array[offset + i * 3 + 2]));
+        }
+        return new SphericalHarmonics3(coeffs);
+    }
+    toArray(offset = 0, array = []) {
+        for (let i = 0; i < 9; i += 1) {
+            const c = this.coefficients[i];
+            array[offset + i * 3] = c.x;
+            array[offset + i * 3 + 1] = c.y;
+            array[offset + i * 3 + 2] = c.z;
+        }
+        return array;
+    }
+}
+//# sourceMappingURL=SphericalHarmonics3.js.map

package/dist/math/SphericalHarmonics3.js.map

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

package/dist/math/Triangle.d.ts

@@ -0,0 +1,45 @@
+import { Vector3 } from "./Vector3.js";
+import { Plane } from "./Plane.js";
+import type { Box3 } from "./Box3.js";
+/**
+ * 3D triangle — three.js `Triangle` parity (immutable; `a`/`b`/`c` vertices).
+ */
+export declare class Triangle {
+    readonly a: Vector3;
+    readonly b: Vector3;
+    readonly c: Vector3;
+    constructor(a?: Vector3, b?: Vector3, c?: Vector3);
+    /** Unit normal of (a,b,c); zero vector for degenerate triangles. */
+    static getNormal(a: Vector3, b: Vector3, c: Vector3): Vector3;
+    /**
+     * Barycentric coordinates of `point` in triangle (a,b,c) — `null` when the
+     * triangle is degenerate (three.js `Triangle.getBarycoord` returns `null`).
+     */
+    static getBarycoord(point: Vector3, a: Vector3, b: Vector3, c: Vector3): Vector3 | null;
+    static containsPoint(point: Vector3, a: Vector3, b: Vector3, c: Vector3): boolean;
+    /**
+     * Interpolates attribute vectors `v1,v2,v3` at `point` via barycentrics —
+     * `null` for a degenerate triangle (three.js `Triangle.getInterpolation`).
+     */
+    static getInterpolation(point: Vector3, p1: Vector3, p2: Vector3, p3: Vector3, v1: Vector3, v2: Vector3, v3: Vector3): Vector3 | null;
+    static isFrontFacing(a: Vector3, b: Vector3, c: Vector3, direction: Vector3): boolean;
+    set(a: Vector3, b: Vector3, c: Vector3): Triangle;
+    setFromPointsAndIndices(points: readonly Vector3[], i0: number, i1: number, i2: number): Triangle;
+    clone(): Triangle;
+    getArea(): number;
+    getMidpoint(): Vector3;
+    getNormal(): Vector3;
+    getPlane(): Plane;
+    getBarycoord(point: Vector3): Vector3 | null;
+    getInterpolation(point: Vector3, v1: Vector3, v2: Vector3, v3: Vector3): Vector3 | null;
+    containsPoint(point: Vector3): boolean;
+    isFrontFacing(direction: Vector3): boolean;
+    intersectsBox(box: Box3): boolean;
+    /**
+     * Closest point on the triangle to `p` — Ericson's voronoi-region method
+     * (three.js `Triangle.closestPointToPoint`).
+     */
+    closestPointToPoint(p: Vector3): Vector3;
+    equals(triangle: Triangle, epsilon?: number): boolean;
+}
+//# sourceMappingURL=Triangle.d.ts.map

package/dist/math/Triangle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Triangle.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Triangle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,qBAAa,QAAQ;IAEjB,QAAQ,CAAC,CAAC,EAAE,OAAO;IACnB,QAAQ,CAAC,CAAC,EAAE,OAAO;IACnB,QAAQ,CAAC,CAAC,EAAE,OAAO;gBAFV,CAAC,GAAE,OAA8B,EACjC,CAAC,GAAE,OAA8B,EACjC,CAAC,GAAE,OAA8B;IAG5C,oEAAoE;IACpE,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO;IAQ7D;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI;IAkBvF,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO;IAMjF;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CACrB,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EACrD,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GACpC,OAAO,GAAG,IAAI;IAQjB,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO;IAMrF,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,QAAQ;IAIjD,uBAAuB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ;IAIjG,KAAK,IAAI,QAAQ;IAIjB,OAAO,IAAI,MAAM;IAMjB,WAAW,IAAI,OAAO;IAItB,SAAS,IAAI,OAAO;IAIpB,QAAQ,IAAI,KAAK;IAIjB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI;IAI5C,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI;IAIvF,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAItC,aAAa,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO;IAI1C,aAAa,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAIjC;;;OAGG;IACH,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO;IAsDxC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,SAAI,GAAG,OAAO;CAGjD"}

package/dist/math/Triangle.js

@@ -0,0 +1,160 @@
+import { Vector3 } from "./Vector3.js";
+import { Plane } from "./Plane.js";
+/**
+ * 3D triangle — three.js `Triangle` parity (immutable; `a`/`b`/`c` vertices).
+ */
+export class Triangle {
+    a;
+    b;
+    c;
+    constructor(a = new Vector3(0, 0, 0), b = new Vector3(0, 0, 0), c = new Vector3(0, 0, 0)) {
+        this.a = a;
+        this.b = b;
+        this.c = c;
+    }
+    /** Unit normal of (a,b,c); zero vector for degenerate triangles. */
+    static getNormal(a, b, c) {
+        const cb = c.subtract(b);
+        const ab = a.subtract(b);
+        const n = cb.cross(ab);
+        const lenSq = n.lengthSquared();
+        return lenSq > 0 ? n.multiplyScalar(1 / Math.sqrt(lenSq)) : new Vector3(0, 0, 0);
+    }
+    /**
+     * Barycentric coordinates of `point` in triangle (a,b,c) — `null` when the
+     * triangle is degenerate (three.js `Triangle.getBarycoord` returns `null`).
+     */
+    static getBarycoord(point, a, b, c) {
+        const v0 = c.subtract(a);
+        const v1 = b.subtract(a);
+        const v2 = point.subtract(a);
+        const dot00 = v0.dot(v0);
+        const dot01 = v0.dot(v1);
+        const dot02 = v0.dot(v2);
+        const dot11 = v1.dot(v1);
+        const dot12 = v1.dot(v2);
+        const denom = dot00 * dot11 - dot01 * dot01;
+        if (denom === 0)
+            return null;
+        const invDenom = 1 / denom;
+        const u = (dot11 * dot02 - dot01 * dot12) * invDenom;
+        const v = (dot00 * dot12 - dot01 * dot02) * invDenom;
+        // barycentric coordinates must always sum to 1
+        return new Vector3(1 - u - v, v, u);
+    }
+    static containsPoint(point, a, b, c) {
+        const bary = Triangle.getBarycoord(point, a, b, c);
+        if (bary === null)
+            return false;
+        return bary.x >= 0 && bary.y >= 0 && bary.x + bary.y <= 1;
+    }
+    /**
+     * Interpolates attribute vectors `v1,v2,v3` at `point` via barycentrics —
+     * `null` for a degenerate triangle (three.js `Triangle.getInterpolation`).
+     */
+    static getInterpolation(point, p1, p2, p3, v1, v2, v3) {
+        const bary = Triangle.getBarycoord(point, p1, p2, p3);
+        if (bary === null)
+            return null;
+        return v1.multiplyScalar(bary.x)
+            .addScaled(v2, bary.y)
+            .addScaled(v3, bary.z);
+    }
+    static isFrontFacing(a, b, c, direction) {
+        const cb = c.subtract(b);
+        const ab = a.subtract(b);
+        return cb.cross(ab).dot(direction) < 0;
+    }
+    set(a, b, c) {
+        return new Triangle(a, b, c);
+    }
+    setFromPointsAndIndices(points, i0, i1, i2) {
+        return new Triangle(points[i0], points[i1], points[i2]);
+    }
+    clone() {
+        return new Triangle(this.a, this.b, this.c);
+    }
+    getArea() {
+        const cb = this.c.subtract(this.b);
+        const ab = this.a.subtract(this.b);
+        return cb.cross(ab).length() * 0.5;
+    }
+    getMidpoint() {
+        return this.a.add(this.b).add(this.c).multiplyScalar(1 / 3);
+    }
+    getNormal() {
+        return Triangle.getNormal(this.a, this.b, this.c);
+    }
+    getPlane() {
+        return Plane.fromCoplanarPoints(this.a, this.b, this.c);
+    }
+    getBarycoord(point) {
+        return Triangle.getBarycoord(point, this.a, this.b, this.c);
+    }
+    getInterpolation(point, v1, v2, v3) {
+        return Triangle.getInterpolation(point, this.a, this.b, this.c, v1, v2, v3);
+    }
+    containsPoint(point) {
+        return Triangle.containsPoint(point, this.a, this.b, this.c);
+    }
+    isFrontFacing(direction) {
+        return Triangle.isFrontFacing(this.a, this.b, this.c, direction);
+    }
+    intersectsBox(box) {
+        return box.intersectsTriangle(this);
+    }
+    /**
+     * Closest point on the triangle to `p` — Ericson's voronoi-region method
+     * (three.js `Triangle.closestPointToPoint`).
+     */
+    closestPointToPoint(p) {
+        const a = this.a;
+        const b = this.b;
+        const c = this.c;
+        const vab = b.subtract(a);
+        const vac = c.subtract(a);
+        const vap = p.subtract(a);
+        const d1 = vab.dot(vap);
+        const d2 = vac.dot(vap);
+        if (d1 <= 0 && d2 <= 0) {
+            return a; // vertex region of A
+        }
+        const vbp = p.subtract(b);
+        const d3 = vab.dot(vbp);
+        const d4 = vac.dot(vbp);
+        if (d3 >= 0 && d4 <= d3) {
+            return b; // vertex region of B
+        }
+        const vc = d1 * d4 - d3 * d2;
+        if (vc <= 0 && d1 >= 0 && d3 <= 0) {
+            const v = d1 / (d1 - d3);
+            return a.addScaled(vab, v); // edge region of AB
+        }
+        const vcp = p.subtract(c);
+        const d5 = vab.dot(vcp);
+        const d6 = vac.dot(vcp);
+        if (d6 >= 0 && d5 <= d6) {
+            return c; // vertex region of C
+        }
+        const vb = d5 * d2 - d1 * d6;
+        if (vb <= 0 && d2 >= 0 && d6 <= 0) {
+            const w = d2 / (d2 - d6);
+            return a.addScaled(vac, w); // edge region of AC
+        }
+        const va = d3 * d6 - d5 * d4;
+        if (va <= 0 && d4 - d3 >= 0 && d5 - d6 >= 0) {
+            const vbc = c.subtract(b);
+            const w = (d4 - d3) / (d4 - d3 + (d5 - d6));
+            return b.addScaled(vbc, w); // edge region of BC
+        }
+        // face region
+        const denom = 1 / (va + vb + vc);
+        const v = vb * denom;
+        const w = vc * denom;
+        return a.addScaled(vab, v).addScaled(vac, w);
+    }
+    equals(triangle, epsilon = 0) {
+        return this.a.equals(triangle.a, epsilon) && this.b.equals(triangle.b, epsilon) && this.c.equals(triangle.c, epsilon);
+    }
+}
+//# sourceMappingURL=Triangle.js.map

package/dist/math/Triangle.js.map

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

package/dist/math/Vector2.d.ts

@@ -15,6 +15,13 @@ export declare class Vector2 {
     length(): number;
     normalize(): Vector2;
     distanceTo(v: Vector2): number;
+    distanceToSquared(v: Vector2): number;
+    /** this + v*s (three.js `addScaledVector`). */
+    addScaled(v: Vector2, s: number): Vector2;
+    negate(): Vector2;
+    /** Per-component floor to min / ceiling to max (three.js `clamp`). */
+    clampTo(min: Vector2, max: Vector2): Vector2;
+    static fromArray(array: ArrayLike<number>, offset?: number): Vector2;
     lerp(v: Vector2, t: number): Vector2;
     equals(v: Vector2, epsilon?: number): boolean;
     toArray(): [number, number];