@vworlds/vecs-physics 1.0.37 → 1.0.38

package/body/pose_out.js

@@ -0,0 +1,59 @@
+import { Module } from "@vworlds/vecs";
+import { getPhysicsEngine, PhysicsSystemTag } from "../adapter/engine.js";
+import { AngularVelocity, Body, BodyType, LinearVelocity, Position, Rotation, } from "./components.js";
+import { PhysicsCoreModule } from "../core/module.js";
+export class BodyPoseOutModule extends Module {
+    init() {
+        const world = this.world;
+        world.module(PhysicsCoreModule);
+        const engine = getPhysicsEngine(world);
+        world
+            .system("PhysicsPoseSyncOut")
+            .phase(engine.phases.postStep)
+            .run(() => {
+            const bodyEvents = engine.box2d.b2World_GetBodyEvents(engine.worldId);
+            try {
+                for (let i = 0; i < bodyEvents.moveCount; i++) {
+                    const move = bodyEvents.GetMoveEvent(i);
+                    try {
+                        const entityId = engine.entityByBodyIndex.get(move.bodyId.index1);
+                        if (entityId === undefined) {
+                            continue;
+                        }
+                        const entity = world.entity(entityId);
+                        const body = entity.get(Body);
+                        if (body?.type !== BodyType.Dynamic) {
+                            continue;
+                        }
+                        entity.set(Position, { x: move.transform.p.x, y: move.transform.p.y });
+                        if (entity.get(Rotation) !== undefined) {
+                            entity.set(Rotation, { angle: move.transform.q.GetAngle() });
+                        }
+                        if (entity.get(LinearVelocity) !== undefined) {
+                            const linear = engine.box2d.b2Body_GetLinearVelocity(move.bodyId);
+                            try {
+                                entity.set(LinearVelocity, { x: linear.x, y: linear.y });
+                            }
+                            finally {
+                                linear.delete();
+                            }
+                        }
+                        if (entity.get(AngularVelocity) !== undefined) {
+                            entity.set(AngularVelocity, {
+                                value: engine.box2d.b2Body_GetAngularVelocity(move.bodyId),
+                            });
+                        }
+                    }
+                    finally {
+                        move.delete();
+                    }
+                }
+            }
+            finally {
+                bodyEvents.delete();
+            }
+        })
+            .add(PhysicsSystemTag);
+    }
+}
+//# sourceMappingURL=pose_out.js.map

package/body/pose_out.js.map

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

package/{components/body_tuning.js → body/tuning.js}

@@ -30,4 +30,4 @@ export class Sleep {
         this.threshold = 0.05;
     }
 }
-//# sourceMappingURL=body_tuning.js.map
+//# sourceMappingURL=tuning.js.map

package/body/tuning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuning.js","sourceRoot":"","sources":["../../../../src/body/tuning.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,sEAAsE;AACtE,+DAA+D;AAE/D,2CAA2C;AAC3C,MAAM,OAAO,OAAO;IAApB;QACE,WAAM,GAAG,CAAC,CAAC;QACX,YAAO,GAAG,CAAC,CAAC;IACd,CAAC;CAAA;AAED,4CAA4C;AAC5C,MAAM,OAAO,YAAY;IAAzB;QACE,UAAK,GAAG,CAAC,CAAC;IACZ,CAAC;CAAA;AAED,oDAAoD;AACpD,MAAM,OAAO,WAAW;IAAxB;QACE,MAAC,GAAG,KAAK,CAAC;QACV,MAAC,GAAG,KAAK,CAAC;QACV,aAAQ,GAAG,KAAK,CAAC;IACnB,CAAC;CAAA;AAED,qFAAqF;AACrF,MAAM,OAAO,KAAK;IAAlB;QACE,YAAO,GAAG,IAAI,CAAC;QACf,UAAK,GAAG,IAAI,CAAC;QACb,cAAS,GAAG,IAAI,CAAC;IACnB,CAAC;CAAA"}

