@vworlds/vecs-physics 1.0.16

package/adapter/disposal.d.ts

@@ -0,0 +1,8 @@
+export interface EmscriptenAllocated {
+    delete(): void;
+}
+/**
+ * Every `new b2Xxx()` or factory allocation inside `src/adapter/` must use this
+ * helper, or an explicit try/finally `.delete()` in the same function.
+ */
+export declare function withAllocated<TAllocated extends EmscriptenAllocated, TResult>(make: () => TAllocated, use: (allocated: TAllocated) => TResult): TResult;

package/adapter/disposal.js

@@ -0,0 +1,14 @@
+/**
+ * Every `new b2Xxx()` or factory allocation inside `src/adapter/` must use this
+ * helper, or an explicit try/finally `.delete()` in the same function.
+ */
+export function withAllocated(make, use) {
+    const allocated = make();
+    try {
+        return use(allocated);
+    }
+    finally {
+        allocated.delete();
+    }
+}
+//# sourceMappingURL=disposal.js.map

package/adapter/disposal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposal.js","sourceRoot":"","sources":["../../../../src/adapter/disposal.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAsB,EACtB,GAAuC;IAEvC,MAAM,SAAS,GAAG,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,MAAM,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/adapter/runtime.d.ts

@@ -0,0 +1,4 @@
+import Box2DFactory from "box2d3-wasm";
+export type Box2DModule = Awaited<ReturnType<typeof Box2DFactory>>;
+export declare function preloadPhysics(): Promise<void>;
+export declare function getBox2D(): Box2DModule;

package/adapter/runtime.js

@@ -0,0 +1,27 @@
+import { cpus } from "node:os";
+import Box2DFactory from "box2d3-wasm";
+let modulePromise = null;
+let module = null;
+export async function preloadPhysics() {
+    var _a;
+    if (modulePromise) {
+        await modulePromise;
+        return;
+    }
+    // box2d3-wasm reads navigator.hardwareConcurrency during Node initialization.
+    const global = globalThis;
+    global.navigator ?? (global.navigator = {});
+    (_a = global.navigator).hardwareConcurrency ?? (_a.hardwareConcurrency = cpus().length);
+    modulePromise = Box2DFactory().then((loadedModule) => {
+        module = loadedModule;
+        return loadedModule;
+    });
+    await modulePromise;
+}
+export function getBox2D() {
+    if (!module) {
+        throw new Error("Box2D module not loaded. Call `await preloadPhysics()` before `installPhysics()`.");
+    }
+    return module;
+}
+//# sourceMappingURL=runtime.js.map

package/adapter/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../../src/adapter/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,YAAY,MAAM,aAAa,CAAC;AAIvC,IAAI,aAAa,GAAgC,IAAI,CAAC;AACtD,IAAI,MAAM,GAAuB,IAAI,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,cAAc;;IAClC,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,aAAa,CAAC;QACpB,OAAO;IACT,CAAC;IAED,8EAA8E;IAC9E,MAAM,MAAM,GAAG,UAA2D,CAAC;IAC3E,MAAM,CAAC,SAAS,KAAhB,MAAM,CAAC,SAAS,GAAK,EAAE,EAAC;IACxB,MAAC,MAAM,CAAC,SAA8C,EAAC,mBAAmB,QAAnB,mBAAmB,GAAK,IAAI,EAAE,CAAC,MAAM,EAAC;IAE7F,aAAa,GAAG,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE;QACnD,MAAM,GAAG,YAAY,CAAC;QACtB,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC,CAAC;IACH,MAAM,aAAa,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/adapter/state.d.ts

