@woosh/meep-engine 2.155.0 → 2.157.0

package/src/engine/control/first-person/math/jumpDynamics.js

@@ -0,0 +1,108 @@
+import { assert } from "../../../../core/assert.js";
+
+/**
+ * Jump power as physics, not a magic velocity.
+ *
+ * A jump is the legs doing WORK: a push-off force `F` (newtons) applied over a
+ * leg-extension distance `d` (meters) while the body is still on the ground.
+ * That work becomes the body's kinetic energy at the instant it leaves the
+ * ground, which gravity then trades back for height:
+ *
+ *     F · d   =   ½ · m · v₀²          (leg work → launch kinetic energy)
+ *     ½ · m · v₀²   =   m · g · h      (launch KE → potential energy at apex)
+ *
+ * Eliminating v₀ collapses the two into a single, mass-honest relationship
+ * between the force the legs deliver and the apex the body reaches:
+ *
+ *     h   =   F · d / (m · g)
+ *     F   =   m · g · h / d
+ *     v₀  =   √(2 · F · d / m)   =   √(2 · g · h)
+ *
+ * Why express jump power as a FORCE (newtons) rather than a launch velocity?
+ *   - It is a property of the CHARACTER (the legs), not of the jump. A fixed
+ *     leg force makes a heavier body jump lower — `h ∝ 1/m` — for free, which a
+ *     raw launch-velocity number cannot express (the same v₀ ignores mass).
+ *   - It composes: momentum, fatigue, and surface bonuses all add/scale in the
+ *     same physical currency (newtons) before a single conversion to velocity.
+ *
+ * `d` (the push-off distance) is the one extra parameter a newtons model needs:
+ * force alone can't determine a launch without the distance (or time) it acts
+ * over. It is a body constant — roughly the crouch-to-full-extension travel of
+ * the legs (~0.4–0.5 m for a ~1.8 m human countermovement jump).
+ *
+ * All three functions are pure and frame-independent. The headline is
+ * {@link jumpForceForHeight}: the newtons a designer needs to reach a desired
+ * apex on a given character. {@link launchVelocityForForce} is the forward
+ * conversion an ability applies at launch.
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+
+/**
+ * The push-off force (newtons) the legs must deliver for the body to reach a
+ * given apex height — i.e. newtons BACK-CALCULATED from the desired maximum
+ * jump height on this character.
+ *
+ *     F = m · g · h / d
+ *
+ * Heavier body → more force for the same height; stronger gravity → more force;
+ * a longer push-off distance → less force (the work is spread over more travel).
+ *
+ * @param {number} mass             body mass, kg (> 0)
+ * @param {number} gravity          gravitational acceleration, m/s² (> 0)
+ * @param {number} pushoffDistance  leg push-off distance, m (> 0)
+ * @param {number} height           desired apex height above launch, m (>= 0)
+ * @returns {number} push-off force in newtons
+ */
+export function jumpForceForHeight(mass, gravity, pushoffDistance, height) {
+    assert.greaterThan(mass, 0, "mass");
+    assert.greaterThan(gravity, 0, "gravity");
+    assert.greaterThan(pushoffDistance, 0, "pushoffDistance");
+    assert.greaterThanOrEqual(height, 0, "height");
+
+    return (mass * gravity * height) / pushoffDistance;
+}
+
+/**
+ * The apex height (meters) a given push-off force produces on this character —
+ * the inverse of {@link jumpForceForHeight}.
+ *
+ *     h = F · d / (m · g)
+ *
+ * @param {number} force            push-off force, newtons (>= 0)
+ * @param {number} mass             body mass, kg (> 0)
+ * @param {number} gravity          gravitational acceleration, m/s² (> 0)
+ * @param {number} pushoffDistance  leg push-off distance, m (> 0)
+ * @returns {number} apex height above launch, meters
+ */
+export function jumpHeightForForce(force, mass, gravity, pushoffDistance) {
+    assert.greaterThanOrEqual(force, 0, "force");
+    assert.greaterThan(mass, 0, "mass");
+    assert.greaterThan(gravity, 0, "gravity");
+    assert.greaterThan(pushoffDistance, 0, "pushoffDistance");
+
+    return (force * pushoffDistance) / (mass * gravity);
+}
+
+/**
+ * The launch velocity (m/s) a given push-off force imparts to this character —
+ * the forward conversion an ability applies at the instant of launch.
+ *
+ *     v₀ = √(2 · F · d / m)
+ *
+ * Note this is independent of gravity: gravity only governs the apex the launch
+ * velocity then reaches, not the launch itself.
+ *
+ * @param {number} force            push-off force, newtons (>= 0)
+ * @param {number} mass             body mass, kg (> 0)
+ * @param {number} pushoffDistance  leg push-off distance, m (> 0)
+ * @returns {number} launch velocity, m/s
+ */
+export function launchVelocityForForce(force, mass, pushoffDistance) {
+    assert.greaterThanOrEqual(force, 0, "force");
+    assert.greaterThan(mass, 0, "mass");
+    assert.greaterThan(pushoffDistance, 0, "pushoffDistance");
+
+    return Math.sqrt((2 * force * pushoffDistance) / mass);
+}