package/core/module.d.ts

@@ -0,0 +1,30 @@
+import { Module, type Entity } from "@vworlds/vecs";
+/** Options for {@link import("../module.js").PhysicsModule}. Every field is optional;
+ * omitted fields fall back to Box2D-aligned defaults. */
+export type PhysicsOptions = {
+    gravity?: {
+        x: number;
+        y: number;
+    };
+    fixedTimeStep?: number;
+    subSteps?: number;
+    debug?: boolean;
+    /** Override the warning sink used by `PhysicsDebugValidation` when
+     * `debug: true`. Accepts any `(message: string) => void` callback.
+     * Primarily for tests; defaults to `console.warn`. */
+    debugSink?: (message: string) => void;
+    preStepPhase?: Entity | string;
+    stepPhase?: Entity | string;
+    postStepPhase?: Entity | string;
+    restitutionThreshold?: number;
+    hitEventThreshold?: number;
+    contactHertz?: number;
+    contactDampingRatio?: number;
+    contactSpeed?: number;
+    maximumLinearSpeed?: number;
+    enableSleep?: boolean;
+    enableContinuous?: boolean;
+};
+export declare class PhysicsCoreModule extends Module<PhysicsOptions | undefined> {
+    init(options: PhysicsOptions | undefined): void;
+}

package/core/module.js

@@ -0,0 +1,77 @@
+import { insertPhaseAfter, Module, ON_UPDATE, Phase, Singleton, } from "@vworlds/vecs";
+import { hasPhysicsEngine, PhysicsEngine, PhysicsSystemTag, } from "../adapter/engine.js";
+import { withAllocated } from "../adapter/disposal.js";
+import { getBox2D } from "../adapter/runtime.js";
+const DEFAULT_PRE_STEP_PHASE = "physics-pre";
+const DEFAULT_STEP_PHASE = "physics-step";
+const DEFAULT_POST_STEP_PHASE = "physics-post";
+export class PhysicsCoreModule extends Module {
+    init(options) {
+        const world = this.world;
+        const opts = options ?? {};
+        if (hasPhysicsEngine(world)) {
+            throw new Error("PhysicsModule has already been registered on this world");
+        }
+        world.component(PhysicsEngine);
+        world.component(PhysicsSystemTag);
+        const phases = {
+            preStep: resolvePhase(world, opts.preStepPhase, DEFAULT_PRE_STEP_PHASE),
+            step: resolvePhase(world, opts.stepPhase, DEFAULT_STEP_PHASE),
+            postStep: resolvePhase(world, opts.postStepPhase, DEFAULT_POST_STEP_PHASE),
+        };
+        const updatePhase = world.entity(ON_UPDATE);
+        insertPhaseAfter(phases.preStep, updatePhase);
+        insertPhaseAfter(phases.step, phases.preStep);
+        insertPhaseAfter(phases.postStep, phases.step);
+        const box2d = getBox2D();
+        const resolved = resolveOptions(opts);
+        const engine = new PhysicsEngine(box2d, resolved, phases, opts.debugSink);
+        engine.worldId = createWorldId(engine, resolved);
+        world.component(PhysicsEngine).add(Singleton);
+        world.component(PhysicsEngine).attach(PhysicsEngine, engine);
+    }
+}
+function createWorldId(engine, options) {
+    const box2d = engine.box2d;
+    return withAllocated(box2d.b2DefaultWorldDef, (def) => {
+        def.gravity.x = options.gravityX;
+        def.gravity.y = options.gravityY;
+        def.restitutionThreshold = options.restitutionThreshold;
+        def.hitEventThreshold = options.hitEventThreshold;
+        def.contactHertz = options.contactHertz;
+        def.contactDampingRatio = options.contactDampingRatio;
+        def.maximumLinearSpeed = options.maximumLinearSpeed;
+        def.enableSleep = options.enableSleep;
+        def.enableContinuous = options.enableContinuous;
+        const worldId = box2d.b2CreateWorld(def);
+        box2d.b2World_SetContactTuning(worldId, options.contactHertz, options.contactDampingRatio, options.contactSpeed);
+        return worldId;
+    });
+}
+/** Resolve a phase placement option to a concrete phase entity. */
+function resolvePhase(world, given, defaultName) {
+    const phase = typeof given === "string" || given === undefined ? world.entity(given ?? defaultName) : given;
+    phase.add(Phase);
+    return phase;
+}
+/** Apply Box2D-aligned defaults to `opts`. */
+function resolveOptions(opts) {
+    return {
+        gravityX: opts.gravity?.x ?? 0,
+        gravityY: opts.gravity?.y ?? -10,
+        fixedTimeStep: opts.fixedTimeStep ?? 1 / 60,
+        subSteps: opts.subSteps ?? 4,
+        debug: opts.debug ?? false,
+        restitutionThreshold: opts.restitutionThreshold ?? 1.0,
+        // box2d b2DefaultWorldDef: def.hitEventThreshold = 1.0f * lengthUnits (types.c:16).
+        hitEventThreshold: opts.hitEventThreshold ?? 1.0,
+        contactHertz: opts.contactHertz ?? 30,
+        contactDampingRatio: opts.contactDampingRatio ?? 10,
+        // box2d b2DefaultWorldDef: def.contactSpeed = 3.0f * lengthUnits (types.c:18).
+        contactSpeed: opts.contactSpeed ?? 3.0,
+        maximumLinearSpeed: opts.maximumLinearSpeed ?? 400,
+        enableSleep: opts.enableSleep ?? true,
+        enableContinuous: opts.enableContinuous ?? true,
+    };
+}
+//# sourceMappingURL=module.js.map

