@codexo/exojs-physics 0.13.0

package/dist/esm/events.d.ts

@@ -0,0 +1,35 @@
+import type { Collider } from './Collider';
+import type { PhysicsBody } from './PhysicsBody';
+/** A single contact point on a {@link CollisionEvent}. World space. */
+export interface ContactPoint {
+    readonly x: number;
+    readonly y: number;
+    /** Penetration depth in px (≥ 0). */
+    readonly penetration: number;
+}
+/**
+ * Immutable per-dispatch snapshot describing a solid (non-sensor) contact.
+ * Frozen: it is safe to read during the callback and to copy fields out, but it
+ * is never reused or mutated, so the classic "stored a pooled event" bug cannot
+ * occur. `normal` points from collider/body **A toward B**.
+ */
+export interface CollisionEvent {
+    readonly bodyA: PhysicsBody;
+    readonly bodyB: PhysicsBody;
+    readonly colliderA: Collider;
+    readonly colliderB: Collider;
+    readonly normal: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    readonly points: readonly ContactPoint[];
+}
+/**
+ * Immutable per-dispatch snapshot for a sensor overlap. `sensor` is the
+ * sensor-flagged collider; `other` is the collider that entered/left it. When
+ * both colliders are sensors, the lower-id collider is reported as `sensor`.
+ */
+export interface SensorEvent {
+    readonly sensor: Collider;
+    readonly other: Collider;
+}

package/dist/esm/index.d.ts

@@ -0,0 +1 @@
+export * from './public';

package/dist/esm/index.js

@@ -0,0 +1,12 @@
+export { PhysicsBinding } from './binding/PhysicsBinding.js';
+export { Collider } from './Collider.js';
+export { PhysicsBody } from './PhysicsBody.js';
+export { physicsBuildInfo } from './physicsBuildInfo.js';
+export { PhysicsWorld } from './PhysicsWorld.js';
+export { BoxShape } from './shapes/BoxShape.js';
+export { CircleShape } from './shapes/CircleShape.js';
+export { PolygonShape } from './shapes/PolygonShape.js';
+export { Shape } from './shapes/Shape.js';
+export { TimeStepper } from './TimeStepper.js';
+export { defaultFilter, shouldCollide } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}

package/dist/esm/math.d.ts

@@ -0,0 +1,32 @@
+/** A mutable two-component output sink used to avoid per-call allocation. */
+export interface Mutable2D {
+    x: number;
+    y: number;
+}
+/** A rigid 2D transform: translation plus the precomputed sin/cos of `angle`. */
+export interface Transform {
+    x: number;
+    y: number;
+    /** Rotation in radians. */
+    angle: number;
+    sin: number;
+    cos: number;
+}
+/** Create a transform from a position and angle (radians). */
+export declare const createTransform: (x?: number, y?: number, angle?: number) => Transform;
+/** Set a transform in place, refreshing sin/cos only when the angle changes. */
+export declare const setTransform: (transform: Transform, x: number, y: number, angle: number) => Transform;
+/** Rotate and translate a local point by `transform`, writing into `out`. */
+export declare const applyTransform: (transform: Transform, x: number, y: number, out: Mutable2D) => Mutable2D;
+/** Rotate a local direction by `transform` (no translation), writing into `out`. */
+export declare const applyRotation: (transform: Transform, x: number, y: number, out: Mutable2D) => Mutable2D;
+/** Map a world point into `transform`'s local frame, writing into `out`. */
+export declare const applyInverseTransform: (transform: Transform, x: number, y: number, out: Mutable2D) => Mutable2D;
+/** Map a world direction into `transform`'s local frame, writing into `out`. */
+export declare const applyInverseRotation: (transform: Transform, x: number, y: number, out: Mutable2D) => Mutable2D;
+/**
+ * Compose `world = body ∘ local` into `out`. The local transform is expressed
+ * in the body frame (a collider's offset + local rotation); the result is the
+ * collider's world transform.
+ */
+export declare const composeTransforms: (body: Transform, local: Transform, out: Transform) => Transform;

package/dist/esm/math.js