@@ -0,0 +1,79 @@
+import { ArrayMap, type Entity, type World } from "@vworlds/vecs";
+import { type WarnSink, WarnDedupe } from "../util/warn.js";
+import { type Box2DModule } from "./runtime.js";
+export type EntityId = number;
+export type b2WorldId = ReturnType<Box2DModule["b2CreateWorld"]>;
+export type b2BodyId = ReturnType<Box2DModule["b2CreateBody"]>;
+export type b2ShapeId = ReturnType<Box2DModule["b2CreateCircleShape"]>;
+export type b2ChainId = ReturnType<Box2DModule["b2CreateChain"]>;
+export type b2Vec2 = ReturnType<Box2DModule["b2Body_GetPosition"]>;
+/** Fully-resolved engine configuration: every `PhysicsOptions` field with its
+ * default applied. Built by `installPhysics`; the source of truth for tunables
+ * the engine reads at runtime. */
+export interface ResolvedPhysicsOptions {
+    gravityX: number;
+    gravityY: number;
+    fixedTimeStep: number;
+    subSteps: number;
+    debug: boolean;
+    restitutionThreshold: number;
+    hitEventThreshold: number;
+    contactHertz: number;
+    contactDampingRatio: number;
+    contactSpeed: number;
+    maximumLinearSpeed: number;
+    enableSleep: boolean;
+    enableContinuous: boolean;
+}
+/** Internal marker tagging every physics **system entity** (systems are entities
+ * in Vecs). `PhysicsPoseSyncIn.ignoreSource([PhysicsSystemTag])` uses it as a
+ * silence domain so the engine's own pose write-back is never mistaken for a
+ * user teleport. Never exported from the package public API and only ever lives
+ * on system entities, so it adds zero per-entity archetype churn. */
+export declare class PhysicsSystemTag {
+}
+export declare function registerInternalComponents(world: World): void;
+export declare function attachPhysics(world: World, state: PhysicsState): void;
+export declare function getPhysics(world: World): PhysicsState;
+export declare function hasPhysics(world: World): boolean;
+export declare class PhysicsState {
+    worldId: b2WorldId;
+    readonly box2d: Box2DModule;
+    readonly options: ResolvedPhysicsOptions;
+    readonly gravityX: number;
+    readonly gravityY: number;
+    readonly fixedTimeStep: number;
+    readonly subSteps: number;
+    readonly debug: boolean;
+    readonly warn: WarnDedupe;
+    readonly restitutionThreshold: number;
+    readonly hitEventThreshold: number;
+    readonly contactHertz: number;
+    readonly contactDampingRatio: number;
+    readonly contactSpeed: number;
+    readonly maximumLinearSpeed: number;
+    readonly enableSleep: boolean;
+    readonly enableContinuous: boolean;
+    readonly bodyByEntityWasm: Map<number, import("node_modules/box2d3-wasm/build/dist/es/deluxe/Box2D.deluxe.js").b2BodyId>;
+    readonly entityByBodyIndex: ArrayMap<number>;
+    readonly shapeByEntityWasm: Map<number, import("node_modules/box2d3-wasm/build/dist/es/deluxe/Box2D.deluxe.js").b2ShapeId>;
+    readonly entityByShapeIndex: ArrayMap<number>;
+    readonly chainByEntity: Map<number, import("node_modules/box2d3-wasm/build/dist/es/deluxe/Box2D.deluxe.js").b2ChainId>;
+    readonly shapeEntityByEid: Map<number, Entity>;
+    readonly dirtyMassBodies: Set<number>;
+    readonly prevTouchedContact: Set<number>;
+    readonly prevTouchedSensor: Set<number>;
+    readonly prevTouchedHit: Set<number>;
+    readonly impulseEntitiesThisStep: Set<number>;
+    readonly pendingLinearImpulse: Map<import("node_modules/box2d3-wasm/build/dist/es/deluxe/Box2D.deluxe.js").b2BodyId, {
+        x: number;
+        y: number;
+        wake: boolean;
+    }>;
+    readonly pendingAngularImpulse: Map<import("node_modules/box2d3-wasm/build/dist/es/deluxe/Box2D.deluxe.js").b2BodyId, {
+        value: number;
+        wake: boolean;
+    }>;
+    readonly scratchVec2: b2Vec2;
+    constructor(box2d: Box2DModule, options: ResolvedPhysicsOptions, warnSink?: WarnSink);
+}

package/adapter/state.js