package/core/module.js.map

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

package/core/reaper.d.ts

@@ -0,0 +1,4 @@
+import { Module } from "@vworlds/vecs";
+export declare class PhysicsReaperModule extends Module {
+    init(): void;
+}

package/core/reaper.js

@@ -0,0 +1,45 @@
+import { Module } from "@vworlds/vecs";
+import { getPhysicsEngine, PhysicsSystemTag } from "../adapter/engine.js";
+import { PhysicsCoreModule } from "./module.js";
+export class PhysicsReaperModule extends Module {
+    init() {
+        const world = this.world;
+        world.module(PhysicsCoreModule);
+        const engine = getPhysicsEngine(world);
+        world
+            .system("PhysicsReaper")
+            .phase(engine.phases.preStep)
+            .run(() => {
+            // Joints first: a body destroy below cascade-destroys its joints, so we
+            // tear down explicitly-removed joints before their bodies disappear. Guard
+            // with b2Joint_IsValid because a joint queued from a cascaded body entity
+            // may already be gone.
+            const joints = engine.pendingJointDestroys;
+            for (const jointId of joints) {
+                if (engine.box2d.b2Joint_IsValid(jointId)) {
+                    engine.box2d.b2DestroyJoint(jointId, true);
+                }
+            }
+            joints.length = 0;
+            const shapes = engine.pendingShapeDestroys;
+            for (const shapeId of shapes) {
+                engine.entityByShapeIndex.delete(shapeId.index1);
+                engine.box2d.b2DestroyShape(shapeId, true);
+            }
+            shapes.length = 0;
+            const chains = engine.pendingChainDestroys;
+            for (const chainId of chains) {
+                engine.box2d.b2DestroyChain(chainId);
+            }
+            chains.length = 0;
+            const bodies = engine.pendingBodyDestroys;
+            for (const bodyId of bodies) {
+                engine.entityByBodyIndex.delete(bodyId.index1);
+                engine.box2d.b2DestroyBody(bodyId);
+            }
+            bodies.length = 0;
+        })
+            .add(PhysicsSystemTag);
+    }
+}
+//# sourceMappingURL=reaper.js.map