@@ -0,0 +1,48 @@
+// Internal rigid-transform and angle helpers. Physics stores rotations as a
+// precomputed `sin`/`cos` pair so the hot collision paths never call the
+// trigonometric functions per vertex. `Mutable2D` is a tiny `{ x, y }` sink to
+// keep the rotate/transform helpers allocation-free at their call sites.
+/** Create a transform from a position and angle (radians). */
+const createTransform = (x = 0, y = 0, angle = 0) => ({
+    x,
+    y,
+    angle,
+    sin: Math.sin(angle),
+    cos: Math.cos(angle),
+});
+/** Set a transform in place, refreshing sin/cos only when the angle changes. */
+const setTransform = (transform, x, y, angle) => {
+    transform.x = x;
+    transform.y = y;
+    if (transform.angle !== angle) {
+        transform.angle = angle;
+        transform.sin = Math.sin(angle);
+        transform.cos = Math.cos(angle);
+    }
+    return transform;
+};
+/** Rotate and translate a local point by `transform`, writing into `out`. */
+const applyTransform = (transform, x, y, out) => {
+    out.x = transform.cos * x - transform.sin * y + transform.x;
+    out.y = transform.sin * x + transform.cos * y + transform.y;
+    return out;
+};
+/** Rotate a local direction by `transform` (no translation), writing into `out`. */
+const applyRotation = (transform, x, y, out) => {
+    out.x = transform.cos * x - transform.sin * y;
+    out.y = transform.sin * x + transform.cos * y;
+    return out;
+};
+/**
+ * Compose `world = body ∘ local` into `out`. The local transform is expressed
+ * in the body frame (a collider's offset + local rotation); the result is the
+ * collider's world transform.
+ */
+const composeTransforms = (body, local, out) => {
+    const x = body.cos * local.x - body.sin * local.y + body.x;
+    const y = body.sin * local.x + body.cos * local.y + body.y;
+    return setTransform(out, x, y, body.angle + local.angle);
+};
+
+export { applyRotation, applyTransform, composeTransforms, createTransform, setTransform };
+//# sourceMappingURL=math.js.map

package/dist/esm/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sources":["../../../src/math.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AAkBA;AACO,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,MAAiB;IACtE,CAAC;IACD,CAAC;IACD,KAAK;AACL,IAAA,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;AACpB,IAAA,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;AACrB,CAAA;AAED;AACO,MAAM,YAAY,GAAG,CAAC,SAAoB,EAAE,CAAS,EAAE,CAAS,EAAE,KAAa,KAAe;AACnG,IAAA,SAAS,CAAC,CAAC,GAAG,CAAC;AACf,IAAA,SAAS,CAAC,CAAC,GAAG,CAAC;AAEf,IAAA,IAAI,SAAS,CAAC,KAAK,KAAK,KAAK,EAAE;AAC7B,QAAA,SAAS,CAAC,KAAK,GAAG,KAAK;QACvB,SAAS,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAC/B,SAAS,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;IACjC;AAEA,IAAA,OAAO,SAAS;AAClB;AAEA;AACO,MAAM,cAAc,GAAG,CAAC,SAAoB,EAAE,CAAS,EAAE,CAAS,EAAE,GAAc,KAAe;AACtG,IAAA,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;AAC3D,IAAA,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;AAE3D,IAAA,OAAO,GAAG;AACZ;AAEA;AACO,MAAM,aAAa,GAAG,CAAC,SAAoB,EAAE,CAAS,EAAE,CAAS,EAAE,GAAc,KAAe;AACrG,IAAA,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC;AAC7C,IAAA,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC;AAE7C,IAAA,OAAO,GAAG;AACZ;AAqBA;;;;AAIG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAe,EAAE,KAAgB,EAAE,GAAc,KAAe;IAChG,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAE1D,IAAA,OAAO,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;AAC1D;;;;"}

package/dist/esm/physicsBuildInfo.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Immutable compile-time build metadata for `@codexo/exojs-physics`.
+ *
+ * `development` mirrors the `__DEV__` compile-time constant and is statically
+ * replaced before tree shaking. `version` is the exact `package.json` version
+ * of the Physics package at build time. `revision` is the short source-control
+ * revision (appended with `-dirty` when uncommitted changes are present) or
+ * `"unknown"` when no revision information is available.
+ */
+export interface PhysicsBuildInfo {
+    readonly version: string;
+    readonly revision: string;
+    readonly development: boolean;
+}
+export declare const physicsBuildInfo: PhysicsBuildInfo;