package/src/engine/control/first-person/prototype_first_person_controller.js

@@ -30,6 +30,7 @@ import { RigidBody } from "../../physics/ecs/RigidBody.js";
 import { PhysicsSurfacePoint } from "../../physics/queries/PhysicsSurfacePoint.js";
 import { LedgeGrab } from "./abilities/LedgeGrab.js";
 import { Mantle } from "./abilities/Mantle.js";
+import { ScrambleUp } from "./abilities/ScrambleUp.js";
 import { Slide } from "./abilities/Slide.js";
 import { WallJump } from "./abilities/WallJump.js";
 import { WallRun } from "./abilities/WallRun.js";
@@ -84,6 +85,7 @@ const COLOR_SLIDE = 0x44ddee;
 const COLOR_GAP = 0xff66cc;
 const COLOR_STAIRS = 0xeedd44;
 const COLOR_RAMP = 0x3377dd;
+const COLOR_SCRAMBLE = 0x33ffaa;
 const COLOR_NEUTRAL = 0xaaaaaa;
 
 const eh = new EngineHarness();
@@ -234,6 +236,7 @@ function buildGym(ecd) {
     buildGapJumpStation(ecd);
     buildStairsStation(ecd);
     buildRampStation(ecd);
+    buildScrambleStation(ecd);
     buildMeshShapeShowcase(ecd);
 }
 
@@ -516,6 +519,34 @@ function buildLedgeGrabStation(ecd) {
     });
 }
 
