@codexo/exojs-physics 0.13.0

package/dist/esm/shapes/PolygonShape.js

@@ -0,0 +1,156 @@
+import { Shape } from './Shape.js';
+
+/** Vertices closer than this (px) are treated as coincident → degenerate. */
+const weldEpsilon = 1e-4;
+/**
+ * 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.
+ */
+class PolygonShape extends Shape {
+    type = 'polygon';
+    /** Local-space vertices, CCW, flattened. */
+    vertices;
+    /** Outward unit edge normals (edge `i` spans vertex `i → i+1`), flattened. */
+    normals;
+    count;
+    boundingRadius;
+    area;
+    centroidX;
+    centroidY;
+    unitInertia;
+    constructor(vertices) {
+        super();
+        if (vertices.length < 3) {
+            throw new RangeError(`PolygonShape: needs at least 3 vertices, received ${vertices.length}.`);
+        }
+        const points = [];
+        for (const vertex of vertices) {
+            if (!Number.isFinite(vertex.x) || !Number.isFinite(vertex.y)) {
+                throw new RangeError(`PolygonShape: vertex has a non-finite component (${vertex.x}, ${vertex.y}).`);
+            }
+            // Reject coincident consecutive (and wrap-around) vertices.
+            const px = points.length >= 2 ? points[points.length - 2] : NaN;
+            const py = points.length >= 2 ? points[points.length - 1] : NaN;
+            if (Math.hypot(vertex.x - px, vertex.y - py) < weldEpsilon) {
+                continue;
+            }
+            points.push(vertex.x, vertex.y);
+        }
+        let count = points.length / 2;
+        // Drop a wrap-around duplicate (last ≈ first).
+        if (count >= 2 && Math.hypot(points[0] - points[points.length - 2], points[1] - points[points.length - 1]) < weldEpsilon) {
+            points.length -= 2;
+            count -= 1;
+        }
+        if (count < 3) {
+            throw new RangeError(`PolygonShape: needs at least 3 distinct vertices after welding, received ${count}.`);
+        }
+        // Canonicalise to CCW (positive signed area). Screen space is +Y down, so a
+        // mathematically CCW polygon appears clockwise — the math stays consistent.
+        if (signedArea(points) < 0) {
+            reverseWinding(points);
+        }
+        const signed = signedArea(points);
+        if (signed <= weldEpsilon) {
+            throw new RangeError('PolygonShape: vertices are degenerate (zero/near-zero area).');
+        }
+        const normals = computeNormals(points);
+        assertConvex(points);
+        // Area, centroid and inertia via the standard polygon integrals.
+        let cx = 0;
+        let cy = 0;
+        let inertiaOrigin = 0;
+        for (let i = 0; i < count; i++) {
+            const ix = points[i * 2];
+            const iy = points[i * 2 + 1];
+            const j = (i + 1) % count;
+            const jx = points[j * 2];
+            const jy = points[j * 2 + 1];
+            const cross = ix * jy - jx * iy;
+            cx += (ix + jx) * cross;
+            cy += (iy + jy) * cross;
+            inertiaOrigin += cross * (ix * ix + ix * jx + jx * jx + iy * iy + iy * jy + jy * jy);
+        }
+        const area = signed;
+        cx /= 6 * area;
+        cy /= 6 * area;
+        this.count = count;
+        this.vertices = Object.freeze(points);
+        this.normals = Object.freeze(normals);
+        this.area = area;
+        this.centroidX = cx;
+        this.centroidY = cy;
+        // ∫ r² dA about the origin, then shifted to the centroid (parallel axis).
+        this.unitInertia = inertiaOrigin / 12 - area * (cx * cx + cy * cy);
+        this.boundingRadius = boundingRadiusOf(points);
+        // The vertex/normal arrays are frozen; the instance itself is not, so
+        // BoxShape (and any future convex helper) can extend this class.
+    }
+}
+/** Signed area (positive = CCW). */
+const signedArea = (points) => {
+    const count = points.length / 2;
+    let sum = 0;
+    for (let i = 0; i < count; i++) {
+        const j = (i + 1) % count;
+        sum += points[i * 2] * points[j * 2 + 1] - points[j * 2] * points[i * 2 + 1];
+    }
+    return sum / 2;
+};
+const reverseWinding = (points) => {
+    const count = points.length / 2;
+    for (let i = 0; i < Math.floor(count / 2); i++) {
+        const j = count - 1 - i;
+        const ix = points[i * 2];
+        const iy = points[i * 2 + 1];
+        points[i * 2] = points[j * 2];
+        points[i * 2 + 1] = points[j * 2 + 1];
+        points[j * 2] = ix;
+        points[j * 2 + 1] = iy;
+    }
+};
+/** Outward unit normals for a CCW polygon: normal of edge `i→i+1` is `(eY, -eX)`. */
+const computeNormals = (points) => {
+    const count = points.length / 2;
+    const normals = [];
+    for (let i = 0; i < count; i++) {
+        const j = (i + 1) % count;
+        const ex = points[j * 2] - points[i * 2];
+        const ey = points[j * 2 + 1] - points[i * 2 + 1];
+        const length = Math.hypot(ex, ey);
+        normals.push(ey / length, -ex / length);
+    }
+    return normals;
+};
+/** Throw unless every interior turn has the same (CCW) orientation. */
+const assertConvex = (points) => {
+    const count = points.length / 2;
+    for (let i = 0; i < count; i++) {
+        const a = i;
+        const b = (i + 1) % count;
+        const c = (i + 2) % count;
+        const e1x = points[b * 2] - points[a * 2];
+        const e1y = points[b * 2 + 1] - points[a * 2 + 1];
+        const e2x = points[c * 2] - points[b * 2];
+        const e2y = points[c * 2 + 1] - points[b * 2 + 1];
+        // CCW polygon ⇒ every cross product must be ≥ 0 (strictly > 0 for no collinear run).
+        if (e1x * e2y - e1y * e2x <= 0) {
+            throw new RangeError('PolygonShape: vertices are not strictly convex (or contain collinear edges).');
+        }
+    }
+};
+const boundingRadiusOf = (points) => {
+    let max = 0;
+    for (let i = 0; i < points.length; i += 2) {
+        max = Math.max(max, Math.hypot(points[i], points[i + 1]));
+    }
+    return max;
+};
+
+export { PolygonShape };
+//# sourceMappingURL=PolygonShape.js.map

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

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

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