package/dist/esm/physicsBuildInfo.js

@@ -0,0 +1,8 @@
+const physicsBuildInfo = Object.freeze({
+    version: "0.13.0",
+    revision: "ad2faf3",
+    development: false,
+});
+
+export { physicsBuildInfo };
+//# sourceMappingURL=physicsBuildInfo.js.map

package/dist/esm/physicsBuildInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"physicsBuildInfo.js","sources":["../../../src/physicsBuildInfo.ts"],"sourcesContent":[null],"names":[],"mappings":"AAeO,MAAM,gBAAgB,GAAqB,MAAM,CAAC,MAAM,CAAC;AAC9D,IAAA,OAAO,EAAE,QAAW;AACpB,IAAA,QAAQ,EAAE,SAAY;AACtB,IAAA,WAAW,EAAE,KAAO;AACrB,CAAA;;;;"}

package/dist/esm/public.d.ts

@@ -0,0 +1,21 @@
+export type { Aabb } from './Aabb';
+export type { BindingOptions } from './binding/PhysicsBinding';
+export { PhysicsBinding } from './binding/PhysicsBinding';
+export type { ColliderOptions } from './Collider';
+export { Collider } from './Collider';
+export type { CollisionEvent, ContactPoint, SensorEvent } from './events';
+export type { BodyOptions } from './PhysicsBody';
+export { PhysicsBody } from './PhysicsBody';
+export { type PhysicsBuildInfo, physicsBuildInfo } from './physicsBuildInfo';
+export type { PhysicsWorldOptions, StaticColliderOptions } from './PhysicsWorld';
+export { PhysicsWorld } from './PhysicsWorld';
+export type { QueryFilter, RayHit } from './query/QueryEngine';
+export { BoxShape } from './shapes/BoxShape';
+export { CircleShape } from './shapes/CircleShape';
+export { PolygonShape } from './shapes/PolygonShape';
+export type { ShapeType } from './shapes/Shape';
+export { Shape } from './shapes/Shape';
+export type { TimeStepperOptions } from './TimeStepper';
+export { TimeStepper } from './TimeStepper';
+export type { BodyType, CollisionFilter, VectorLike } from './types';
+export { defaultFilter, shouldCollide } from './types';

package/dist/esm/query/QueryEngine.d.ts

@@ -0,0 +1,51 @@
+import type { Aabb } from '../Aabb';
+import type { Collider } from '../Collider';
+import type { PhysicsBody } from '../PhysicsBody';
+import type { Shape } from '../shapes/Shape';
+import type { VectorLike } from '../types';
+/** A category/mask/group filter applied to a query. Omitting it matches everything. */
+export type QueryFilter = Partial<{
+    category: number;
+    mask: number;
+    group: number;
+}>;
+/** A single ray-cast intersection. */
+export interface RayHit {
+    collider: Collider;
+    body: PhysicsBody;
+    /** World-space hit position. */
+    point: {
+        x: number;
+        y: number;
+    };
+    /** Surface normal at the hit (unit, pointing back toward the ray origin). */
+    normal: {
+        x: number;
+        y: number;
+    };
+    /** Distance from the origin along the (normalised) ray direction. */
+    distance: number;
+}
+/**
+ * Spatial queries over the world's live collider set. The engine holds a
+ * reference to the world's collider array (kept world-synchronised on every
+ * body move), so queries always see current placements. Array-returning queries
+ * follow the three explicit allocation forms: fresh array, caller-owned `out`,
+ * or an allocation-free callback — never a hidden shared buffer.
+ */
+export declare class QueryEngine {
+    private readonly _colliders;
+    constructor(colliders: readonly Collider[]);
+    /** Colliders containing `point`. Allocates a fresh array. */
+    queryPoint(point: VectorLike, filter?: QueryFilter): Collider[];
+    /** Colliders whose AABB overlaps `bounds`. Writes into `out` (cleared first) when given, else a fresh array. */
+    queryAabb(bounds: Aabb, filter?: QueryFilter, out?: Collider[]): Collider[];
+    /** Invoke `callback` for each collider whose AABB overlaps `bounds`. Allocation-free. */
+    forEachAabbHit(bounds: Aabb, filter: QueryFilter | undefined, callback: (collider: Collider) => void): void;
+    /** Nearest collider hit by the ray from `origin` along `direction`, or `null`. */
+    rayCast(origin: VectorLike, direction: VectorLike, filter?: QueryFilter, maxDistance?: number): RayHit | null;
+    /** All collider hits along the ray, sorted by distance. Writes into `out` (cleared first) when given. */
+    rayCastAll(origin: VectorLike, direction: VectorLike, filter?: QueryFilter, out?: RayHit[], maxDistance?: number): RayHit[];
+    /** Colliders overlapping `shape` placed at `position`/`angle`. Allocates a fresh array. */
+    overlapShape(shape: Shape, position: VectorLike, filter?: QueryFilter, angle?: number): Collider[];
+}