@@ -0,0 +1,89 @@
+import { ArrayMap, Singleton } from "@vworlds/vecs";
+import { WarnDedupe } from "../util/warn.js";
+/** Internal marker tagging every physics **system entity** (systems are entities
+ * in Vecs). `PhysicsPoseSyncIn.ignoreSource([PhysicsSystemTag])` uses it as a
+ * silence domain so the engine's own pose write-back is never mistaken for a
+ * user teleport. Never exported from the package public API and only ever lives
+ * on system entities, so it adds zero per-entity archetype churn. */
+export class PhysicsSystemTag {
+}
+export function registerInternalComponents(world) {
+    world.component(PhysicsRoot);
+    world.component(PhysicsSystemTag);
+}
+export function attachPhysics(world, state) {
+    world.component(PhysicsRoot).add(Singleton);
+    world.set(PhysicsRoot, { state });
+}
+export function getPhysics(world) {
+    const root = world.get(PhysicsRoot);
+    if (!root) {
+        throw new Error("installPhysics(world, ...) must be called before world.start()");
+    }
+    return root.state;
+}
+export function hasPhysics(world) {
+    if (!world._classRegistry.has(PhysicsRoot)) {
+        return false;
+    }
+    const root = world.get(PhysicsRoot);
+    return root?.state !== undefined;
+}
+export class PhysicsState {
+    constructor(box2d, options, warnSink) {
+        // Entity → WASM body/shape IDs plus index-keyed reverse ArrayMaps.
+        // Emscripten returns fresh wrapper objects for b2*Id fields on events, so
+        // Map<b2*Id, EntityId> misses by object identity. Public index1 slot 0 is
+        // unused/null-aligned by Box2D, so ArrayMap slot 0 stays empty too. We do not
+        // check id generations in hot lookups: correctness comes from clearing each
+        // slot on Box2D destruction before Box2D can reuse that index1.
+        this.bodyByEntityWasm = new Map();
+        this.entityByBodyIndex = new ArrayMap();
+        this.shapeByEntityWasm = new Map();
+        this.entityByShapeIndex = new ArrayMap();
+        this.chainByEntity = new Map();
+        // Shape entity object map: shape eid → Entity object.
+        // Used by events.ts to resolve entities for teardown events even after
+        // the entity has been removed from the world lookup table.
+        this.shapeEntityByEid = new Map();
+        // Bodies whose mass needs recomputing this step (populated by shape lifecycle).
+        this.dirtyMassBodies = new Set();
+        // Per-step event tracking sets for PhysicsEvents (M7-8 should-fix: moved from
+        // closure-local to state so they survive future pause/resume cycles).
+        // Populated by PhysicsEvents at the end of each step; persist into the next
+        // step to detect which entities stopped receiving events.
+        this.prevTouchedContact = new Set();
+        this.prevTouchedSensor = new Set();
+        this.prevTouchedHit = new Set();
+        // EIDs of entities that had Impulse or AngularImpulse set this step.
+        // PhysicsImpulseZero walks this set in physics-post to silently zero them.
+        // Cleared by PhysicsImpulseZero at the end of each post phase.
+        this.impulseEntitiesThisStep = new Set();
+        // Pending impulses remain wrapper-keyed by invariant: hooks resolve bodyId
+        // from bodyByEntityWasm, then get/set with that same stored wrapper, and the
+        // pre-step drain iterates stored keys instead of looking up event wrappers.
+        this.pendingLinearImpulse = new Map();
+        this.pendingAngularImpulse = new Map();
+        this.box2d = box2d;
+        this.options = options;
+        this.gravityX = options.gravityX;
+        this.gravityY = options.gravityY;
+        this.fixedTimeStep = options.fixedTimeStep;
+        this.subSteps = options.subSteps;
+        this.debug = options.debug;
+        this.warn = new WarnDedupe(warnSink);
+        this.restitutionThreshold = options.restitutionThreshold;
+        this.hitEventThreshold = options.hitEventThreshold;
+        this.contactHertz = options.contactHertz;
+        this.contactDampingRatio = options.contactDampingRatio;
+        this.contactSpeed = options.contactSpeed;
+        this.maximumLinearSpeed = options.maximumLinearSpeed;
+        this.enableSleep = options.enableSleep;
+        this.enableContinuous = options.enableContinuous;
+        this.scratchVec2 = new box2d.b2Vec2();
+    }
+}
+// Internal singleton state holder. Never exported from the package public API.
+class PhysicsRoot {
+}
+//# sourceMappingURL=state.js.map

package/adapter/state.js.map

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

package/components/body.d.ts

