@aura3d/engine 4.0.3 → 4.0.4

package/dist/math/Octree.js

@@ -0,0 +1,385 @@
+import { Box3 } from "./Box3.js";
+import { Capsule } from "./Capsule.js";
+import { Line3 } from "./Line3.js";
+import { Sphere } from "./Sphere.js";
+import { Triangle } from "./Triangle.js";
+import { Vector3 } from "./Vector3.js";
+const EPS = 1e-10;
+/** Closest points on two finite line segments (three `lineToLineClosestPoints`). */
+function lineToLineClosestPoints(line1, line2) {
+    const r = line1.end.subtract(line1.start);
+    const s = line2.end.subtract(line2.start);
+    const w = line2.start.subtract(line1.start);
+    const a = r.dot(s);
+    const b = r.dot(r);
+    const c = s.dot(s);
+    const d = s.dot(w);
+    const e = r.dot(w);
+    let t1;
+    let t2;
+    const divisor = b * c - a * a;
+    if (Math.abs(divisor) < EPS) {
+        const d1 = -d / c;
+        const d2 = (a - d) / c;
+        if (Math.abs(d1 - 0.5) < Math.abs(d2 - 0.5)) {
+            t1 = 0;
+            t2 = d1;
+        }
+        else {
+            t1 = 1;
+            t2 = d2;
+        }
+    }
+    else {
+        t1 = (d * a + e * c) / divisor;
+        t2 = (t1 * a - d) / c;
+    }
+    t2 = Math.max(0, Math.min(1, t2));
+    t1 = Math.max(0, Math.min(1, t1));
+    return {
+        point1: r.multiplyScalar(t1).add(line1.start),
+        point2: s.multiplyScalar(t2).add(line2.start)
+    };
+}
+/**
+ * Triangle octree — three.js `examples/jsm/math/Octree.js` parity:
+ * `addTriangle`/`build`/`split` and `boxIntersect`, `sphereIntersect`,
+ * `capsuleIntersect`, `rayIntersect` collision queries.
+ *
+ * `fromTriangles(triangles)` is the `fromGraphNode` equivalent for
+ * triangle-soup sources (meshes adapted by callers); `fromPositions` accepts
+ * raw vertex data + optional index/world transform.
+ */
+export class Octree {
+    /** Cell bounds — `undefined` until {@link calcBox}/{@link build}. */
+    box;
+    /** Loose bounds grown by {@link addTriangle}. */
+    bounds = new Box3();
+    trianglesPerLeaf = 8;
+    maxLevel = 16;
+    subTrees = [];
+    triangles = [];
+    constructor(box) {
+        this.box = box;
+    }
+    addTriangle(triangle) {
+        const min = this.bounds.min;
+        const max = this.bounds.max;
+        const newMin = new Vector3(Math.min(min.x, triangle.a.x, triangle.b.x, triangle.c.x), Math.min(min.y, triangle.a.y, triangle.b.y, triangle.c.y), Math.min(min.z, triangle.a.z, triangle.b.z, triangle.c.z));
+        const newMax = new Vector3(Math.max(max.x, triangle.a.x, triangle.b.x, triangle.c.x), Math.max(max.y, triangle.a.y, triangle.b.y, triangle.c.y), Math.max(max.z, triangle.a.z, triangle.b.z, triangle.c.z));
+        this.bounds = new Box3(newMin, newMax);
+        this.triangles.push(triangle);
+        return this;
+    }
+    calcBox() {
+        this.box = this.bounds.clone();
+        // offset small amount to account for regular grid
+        this.box = new Box3(new Vector3(this.box.min.x - 0.01, this.box.min.y - 0.01, this.box.min.z - 0.01), this.box.max);
+        return this;
+    }
+    split(level) {
+        if (!this.box)
+            return this;
+        const subTrees = [];
+        const halfsize = this.box.max.subtract(this.box.min).multiplyScalar(0.5);
+        for (let x = 0; x < 2; x += 1) {
+            for (let y = 0; y < 2; y += 1) {
+                for (let z = 0; z < 2; z += 1) {
+                    const v = new Vector3(x, y, z).multiply(halfsize);
+                    const min = this.box.min.add(v);
+                    const max = min.add(halfsize);
+                    subTrees.push(new Octree(new Box3(min, max)));
+                }
+            }
+        }
+        let triangle;
+        while ((triangle = this.triangles.pop()) !== undefined) {
+            for (const subTree of subTrees) {
+                if (subTree.box.intersectsTriangle(triangle)) {
+                    subTree.triangles.push(triangle);
+                }
+            }
+        }
+        for (const subTree of subTrees) {
+            const len = subTree.triangles.length;
+            if (len > this.trianglesPerLeaf && level < this.maxLevel) {
+                subTree.split(level + 1);
+            }
+            if (len !== 0) {
+                this.subTrees.push(subTree);
+            }
+        }
+        return this;
+    }
+    build() {
+        this.calcBox();
+        this.split(0);
+        return this;
+    }
+    /** `fromGraphNode` equivalent: build over an explicit triangle list. */
+    fromTriangles(triangles) {
+        for (const triangle of triangles)
+            this.addTriangle(triangle);
+        this.build();
+        return this;
+    }
+    /**
+     * Build over raw vertex positions with optional index list and world
+     * transform — the `fromGraphNode` equivalent for mesh data.
+     */
+    fromPositions(positions, indices, worldMatrix) {
+        if (indices !== undefined && indices.length > 0) {
+            for (let i = 0; i < indices.length; i += 3) {
+                const a = Vector3.fromArray(positions, indices[i] * 3);
+                const b = Vector3.fromArray(positions, indices[i + 1] * 3);
+                const c = Vector3.fromArray(positions, indices[i + 2] * 3);
+                this.addTriangle(new Triangle(worldMatrix ? a.transformMatrix4(worldMatrix) : a, worldMatrix ? b.transformMatrix4(worldMatrix) : b, worldMatrix ? c.transformMatrix4(worldMatrix) : c));
+            }
+        }
+        else {
+            for (let i = 0; i < positions.length; i += 9) {
+                const a = Vector3.fromArray(positions, i);
+                const b = Vector3.fromArray(positions, i + 3);
+                const c = Vector3.fromArray(positions, i + 6);
+                this.addTriangle(new Triangle(worldMatrix ? a.transformMatrix4(worldMatrix) : a, worldMatrix ? b.transformMatrix4(worldMatrix) : b, worldMatrix ? c.transformMatrix4(worldMatrix) : c));
+            }
+        }
+        this.build();
+        return this;
+    }
+    getRayTriangles(ray, triangles) {
+        for (const subTree of this.subTrees) {
+            if (!ray.intersectsBox(subTree.box))
+                continue;
+            if (subTree.triangles.length > 0) {
+                for (const triangle of subTree.triangles) {
+                    if (!triangles.includes(triangle))
+                        triangles.push(triangle);
+                }
+            }
+            else {
+                subTree.getRayTriangles(ray, triangles);
+            }
+        }
+    }
+    triangleCapsuleIntersect(capsule, triangle) {
+        const plane = triangle.getPlane();
+        const d1 = plane.distanceToPoint(capsule.start) - capsule.radius;
+        const d2 = plane.distanceToPoint(capsule.end) - capsule.radius;
+        if ((d1 > 0 && d2 > 0) || (d1 < -capsule.radius && d2 < -capsule.radius)) {
+            return false;
+        }
+        const delta = Math.abs(d1 / (Math.abs(d1) + Math.abs(d2)));
+        const intersectPoint = capsule.start.lerp(capsule.end, delta);
+        if (triangle.containsPoint(intersectPoint)) {
+            return { normal: plane.normal, point: intersectPoint, depth: Math.abs(Math.min(d1, d2)) };
+        }
+        const r2 = capsule.radius * capsule.radius;
+        const line1 = new Line3(capsule.start, capsule.end);
+        const lines = [
+            [triangle.a, triangle.b],
+            [triangle.b, triangle.c],
+            [triangle.c, triangle.a]
+        ];
+        for (const [start, end] of lines) {
+            const line2 = new Line3(start, end);
+            const { point1, point2 } = lineToLineClosestPoints(line1, line2);
+            if (point1.distanceToSquared(point2) < r2) {
+                return {
+                    normal: point1.subtract(point2).normalize(),
+                    point: point2,
+                    depth: capsule.radius - point1.distanceTo(point2)
+                };
+            }
+        }
+        return false;
+    }
+    triangleBoxIntersect(box, triangle) {
+        // cheap check
+        if (Math.max(triangle.a.x, triangle.b.x, triangle.c.x) < box.min.x ||
+            Math.min(triangle.a.x, triangle.b.x, triangle.c.x) > box.max.x ||
+            Math.max(triangle.a.y, triangle.b.y, triangle.c.y) < box.min.y ||
+            Math.min(triangle.a.y, triangle.b.y, triangle.c.y) > box.max.y ||
+            Math.max(triangle.a.z, triangle.b.z, triangle.c.z) < box.min.z ||
+            Math.min(triangle.a.z, triangle.b.z, triangle.c.z) > box.max.z) {
+            return false;
+        }
+        // expensive check
+        if (!box.intersectsTriangle(triangle))
+            return false;
+        const plane = triangle.getPlane();
+        // deepest box corner relative to the plane
+        const v1 = new Vector3(plane.normal.x > 0 ? box.min.x : box.max.x, plane.normal.y > 0 ? box.min.y : box.max.y, plane.normal.z > 0 ? box.min.z : box.max.z);
+        const distance = plane.distanceToPoint(v1);
+        return {
+            depth: -distance,
+            normal: plane.normal,
+            point: v1.addScaled(plane.normal, distance)
+        };
+    }
+    triangleSphereIntersect(sphere, triangle) {
+        const plane = triangle.getPlane();
+        if (!sphere.intersectsPlane(plane))
+            return false;
+        const depth = Math.abs(plane.distanceToSphere(sphere));
+        const r2 = sphere.radius * sphere.radius - depth * depth;
+        const plainPoint = plane.projectPoint(sphere.center);
+        if (triangle.containsPoint(sphere.center)) {
+            return { normal: plane.normal, point: plainPoint, depth: Math.abs(plane.distanceToSphere(sphere)) };
+        }
+        const lines = [
+            [triangle.a, triangle.b],
+            [triangle.b, triangle.c],
+            [triangle.c, triangle.a]
+        ];
+        for (const [start, end] of lines) {
+            const line = new Line3(start, end);
+            const v2 = line.closestPointToPoint(plainPoint, true);
+            const d = v2.distanceToSquared(sphere.center);
+            if (d < r2) {
+                return {
+                    normal: sphere.center.subtract(v2).normalize(),
+                    point: v2,
+                    depth: sphere.radius - Math.sqrt(d)
+                };
+            }
+        }
+        return false;
+    }
+    getSphereTriangles(sphere, triangles) {
+        for (const subTree of this.subTrees) {
+            if (!sphere.intersectsBox(subTree.box))
+                continue;
+            if (subTree.triangles.length > 0) {
+                for (const triangle of subTree.triangles) {
+                    if (!triangles.includes(triangle))
+                        triangles.push(triangle);
+                }
+            }
+            else {
+                subTree.getSphereTriangles(sphere, triangles);
+            }
+        }
+    }
+    getBoxTriangles(box, triangles) {
+        for (const subTree of this.subTrees) {
+            if (!box.intersectsBox(subTree.box))
+                continue;
+            if (subTree.triangles.length > 0) {
+                for (const triangle of subTree.triangles) {
+                    if (!triangles.includes(triangle))
+                        triangles.push(triangle);
+                }
+            }
+            else {
+                subTree.getBoxTriangles(box, triangles);
+            }
+        }
+    }
+    getCapsuleTriangles(capsule, triangles) {
+        for (const subTree of this.subTrees) {
+            if (!capsule.intersectsBox(subTree.box))
+                continue;
+            if (subTree.triangles.length > 0) {
+                for (const triangle of subTree.triangles) {
+                    if (!triangles.includes(triangle))
+                        triangles.push(triangle);
+                }
+            }
+            else {
+                subTree.getCapsuleTriangles(capsule, triangles);
+            }
+        }
+    }
+    /**
+     * Resolves `box` against the octree — returns the accumulated collision
+     * normal + depth or `false` (three `Octree.boxIntersect`).
+     */
+    boxIntersect(box) {
+        let moving = box;
+        const triangles = [];
+        let hit = false;
+        this.getBoxTriangles(box, triangles);
+        for (const triangle of triangles) {
+            const result = this.triangleBoxIntersect(moving, triangle);
+            if (result) {
+                hit = true;
+                moving = moving.translate(result.normal.multiplyScalar(result.depth));
+            }
+        }
+        if (hit) {
+            const collisionVector = moving.getCenter().subtract(box.getCenter());
+            const depth = collisionVector.length();
+            return { normal: collisionVector.normalize(), depth };
+        }
+        return false;
+    }
+    /** three.js `Octree.sphereIntersect`. */
+    sphereIntersect(sphere) {
+        let moving = sphere;
+        const triangles = [];
+        let hit = false;
+        this.getSphereTriangles(sphere, triangles);
+        for (const triangle of triangles) {
+            const result = this.triangleSphereIntersect(moving, triangle);
+            if (result) {
+                hit = true;
+                moving = moving.translate(result.normal.multiplyScalar(result.depth));
+            }
+        }
+        if (hit) {
+            const collisionVector = moving.center.subtract(sphere.center);
+            const depth = collisionVector.length();
+            return { normal: collisionVector.normalize(), depth };
+        }
+        return false;
+    }
+    /** three.js `Octree.capsuleIntersect`. */
+    capsuleIntersect(capsule) {
+        let moving = capsule;
+        const triangles = [];
+        let hit = false;
+        this.getCapsuleTriangles(capsule, triangles);
+        for (const triangle of triangles) {
+            const result = this.triangleCapsuleIntersect(moving, triangle);
+            if (result) {
+                hit = true;
+                moving = moving.translate(result.normal.multiplyScalar(result.depth));
+            }
+        }
+        if (hit) {
+            const collisionVector = moving.getCenter().subtract(capsule.getCenter());
+            const depth = collisionVector.length();
+            return { normal: collisionVector.normalize(), depth };
+        }
+        return false;
+    }
+    /** three.js `Octree.rayIntersect` — nearest triangle hit (backface-culled). */
+    rayIntersect(ray) {
+        const triangles = [];
+        let triangle;
+        let position;
+        let distance = 1e100;
+        this.getRayTriangles(ray, triangles);
+        for (const tri of triangles) {
+            const result = ray.intersectTriangle(tri.a, tri.b, tri.c, true);
+            if (result !== undefined) {
+                const newdistance = result.subtract(ray.origin).length();
+                if (distance > newdistance) {
+                    position = result;
+                    distance = newdistance;
+                    triangle = tri;
+                }
+            }
+        }
+        return distance < 1e100 ? { distance, triangle: triangle, position: position } : false;
+    }
+    clear() {
+        this.box = undefined;
+        this.bounds = new Box3();
+        this.subTrees.length = 0;
+        this.triangles.length = 0;
+        return this;
+    }
+}
+//# sourceMappingURL=Octree.js.map