package/dist/esm/query/QueryEngine.js

@@ -0,0 +1,246 @@
+import { aabbOverlap, aabbContainsPoint } from '../Aabb.js';
+import { testOverlap } from '../collision/narrowphase.js';
+import { applyTransform, applyRotation, createTransform } from '../math.js';
+import { resolveFilter, shouldCollide } from '../types.js';
+
+/**
+ * Spatial queries over the world's live collider set. The engine holds a
+ * reference to the world's collider array (kept world-synchronised on every
+ * body move), so queries always see current placements. Array-returning queries
+ * follow the three explicit allocation forms: fresh array, caller-owned `out`,
+ * or an allocation-free callback — never a hidden shared buffer.
+ */
+class QueryEngine {
+    _colliders;
+    constructor(colliders) {
+        this._colliders = colliders;
+    }
+    /** Colliders containing `point`. Allocates a fresh array. */
+    queryPoint(point, filter) {
+        const out = [];
+        const resolved = filter ? resolveFilter(filter) : null;
+        for (const collider of this._colliders) {
+            if (resolved && !shouldCollide(resolved, collider.filter)) {
+                continue;
+            }
+            if (pointInCollider(collider, point.x, point.y)) {
+                out.push(collider);
+            }
+        }
+        return out;
+    }
+    /** Colliders whose AABB overlaps `bounds`. Writes into `out` (cleared first) when given, else a fresh array. */
+    queryAabb(bounds, filter, out) {
+        const result = out ?? [];
+        result.length = 0;
+        const resolved = filter ? resolveFilter(filter) : null;
+        for (const collider of this._colliders) {
+            if (resolved && !shouldCollide(resolved, collider.filter)) {
+                continue;
+            }
+            if (aabbOverlap(collider.aabb, bounds)) {
+                result.push(collider);
+            }
+        }
+        return result;
+    }
+    /** Invoke `callback` for each collider whose AABB overlaps `bounds`. Allocation-free. */
+    forEachAabbHit(bounds, filter, callback) {
+        const resolved = filter ? resolveFilter(filter) : null;
+        for (const collider of this._colliders) {
+            if (resolved && !shouldCollide(resolved, collider.filter)) {
+                continue;
+            }
+            if (aabbOverlap(collider.aabb, bounds)) {
+                callback(collider);
+            }
+        }
+    }
+    /** Nearest collider hit by the ray from `origin` along `direction`, or `null`. */
+    rayCast(origin, direction, filter, maxDistance = Infinity) {
+        const length = Math.hypot(direction.x, direction.y);
+        if (length < 1e-9) {
+            throw new RangeError('QueryEngine.rayCast: direction must be non-zero.');
+        }
+        const dx = direction.x / length;
+        const dy = direction.y / length;
+        const resolved = filter ? resolveFilter(filter) : null;
+        let best = null;
+        for (const collider of this._colliders) {
+            if (resolved && !shouldCollide(resolved, collider.filter)) {
+                continue;
+            }
+            const hit = rayCastCollider(collider, origin.x, origin.y, dx, dy, best ? best.distance : maxDistance);
+            if (hit && (best === null || hit.distance < best.distance)) {
+                best = hit;
+            }
+        }
+        return best;
+    }
+    /** All collider hits along the ray, sorted by distance. Writes into `out` (cleared first) when given. */
+    rayCastAll(origin, direction, filter, out, maxDistance = Infinity) {
+        const length = Math.hypot(direction.x, direction.y);
+        if (length < 1e-9) {
+            throw new RangeError('QueryEngine.rayCastAll: direction must be non-zero.');
+        }
+        const dx = direction.x / length;
+        const dy = direction.y / length;
+        const resolved = filter ? resolveFilter(filter) : null;
+        const result = out ?? [];
+        result.length = 0;
+        for (const collider of this._colliders) {
+            if (resolved && !shouldCollide(resolved, collider.filter)) {
+                continue;
+            }
+            const hit = rayCastCollider(collider, origin.x, origin.y, dx, dy, maxDistance);
+            if (hit) {
+                result.push(hit);
+            }
+        }
+        result.sort((a, b) => a.distance - b.distance);
+        return result;
+    }
+    /** Colliders overlapping `shape` placed at `position`/`angle`. Allocates a fresh array. */
+    overlapShape(shape, position, filter, angle = 0) {
+        const proxy = makeProxy(shape, position.x, position.y, angle);
+        const out = [];
+        const resolved = filter ? resolveFilter(filter) : null;
+        for (const collider of this._colliders) {
+            if (resolved && !shouldCollide(resolved, collider.filter)) {
+                continue;
+            }
+            if (testOverlap(proxy, collider)) {
+                out.push(collider);
+            }
+        }
+        return out;
+    }
+}
+/** `true` when world point `(px, py)` lies inside `collider`'s shape. */
+const pointInCollider = (collider, px, py) => {
+    if (!aabbContainsPoint(collider.aabb, px, py)) {
+        return false;
+    }
+    if (collider.shape.type === 'circle') {
+        const c = collider.worldCenter;
+        const r = collider.shape.radius;
+        const dx = px - c.x;
+        const dy = py - c.y;
+        return dx * dx + dy * dy <= r * r;
+    }
+    const verts = collider.worldVertices;
+    const normals = collider.worldNormals;
+    const count = collider.shape.count;
+    for (let i = 0; i < count; i++) {
+        if (normals[i * 2] * (px - verts[i * 2]) + normals[i * 2 + 1] * (py - verts[i * 2 + 1]) > 0) {
+            return false;
+        }
+    }
+    return true;
+};
+/** Cast the (normalised) ray against one collider, returning the entry hit or `null`. */
+const rayCastCollider = (collider, ox, oy, dx, dy, maxDistance) => {
+    if (collider.shape.type === 'circle') {
+        return rayCastCircle(collider, ox, oy, dx, dy, maxDistance);
+    }
+    return rayCastPolygon(collider, ox, oy, dx, dy, maxDistance);
+};
+const rayCastCircle = (collider, ox, oy, dx, dy, maxDistance) => {
+    const c = collider.worldCenter;
+    const r = collider.shape.radius;
+    const mx = ox - c.x;
+    const my = oy - c.y;
+    const b = mx * dx + my * dy;
+    const cc = mx * mx + my * my - r * r;
+    // Origin outside and pointing away.
+    if (cc > 0 && b > 0) {
+        return null;
+    }
+    const disc = b * b - cc;
+    if (disc < 0) {
+        return null;
+    }
+    let t = -b - Math.sqrt(disc);
+    if (t < 0) {
+        t = 0;
+    }
+    if (t > maxDistance) {
+        return null;
+    }
+    const px = ox + dx * t;
+    const py = oy + dy * t;
+    const nx = (px - c.x) / r;
+    const ny = (py - c.y) / r;
+    return { collider, body: collider.body, point: { x: px, y: py }, normal: { x: nx, y: ny }, distance: t };
+};
+const rayCastPolygon = (collider, ox, oy, dx, dy, maxDistance) => {
+    const verts = collider.worldVertices;
+    const normals = collider.worldNormals;
+    const count = collider.shape.count;
+    let tmin = 0;
+    let tmax = maxDistance;
+    let enterNx = 0;
+    let enterNy = 0;
+    let entered = false;
+    for (let i = 0; i < count; i++) {
+        const nx = normals[i * 2];
+        const ny = normals[i * 2 + 1];
+        const numerator = nx * (verts[i * 2] - ox) + ny * (verts[i * 2 + 1] - oy);
+        const denominator = nx * dx + ny * dy;
+        if (denominator === 0) {
+            // Parallel to this face: if the origin is outside it, the ray misses.
+            if (numerator < 0) {
+                return null;
+            }
+            continue;
+        }
+        const t = numerator / denominator;
+        if (denominator < 0) {
+            // Entering this half-plane.
+            if (t > tmin) {
+                tmin = t;
+                enterNx = nx;
+                enterNy = ny;
+                entered = true;
+            }
+        }
+        else if (t < tmax) {
+            // Leaving this half-plane.
+            tmax = t;
+        }
+        if (tmin > tmax) {
+            return null;
+        }
+    }
+    if (!entered || tmin < 0 || tmin > maxDistance) {
+        return null;
+    }
+    return {
+        collider,
+        body: collider.body,
+        point: { x: ox + dx * tmin, y: oy + dy * tmin },
+        normal: { x: enterNx, y: enterNy },
+        distance: tmin,
+    };
+};
+/** Build a throwaway collision proxy for a shape placed at `(x, y)` with `angle`. */
+const makeProxy = (shape, x, y, angle) => {
+    if (shape.type === 'circle') {
+        return { shape, worldCenter: { x, y }, worldVertices: [], worldNormals: [] };
+    }
+    const polygon = shape;
+    const transform = createTransform(x, y, angle);
+    const worldVertices = [];
+    const worldNormals = [];
+    const out = { x: 0, y: 0 };
+    for (let i = 0; i < polygon.count; i++) {
+        applyTransform(transform, polygon.vertices[i * 2], polygon.vertices[i * 2 + 1], out);
+        worldVertices.push(out.x, out.y);
+        applyRotation(transform, polygon.normals[i * 2], polygon.normals[i * 2 + 1], out);
+        worldNormals.push(out.x, out.y);
+    }
+    return { shape, worldCenter: { x, y }, worldVertices, worldNormals };
+};
+
+export { QueryEngine };
+//# sourceMappingURL=QueryEngine.js.map