@@ -0,0 +1,34 @@
+/** Simulation behaviour of a {@link Body}. */
+export declare enum BodyType {
+    /** Immovable level geometry. */
+    Static = "static",
+    /** Moved by user-authored velocity or kinematic targets; infinite mass. */
+    Kinematic = "kinematic",
+    /** Responds to forces, impulses, gravity, and contacts. */
+    Dynamic = "dynamic"
+}
+/** Marks an entity as a physics body. Missing `Body` means physics ignores it. */
+export declare class Body {
+    type: BodyType;
+    bullet: boolean;
+    enabled: boolean;
+    allowFastRotation: boolean;
+}
+/** Canonical world-space body position. Teleports when written by user code. */
+export declare class Position {
+    x: number;
+    y: number;
+}
+/** World-space body rotation in radians. Missing `Rotation` means angle 0. */
+export declare class Rotation {
+    angle: number;
+}
+/** Body linear velocity in metres per second. Authoritative both directions. */
+export declare class LinearVelocity {
+    x: number;
+    y: number;
+}
+/** Body angular velocity in radians per second. */
+export declare class AngularVelocity {
+    value: number;
+}

package/components/body.js

@@ -0,0 +1,53 @@
+// Body-level components: the entity-marking `Body` plus the canonical pose and
+// velocity state. Defaults match Box2D's `b2DefaultBodyDef()` (see
+// `box2d/src/types.c`). Public API — see `docs/components.md`.
+//
+// These are plain data classes: every field is initialised on the class body so
+// `new C()` yields a valid, default-shaped instance (the Vecs zero-arg
+// contract). No imports from engine/ or systems/ — components are pure data.
+/** Simulation behaviour of a {@link Body}. */
+export var BodyType;
+(function (BodyType) {
+    /** Immovable level geometry. */
+    BodyType["Static"] = "static";
+    /** Moved by user-authored velocity or kinematic targets; infinite mass. */
+    BodyType["Kinematic"] = "kinematic";
+    /** Responds to forces, impulses, gravity, and contacts. */
+    BodyType["Dynamic"] = "dynamic";
+})(BodyType || (BodyType = {}));
+/** Marks an entity as a physics body. Missing `Body` means physics ignores it. */
+export class Body {
+    constructor() {
+        this.type = BodyType.Static;
+        this.bullet = false;
+        this.enabled = true;
+        this.allowFastRotation = false;
+    }
+}
+/** Canonical world-space body position. Teleports when written by user code. */
+export class Position {
+    constructor() {
+        this.x = 0;
+        this.y = 0;
+    }
+}
+/** World-space body rotation in radians. Missing `Rotation` means angle 0. */
+export class Rotation {
+    constructor() {
+        this.angle = 0;
+    }
+}
+/** Body linear velocity in metres per second. Authoritative both directions. */
+export class LinearVelocity {
+    constructor() {
+        this.x = 0;
+        this.y = 0;
+    }
+}
+/** Body angular velocity in radians per second. */
+export class AngularVelocity {
+    constructor() {
+        this.value = 0;
+    }
+}
+//# sourceMappingURL=body.js.map

package/components/body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.js","sourceRoot":"","sources":["../../../../src/components/body.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,+DAA+D;AAC/D,EAAE;AACF,gFAAgF;AAChF,uEAAuE;AACvE,6EAA6E;AAE7E,8CAA8C;AAC9C,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,gCAAgC;IAChC,6BAAiB,CAAA;IACjB,2EAA2E;IAC3E,mCAAuB,CAAA;IACvB,2DAA2D;IAC3D,+BAAmB,CAAA;AACrB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAED,kFAAkF;AAClF,MAAM,OAAO,IAAI;IAAjB;QACE,SAAI,GAAG,QAAQ,CAAC,MAAM,CAAC;QACvB,WAAM,GAAG,KAAK,CAAC;QACf,YAAO,GAAG,IAAI,CAAC;QACf,sBAAiB,GAAG,KAAK,CAAC;IAC5B,CAAC;CAAA;AAED,gFAAgF;AAChF,MAAM,OAAO,QAAQ;IAArB;QACE,MAAC,GAAG,CAAC,CAAC;QACN,MAAC,GAAG,CAAC,CAAC;IACR,CAAC;CAAA;AAED,8EAA8E;AAC9E,MAAM,OAAO,QAAQ;IAArB;QACE,UAAK,GAAG,CAAC,CAAC;IACZ,CAAC;CAAA;AAED,gFAAgF;AAChF,MAAM,OAAO,cAAc;IAA3B;QACE,MAAC,GAAG,CAAC,CAAC;QACN,MAAC,GAAG,CAAC,CAAC;IACR,CAAC;CAAA;AAED,mDAAmD;AACnD,MAAM,OAAO,eAAe;IAA5B;QACE,UAAK,GAAG,CAAC,CAAC;IACZ,CAAC;CAAA"}