package/dist/math/Octree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Octree.js","sourceRoot":"","sources":["../../../../packages/math/src/Octree.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,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAIvC,MAAM,GAAG,GAAG,KAAK,CAAC;AAElB,oFAAoF;AACpF,SAAS,uBAAuB,CAAC,KAAY,EAAE,KAAY;IACzD,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnB,IAAI,EAAU,CAAC;IACf,IAAI,EAAU,CAAC;IACf,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAClB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;YAC5C,EAAE,GAAG,CAAC,CAAC;YACP,EAAE,GAAG,EAAE,CAAC;QACV,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,CAAC,CAAC;YACP,EAAE,GAAG,EAAE,CAAC;QACV,CAAC;IACH,CAAC;SAAM,CAAC;QACN,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC;QAC/B,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAClC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAClC,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;QAC7C,MAAM,EAAE,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;KAC9C,CAAC;AACJ,CAAC;AAmBD;;;;;;;;GAQG;AACH,MAAM,OAAO,MAAM;IACjB,qEAAqE;IACrE,GAAG,CAAmB;IACtB,iDAAiD;IACjD,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;IAEpB,gBAAgB,GAAG,CAAC,CAAC;IACrB,QAAQ,GAAG,EAAE,CAAC;IAEL,QAAQ,GAAa,EAAE,CAAC;IACxB,SAAS,GAAe,EAAE,CAAC;IAEpC,YAAY,GAAU;QACpB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,WAAW,CAAC,QAAkB;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,OAAO,CACxB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EACzD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EACzD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAC1D,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,OAAO,CACxB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EACzD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EACzD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAC1D,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC/B,kDAAkD;QAClD,IAAI,CAAC,GAAG,GAAG,IAAI,IAAI,CACjB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAChF,IAAI,CAAC,GAAG,CAAC,GAAG,CACb,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAC3B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACzE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC9B,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;oBAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBAChC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC9B,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,QAA8B,CAAC;QACnC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;YACvD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,IAAI,OAAO,CAAC,GAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC9C,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC;YACrC,IAAI,GAAG,GAAG,IAAI,CAAC,gBAAgB,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACzD,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC3B,CAAC;YACD,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;gBACd,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wEAAwE;IACxE,aAAa,CAAC,SAA8B;QAC1C,KAAK,MAAM,QAAQ,IAAI,SAAS;YAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,SAA4B,EAAE,OAA2B,EAAE,WAAqB;QAC5F,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3C,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC;gBACxD,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC;gBAC5D,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC;gBAC5D,IAAI,CAAC,WAAW,CAAC,IAAI,QAAQ,CAC3B,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EACjD,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EACjD,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAClD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7C,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;gBAC1C,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9C,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9C,IAAI,CAAC,WAAW,CAAC,IAAI,QAAQ,CAC3B,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EACjD,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EACjD,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAClD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,eAAe,CAAC,GAAQ,EAAE,SAAqB;QAC7C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,GAAI,CAAC;gBAAE,SAAS;YAC/C,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;oBACzC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;wBAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAED,wBAAwB,CAAC,OAAgB,EAAE,QAAkB;QAC3D,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;QACjE,MAAM,EAAE,GAAG,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/D,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACzE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9D,IAAI,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QAC5F,CAAC;QAED,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,KAAK,GAAyB;YAClC,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;YACxB,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;YACxB,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;SACzB,CAAC;QACF,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACpC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACjE,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC;gBAC1C,OAAO;oBACL,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE;oBAC3C,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;iBAClD,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oBAAoB,CAAC,GAAS,EAAE,QAAkB;QAChD,cAAc;QACd,IACE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9D,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9D,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9D,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9D,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9D,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAC9D,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,kBAAkB;QAClB,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAEpD,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAClC,2CAA2C;QAC3C,MAAM,EAAE,GAAG,IAAI,OAAO,CACpB,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAC1C,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAC1C,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAC3C,CAAC;QACF,MAAM,QAAQ,GAAG,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAC3C,OAAO;YACL,KAAK,EAAE,CAAC,QAAQ;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC;SAC5C,CAAC;IACJ,CAAC;IAED,uBAAuB,CAAC,MAAc,EAAE,QAAkB;QACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAEjD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;QACzD,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACtG,CAAC;QACD,MAAM,KAAK,GAAyB;YAClC,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;YACxB,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;YACxB,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;SACzB,CAAC;QACF,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACnC,MAAM,EAAE,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACtD,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBACX,OAAO;oBACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE;oBAC9C,KAAK,EAAE,EAAE;oBACT,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;iBACpC,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kBAAkB,CAAC,MAAc,EAAE,SAAqB;QACtD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,GAAI,CAAC;gBAAE,SAAS;YAClD,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;oBACzC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;wBAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED,eAAe,CAAC,GAAS,EAAE,SAAqB;QAC9C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,GAAI,CAAC;gBAAE,SAAS;YAC/C,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;oBACzC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;wBAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,OAAgB,EAAE,SAAqB;QACzD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,GAAI,CAAC;gBAAE,SAAS;YACnD,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;oBACzC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;wBAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,GAAS;QACpB,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,MAAM,SAAS,GAAe,EAAE,CAAC;QACjC,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC3D,IAAI,MAAM,EAAE,CAAC;gBACX,GAAG,GAAG,IAAI,CAAC;gBACX,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QACD,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;YACrE,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC;YACvC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,yCAAyC;IACzC,eAAe,CAAC,MAAc;QAC5B,IAAI,MAAM,GAAG,MAAM,CAAC;QACpB,MAAM,SAAS,GAAe,EAAE,CAAC;QACjC,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC9D,IAAI,MAAM,EAAE,CAAC;gBACX,GAAG,GAAG,IAAI,CAAC;gBACX,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QACD,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9D,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC;YACvC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0CAA0C;IAC1C,gBAAgB,CAAC,OAAgB;QAC/B,IAAI,MAAM,GAAG,OAAO,CAAC;QACrB,MAAM,SAAS,GAAe,EAAE,CAAC;QACjC,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC7C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC/D,IAAI,MAAM,EAAE,CAAC;gBACX,GAAG,GAAG,IAAI,CAAC;gBACX,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QACD,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;YACzE,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC;YACvC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+EAA+E;IAC/E,YAAY,CAAC,GAAQ;QACnB,MAAM,SAAS,GAAe,EAAE,CAAC;QACjC,IAAI,QAA8B,CAAC;QACnC,IAAI,QAA6B,CAAC;QAClC,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAChE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;gBACzD,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;oBAC3B,QAAQ,GAAG,MAAM,CAAC;oBAClB,QAAQ,GAAG,WAAW,CAAC;oBACvB,QAAQ,GAAG,GAAG,CAAC;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAS,EAAE,QAAQ,EAAE,QAAS,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3F,CAAC;IAED,KAAK;QACH,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/math/Plane.d.ts