package/core/reaper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reaper.js","sourceRoot":"","sources":["../../../../src/core/reaper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,OAAO,mBAAoB,SAAQ,MAAM;IACtC,IAAI;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAEhC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,KAAK;aACF,MAAM,CAAC,eAAe,CAAC;aACvB,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;aAC5B,GAAG,CAAC,GAAG,EAAE;YACR,wEAAwE;YACxE,2EAA2E;YAC3E,0EAA0E;YAC1E,uBAAuB;YACvB,MAAM,MAAM,GAAG,MAAM,CAAC,oBAAoB,CAAC;YAC3C,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;gBAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1C,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;YACD,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YAElB,MAAM,MAAM,GAAG,MAAM,CAAC,oBAAoB,CAAC;YAC3C,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;gBAC7B,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACjD,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YAElB,MAAM,MAAM,GAAG,MAAM,CAAC,oBAAoB,CAAC;YAC3C,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;gBAC7B,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YAElB,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC;YAC1C,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;gBAC5B,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC/C,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC;YACD,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACpB,CAAC,CAAC;aACD,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/core/step.d.ts

@@ -0,0 +1,4 @@
+import { Module } from "@vworlds/vecs";
+export declare class PhysicsStepModule extends Module {
+    init(): void;
+}

package/core/step.js

@@ -0,0 +1,22 @@
+import { Module } from "@vworlds/vecs";
+import { getPhysicsEngine, PhysicsSystemTag } from "../adapter/engine.js";
+import { PhysicsCoreModule } from "./module.js";
+export class PhysicsStepModule extends Module {
+    init() {
+        const world = this.world;
+        world.module(PhysicsCoreModule);
+        const engine = getPhysicsEngine(world);
+        world
+            .system("PhysicsStep")
+            .phase(engine.phases.step)
+            .run((_now, delta) => {
+            if (engine.debug && Math.abs(delta / 1000 - engine.fixedTimeStep) > 1e-4) {
+                engine.warn.warnOnce(0, "delta-mismatch", `frame delta ${delta}ms does not match fixedTimeStep ${engine.fixedTimeStep * 1000}ms; ` +
+                    `physics expects a fixed delta.`);
+            }
+            engine.box2d.b2World_Step(engine.worldId, engine.fixedTimeStep, engine.subSteps);
+        })
+            .add(PhysicsSystemTag);
+    }
+}
+//# sourceMappingURL=step.js.map

package/core/step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../../../../src/core/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,OAAO,iBAAkB,SAAQ,MAAM;IACpC,IAAI;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAEhC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,KAAK;aACF,MAAM,CAAC,aAAa,CAAC;aACrB,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;aACzB,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACnB,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,EAAE,CAAC;gBACzE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAClB,CAAC,EACD,gBAAgB,EAChB,eAAe,KAAK,mCAAmC,MAAM,CAAC,aAAa,GAAG,IAAI,MAAM;oBACtF,gCAAgC,CACnC,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnF,CAAC,CAAC;aACD,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/debug/validation.d.ts

@@ -0,0 +1,4 @@
+import { Module } from "@vworlds/vecs";
+export declare class DebugModule extends Module {
+    init(): void;
+}

package/{systems/debug.js → debug/validation.js}

@@ -40,13 +40,18 @@
 //
 // Upstream docs: docs/debug-validation.md.
 // Polygon validity is checked via b2ComputeHull (box2d3-wasm); see isValidPolygon.