package/dist/esm/query/QueryEngine.js.map

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

package/dist/esm/shapes/BoxShape.d.ts

@@ -0,0 +1,11 @@
+import { PolygonShape } from './PolygonShape';
+/**
+ * Axis-aligned box of `width × height` centred on the collider's local origin —
+ * a convenience over {@link PolygonShape}. The result is a regular polygon, so
+ * it participates in the polygon narrow phase like any other convex shape.
+ */
+export declare class BoxShape extends PolygonShape {
+    readonly width: number;
+    readonly height: number;
+    constructor(width: number, height: number);
+}

package/dist/esm/shapes/BoxShape.js

@@ -0,0 +1,29 @@
+import { PolygonShape } from './PolygonShape.js';
+
+/**
+ * Axis-aligned box of `width × height` centred on the collider's local origin —
+ * a convenience over {@link PolygonShape}. The result is a regular polygon, so
+ * it participates in the polygon narrow phase like any other convex shape.
+ */
+class BoxShape extends PolygonShape {
+    width;
+    height;
+    constructor(width, height) {
+        if (!Number.isFinite(width) || width <= 0 || !Number.isFinite(height) || height <= 0) {
+            throw new RangeError(`BoxShape: width and height must be positive finite numbers, received ${width} × ${height}.`);
+        }
+        const hw = width / 2;
+        const hh = height / 2;
+        super([
+            { x: -hw, y: -hh },
+            { x: hw, y: -hh },
+            { x: hw, y: hh },
+            { x: -hw, y: hh },
+        ]);
+        this.width = width;
+        this.height = height;
+    }
+}
+
+export { BoxShape };
+//# sourceMappingURL=BoxShape.js.map