+/**
+ * Scramble-up station — a tall wall the player runs vertically UP a short
+ * distance (à la Assassin's Creed) to reach a grabbable top, or to kick off.
+ * East of spawn.
+ *
+ *   1. sprint at the wall (hold forward into it)
+ *   2. ScrambleUp launches a short vertical climb up the face
+ *   3. near the apex the top comes into reach → LedgeGrab catches it on the
+ *      way down → press jump to Mantle up onto the platform
+ *   4. …or press jump DURING the climb for a wall-kick off the face
+ *
+ * The wall top (2.8 m) is just out of standing grab reach (~1.9 m), so a
+ * scramble is required — a shorter wall would just be a plain Mantle.
+ */
+function buildScrambleStation(ecd) {
+    const baseX = SPAWN_X + 15;
+    spawnPad(ecd, baseX - 6, SPAWN_Z, COLOR_SCRAMBLE);
+
+    // Tall solid block: top at 2.8 m, wide + deep enough to stand on after the
+    // climb (so scramble → grab → mantle-up lands somewhere).
+    spawnBox(ecd, {
+        center: new Vector3(baseX, 1.4, SPAWN_Z),
+        size: new Vector3(4, 2.8, 8),
+        color: COLOR_SCRAMBLE,
+        roughness: 0.6,
+    });
+}
+
 /**
  * Slide tunnel — a sprint run-up followed by a low ceiling that forces
  * the player to slide under. NE of spawn.
@@ -830,6 +861,7 @@ function buildPlayerEntity(ecd) {
     controller.abilities.add(new Slide());
     controller.abilities.add(new Mantle());
     controller.abilities.add(new LedgeGrab());
+    controller.abilities.add(new ScrambleUp());
     controller.abilities.add(new WallRun());
     controller.abilities.add(new WallJump());
 
@@ -971,8 +1003,20 @@ function setupPointerLock(engine) {
     const captureEl = engine.viewStack.el;
 
     captureEl.addEventListener("click", () => {
-        if (document.pointerLockElement !== el && el.requestPointerLock) {
+        if (document.pointerLockElement === el || !el.requestPointerLock) return;
+        // Request RAW mouse input (no OS pointer acceleration) where supported —
+        // acceleration on a high-res mouse amplifies micro-bursts into spurious
+        // `movementX` spikes (the camera-snap source). Browsers that don't
+        // support the option reject/throw; fall back to a plain lock.
+        let p;
+        try {
+            p = el.requestPointerLock({ unadjustedMovement: true });
+        } catch (e) {
             el.requestPointerLock();
+            return;
+        }
+        if (p && typeof p.catch === "function") {
+            p.catch(() => { el.requestPointerLock(); });
         }
     });
 

package/src/engine/ecs/sockets/serialization/AttachmentSocketsAssetLoader.d.ts

@@ -1,6 +1,6 @@
 export class AttachmentSocketsAssetLoader extends AssetLoader<any, any> {
     constructor();
-    load(scope: any, path: any, success: any, failure: any, progress: any): void;
+    load(scope: any, path: any, success: any, failure: any, progress: any): Promise<void>;
 }
 import { AssetLoader } from "../../../asset/loaders/AssetLoader.js";
 //# sourceMappingURL=AttachmentSocketsAssetLoader.d.ts.map

package/src/engine/ecs/sockets/serialization/AttachmentSocketsAssetLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AttachmentSocketsAssetLoader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/sockets/serialization/AttachmentSocketsAssetLoader.js"],"names":[],"mappings":"AAKA;;IACI,6EAcC;CACJ;4BArB2B,uCAAuC"}
+{"version":3,"file":"AttachmentSocketsAssetLoader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/sockets/serialization/AttachmentSocketsAssetLoader.js"],"names":[],"mappings":"AAKA;;IACI,sFAWC;CACJ;4BAlB2B,uCAAuC"}

package/src/engine/ecs/sockets/serialization/AttachmentSocketsAssetLoader.js

@@ -1,22 +1,19 @@
-import { AssetLoader } from "../../../asset/loaders/AssetLoader.js";
-import { GameAssetType } from "../../../asset/GameAssetType.js";
-import { AttachmentSockets } from "../AttachmentSockets.js";
-import { Asset } from "../../../asset/Asset.js";
-
-export class AttachmentSocketsAssetLoader extends AssetLoader {
-    load(scope, path, success, failure, progress) {
-
-        this.assetManager.promise(path, GameAssetType.JSON, { scope })
-            .then(asset => {
-
-                const json = asset.create();
-
-                const a = new Asset(() => {
-                    return AttachmentSockets.fromJSON(json);
-                }, 1);
-
-                success(a);
-            }, failure);
-
-    }
-}
+import { AssetLoader } from "../../../asset/loaders/AssetLoader.js";
+import { GameAssetType } from "../../../asset/GameAssetType.js";
+import { AttachmentSockets } from "../AttachmentSockets.js";
+import { Asset } from "../../../asset/Asset.js";
+
+export class AttachmentSocketsAssetLoader extends AssetLoader {
+    async load(scope, path, success, failure, progress) {
+
+        const asset = await this.assetManager.promise(path, GameAssetType.JSON, { scope, progress });
+
+        const json = asset.create();
+
+        const a = new Asset(() => {
+            return AttachmentSockets.fromJSON(json);
+        }, 1);
+
+        success(a);
+    }
+}

package/src/engine/graphics/FrameThrottle.d.ts

@@ -1,8 +1,2 @@
-/**
- * Wraps a function in {@link window.requestAnimationFrame}
- * @param {function} original
- * @param {*} [thisArg]
- * @returns {function} proxy which will call the original at most once per frame
- */
-export function frameThrottle(original: Function, thisArg?: any): Function;
+export { frameThrottle } from "../../core/function/frameThrottle.js";
 //# sourceMappingURL=FrameThrottle.d.ts.map

package/src/engine/graphics/FrameThrottle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FrameThrottle.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics/FrameThrottle.js"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,2EAgBC"}
+{"version":3,"file":"FrameThrottle.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics/FrameThrottle.js"],"names":[],"mappings":""}

package/src/engine/graphics/FrameThrottle.js