-import { ArrayMap, ChildOf } from "@vworlds/vecs";
-import { Body, BodyType, Position } from "../components/body.js";
-import { AngularImpulse, Force, Impulse, Torque } from "../components/force.js";
-import { Chain, Polygon, Shape } from "../components/geometry.js";
-import { Material } from "../components/material.js";
-import { ShapePosition, ShapeRotation } from "../components/shape_pose.js";
-import { PhysicsSystemTag } from "../adapter/engine.js";
+import { ArrayMap, ChildOf, Module } from "@vworlds/vecs";
+import { getPhysicsEngine, PhysicsSystemTag } from "../adapter/engine.js";
+import { Body, BodyType, Position } from "../body/components.js";
+import { BodyModule } from "../body/module.js";
+import { PhysicsCoreModule } from "../core/module.js";
+import { AngularImpulse, Force, Impulse, Torque } from "../forces/components.js";
+import { ForcesModule } from "../forces/module.js";
+import { Chain, Polygon, Shape } from "../shapes/components.js";
+import { ShapesModule } from "../shapes/module.js";
+import { Material } from "../materials/components.js";
+import { MaterialsModule } from "../materials/module.js";
+import { ShapePosition, ShapeRotation } from "../shapes/pose_components.js";
 // ─── Issue codes ──────────────────────────────────────────────────────────────
 const CODE_SHAPE_WITHOUT_PARENT_BODY = "shape-without-parent-body";
 const CODE_DYNAMIC_BODY_WITHOUT_DENSITY = "dynamic-body-without-density";
@@ -56,33 +61,44 @@ const CODE_SHAPE_POSITION_ON_BODY = "shape-position-on-body";
 const CODE_POSITION_ON_SHAPE_ENTITY = "position-on-shape-entity";
 const CODE_FORCE_WITHOUT_TARGET = "force-without-target";
 // ─── System factory ───────────────────────────────────────────────────────────