package/components/body_tuning.d.ts

@@ -0,0 +1,21 @@
+/** Linear and angular velocity damping. */
+export declare class Damping {
+    linear: number;
+    angular: number;
+}
+/** Per-body multiplier on world gravity. */
+export declare class GravityScale {
+    value: number;
+}
+/** Restricts body translation (x/y) or rotation. */
+export declare class MotionLocks {
+    x: boolean;
+    y: boolean;
+    rotation: boolean;
+}
+/** Per-body sleep behaviour. `threshold` is in metres/second (b2 sleepThreshold). */
+export declare class Sleep {
+    enabled: boolean;
+    awake: boolean;
+    threshold: number;
+}

package/components/body_tuning.js

@@ -0,0 +1,33 @@
+// Optional body tunables. `Body` stays small; less common settings live here so
+// they only cost an archetype slot when actually used. Defaults match
+// `b2DefaultBodyDef()`. Public API — see `docs/components.md`.
+/** Linear and angular velocity damping. */
+export class Damping {
+    constructor() {
+        this.linear = 0;
+        this.angular = 0;
+    }
+}
+/** Per-body multiplier on world gravity. */
+export class GravityScale {
+    constructor() {
+        this.value = 1;
+    }
+}
+/** Restricts body translation (x/y) or rotation. */
+export class MotionLocks {
+    constructor() {
+        this.x = false;
+        this.y = false;
+        this.rotation = false;
+    }
+}
+/** Per-body sleep behaviour. `threshold` is in metres/second (b2 sleepThreshold). */
+export class Sleep {
+    constructor() {
+        this.enabled = true;
+        this.awake = true;
+        this.threshold = 0.05;
+    }
+}
+//# sourceMappingURL=body_tuning.js.map

package/components/body_tuning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body_tuning.js","sourceRoot":"","sources":["../../../../src/components/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/components/events.d.ts

@@ -0,0 +1,32 @@
+import type { Entity } from "@vworlds/vecs";
+/** A single contact begin/end event. `other` is the colliding shape entity. */
+export type ContactEvent = {
+    other: Entity;
+};
+/** A single sensor overlap begin/end event. */
+export type SensorEvent = {
+    other: Entity;
+};
+/** A single hit event: contact point, normal, and approach speed. */
+export type HitEvent = {
+    other: Entity;
+    x: number;
+    y: number;
+    normalX: number;
+    normalY: number;
+    speed: number;
+};
+/** Per-shape contact begin/end buffers. Add to opt a shape into contact events. */
+export declare class ContactEvents {
+    begin: ContactEvent[];
+    end: ContactEvent[];
+}
+/** Per-shape sensor overlap begin/end buffers. */
+export declare class SensorEvents {
+    begin: SensorEvent[];
+    end: SensorEvent[];
+}
+/** Per-shape hit-event buffer (fast/high-speed contacts). */
+export declare class HitEvents {
+    hits: HitEvent[];
+}

package/components/events.js

@@ -0,0 +1,25 @@
+// Opt-in event buffers attached to shape entities. Arrays are cleared and reused
+// each physics step; physics marks the component modified only when new events
+// arrive (see PLAN → PhysicsEvents). The field initialisers give each instance
+// its own arrays. Public API — see `docs/components.md`.
+/** Per-shape contact begin/end buffers. Add to opt a shape into contact events. */
+export class ContactEvents {
+    constructor() {
+        this.begin = [];
+        this.end = [];
+    }
+}
+/** Per-shape sensor overlap begin/end buffers. */
+export class SensorEvents {
+    constructor() {
+        this.begin = [];
+        this.end = [];
+    }
+}
+/** Per-shape hit-event buffer (fast/high-speed contacts). */
+export class HitEvents {
+    constructor() {
+        this.hits = [];
+    }
+}
+//# sourceMappingURL=events.js.map

package/components/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../src/components/events.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/components/force.d.ts

@@ -0,0 +1,22 @@
+/** Persistent force in newtons. */
+export declare class Force {
+    x: number;
+    y: number;
+    wake: boolean;
+}
+/** Persistent torque (angular force). */
+export declare class Torque {
+    value: number;
+    wake: boolean;
+}
+/** One-shot linear impulse in newton-seconds. Zeroed silently after applied. */
+export declare class Impulse {
+    x: number;
+    y: number;
+    wake: boolean;
+}
+/** One-shot angular impulse. Zeroed silently after applied. */
+export declare class AngularImpulse {
+    value: number;
+    wake: boolean;
+}