@@ -1,11 +1,53 @@
 import { Vector3 } from "./Vector3.js";
+import { Matrix3 } from "./Matrix3.js";
+import type { Line3 } from "./Line3.js";
+import type { Box3 } from "./Box3.js";
+import type { Sphere } from "./Sphere.js";
+import type { Matrix4 } from "./Matrix4.js";
+/**
+ * Plane `n·x + c = 0` with normalized `normal` — three.js `Plane` parity.
+ * The constructor normalizes `(normal, constant)` like three's
+ * `Plane.normalize()` so signed distances are always well-defined.
+ */
 export declare class Plane {
     readonly normal: Vector3;
     readonly constant: number;
     constructor(normal?: Vector3, constant?: number);
+    /** three.js `Plane.setComponents` — does NOT normalize (three semantics). */
+    static setComponents(x: number, y: number, z: number, w: number): Plane;
     static fromPointNormal(point: Vector3, normal: Vector3): Plane;
+    /** three.js `Plane.setFromNormalAndCoplanarPoint`. */
+    static setFromNormalAndCoplanarPoint(normal: Vector3, point: Vector3): Plane;
+    /** CCW winding determines the normal (three `setFromCoplanarPoints`). */
+    static fromCoplanarPoints(a: Vector3, b: Vector3, c: Vector3): Plane;
+    setFromCoplanarPoints(a: Vector3, b: Vector3, c: Vector3): Plane;
+    clone(): Plane;
+    copy(plane: Plane): Plane;
+    negate(): Plane;
     distanceToPoint(point: Vector3): number;
+    /** Signed distance to a sphere's center plus its radius (three `distanceToSphere`). */
+    distanceToSphere(sphere: Sphere): number;
     projectPoint(point: Vector3): Vector3;
+    /** Point on the plane nearest the origin — `normal * -constant` (three `coplanarPoint`). */
+    coplanarPoint(): Vector3;
+    /**
+     * Segment intersection — three.js `Plane.intersectLine` parity:
+     * coplanar line returns `line.start`, parallel returns `undefined`,
+     * and `undefined` when the intersection lies outside the segment.
+     */
     intersectLine(start: Vector3, end: Vector3): Vector3 | undefined;
+    intersectLine(line: Line3): Vector3 | undefined;
+    /** Whether the segment `line` crosses the plane (three `intersectsLine`). */
+    intersectsLine(line: Line3): boolean;
+    intersectsBox(box: Box3): boolean;
+    intersectsSphere(sphere: Sphere): boolean;
+    /**
+     * three.js `Plane.applyMatrix4` — the matrix must be affine; pass a
+     * precomputed `Matrix3.getNormalMatrix(matrix)` as `normalMatrix` to
+     * skip recomputation.
+     */
+    applyMatrix4(matrix: Matrix4, normalMatrix?: Matrix3): Plane;
+    translate(offset: Vector3): Plane;
+    equals(plane: Plane, epsilon?: number): boolean;
 }
 //# sourceMappingURL=Plane.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Plane.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Plane.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,qBAAa,KAAK;IAChB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,MAAM,UAAqB,EAAE,QAAQ,SAAI;IAOrD,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK;IAK9D,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAIvC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIrC,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;CAOjE"}