@@ -0,0 +1,26 @@
+/** Discriminant for the concrete shape kinds supported in the MVP. */
+export type ShapeType = 'circle' | 'polygon';
+/**
+ * Immutable local-space collision geometry. A `Shape` carries no transform — a
+ * {@link Collider} positions it in a body. Shapes also expose the area-based
+ * mass properties (`area`, `centroid`, `unitInertia`) the body uses to derive
+ * mass and rotational inertia from a density; these are computed once at
+ * construction and frozen.
+ *
+ * `unitInertia` is the second moment of area about the shape's own centroid
+ * (∫ r² dA). Multiplying by density yields the rotational inertia contribution
+ * of the shape about its centroid.
+ */
+export declare abstract class Shape {
+    abstract readonly type: ShapeType;
+    /** Radius of the smallest circle about the local origin enclosing the shape. */
+    abstract readonly boundingRadius: number;
+    /** Surface area in px². `mass = density × area`. */
+    abstract readonly area: number;
+    /** X of the area centroid in local space. */
+    abstract readonly centroidX: number;
+    /** Y of the area centroid in local space. */
+    abstract readonly centroidY: number;
+    /** Second moment of area (∫ r² dA) about the centroid; `inertia = density × unitInertia`. */
+    abstract readonly unitInertia: number;
+}

package/dist/esm/shapes/Shape.js

@@ -0,0 +1,16 @@
+/**
+ * Immutable local-space collision geometry. A `Shape` carries no transform — a
+ * {@link Collider} positions it in a body. Shapes also expose the area-based
+ * mass properties (`area`, `centroid`, `unitInertia`) the body uses to derive
+ * mass and rotational inertia from a density; these are computed once at
+ * construction and frozen.
+ *
+ * `unitInertia` is the second moment of area about the shape's own centroid
+ * (∫ r² dA). Multiplying by density yields the rotational inertia contribution
+ * of the shape about its centroid.
+ */
+class Shape {
+}
+
+export { Shape };
+//# sourceMappingURL=Shape.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Shape.js","sources":["../../../../src/shapes/Shape.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGA;;;;;;;;;;AAUG;MACmB,KAAK,CAAA;AAiB1B;;;;"}

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

@@ -0,0 +1,4 @@
+export { BoxShape } from './BoxShape';
+export { CircleShape } from './CircleShape';
+export { PolygonShape } from './PolygonShape';
+export { Shape, type ShapeType } from './Shape';

package/dist/esm/types.d.ts

