@aura3d/engine 4.0.3 → 4.0.4

package/dist/math/Curves.d.ts

@@ -1,22 +1,63 @@
-import { Vector3 } from "./Vector3.js";
-export interface CurveSample {
-    readonly position: Vector3;
-    readonly tangent: Vector3;
+import type { Vector2 } from "./Vector2.js";
+import type { Vector3 } from "./Vector3.js";
+/**
+ * Rotation-minimizing frame output of {@link Curve.computeFrenetFrames}
+ * (three.js `Curve.computeFrenetFrames` parity).
+ */
+export interface FrenetFrame {
+    readonly tangents: Vector3[];
+    readonly normals: Vector3[];
+    readonly binormals: Vector3[];
 }
-export declare class CatmullRomCurve3 {
-    readonly points: readonly Vector3[];
-    constructor(points: readonly Vector3[]);
-    getPoint(t: number): Vector3;
-    getTangent(t: number): Vector3;
-    sample(t: number): CurveSample;
+/**
+ * three.js `Curve` surface for `Vector2`- and `Vector3`-valued curves.
+ * Implementations (see `M/curves/`) evaluate parametric points, keep a cached
+ * arc-length table, and expose length-, tangent- and frame-based queries.
+ */
+export interface Curve<V extends Vector2 | Vector3> {
+    readonly arcLengthDivisions: number;
+    getPoint(t: number): V;
+    /** Point at arc-length fraction `u` ∈ [0,1] (uniform speed). */
+    getPointAt(u: number): V;
+    /** Unit tangent at parameter `t`. */
+    getTangent(t: number): V;
+    /** Unit tangent at arc-length fraction `u`. */
+    getTangentAt(u: number): V;
+    getPoints(divisions?: number): V[];
+    /** Evenly arc-length spaced points (divisions + 1 samples). */
+    getSpacedPoints(divisions?: number): V[];
+    getLength(): number;
+    /** Cumulative arc lengths at `divisions` uniform `t` samples. */
+    getLengths(divisions?: number): number[];
+    /** Maps normalized arc length `u` ∈ [0,1] back to parameter `t`. */
+    getUtoTmapping(u: number): number;
+    /**
+     * Tangent / normal / binormal frames — only defined for `Vector3` curves;
+     * returns `null` for `Vector2` curves (three.js logs and returns `null`).
+     */
+    computeFrenetFrames(segments: number, closed?: boolean): FrenetFrame | null;
+    /** Flags the cached arc-length table for rebuild on next access. */
+    updateArcLengths(): void;
 }
-export declare class CubicBezierCurve3 {
-    readonly p0: Vector3;
-    readonly p1: Vector3;
-    readonly p2: Vector3;
-    readonly p3: Vector3;
-    constructor(p0: Vector3, p1: Vector3, p2: Vector3, p3: Vector3);
-    getPoint(t: number): Vector3;
-    getTangent(t: number): Vector3;
+/** Legacy sample pair returned by `CatmullRomCurve3.sample`. */
+export interface CurveSample {
+    readonly point: Vector3;
+    readonly tangent: Vector3;
 }
+export { CurveBase } from "./curves/CurveBase.js";
+export { CatmullRomCurve3, catmullRomSegment, catmullRomSegmentDerivative } from "./curves/CatmullRomCurve3.js";
+export type { CatmullRomCurveType } from "./curves/CatmullRomCurve3.js";
+export { ClampedCatmullRomCurve3 } from "./curves/ClampedCatmullRomCurve3.js";
+export { CubicBezierCurve3 } from "./curves/CubicBezierCurve3.js";
+export { QuadraticBezierCurve3 } from "./curves/QuadraticBezierCurve3.js";
+export { LineCurve3 } from "./curves/LineCurve3.js";
+export { LineCurve } from "./curves/LineCurve.js";
+export { QuadraticBezierCurve } from "./curves/QuadraticBezierCurve.js";
+export { CubicBezierCurve } from "./curves/CubicBezierCurve.js";
+export { SplineCurve } from "./curves/SplineCurve.js";
+export { EllipseCurve } from "./curves/EllipseCurve.js";
+export { ArcCurve } from "./curves/ArcCurve.js";
+export { CurvePath } from "./curves/CurvePath.js";
+export { Path } from "./curves/Path.js";
+export { Shape } from "./curves/Shape.js";
 //# sourceMappingURL=Curves.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Curves.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Curves.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,gBAAgB;aACC,MAAM,EAAE,SAAS,OAAO,EAAE;gBAA1B,MAAM,EAAE,SAAS,OAAO,EAAE;IAItD,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAY5B,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAO9B,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW;CAG/B;AAED,qBAAa,iBAAiB;aAEV,EAAE,EAAE,OAAO;aACX,EAAE,EAAE,OAAO;aACX,EAAE,EAAE,OAAO;aACX,EAAE,EAAE,OAAO;gBAHX,EAAE,EAAE,OAAO,EACX,EAAE,EAAE,OAAO,EACX,EAAE,EAAE,OAAO,EACX,EAAE,EAAE,OAAO;IAG7B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAY5B,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;CAO/B"}
+{"version":3,"file":"Curves.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Curves.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IAChD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACvB,gEAAgE;IAChE,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACzB,qCAAqC;IACrC,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACzB,+CAA+C;IAC/C,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IAC3B,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IACnC,+DAA+D;IAC/D,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IACzC,SAAS,IAAI,MAAM,CAAC;IACpB,iEAAiE;IACjE,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzC,oEAAoE;IACpE,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;IAC5E,oEAAoE;IACpE,gBAAgB,IAAI,IAAI,CAAC;CAC1B;AAED,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAChH,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/math/Curves.js

@@ -1,74 +1,16 @@
-import { Vector3 } from "./Vector3.js";
-export class CatmullRomCurve3 {
-    points;
-    constructor(points) {
-        this.points = points;
-        if (points.length < 2)
-            throw new Error("CatmullRomCurve3 requires at least two points.");
-    }
-    getPoint(t) {
-        const clamped = clamp01(t);
-        const scaled = clamped * (this.points.length - 1);
-        const index = Math.min(Math.floor(scaled), this.points.length - 2);
-        const localT = scaled - index;
-        const p0 = this.points[Math.max(0, index - 1)];
-        const p1 = this.points[index];
-        const p2 = this.points[index + 1];
-        const p3 = this.points[Math.min(this.points.length - 1, index + 2)];
-        return catmullRom(p0, p1, p2, p3, localT);
-    }
-    getTangent(t) {
-        const delta = 1e-4;
-        const before = this.getPoint(Math.max(0, t - delta));
-        const after = this.getPoint(Math.min(1, t + delta));
-        return after.subtract(before).normalize();
-    }
-    sample(t) {
-        return { position: this.getPoint(t), tangent: this.getTangent(t) };
-    }
-}
-export class CubicBezierCurve3 {
-    p0;
-    p1;
-    p2;
-    p3;
-    constructor(p0, p1, p2, p3) {
-        this.p0 = p0;
-        this.p1 = p1;
-        this.p2 = p2;
-        this.p3 = p3;
-    }
-    getPoint(t) {
-        const u = 1 - clamp01(t);
-        const tt = clamp01(t) * clamp01(t);
-        const uu = u * u;
-        const uuu = uu * u;
-        const ttt = tt * clamp01(t);
-        return this.p0.multiplyScalar(uuu)
-            .add(this.p1.multiplyScalar(3 * uu * clamp01(t)))
-            .add(this.p2.multiplyScalar(3 * u * tt))
-            .add(this.p3.multiplyScalar(ttt));
-    }
-    getTangent(t) {
-        const u = 1 - clamp01(t);
-        return this.p1.subtract(this.p0).multiplyScalar(3 * u * u)
-            .add(this.p2.subtract(this.p1).multiplyScalar(6 * u * clamp01(t)))
-            .add(this.p3.subtract(this.p2).multiplyScalar(3 * clamp01(t) * clamp01(t)))
-            .normalize();
-    }
-}
-function catmullRom(p0, p1, p2, p3, t) {
-    const t2 = t * t;
-    const t3 = t2 * t;
-    return p1.multiplyScalar(2)
-        .add(p2.subtract(p0).multiplyScalar(t))
-        .add(p0.multiplyScalar(2).subtract(p1.multiplyScalar(5)).add(p2.multiplyScalar(4)).subtract(p3).multiplyScalar(t2))
-        .add(p3.subtract(p0).add(p1.multiplyScalar(3).subtract(p2.multiplyScalar(3))).multiplyScalar(t3))
-        .multiplyScalar(0.5);
-}
-function clamp01(value) {
-    if (!Number.isFinite(value))
-        throw new Error("Curve parameter must be finite.");
-    return Math.min(1, Math.max(0, value));
-}
+export { CurveBase } from "./curves/CurveBase.js";
+export { CatmullRomCurve3, catmullRomSegment, catmullRomSegmentDerivative } from "./curves/CatmullRomCurve3.js";
+export { ClampedCatmullRomCurve3 } from "./curves/ClampedCatmullRomCurve3.js";
+export { CubicBezierCurve3 } from "./curves/CubicBezierCurve3.js";
+export { QuadraticBezierCurve3 } from "./curves/QuadraticBezierCurve3.js";
+export { LineCurve3 } from "./curves/LineCurve3.js";
+export { LineCurve } from "./curves/LineCurve.js";
+export { QuadraticBezierCurve } from "./curves/QuadraticBezierCurve.js";
+export { CubicBezierCurve } from "./curves/CubicBezierCurve.js";
+export { SplineCurve } from "./curves/SplineCurve.js";
+export { EllipseCurve } from "./curves/EllipseCurve.js";
+export { ArcCurve } from "./curves/ArcCurve.js";
+export { CurvePath } from "./curves/CurvePath.js";
+export { Path } from "./curves/Path.js";
+export { Shape } from "./curves/Shape.js";
 //# sourceMappingURL=Curves.js.map

package/dist/math/Curves.js.map

@@ -1 +1 @@
-{"version":3,"file":"Curves.js","sourceRoot":"","sources":["../../../../packages/math/src/Curves.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Curves.js","sourceRoot":"","sources":["../../../../packages/math/src/Curves.ts"],"names":[],"mappings":"AAkDA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAEhH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/math/Cylindrical.d.ts

@@ -0,0 +1,19 @@
+import { Vector3 } from "./Vector3.js";
+/**
+ * Cylindrical coordinates `(radius, theta, y)` — three.js `Cylindrical`.
+ * `theta` = azimuth around +Y measured from +Z.
+ */
+export declare class Cylindrical {
+    readonly radius: number;
+    readonly theta: number;
+    readonly y: number;
+    constructor(radius?: number, theta?: number, y?: number);
+    set(radius: number, theta: number, y: number): Cylindrical;
+    clone(): Cylindrical;
+    copy(other: Cylindrical): Cylindrical;
+    setFromVector3(v: Vector3): Cylindrical;
+    setFromCartesianCoords(x: number, y: number, z: number): Cylindrical;
+    toVector3(): Vector3;
+    equals(other: Cylindrical, epsilon?: number): boolean;
+}
+//# sourceMappingURL=Cylindrical.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Cylindrical.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Cylindrical.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;GAGG;AACH,qBAAa,WAAW;IAEpB,QAAQ,CAAC,MAAM;IACf,QAAQ,CAAC,KAAK;IACd,QAAQ,CAAC,CAAC;gBAFD,MAAM,SAAI,EACV,KAAK,SAAI,EACT,CAAC,SAAI;IAGhB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW;IAI1D,KAAK,IAAI,WAAW;IAIpB,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW;IAIrC,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,WAAW;IAIvC,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW;IAKpE,SAAS,IAAI,OAAO;IAQpB,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,SAAQ,GAAG,OAAO;CAOrD"}

package/dist/math/Cylindrical.js

@@ -0,0 +1,40 @@
+import { Vector3 } from "./Vector3.js";
+/**
+ * Cylindrical coordinates `(radius, theta, y)` — three.js `Cylindrical`.
+ * `theta` = azimuth around +Y measured from +Z.
+ */
+export class Cylindrical {
+    radius;
+    theta;
+    y;
+    constructor(radius = 1, theta = 0, y = 0) {
+        this.radius = radius;
+        this.theta = theta;
+        this.y = y;
+    }
+    set(radius, theta, y) {
+        return new Cylindrical(radius, theta, y);
+    }
+    clone() {
+        return new Cylindrical(this.radius, this.theta, this.y);
+    }
+    copy(other) {
+        return new Cylindrical(other.radius, other.theta, other.y);
+    }
+    setFromVector3(v) {
+        return this.setFromCartesianCoords(v.x, v.y, v.z);
+    }
+    setFromCartesianCoords(x, y, z) {
+        const radius = Math.sqrt(x * x + z * z);
+        return new Cylindrical(radius, Math.atan2(x, z), y);
+    }
+    toVector3() {
+        return new Vector3(this.radius * Math.sin(this.theta), this.y, this.radius * Math.cos(this.theta));
+    }
+    equals(other, epsilon = 1e-10) {
+        return (Math.abs(this.radius - other.radius) <= epsilon &&
+            Math.abs(this.theta - other.theta) <= epsilon &&
+            Math.abs(this.y - other.y) <= epsilon);
+    }
+}
+//# sourceMappingURL=Cylindrical.js.map

package/dist/math/Cylindrical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cylindrical.js","sourceRoot":"","sources":["../../../../packages/math/src/Cylindrical.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;GAGG;AACH,MAAM,OAAO,WAAW;IAEX;IACA;IACA;IAHX,YACW,SAAS,CAAC,EACV,QAAQ,CAAC,EACT,IAAI,CAAC;QAFL,WAAM,GAAN,MAAM,CAAI;QACV,UAAK,GAAL,KAAK,CAAI;QACT,MAAC,GAAD,CAAC,CAAI;IACb,CAAC;IAEJ,GAAG,CAAC,MAAc,EAAE,KAAa,EAAE,CAAS;QAC1C,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK;QACH,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC,KAAkB;QACrB,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,cAAc,CAAC,CAAU;QACvB,OAAO,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,sBAAsB,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,SAAS;QACP,OAAO,IAAI,OAAO,CAChB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAClC,IAAI,CAAC,CAAC,EACN,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CACnC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAkB,EAAE,OAAO,GAAG,KAAK;QACxC,OAAO,CACL,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,OAAO;YAC/C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO;YAC7C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,CACtC,CAAC;IACJ,CAAC;CACF"}

package/dist/math/Euler.d.ts

@@ -1,12 +1,36 @@
 import { Quaternion, type EulerOrder } from "./Quaternion.js";
+import { Matrix4 } from "./Matrix4.js";
+import type { Vector3 } from "./Vector3.js";
+/**
+ * Intrinsic Euler angles (radians) with a named application order — three.js
+ * `Euler` parity: all six orders, `setFromRotationMatrix`,
+ * `setFromQuaternion`, `reorder`. Instances are immutable; "setters" return
+ * new `Euler` values.
+ */
 export declare class Euler {
     readonly x: number;
     readonly y: number;
     readonly z: number;
     readonly order: EulerOrder;
+    static readonly DEFAULT_ORDER: EulerOrder;
     constructor(x?: number, y?: number, z?: number, order?: EulerOrder);
+    /** three.js `Euler.set` — returns a new Euler (order defaults to current). */
+    set(x: number, y: number, z: number, order?: EulerOrder): Euler;
+    clone(): Euler;
+    /** three.js `Euler.setFromRotationMatrix` — rotation part of m, no scaling. */
+    setFromRotationMatrix(m: Matrix4, order?: EulerOrder): Euler;
+    /** three.js `Euler.setFromQuaternion`. */
+    setFromQuaternion(q: Quaternion, order?: EulerOrder): Euler;
+    /** three.js `Euler.setFromVector3` — angles from a vector, order kept. */
+    setFromVector3(v: Vector3, order?: EulerOrder): Euler;
+    /** three.js `Euler.reorder` — same rotation expressed in `newOrder`. */
+    reorder(newOrder: EulerOrder): Euler;
+    static fromRotationMatrix(m: Matrix4, order?: EulerOrder): Euler;
+    static fromQuaternion(q: Quaternion, order?: EulerOrder): Euler;
     toQuaternion(): Quaternion;
     equals(euler: Euler, epsilon?: number): boolean;
     toArray(): [number, number, number];
+    /** three.js `Euler.toArray` — `[x, y, z, order]`. */
+    toArrayWithOrder(): [number, number, number, EulerOrder];
 }
 //# sourceMappingURL=Euler.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Euler.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Euler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE9D,qBAAa,KAAK;IAEd,QAAQ,CAAC,CAAC;IACV,QAAQ,CAAC,CAAC;IACV,QAAQ,CAAC,CAAC;IACV,QAAQ,CAAC,KAAK,EAAE,UAAU;gBAHjB,CAAC,SAAI,EACL,CAAC,SAAI,EACL,CAAC,SAAI,EACL,KAAK,GAAE,UAAkB;IAMpC,YAAY,IAAI,UAAU;IAI1B,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,SAAQ,GAAG,OAAO;IAS9C,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;CAGpC"}
+{"version":3,"file":"Euler.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Euler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAc5C;;;;;GAKG;AACH,qBAAa,KAAK;IAId,QAAQ,CAAC,CAAC;IACV,QAAQ,CAAC,CAAC;IACV,QAAQ,CAAC,CAAC;IACV,QAAQ,CAAC,KAAK,EAAE,UAAU;IAN5B,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAS;gBAGvC,CAAC,SAAI,EACL,CAAC,SAAI,EACL,CAAC,SAAI,EACL,KAAK,GAAE,UAAkB;IAMpC,8EAA8E;IAC9E,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,UAAuB,GAAG,KAAK;IAI3E,KAAK,IAAI,KAAK;IAId,+EAA+E;IAC/E,qBAAqB,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,GAAE,UAAuB,GAAG,KAAK;IAwExE,0CAA0C;IAC1C,iBAAiB,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,GAAE,UAAuB,GAAG,KAAK;IAIvE,0EAA0E;IAC1E,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,GAAE,UAAuB,GAAG,KAAK;IAIjE,wEAAwE;IACxE,OAAO,CAAC,QAAQ,EAAE,UAAU,GAAG,KAAK;IAKpC,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,GAAE,UAAkB,GAAG,KAAK;IAIvE,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,GAAE,UAAkB,GAAG,KAAK;IAItE,YAAY,IAAI,UAAU;IAI1B,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,SAAQ,GAAG,OAAO;IAS9C,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAInC,qDAAqD;IACrD,gBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC;CAGzD"}

package/dist/math/Euler.js

@@ -1,9 +1,26 @@
 import { Quaternion } from "./Quaternion.js";
+import { Matrix4 } from "./Matrix4.js";
+const EULER_ORDERS = ["XYZ", "YXZ", "ZXY", "ZYX", "YZX", "XZY"];
+function assertOrder(order) {
+    if (!EULER_ORDERS.includes(order)) {
+        throw new RangeError(`Unsupported Euler order: ${order}`);
+    }
+}
+function clampUnit(value) {
+    return Math.max(-1, Math.min(1, value));
+}
+/**
+ * Intrinsic Euler angles (radians) with a named application order — three.js
+ * `Euler` parity: all six orders, `setFromRotationMatrix`,
+ * `setFromQuaternion`, `reorder`. Instances are immutable; "setters" return
+ * new `Euler` values.
+ */
 export class Euler {
     x;
     y;
     z;
     order;
+    static DEFAULT_ORDER = "XYZ";
     constructor(x = 0, y = 0, z = 0, order = "XYZ") {
         this.x = x;
         this.y = y;
@@ -11,8 +28,111 @@ export class Euler {
         this.order = order;
         if (![x, y, z].every(Number.isFinite))
             throw new RangeError("Euler angles must be finite.");
-        if (order !== "XYZ")
-            throw new RangeError(`Unsupported Euler order: ${order}`);
+        assertOrder(order);
+    }
+    /** three.js `Euler.set` — returns a new Euler (order defaults to current). */
+    set(x, y, z, order = this.order) {
+        return new Euler(x, y, z, order);
+    }
+    clone() {
+        return new Euler(this.x, this.y, this.z, this.order);
+    }
+    /** three.js `Euler.setFromRotationMatrix` — rotation part of m, no scaling. */
+    setFromRotationMatrix(m, order = this.order) {
+        assertOrder(order);
+        const te = m.elements;
+        const m11 = te[0], m12 = te[4], m13 = te[8];
+        const m21 = te[1], m22 = te[5], m23 = te[9];
+        const m31 = te[2], m32 = te[6], m33 = te[10];
+        let x = 0, y = 0, z = 0;
+        switch (order) {
+            case "XYZ":
+                y = Math.asin(clampUnit(m13));
+                if (Math.abs(m13) < 0.9999999) {
+                    x = Math.atan2(-m23, m33);
+                    z = Math.atan2(-m12, m11);
+                }
+                else {
+                    x = Math.atan2(m32, m22);
+                    z = 0;
+                }
+                break;
+            case "YXZ":
+                x = Math.asin(-clampUnit(m23));
+                if (Math.abs(m23) < 0.9999999) {
+                    y = Math.atan2(m13, m33);
+                    z = Math.atan2(m21, m22);
+                }
+                else {
+                    y = Math.atan2(-m31, m11);
+                    z = 0;
+                }
+                break;
+            case "ZXY":
+                x = Math.asin(clampUnit(m32));
+                if (Math.abs(m32) < 0.9999999) {
+                    y = Math.atan2(-m31, m33);
+                    z = Math.atan2(-m12, m22);
+                }
+                else {
+                    y = 0;
+                    z = Math.atan2(m21, m11);
+                }
+                break;
+            case "ZYX":
+                y = Math.asin(-clampUnit(m31));
+                if (Math.abs(m31) < 0.9999999) {
+                    x = Math.atan2(m32, m33);
+                    z = Math.atan2(m21, m11);
+                }
+                else {
+                    x = 0;
+                    z = Math.atan2(-m12, m22);
+                }
+                break;
+            case "YZX":
+                z = Math.asin(clampUnit(m21));
+                if (Math.abs(m21) < 0.9999999) {
+                    x = Math.atan2(-m23, m22);
+                    y = Math.atan2(-m31, m11);
+                }
+                else {
+                    x = 0;
+                    y = Math.atan2(m13, m33);
+                }
+                break;
+            case "XZY":
+                z = Math.asin(-clampUnit(m12));
+                if (Math.abs(m12) < 0.9999999) {
+                    x = Math.atan2(m32, m22);
+                    y = Math.atan2(m13, m11);
+                }
+                else {
+                    x = Math.atan2(-m23, m33);
+                    y = 0;
+                }
+                break;
+        }
+        return new Euler(x, y, z, order);
+    }
+    /** three.js `Euler.setFromQuaternion`. */
+    setFromQuaternion(q, order = this.order) {
+        return this.setFromRotationMatrix(Matrix4.rotation(q), order);
+    }
+    /** three.js `Euler.setFromVector3` — angles from a vector, order kept. */
+    setFromVector3(v, order = this.order) {
+        return new Euler(v.x, v.y, v.z, order);
+    }
+    /** three.js `Euler.reorder` — same rotation expressed in `newOrder`. */
+    reorder(newOrder) {
+        assertOrder(newOrder);
+        return new Euler(0, 0, 0, newOrder).setFromQuaternion(this.toQuaternion(), newOrder);
+    }
+    static fromRotationMatrix(m, order = "XYZ") {
+        return new Euler(0, 0, 0, order).setFromRotationMatrix(m, order);
+    }
+    static fromQuaternion(q, order = "XYZ") {
+        return new Euler(0, 0, 0, order).setFromQuaternion(q, order);
     }
     toQuaternion() {
         return Quaternion.fromEuler(this.x, this.y, this.z, this.order);
@@ -26,5 +146,9 @@ export class Euler {
     toArray() {
         return [this.x, this.y, this.z];
     }
+    /** three.js `Euler.toArray` — `[x, y, z, order]`. */
+    toArrayWithOrder() {
+        return [this.x, this.y, this.z, this.order];
+    }
 }
 //# sourceMappingURL=Euler.js.map

package/dist/math/Euler.js.map

@@ -1 +1 @@
-{"version":3,"file":"Euler.js","sourceRoot":"","sources":["../../../../packages/math/src/Euler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAmB,MAAM,iBAAiB,CAAC;AAE9D,MAAM,OAAO,KAAK;IAEL;IACA;IACA;IACA;IAJX,YACW,IAAI,CAAC,EACL,IAAI,CAAC,EACL,IAAI,CAAC,EACL,QAAoB,KAAK;QAHzB,MAAC,GAAD,CAAC,CAAI;QACL,MAAC,GAAD,CAAC,CAAI;QACL,MAAC,GAAD,CAAC,CAAI;QACL,UAAK,GAAL,KAAK,CAAoB;QAElC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,CAAC;QAC5F,IAAI,KAAK,KAAK,KAAK;YAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,YAAY;QACV,OAAO,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,KAAY,EAAE,OAAO,GAAG,KAAK;QAClC,OAAO,CACL,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO;YACrC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO;YACrC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO;YACrC,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAC3B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;CACF"}
+{"version":3,"file":"Euler.js","sourceRoot":"","sources":["../../../../packages/math/src/Euler.ts"],"names":[],"mappings":"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"}

package/dist/math/Frustum.d.ts

@@ -3,12 +3,30 @@ import { Matrix4 } from "./Matrix4.js";
 import { Plane } from "./Plane.js";
 import { Sphere } from "./Sphere.js";
 import { Vector3 } from "./Vector3.js";
+/** Clip-space depth convention for {@link Frustum.setFromProjectionMatrix}. */
+export type FrustumCoordinateSystem = "webgl" | "webgpu";
+/**
+ * View frustum as six clipping planes — three.js `Frustum` parity.
+ * Plane order matches three: `[right, left, bottom, top, far, near]`.
+ */
 export declare class Frustum {
     readonly planes: readonly [Plane, Plane, Plane, Plane, Plane, Plane];
     constructor(planes: readonly [Plane, Plane, Plane, Plane, Plane, Plane]);
     static fromMatrix(matrix: Matrix4): Frustum;
+    /**
+     * Extracts the six frustum planes from a projection matrix —
+     * three.js `Frustum.setFromProjectionMatrix`. `coordinateSystem` selects
+     * the near-plane convention (`"webgl"`: NDC z ∈ [−1,1], `"webgpu"`:
+     * [0,1]); `reversedDepth` swaps near/far.
+     */
+    static setFromProjectionMatrix(matrix: Matrix4, coordinateSystem?: FrustumCoordinateSystem, reversedDepth?: boolean): Frustum;
+    set(p0: Plane, p1: Plane, p2: Plane, p3: Plane, p4: Plane, p5: Plane): Frustum;
+    clone(): Frustum;
+    copy(frustum: Frustum): Frustum;
     containsPoint(point: Vector3): boolean;
     intersectsSphere(sphere: Sphere): boolean;
     intersectsBox(box: Box3): boolean;
+    /** three.js `Frustum.intersectsObject`-equivalent over a bounds provider. */
+    intersectsBoundingSphere(sphere: Sphere, worldMatrix?: Matrix4): boolean;
 }
 //# sourceMappingURL=Frustum.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Frustum.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Frustum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,qBAAa,OAAO;IACN,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;gBAA3D,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IAEhF,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;IAa3C,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAItC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIzC,aAAa,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;CAYlC"}
+{"version":3,"file":"Frustum.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Frustum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,+EAA+E;AAC/E,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEzD;;;GAGG;AACH,qBAAa,OAAO;IACN,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;gBAA3D,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IAEhF,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;IAI3C;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB,CAC5B,MAAM,EAAE,OAAO,EACf,gBAAgB,GAAE,uBAAiC,EACnD,aAAa,UAAQ,GACpB,OAAO;IAiCV,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO;IAI9E,KAAK,IAAI,OAAO;IAIhB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAI/B,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAItC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKzC,aAAa,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAcjC,6EAA6E;IAC7E,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO;CAIzE"}

package/dist/math/Frustum.js

@@ -3,38 +3,88 @@ import { Matrix4 } from "./Matrix4.js";
 import { Plane } from "./Plane.js";
 import { Sphere } from "./Sphere.js";
 import { Vector3 } from "./Vector3.js";
+/**
+ * View frustum as six clipping planes — three.js `Frustum` parity.
+ * Plane order matches three: `[right, left, bottom, top, far, near]`.
+ */
 export class Frustum {
     planes;
     constructor(planes) {
         this.planes = planes;
     }
     static fromMatrix(matrix) {
-        const m = matrix.elements;
-        const planes = [
-            new Plane(new Vector3(m[3] + m[0], m[7] + m[4], m[11] + m[8]), m[15] + m[12]),
-            new Plane(new Vector3(m[3] - m[0], m[7] - m[4], m[11] - m[8]), m[15] - m[12]),
-            new Plane(new Vector3(m[3] + m[1], m[7] + m[5], m[11] + m[9]), m[15] + m[13]),
-            new Plane(new Vector3(m[3] - m[1], m[7] - m[5], m[11] - m[9]), m[15] - m[13]),
-            new Plane(new Vector3(m[3] + m[2], m[7] + m[6], m[11] + m[10]), m[15] + m[14]),
-            new Plane(new Vector3(m[3] - m[2], m[7] - m[6], m[11] - m[10]), m[15] - m[14])
-        ];
-        return new Frustum(planes);
+        return Frustum.setFromProjectionMatrix(matrix);
+    }
+    /**
+     * Extracts the six frustum planes from a projection matrix —
+     * three.js `Frustum.setFromProjectionMatrix`. `coordinateSystem` selects
+     * the near-plane convention (`"webgl"`: NDC z ∈ [−1,1], `"webgpu"`:
+     * [0,1]); `reversedDepth` swaps near/far.
+     */
+    static setFromProjectionMatrix(matrix, coordinateSystem = "webgl", reversedDepth = false) {
+        const me = matrix.elements;
+        const me0 = me[0], me1 = me[1], me2 = me[2], me3 = me[3];
+        const me4 = me[4], me5 = me[5], me6 = me[6], me7 = me[7];
+        const me8 = me[8], me9 = me[9], me10 = me[10], me11 = me[11];
+        const me12 = me[12], me13 = me[13], me14 = me[14], me15 = me[15];
+        let far;
+        let near;
+        if (reversedDepth) {
+            far = new Plane(new Vector3(me2, me6, me10), me14);
+            near = new Plane(new Vector3(me3 - me2, me7 - me6, me11 - me10), me15 - me14);
+        }
+        else {
+            far = new Plane(new Vector3(me3 - me2, me7 - me6, me11 - me10), me15 - me14);
+            if (coordinateSystem === "webgl") {
+                near = new Plane(new Vector3(me3 + me2, me7 + me6, me11 + me10), me15 + me14);
+            }
+            else if (coordinateSystem === "webgpu") {
+                near = new Plane(new Vector3(me2, me6, me10), me14);
+            }
+            else {
+                throw new RangeError(`Invalid coordinate system: ${coordinateSystem}`);
+            }
+        }
+        return new Frustum([
+            new Plane(new Vector3(me3 - me0, me7 - me4, me11 - me8), me15 - me12), // right
+            new Plane(new Vector3(me3 + me0, me7 + me4, me11 + me8), me15 + me12), // left
+            new Plane(new Vector3(me3 + me1, me7 + me5, me11 + me9), me15 + me13), // bottom
+            new Plane(new Vector3(me3 - me1, me7 - me5, me11 - me9), me15 - me13), // top
+            far,
+            near
+        ]);
+    }
+    set(p0, p1, p2, p3, p4, p5) {
+        return new Frustum([p0, p1, p2, p3, p4, p5]);
+    }
+    clone() {
+        return new Frustum([...this.planes]);
+    }
+    copy(frustum) {
+        return frustum.clone();
     }
     containsPoint(point) {
         return this.planes.every((plane) => plane.distanceToPoint(point) >= 0);
     }
     intersectsSphere(sphere) {
-        return this.planes.every((plane) => plane.distanceToPoint(sphere.center) >= -sphere.radius);
+        const negRadius = -sphere.radius;
+        return this.planes.every((plane) => plane.distanceToPoint(sphere.center) >= negRadius);
     }
     intersectsBox(box) {
         if (box.isEmpty())
             return false;
         for (const plane of this.planes) {
-            const p = new Vector3(plane.normal.x >= 0 ? box.max.x : box.min.x, plane.normal.y >= 0 ? box.max.y : box.min.y, plane.normal.z >= 0 ? box.max.z : box.min.z);
+            // corner at max distance along the plane normal
+            const p = new Vector3(plane.normal.x > 0 ? box.max.x : box.min.x, plane.normal.y > 0 ? box.max.y : box.min.y, plane.normal.z > 0 ? box.max.z : box.min.z);
             if (plane.distanceToPoint(p) < 0)
                 return false;
         }
         return true;
     }
+    /** three.js `Frustum.intersectsObject`-equivalent over a bounds provider. */
+    intersectsBoundingSphere(sphere, worldMatrix) {
+        const transformed = worldMatrix ? sphere.applyMatrix4(worldMatrix) : sphere;
+        return this.intersectsSphere(transformed);
+    }
 }
 //# sourceMappingURL=Frustum.js.map