+{"version":3,"file":"Plane.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Plane.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,MAAM,UAAqB,EAAE,QAAQ,SAAI;IAOrD,6EAA6E;IAC7E,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK;IAIvE,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK;IAK9D,sDAAsD;IACtD,MAAM,CAAC,6BAA6B,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK;IAI5E,yEAAyE;IACzE,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,KAAK;IAKpE,qBAAqB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,KAAK;IAIhE,KAAK,IAAI,KAAK;IAId,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAIzB,MAAM,IAAI,KAAK;IAIf,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAIvC,uFAAuF;IACvF,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIxC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIrC,4FAA4F;IAC5F,aAAa,IAAI,OAAO;IAIxB;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAChE,aAAa,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS;IAgB/C,6EAA6E;IAC7E,cAAc,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO;IAMpC,aAAa,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAIjC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,KAAK;IAO5D,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK;IAIjC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,SAAQ,GAAG,OAAO;CAG/C"}

package/dist/math/Plane.js

@@ -1,4 +1,10 @@
 import { Vector3 } from "./Vector3.js";
+import { Matrix3 } from "./Matrix3.js";
+/**
+ * Plane `n·x + c = 0` with normalized `normal` — three.js `Plane` parity.
+ * The constructor normalizes `(normal, constant)` like three's
+ * `Plane.normalize()` so signed distances are always well-defined.
+ */
 export class Plane {
     normal;
     constant;
@@ -9,23 +15,93 @@ export class Plane {
         this.normal = normal.multiplyScalar(1 / len);
         this.constant = constant / len;
     }
+    /** three.js `Plane.setComponents` — does NOT normalize (three semantics). */
+    static setComponents(x, y, z, w) {
+        return new Plane(new Vector3(x, y, z), w);
+    }
     static fromPointNormal(point, normal) {
         const normalized = normal.normalize();
         return new Plane(normalized, -point.dot(normalized));
     }
+    /** three.js `Plane.setFromNormalAndCoplanarPoint`. */
+    static setFromNormalAndCoplanarPoint(normal, point) {
+        return Plane.fromPointNormal(point, normal);
+    }
+    /** CCW winding determines the normal (three `setFromCoplanarPoints`). */
+    static fromCoplanarPoints(a, b, c) {
+        const normal = c.subtract(b).cross(a.subtract(b)).normalize();
+        return Plane.fromPointNormal(a, normal);
+    }
+    setFromCoplanarPoints(a, b, c) {
+        return Plane.fromCoplanarPoints(a, b, c);
+    }
+    clone() {
+        return new Plane(this.normal, this.constant);
+    }
+    copy(plane) {
+        return new Plane(plane.normal, plane.constant);
+    }
+    negate() {
+        return new Plane(this.normal.negate(), -this.constant);
+    }
     distanceToPoint(point) {
         return this.normal.dot(point) + this.constant;
     }
+    /** Signed distance to a sphere's center plus its radius (three `distanceToSphere`). */
+    distanceToSphere(sphere) {
+        return this.distanceToPoint(sphere.center) - sphere.radius;
+    }
     projectPoint(point) {
         return point.subtract(this.normal.multiplyScalar(this.distanceToPoint(point)));
     }
-    intersectLine(start, end) {
+    /** Point on the plane nearest the origin — `normal * -constant` (three `coplanarPoint`). */
+    coplanarPoint() {
+        return this.normal.multiplyScalar(-this.constant);
+    }
+    intersectLine(a, b) {
+        const start = a instanceof Vector3 ? a : a.start;
+        const end = a instanceof Vector3 ? b : a.end;
         const direction = end.subtract(start);
         const denominator = this.normal.dot(direction);
-        if (Math.abs(denominator) < 1e-12)
+        if (denominator === 0) {
+            // line is coplanar, return start; otherwise no intersection
+            if (this.distanceToPoint(start) === 0)
+                return start;
             return undefined;
+        }
         const t = -(start.dot(this.normal) + this.constant) / denominator;
-        return t < 0 || t > 1 ? undefined : start.add(direction.multiplyScalar(t));
+        if (t < 0 || t > 1)
+            return undefined;
+        return start.addScaled(direction, t);
+    }
+    /** Whether the segment `line` crosses the plane (three `intersectsLine`). */
+    intersectsLine(line) {
+        const startSign = this.distanceToPoint(line.start);
+        const endSign = this.distanceToPoint(line.end);
+        return (startSign < 0 && endSign > 0) || (endSign < 0 && startSign > 0);
+    }
+    intersectsBox(box) {
+        return box.intersectsPlane(this);
+    }
+    intersectsSphere(sphere) {
+        return sphere.intersectsPlane(this);
+    }
+    /**
+     * three.js `Plane.applyMatrix4` — the matrix must be affine; pass a
+     * precomputed `Matrix3.getNormalMatrix(matrix)` as `normalMatrix` to
+     * skip recomputation.
+     */
+    applyMatrix4(matrix, normalMatrix) {
+        const nm = normalMatrix ?? Matrix3.normalFromMatrix4(matrix);
+        const referencePoint = this.coplanarPoint().transformMatrix4(matrix);
+        const normal = this.normal.applyMatrix3(nm).normalize();
+        return new Plane(normal, -referencePoint.dot(normal));
+    }
+    translate(offset) {
+        return new Plane(this.normal, this.constant - offset.dot(this.normal));
+    }
+    equals(plane, epsilon = 1e-10) {
+        return this.normal.equals(plane.normal, epsilon) && Math.abs(this.constant - plane.constant) <= epsilon;
     }
 }
 //# sourceMappingURL=Plane.js.map

package/dist/math/Plane.js.map

@@ -1 +1 @@
-{"version":3,"file":"Plane.js","sourceRoot":"","sources":["../../../../packages/math/src/Plane.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,OAAO,KAAK;IACP,MAAM,CAAU;IAChB,QAAQ,CAAS;IAE1B,YAAY,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,QAAQ,GAAG,CAAC;QACnD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,GAAG,KAAK,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,gCAAgC,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,QAAQ,GAAG,GAAG,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,eAAe,CAAC,KAAc,EAAE,MAAe;QACpD,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,eAAe,CAAC,KAAc;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;IAChD,CAAC;IAED,YAAY,CAAC,KAAc;QACzB,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,aAAa,CAAC,KAAc,EAAE,GAAY;QACxC,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,KAAK;YAAE,OAAO,SAAS,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;CACF"}
+{"version":3,"file":"Plane.js","sourceRoot":"","sources":["../../../../packages/math/src/Plane.ts"],"names":[],"mappings":"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"}

package/dist/math/Quaternion.d.ts

@@ -1,6 +1,7 @@
 import { Vector3 } from "./Vector3.js";
 import type { Matrix4 } from "./Matrix4.js";
-export type EulerOrder = "XYZ";
+/** Intrinsic rotation order, matching three.js `Euler` orders. */
+export type EulerOrder = "XYZ" | "YXZ" | "ZXY" | "ZYX" | "YZX" | "XZY";
 export declare class Quaternion {
     readonly x: number;
     readonly y: number;
@@ -10,6 +11,10 @@ export declare class Quaternion {
     constructor(x?: number, y?: number, z?: number, w?: number);
     static fromAxisAngle(axis: Vector3, radians: number): Quaternion;
     static fromUnitVectors(from: Vector3, to: Vector3): Quaternion;
+    /**
+     * Quaternion for the given intrinsic Euler rotations, applied in `order`
+     * (all six three.js orders — same formulas as `Quaternion.setFromEuler`).
+     */
     static fromEuler(x: number, y: number, z: number, order?: EulerOrder): Quaternion;
     static fromRotationMatrix(matrix: Matrix4): Quaternion;
     clone(): Quaternion;

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

@@ -1 +1 @@
-{"version":3,"file":"Quaternion.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Quaternion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC;AAE/B,qBAAa,UAAU;IAInB,QAAQ,CAAC,CAAC;IACV,QAAQ,CAAC,CAAC;IACV,QAAQ,CAAC,CAAC;IACV,QAAQ,CAAC,CAAC;IANZ,MAAM,CAAC,QAAQ,CAAC,QAAQ,uBAA6C;gBAG1D,CAAC,SAAI,EACL,CAAC,SAAI,EACL,CAAC,SAAI,EACL,CAAC,SAAI;IAGhB,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU;IAQhE,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,UAAU;IAe9D,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,UAAkB,GAAG,UAAU;IAiBxF,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU;IA2CtD,KAAK,IAAI,UAAU;IAInB,MAAM,IAAI,MAAM;IAIhB,SAAS,IAAI,UAAU;IAMvB,SAAS,IAAI,UAAU;IAIvB,OAAO,IAAI,UAAU;IAYrB,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU;IASnC,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO;IAMjC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU;IA+B5C,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,SAAQ,GAAG,OAAO;CAGhD"}
+{"version":3,"file":"Quaternion.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Quaternion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,kEAAkE;AAClE,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvE,qBAAa,UAAU;IAInB,QAAQ,CAAC,CAAC;IACV,QAAQ,CAAC,CAAC;IACV,QAAQ,CAAC,CAAC;IACV,QAAQ,CAAC,CAAC;IANZ,MAAM,CAAC,QAAQ,CAAC,QAAQ,uBAA6C;gBAG1D,CAAC,SAAI,EACL,CAAC,SAAI,EACL,CAAC,SAAI,EACL,CAAC,SAAI;IAGhB,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU;IAQhE,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,UAAU;IAe9D;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,UAAkB,GAAG,UAAU;IAgExF,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU;IA2CtD,KAAK,IAAI,UAAU;IAInB,MAAM,IAAI,MAAM;IAIhB,SAAS,IAAI,UAAU;IAMvB,SAAS,IAAI,UAAU;IAIvB,OAAO,IAAI,UAAU;IAYrB,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU;IASnC,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO;IAMjC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU;IA+B5C,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,SAAQ,GAAG,OAAO;CAGhD"}