@@ -0,0 +1,39 @@
+/** A read-only two-component point/vector. `Vector` from core satisfies this. */
+export interface VectorLike {
+    readonly x: number;
+    readonly y: number;
+}
+/**
+ * Simulation role of a {@link PhysicsBody}.
+ *
+ * - `dynamic` — fully simulated (finite mass); moved by the solver once
+ *   dynamics ship, and by `setTransform` meanwhile.
+ * - `static` — never moves; infinite mass. Ground, walls, level geometry.
+ * - `kinematic` — moved only by `setTransform` (game-driven); infinite mass,
+ *   unaffected by contacts. Platforms, doors.
+ */
+export type BodyType = 'dynamic' | 'static' | 'kinematic';
+/**
+ * Per-collider collision filter. A pair is considered for collision only when
+ * each collider's {@link mask} includes the other's {@link category}. A
+ * non-zero {@link group} overrides category/mask: identical positive groups
+ * always collide, identical negative groups never do.
+ */
+export interface CollisionFilter {
+    /** Category bits this collider belongs to. Default `0x0001`. */
+    category: number;
+    /** Categories this collider collides with. Default `0xffff`. */
+    mask: number;
+    /** Signed override group; `0` defers to category/mask. Default `0`. */
+    group: number;
+}
+/** The default collider filter: category 1, collides with everything, no group. */
+export declare const defaultFilter: Readonly<CollisionFilter>;
+/** Normalise a partial filter against {@link defaultFilter}. */
+export declare const resolveFilter: (filter?: Partial<CollisionFilter>) => CollisionFilter;
+/**
+ * Decide whether two filters permit a collision/overlap. Implements the
+ * standard category/mask rule with the signed-group override (Box2D/Matter
+ * semantics).
+ */
+export declare const shouldCollide: (a: CollisionFilter, b: CollisionFilter) => boolean;

package/dist/esm/types.js

@@ -0,0 +1,28 @@
+// Shared value types for the physics package. Kept dependency-light so the
+// shapes, colliders and world modules can all reference them without cycles.
+/** The default collider filter: category 1, collides with everything, no group. */
+const defaultFilter = Object.freeze({
+    category: 0x0001,
+    mask: 0xffff,
+    group: 0,
+});
+/** Normalise a partial filter against {@link defaultFilter}. */
+const resolveFilter = (filter) => ({
+    category: filter?.category ?? defaultFilter.category,
+    mask: filter?.mask ?? defaultFilter.mask,
+    group: filter?.group ?? defaultFilter.group,
+});
+/**
+ * Decide whether two filters permit a collision/overlap. Implements the
+ * standard category/mask rule with the signed-group override (Box2D/Matter
+ * semantics).
+ */
+const shouldCollide = (a, b) => {
+    if (a.group !== 0 && a.group === b.group) {
+        return a.group > 0;
+    }
+    return (a.mask & b.category) !== 0 && (b.mask & a.category) !== 0;
+};
+
+export { defaultFilter, resolveFilter, shouldCollide };
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../../src/types.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AAkCA;AACO,MAAM,aAAa,GAA8B,MAAM,CAAC,MAAM,CAAC;AACpE,IAAA,QAAQ,EAAE,MAAM;AAChB,IAAA,IAAI,EAAE,MAAM;AACZ,IAAA,KAAK,EAAE,CAAC;AACT,CAAA;AAED;MACa,aAAa,GAAG,CAAC,MAAiC,MAAuB;AACpF,IAAA,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,aAAa,CAAC,QAAQ;AACpD,IAAA,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,aAAa,CAAC,IAAI;AACxC,IAAA,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,aAAa,CAAC,KAAK;AAC5C,CAAA;AAED;;;;AAIG;MACU,aAAa,GAAG,CAAC,CAAkB,EAAE,CAAkB,KAAa;AAC/E,IAAA,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE;AACxC,QAAA,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC;IACpB;IAEA,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,MAAM,CAAC;AACnE;;;;"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@codexo/exojs-physics",
+  "version": "0.13.0",
+  "description": "Native 2D collision, query and sensor runtime for ExoJS.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Exoridus/ExoJS.git",
+    "directory": "packages/exojs-physics"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/esm/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "default": "./dist/esm/index.js"
+    },
+    "./debug": {
+      "types": "./dist/esm/debug/index.d.ts",
+      "import": "./dist/esm/debug/index.js",
+      "default": "./dist/esm/debug/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/esm/",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@codexo/exojs": "0.13.x"
+  },
+  "devDependencies": {
+    "@codexo/exojs": "0.13.0",
+    "@codexo/exojs-config": "0.0.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsx ../../node_modules/rollup/dist/bin/rollup -c --environment EXOJS_ENV:production",
+    "build:dev": "tsx ../../node_modules/rollup/dist/bin/rollup -c --environment EXOJS_ENV:development",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
+    "test": "vitest run --root ../.. --project=exojs-physics"
+  }
+}