package/dist/esm/shapes/BoxShape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxShape.js","sources":["../../../../src/shapes/BoxShape.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;AAIG;AACG,MAAO,QAAS,SAAQ,YAAY,CAAA;AACxB,IAAA,KAAK;AACL,IAAA,MAAM;IAEtB,WAAA,CAAmB,KAAa,EAAE,MAAc,EAAA;QAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE;YACpF,MAAM,IAAI,UAAU,CAAC,CAAA,qEAAA,EAAwE,KAAK,CAAA,GAAA,EAAM,MAAM,CAAA,CAAA,CAAG,CAAC;QACpH;AAEA,QAAA,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC;AACpB,QAAA,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC;AAErB,QAAA,KAAK,CAAC;YACJ,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;YAClB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;AACjB,YAAA,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;YAChB,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;AAClB,SAAA,CAAC;AAEF,QAAA,IAAI,CAAC,KAAK,GAAG,KAAK;AAClB,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM;IACtB;AACD;;;;"}

package/dist/esm/shapes/CircleShape.d.ts

@@ -0,0 +1,16 @@
+import type { ShapeType } from './Shape';
+import { Shape } from './Shape';
+/**
+ * A circle of the given `radius` centred on the collider's local origin.
+ * The cheapest shape for both broad- and narrow-phase.
+ */
+export declare class CircleShape extends Shape {
+    readonly type: ShapeType;
+    readonly radius: number;
+    readonly boundingRadius: number;
+    readonly area: number;
+    readonly centroidX = 0;
+    readonly centroidY = 0;
+    readonly unitInertia: number;
+    constructor(radius: number);
+}