@@ -1,24 +1,2 @@
-
-/**
- * Wraps a function in {@link window.requestAnimationFrame}
- * @param {function} original
- * @param {*} [thisArg]
- * @returns {function} proxy which will call the original at most once per frame
- */
-export function frameThrottle(original, thisArg) {
-    let pending = false;
-
-    function wrap() {
-        pending = false;
-        original.call(thisArg);
-    }
-
-    function proxy() {
-        if (!pending) {
-            pending = true;
-            requestAnimationFrame(wrap);
-        }
-    }
-
-    return proxy;
-}
+// Re-export for path compatibility; implementation lives in core/function/frameThrottle.js
+export { frameThrottle } from "../../core/function/frameThrottle.js";

package/src/engine/graphics/camera/testClippingPlaneComputation.js

@@ -73,7 +73,7 @@ function makeConfig(engine) {
         new ScriptSystem(),
         new FacingDirectionSystem(),
         new PathFollowingSystem(),
-        new SoundEmitterSystem(assetManager, sound.destination, sound.context),
+        new SoundEmitterSystem(assetManager, sound),
         new SoundControllerSystem(),
         new SoundListenerSystem(sound.context),
         new TimerSystem(),

package/src/{core/geom/3d/shape/util → engine/graphics/debug}/shape_to_visual_entity.d.ts

@@ -6,5 +6,5 @@
  */
 export function shape_to_visual_entity(shape: AbstractShape3D, ecd: EntityComponentDataset): Entity;
 export const SHAPE_VISUAL_ENTITY_TAG: "util/vis/Shape3D";
-import Entity from "../../../../../engine/ecs/Entity.js";
+import Entity from "../../ecs/Entity.js";
 //# sourceMappingURL=shape_to_visual_entity.d.ts.map

package/src/engine/graphics/debug/shape_to_visual_entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape_to_visual_entity.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/debug/shape_to_visual_entity.js"],"names":[],"mappings":"AA4IA;;;;;GAKG;AACH,6FAFa,MAAM,CAclB;AAlID,yDAA0D;mBAnBvC,qBAAqB"}

package/src/{core/geom/3d/shape/util → engine/graphics/debug}/shape_to_visual_entity.js

@@ -1,159 +1,159 @@
-import { LineBasicMaterial } from "three";
-import { makeHelperBoxGeometry } from "../../../../../../editor/process/symbolic/makeHelperBoxGeometry.js";
-import { makeHelperSphereGeometry } from "../../../../../../editor/process/symbolic/makeHelperSphereGeometry.js";
-import { Attachment } from "../../../../../engine/ecs/attachment/Attachment.js";
-import Tag from "../../../../../engine/ecs/components/Tag.js";
-import Entity from "../../../../../engine/ecs/Entity.js";
-import { AttachmentSockets } from "../../../../../engine/ecs/sockets/AttachmentSockets.js";
-import { Transform } from "../../../../../engine/ecs/transform/Transform.js";
-import { DrawMode } from "../../../../../engine/graphics/ecs/mesh-v2/DrawMode.js";
-import { ShadedGeometry } from "../../../../../engine/graphics/ecs/mesh-v2/ShadedGeometry.js";
-import { SphereShape3D } from "../SphereShape3D.js";
-import { TransformedShape3D } from "../TransformedShape3D.js";
-import { UnionShape3D } from "../UnionShape3D.js";
-import { UnitCubeShape3D } from "../UnitCubeShape3D.js";
-
-const g_unit_sphere = makeHelperSphereGeometry(0.5, 32);
-const g_unit_cube = makeHelperBoxGeometry(1, 1, 1);
-
-const lineMaterial = new LineBasicMaterial({
-    depthTest: true,
-    depthWrite: false,
-    transparent: true,
-    linewidth: 1,
-    fog: false,
-    color: '#FFFFFF',
-    opacity: 1
-});
-
-export const SHAPE_VISUAL_ENTITY_TAG = 'util/vis/Shape3D';
-
-/**
- *
- * @param {UnionShape3D} shape
- * @param {EntityComponentDataset} ecd
- * @returns {Entity}
- */
-function composite_shape_to_entity(shape, ecd) {
-
-    const parent = new Entity();
-    parent
-        .add(new Transform())
-        .add(AttachmentSockets.fromJSON({
-            elements: [
-                {
-                    type: 0,
-                    id: 0
-                }
-            ]
-        }))
-        .build(ecd);
-
-    shape.children.forEach(c => {
-
-        const child_entity = shape_to_visual_entity(c, ecd);
-
-        child_entity.add(Attachment.fromJSON({
-            socket: 0,
-            parent: parent.id,
-            immediate: true
-        }));
-
-    })
-
-    return parent;
-}
-
-
-/**
- *
- * @param {UnitCubeShape3D} shape
- * @param {EntityComponentDataset} ecd
- * @returns {Entity}
- */
-function cube_shape_to_entity(shape, ecd) {
-    const eb = new Entity();
-
-    eb.add(new Transform());
-    eb.add(Tag.fromOne(SHAPE_VISUAL_ENTITY_TAG));
-    eb.add(ShadedGeometry.from(g_unit_cube, lineMaterial, DrawMode.LineSegments));
-
-    eb.build(ecd);
-
-    return eb;
-}
-
-
-/**
- *
- * @param {UnitSphereShape3D} shape
- * @param {EntityComponentDataset} ecd
- * @returns {Entity}
- */
-function sphere_shape_to_entity(shape, ecd) {
-    const eb = new Entity();
-
-    eb.add(new Transform());
-    eb.add(Tag.fromOne(SHAPE_VISUAL_ENTITY_TAG));
-    eb.add(ShadedGeometry.from(g_unit_sphere, lineMaterial, DrawMode.Lines));
-
-    eb.build(ecd);
-
-    return eb;
-
-}
-
-/**
- *
- * @param {TransformedShape3D} shape
- * @param {EntityComponentDataset} ecd
- * @returns {Entity}
- */
-function transformed_shape_to_entity(shape, ecd) {
-    const subject = shape_to_visual_entity(shape.subject, ecd);
-
-    const parent = new Entity();
-    parent
-        .add(new Transform())
-        .add(AttachmentSockets.fromJSON({
-            elements: [
-                {
-                    type: 0,
-                    id: 0
-                }
-            ]
-        }))
-        .build(ecd);
-
-    const attachment = Attachment.fromJSON({
-        socket: 0,
-        parent: parent.id,
-        immediate: true
-    });
-
-    attachment.transform.fromMatrix(shape.transform);
-
-    subject.add(attachment);
-
-    return parent;
-}
-
-/**
- *
- * @param {AbstractShape3D} shape
- * @param {EntityComponentDataset} ecd
- * @returns {Entity}
- */
-export function shape_to_visual_entity(shape, ecd) {
-    if (shape instanceof UnionShape3D) {
-        return composite_shape_to_entity(shape, ecd);
-    } else if (shape instanceof UnitCubeShape3D) {
-        return cube_shape_to_entity(shape, ecd);
-    } else if (shape instanceof SphereShape3D) {
-        return sphere_shape_to_entity(shape, ecd);
-    } else if (shape instanceof TransformedShape3D) {
-        return transformed_shape_to_entity(shape, ecd);
-    } else {
-        throw new Error('Unsupported shape type');
-    }
-}
+import { LineBasicMaterial } from "three";
+import { makeHelperBoxGeometry } from "../../../../editor/process/symbolic/makeHelperBoxGeometry.js";
+import { makeHelperSphereGeometry } from "../../../../editor/process/symbolic/makeHelperSphereGeometry.js";
+import { SphereShape3D } from "../../../core/geom/3d/shape/SphereShape3D.js";
+import { TransformedShape3D } from "../../../core/geom/3d/shape/TransformedShape3D.js";
+import { UnionShape3D } from "../../../core/geom/3d/shape/UnionShape3D.js";
+import { UnitCubeShape3D } from "../../../core/geom/3d/shape/UnitCubeShape3D.js";
+import { Attachment } from "../../ecs/attachment/Attachment.js";
+import Tag from "../../ecs/components/Tag.js";
+import Entity from "../../ecs/Entity.js";
+import { AttachmentSockets } from "../../ecs/sockets/AttachmentSockets.js";
+import { Transform } from "../../ecs/transform/Transform.js";
+import { DrawMode } from "../ecs/mesh-v2/DrawMode.js";
+import { ShadedGeometry } from "../ecs/mesh-v2/ShadedGeometry.js";
+
+const g_unit_sphere = makeHelperSphereGeometry(0.5, 32);
+const g_unit_cube = makeHelperBoxGeometry(1, 1, 1);
+
+const lineMaterial = new LineBasicMaterial({
+    depthTest: true,
+    depthWrite: false,
+    transparent: true,
+    linewidth: 1,
+    fog: false,
+    color: '#FFFFFF',
+    opacity: 1
+});
+
+export const SHAPE_VISUAL_ENTITY_TAG = 'util/vis/Shape3D';
+
+/**
+ *
+ * @param {UnionShape3D} shape
+ * @param {EntityComponentDataset} ecd
+ * @returns {Entity}
+ */
+function composite_shape_to_entity(shape, ecd) {
+
+    const parent = new Entity();
+    parent
+        .add(new Transform())
+        .add(AttachmentSockets.fromJSON({
+            elements: [
+                {
+                    type: 0,
+                    id: 0
+                }
+            ]
+        }))
+        .build(ecd);
+
+    shape.children.forEach(c => {
+
+        const child_entity = shape_to_visual_entity(c, ecd);
+
+        child_entity.add(Attachment.fromJSON({
+            socket: 0,
+            parent: parent.id,
+            immediate: true
+        }));
+
+    })
+
+    return parent;
+}
+
+
+/**
+ *
+ * @param {UnitCubeShape3D} shape
+ * @param {EntityComponentDataset} ecd
+ * @returns {Entity}
+ */
+function cube_shape_to_entity(shape, ecd) {
+    const eb = new Entity();
+
+    eb.add(new Transform());
+    eb.add(Tag.fromOne(SHAPE_VISUAL_ENTITY_TAG));
+    eb.add(ShadedGeometry.from(g_unit_cube, lineMaterial, DrawMode.LineSegments));
+
+    eb.build(ecd);
+
+    return eb;
+}
+
+
+/**
+ *
+ * @param {UnitSphereShape3D} shape
+ * @param {EntityComponentDataset} ecd
+ * @returns {Entity}
+ */
+function sphere_shape_to_entity(shape, ecd) {
+    const eb = new Entity();
+
+    eb.add(new Transform());
+    eb.add(Tag.fromOne(SHAPE_VISUAL_ENTITY_TAG));
+    eb.add(ShadedGeometry.from(g_unit_sphere, lineMaterial, DrawMode.Lines));
+
+    eb.build(ecd);
+
+    return eb;
+
+}
+
+/**
+ *
+ * @param {TransformedShape3D} shape
+ * @param {EntityComponentDataset} ecd
+ * @returns {Entity}
+ */
+function transformed_shape_to_entity(shape, ecd) {
+    const subject = shape_to_visual_entity(shape.subject, ecd);
+
+    const parent = new Entity();
+    parent
+        .add(new Transform())
+        .add(AttachmentSockets.fromJSON({
+            elements: [
+                {
+                    type: 0,
+                    id: 0
+                }
+            ]
+        }))
+        .build(ecd);
+
+    const attachment = Attachment.fromJSON({
+        socket: 0,
+        parent: parent.id,
+        immediate: true
+    });
+
+    attachment.transform.fromMatrix(shape.transform);
+
+    subject.add(attachment);
+
+    return parent;
+}
+
+/**
+ *
+ * @param {AbstractShape3D} shape
+ * @param {EntityComponentDataset} ecd
+ * @returns {Entity}
+ */
+export function shape_to_visual_entity(shape, ecd) {
+    if (shape instanceof UnionShape3D) {
+        return composite_shape_to_entity(shape, ecd);
+    } else if (shape instanceof UnitCubeShape3D) {
+        return cube_shape_to_entity(shape, ecd);
+    } else if (shape instanceof SphereShape3D) {
+        return sphere_shape_to_entity(shape, ecd);
+    } else if (shape instanceof TransformedShape3D) {
+        return transformed_shape_to_entity(shape, ecd);
+    } else {
+        throw new Error('Unsupported shape type');
+    }
+}

package/src/{core/geom/3d/tetrahedra → engine/graphics/debug}/visualize_tetrahedral_mesh.d.ts

@@ -7,5 +7,5 @@
  * @returns {Entity}
  */
 export function visualize_tetrahedral_mesh({ mesh, positions, color, opacity }: TetrahedralMesh): Entity;
-import Entity from "../../../../engine/ecs/Entity.js";
+import Entity from "../../ecs/Entity.js";
 //# sourceMappingURL=visualize_tetrahedral_mesh.d.ts.map

package/src/engine/graphics/debug/visualize_tetrahedral_mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualize_tetrahedral_mesh.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/debug/visualize_tetrahedral_mesh.js"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,kGAFa,MAAM,CA8BlB;mBA1CkB,qBAAqB"}