-/** Create `PhysicsDebugValidation` on `world` in `phase`. */
-export function installDebugValidation(world, engine, phase) {
-    // ── Filters (non-reactive; walked every step) ─────────────────────────────
-    // Geometry entities: any entity with at least one geometry component.
-    const geomFilter = world.filter(Shape);
-    // Body entities: any entity with Body.
-    const bodyFilter = world.filter(Body);
-    // Force-class entities: any entity with a force, torque, impulse, or angular impulse.
-    const forceFilter = world.filter({ any: [Force, Torque, Impulse, AngularImpulse] });
-    // Body entities that also carry ShapePosition or ShapeRotation.
-    const bodyPoseFilter = world.filter({
-        all: [Body, { any: [ShapePosition, ShapeRotation] }],
-    });
-    // Track body-pose entities seen in the previous step so we can rearm those
-    // that leave the filter (ShapePosition/ShapeRotation removed). Re-entry into
-    // the filter will then produce a fresh warning, completing the re-arm cycle.
-    const prevBodyPoseEids = new Set();
-    const system = world
-        .system("PhysicsDebugValidation")
-        .phase(phase)
-        .run(() => {
-        _validateGeomEntities(engine, geomFilter, engine.warn);
-        _validateBodyEntities(geomFilter, bodyFilter, engine.warn);
-        _validateBodyShapePositionEntities(bodyPoseFilter, prevBodyPoseEids, engine.warn);
-        _validateForceEntities(forceFilter, engine.warn);
-    });
-    system.entity.add(PhysicsSystemTag);
+export class DebugModule extends Module {
+    init() {
+        const world = this.world;
+        world.module(PhysicsCoreModule);
+        world.module(BodyModule);
+        world.module(ShapesModule);
+        world.module(MaterialsModule);
+        world.module(ForcesModule);
+        const engine = getPhysicsEngine(world);
+        if (!engine.debug) {
+            return;
+        }
+        // ── Filters (non-reactive; walked every step) ─────────────────────────────
+        // Geometry entities: any entity with at least one geometry component.
+        const geomFilter = world.filter(Shape);
+        // Body entities: any entity with Body.
+        const bodyFilter = world.filter(Body);
+        // Force-class entities: any entity with a force, torque, impulse, or angular impulse.
+        const forceFilter = world.filter({ any: [Force, Torque, Impulse, AngularImpulse] });
+        // Body entities that also carry ShapePosition or ShapeRotation.
+        const bodyPoseFilter = world.filter({
+            all: [Body, { any: [ShapePosition, ShapeRotation] }],
+        });
+        // Track body-pose entities seen in the previous step so we can rearm those
+        // that leave the filter (ShapePosition/ShapeRotation removed). Re-entry into
+        // the filter will then produce a fresh warning, completing the re-arm cycle.
+        const prevBodyPoseEids = new Set();
+        world
+            .system("PhysicsDebugValidation")
+            .phase(engine.phases.preStep)
+            .run(() => {
+            _validateGeomEntities(engine, geomFilter, engine.warn);
+            _validateBodyEntities(geomFilter, bodyFilter, engine.warn);
+            _validateBodyShapePositionEntities(bodyPoseFilter, prevBodyPoseEids, engine.warn);
+            _validateForceEntities(forceFilter, engine.warn);
+        })
+            .add(PhysicsSystemTag);
+    }
 }
 // ─── Geometry-entity validation ───────────────────────────────────────────────
 /** Walk every entity with a geometry component and check:
@@ -265,4 +281,4 @@ function _validateForceEntities(forceFilter, dedupe) {
         }
     });
 }
-//# sourceMappingURL=debug.js.map
+//# sourceMappingURL=validation.js.map

package/debug/validation.js.map

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

package/{components/events.js → events/components.js}

@@ -22,4 +22,4 @@ export class HitEvents {
         this.hits = [];
     }
 }
-//# sourceMappingURL=events.js.map
+//# sourceMappingURL=components.js.map

package/events/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../../../src/events/components.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,+EAA+E;AAC/E,+EAA+E;AAC/E,yDAAyD;AAwBzD,mFAAmF;AACnF,MAAM,OAAO,aAAa;IAA1B;QACE,UAAK,GAAmB,EAAE,CAAC;QAC3B,QAAG,GAAmB,EAAE,CAAC;IAC3B,CAAC;CAAA;AAED,kDAAkD;AAClD,MAAM,OAAO,YAAY;IAAzB;QACE,UAAK,GAAkB,EAAE,CAAC;QAC1B,QAAG,GAAkB,EAAE,CAAC;IAC1B,CAAC;CAAA;AAED,6DAA6D;AAC7D,MAAM,OAAO,SAAS;IAAtB;QACE,SAAI,GAAe,EAAE,CAAC;IACxB,CAAC;CAAA"}

package/events/module.d.ts

@@ -0,0 +1,4 @@
+import { Module } from "@vworlds/vecs";
+export declare class EventsModule extends Module {
+    init(): void;
+}

package/events/module.js

@@ -0,0 +1,13 @@
+import { Module } from "@vworlds/vecs";
+import { PhysicsCoreModule } from "../core/module.js";
+import { ContactEvents, HitEvents, SensorEvents } from "./components.js";
+export class EventsModule extends Module {
+    init() {
+        const world = this.world;
+        world.module(PhysicsCoreModule);
+        world.component(ContactEvents);
+        world.component(SensorEvents);
+        world.component(HitEvents);
+    }
+}
+//# sourceMappingURL=module.js.map

package/events/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../../src/events/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEzE,MAAM,OAAO,YAAa,SAAQ,MAAM;IAC/B,IAAI;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAEhC,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC/B,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC9B,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/events/opt_in.d.ts

@@ -0,0 +1,4 @@
+import { Module } from "@vworlds/vecs";
+export declare class EventOptInModule extends Module {
+    init(): void;
+}

package/events/opt_in.js

@@ -0,0 +1,86 @@
+import { ChildOf, Iter, Module } from "@vworlds/vecs";
+import { getPhysicsEngine, PhysicsSystemTag, } from "../adapter/engine.js";
+import { Body } from "../body/components.js";
+import { Chain, SingleShape } from "../shapes/components.js";
+import { ContactEvents, HitEvents, SensorEvents } from "./components.js";
+import { Detectable } from "../materials/components.js";
+import { PhysicsCoreModule } from "../core/module.js";
+import { MaterialsModule } from "../materials/module.js";
+import { recreateChainForEntity } from "../shapes/chain.js";
+import { ShapesModule } from "../shapes/module.js";
+import { chainWithBodyParent } from "../shapes/predicates.js";
+import { EventsModule } from "./module.js";
+export class EventOptInModule extends Module {
+    init() {
+        const world = this.world;
+        world.module(PhysicsCoreModule);
+        world.module(ShapesModule);
+        world.module(MaterialsModule);
+        world.module(EventsModule);
+        const engine = getPhysicsEngine(world);
+        const phase = engine.phases.preStep;
+        world.component(ContactEvents).onAdd((entity) => setEventFlag(engine, entity, "contact", true));
+        world
+            .component(ContactEvents)
+            .onRemove((entity) => setEventFlag(engine, entity, "contact", false));
+        world.component(HitEvents).onAdd((entity) => setEventFlag(engine, entity, "hit", true));
+        world.component(HitEvents).onRemove((entity) => setEventFlag(engine, entity, "hit", false));
+        // Sensor detection: enable if SensorEvents OR Detectable is present.
+        // Query only single b2Shape geometries; chains have no runtime sensor-event
+        // setter and are recreated by the chain opt-in system below.
+        world
+            .system("PhysicsEventOptInSync:Sensor")
+            .with({ all: [SingleShape, { any: [SensorEvents, Detectable] }] })
+            .phase(phase)
+            .add(PhysicsSystemTag)
+            .enter([SingleShape], (_e, [shape]) => {
+            const shapeId = shape._shapeId;
+            if (shapeId !== undefined) {
+                engine.box2d.b2Shape_EnableSensorEvents(shapeId, true);
+            }
+        })
+            .exit([SingleShape], (_e, [shape]) => {
+            const shapeId = shape._shapeId;
+            // No stale-id guard needed: PhysicsReaper runs after this system, so a
+            // destroyed shape is still live (and not yet slot-recycled) here.
+            if (shapeId !== undefined) {
+                engine.box2d.b2Shape_EnableSensorEvents(shapeId, false);
+            }
+        });
+        world
+            .system("PhysicsEventOptInSync:ChainSensor")
+            .with({ all: [Chain, { any: [SensorEvents, Detectable] }] }, chainWithBodyParent)
+            .phase(phase)
+            .add(PhysicsSystemTag)
+            .enter({ cursor: Iter, inject: [Chain, { target: [ChildOf, [Body]] }] }, (it, [chain, body]) => {
+            recreateChainForEntity(engine, it.entity, it.src[1], body, chain);
+        })
+            .exit((entity) => {
+            const chain = entity.get(Chain);
+            const parent = entity.parent;
+            recreateChainForEntity(engine, entity, parent, parent?.get(Body), chain);
+        });
+    }
+}
+function setEventFlag(engine, entity, flag, enabled) {
+    const shape = entity.get(SingleShape);
+    if (shape !== undefined) {
+        const shapeId = shape._shapeId;
+        // No stale-id guard: with deferred teardown the shape's slot is never freed
+        // mid-pass, so this contact/hit setter never lands on a recycled slot.
+        if (shapeId !== undefined) {
+            applyEventFlag(engine, shapeId, flag, enabled);
+        }
+    }
+}
+function applyEventFlag(engine, shapeId, flag, enabled) {
+    switch (flag) {
+        case "contact":
+            engine.box2d.b2Shape_EnableContactEvents(shapeId, enabled);
+            break;
+        case "hit":
+            engine.box2d.b2Shape_EnableHitEvents(shapeId, enabled);
+            break;
+    }
+}
+//# sourceMappingURL=opt_in.js.map

package/events/opt_in.js.map

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

package/events/publish.d.ts

@@ -0,0 +1,4 @@
+import { Module } from "@vworlds/vecs";
+export declare class EventPublishModule extends Module {
+    init(): void;
+}