package/dist/esm/shapes/CircleShape.js

@@ -0,0 +1,30 @@
+import { Shape } from './Shape.js';
+
+/**
+ * A circle of the given `radius` centred on the collider's local origin.
+ * The cheapest shape for both broad- and narrow-phase.
+ */
+class CircleShape extends Shape {
+    type = 'circle';
+    radius;
+    boundingRadius;
+    area;
+    centroidX = 0;
+    centroidY = 0;
+    unitInertia;
+    constructor(radius) {
+        super();
+        if (!Number.isFinite(radius) || radius <= 0) {
+            throw new RangeError(`CircleShape: radius must be a positive finite number, received ${radius}.`);
+        }
+        this.radius = radius;
+        this.boundingRadius = radius;
+        this.area = Math.PI * radius * radius;
+        // Second moment of area of a disc about its centre: ∫ r² dA = (π/2) R⁴.
+        this.unitInertia = 0.5 * this.area * radius * radius;
+        Object.freeze(this);
+    }
+}
+
+export { CircleShape };
+//# sourceMappingURL=CircleShape.js.map

package/dist/esm/shapes/CircleShape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircleShape.js","sources":["../../../../src/shapes/CircleShape.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;;;AAGG;AACG,MAAO,WAAY,SAAQ,KAAK,CAAA;IACpB,IAAI,GAAc,QAAQ;AAC1B,IAAA,MAAM;AACN,IAAA,cAAc;AACd,IAAA,IAAI;IACJ,SAAS,GAAG,CAAC;IACb,SAAS,GAAG,CAAC;AACb,IAAA,WAAW;AAE3B,IAAA,WAAA,CAAmB,MAAc,EAAA;AAC/B,QAAA,KAAK,EAAE;AAEP,QAAA,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE;AAC3C,YAAA,MAAM,IAAI,UAAU,CAAC,kEAAkE,MAAM,CAAA,CAAA,CAAG,CAAC;QACnG;AAEA,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM;AACpB,QAAA,IAAI,CAAC,cAAc,GAAG,MAAM;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,GAAG,MAAM,GAAG,MAAM;;AAErC,QAAA,IAAI,CAAC,WAAW,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,MAAM,GAAG,MAAM;AAEpD,QAAA,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IACrB;AACD;;;;"}

package/dist/esm/shapes/PolygonShape.d.ts

@@ -0,0 +1,26 @@
+import type { VectorLike } from '../types';
+import type { ShapeType } from './Shape';
+import { Shape } from './Shape';
+/**
+ * A convex polygon defined by ≥3 local-space vertices. Input vertices may be
+ * given in either winding; they are canonicalised to counter-clockwise and the
+ * outward edge normals are precomputed. Construction throws on any non-convex,
+ * degenerate, or under-specified input — there is no silent repair.
+ *
+ * Vertices and normals are exposed as flat `[x0, y0, x1, y1, …]` arrays to keep
+ * the narrow phase allocation-free; both are frozen.
+ */
+export declare class PolygonShape extends Shape {
+    readonly type: ShapeType;
+    /** Local-space vertices, CCW, flattened. */
+    readonly vertices: readonly number[];
+    /** Outward unit edge normals (edge `i` spans vertex `i → i+1`), flattened. */
+    readonly normals: readonly number[];
+    readonly count: number;
+    readonly boundingRadius: number;
+    readonly area: number;
+    readonly centroidX: number;
+    readonly centroidY: number;
+    readonly unitInertia: number;
+    constructor(vertices: readonly VectorLike[]);
+}