package/components/force.js

@@ -0,0 +1,35 @@
+// Force, torque, and one-shot impulse components. May live on a body entity or
+// an immediate child of one. `wake` controls whether applying the load wakes a
+// sleeping body. Impulses are zeroed silently after they are applied (see PLAN →
+// PhysicsImpulseZero). Public API — see `docs/components.md`.
+/** Persistent force in newtons. */
+export class Force {
+    constructor() {
+        this.x = 0;
+        this.y = 0;
+        this.wake = true;
+    }
+}
+/** Persistent torque (angular force). */
+export class Torque {
+    constructor() {
+        this.value = 0;
+        this.wake = true;
+    }
+}
+/** One-shot linear impulse in newton-seconds. Zeroed silently after applied. */
+export class Impulse {
+    constructor() {
+        this.x = 0;
+        this.y = 0;
+        this.wake = true;
+    }
+}
+/** One-shot angular impulse. Zeroed silently after applied. */
+export class AngularImpulse {
+    constructor() {
+        this.value = 0;
+        this.wake = true;
+    }
+}
+//# sourceMappingURL=force.js.map

package/components/force.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"force.js","sourceRoot":"","sources":["../../../../src/components/force.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+EAA+E;AAC/E,iFAAiF;AACjF,8DAA8D;AAE9D,mCAAmC;AACnC,MAAM,OAAO,KAAK;IAAlB;QACE,MAAC,GAAG,CAAC,CAAC;QACN,MAAC,GAAG,CAAC,CAAC;QACN,SAAI,GAAG,IAAI,CAAC;IACd,CAAC;CAAA;AAED,yCAAyC;AACzC,MAAM,OAAO,MAAM;IAAnB;QACE,UAAK,GAAG,CAAC,CAAC;QACV,SAAI,GAAG,IAAI,CAAC;IACd,CAAC;CAAA;AAED,gFAAgF;AAChF,MAAM,OAAO,OAAO;IAApB;QACE,MAAC,GAAG,CAAC,CAAC;QACN,MAAC,GAAG,CAAC,CAAC;QACN,SAAI,GAAG,IAAI,CAAC;IACd,CAAC;CAAA;AAED,+DAA+D;AAC/D,MAAM,OAAO,cAAc;IAA3B;QACE,UAAK,GAAG,CAAC,CAAC;QACV,SAAI,GAAG,IAAI,CAAC;IACd,CAAC;CAAA"}

package/components/geometry.d.ts

@@ -0,0 +1,55 @@
+/** Plain 2D point used by {@link Polygon} and {@link Chain}. */
+export type Vec2 = {
+    x: number;
+    y: number;
+};
+/**
+ * Axis-aligned box in local shape space, stored as half extents (`hx`/`hy`) to
+ * match Box2D's internal representation. The `width`/`height` accessors are
+ * read/write ergonomics over the half extents.
+ *
+ * Vecs cannot observe accessor writes: after `box.width = 2` the caller must
+ * still go through `entity.set(Box, …)` or `entity.modified(Box)` for physics
+ * to notice. See PLAN → Box accessors.
+ */
+export declare class Box {
+    hx: number;
+    hy: number;
+    get width(): number;
+    set width(value: number);
+    get height(): number;
+    set height(value: number);
+}
+/** Circle geometry. */
+export declare class Circle {
+    radius: number;
+}
+/** Capsule geometry: two local endpoints joined by a radius. */
+export declare class Capsule {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    radius: number;
+}
+/** Line-segment geometry. */
+export declare class Segment {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+/**
+ * Convex polygon geometry (up to `B2_MAX_POLYGON_VERTICES` = 8 vertices).
+ * Convexity and vertex count are validated on shape creation, not on every
+ * update. See PLAN → Vec2 in Polygon / Chain.
+ */
+export declare class Polygon {
+    vertices: Vec2[];
+    radius: number;
+}
+/** Chain geometry for static terrain. Needs at least four points. */
+export declare class Chain {
+    points: Vec2[];
+    loop: boolean;
+}

package/components/geometry.js

@@ -0,0 +1,74 @@
+// Geometry components. Exactly one per shape entity; `installPhysics` marks them
+// mutually exclusive so adding one removes any previous geometry. Defaults match
+// the documented shapes. Public API — see `docs/components.md`.
+/**
+ * Axis-aligned box in local shape space, stored as half extents (`hx`/`hy`) to
+ * match Box2D's internal representation. The `width`/`height` accessors are
+ * read/write ergonomics over the half extents.
+ *
+ * Vecs cannot observe accessor writes: after `box.width = 2` the caller must
+ * still go through `entity.set(Box, …)` or `entity.modified(Box)` for physics
+ * to notice. See PLAN → Box accessors.
+ */
+export class Box {
+    constructor() {
+        this.hx = 0.5;
+        this.hy = 0.5;
+    }
+    get width() {
+        return this.hx * 2;
+    }
+    set width(value) {
+        this.hx = value / 2;
+    }
+    get height() {
+        return this.hy * 2;
+    }
+    set height(value) {
+        this.hy = value / 2;
+    }
+}
+/** Circle geometry. */
+export class Circle {
+    constructor() {
+        this.radius = 0.5;
+    }
+}
+/** Capsule geometry: two local endpoints joined by a radius. */
+export class Capsule {
+    constructor() {
+        this.x1 = -0.5;
+        this.y1 = 0;
+        this.x2 = 0.5;
+        this.y2 = 0;
+        this.radius = 0.25;
+    }
+}
+/** Line-segment geometry. */
+export class Segment {
+    constructor() {
+        this.x1 = -0.5;
+        this.y1 = 0;
+        this.x2 = 0.5;
+        this.y2 = 0;
+    }
+}
+/**
+ * Convex polygon geometry (up to `B2_MAX_POLYGON_VERTICES` = 8 vertices).
+ * Convexity and vertex count are validated on shape creation, not on every
+ * update. See PLAN → Vec2 in Polygon / Chain.
+ */
+export class Polygon {
+    constructor() {
+        this.vertices = [];
+        this.radius = 0;
+    }
+}
+/** Chain geometry for static terrain. Needs at least four points. */
+export class Chain {
+    constructor() {
+        this.points = [];
+        this.loop = false;
+    }
+}
+//# sourceMappingURL=geometry.js.map

package/components/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../../../src/components/geometry.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,iFAAiF;AACjF,gEAAgE;AAKhE;;;;;;;;GAQG;AACH,MAAM,OAAO,GAAG;IAAhB;QACE,OAAE,GAAG,GAAG,CAAC;QACT,OAAE,GAAG,GAAG,CAAC;IAiBX,CAAC;IAfC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,KAAK,CAAC,KAAa;QACrB,IAAI,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,MAAM,CAAC,KAAa;QACtB,IAAI,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;IACtB,CAAC;CACF;AAED,uBAAuB;AACvB,MAAM,OAAO,MAAM;IAAnB;QACE,WAAM,GAAG,GAAG,CAAC;IACf,CAAC;CAAA;AAED,gEAAgE;AAChE,MAAM,OAAO,OAAO;IAApB;QACE,OAAE,GAAG,CAAC,GAAG,CAAC;QACV,OAAE,GAAG,CAAC,CAAC;QACP,OAAE,GAAG,GAAG,CAAC;QACT,OAAE,GAAG,CAAC,CAAC;QACP,WAAM,GAAG,IAAI,CAAC;IAChB,CAAC;CAAA;AAED,6BAA6B;AAC7B,MAAM,OAAO,OAAO;IAApB;QACE,OAAE,GAAG,CAAC,GAAG,CAAC;QACV,OAAE,GAAG,CAAC,CAAC;QACP,OAAE,GAAG,GAAG,CAAC;QACT,OAAE,GAAG,CAAC,CAAC;IACT,CAAC;CAAA;AAED;;;;GAIG;AACH,MAAM,OAAO,OAAO;IAApB;QACE,aAAQ,GAAW,EAAE,CAAC;QACtB,WAAM,GAAG,CAAC,CAAC;IACb,CAAC;CAAA;AAED,qEAAqE;AACrE,MAAM,OAAO,KAAK;IAAlB;QACE,WAAM,GAAW,EAAE,CAAC;QACpB,SAAI,GAAG,KAAK,CAAC;IACf,CAAC;CAAA"}