@newkrok/nape-js 3.13.5 → 3.13.7

package/README.md

@@ -7,10 +7,10 @@
 [![npm version](https://img.shields.io/npm/v/@newkrok/nape-js.svg)](https://www.npmjs.com/package/@newkrok/nape-js)
 [![npm downloads](https://img.shields.io/npm/dm/@newkrok/nape-js.svg)](https://www.npmjs.com/package/@newkrok/nape-js)
 [![CI](https://github.com/NewKrok/nape-js/actions/workflows/ci.yml/badge.svg)](https://github.com/NewKrok/nape-js/actions/workflows/ci.yml)
-[![bundle size](https://img.shields.io/badge/gzip-414%20KB-blue.svg)](https://github.com/NewKrok/nape-js)
+[![bundle size](https://img.shields.io/badge/gzip-16%20KB-blue.svg)](https://github.com/NewKrok/nape-js)
 [![license](https://img.shields.io/npm/l/@newkrok/nape-js.svg)](https://github.com/NewKrok/nape-js/blob/master/LICENSE)
 
-Fully typed, tree-shakeable 2D physics engine — a complete TypeScript port of the
+Fully typed, tree-shakeable 2D physics engine — a modern TypeScript rewrite of the
 [Nape](https://github.com/deltaluca/nape) Haxe physics engine.
 
 - Originally created in Haxe by Luca Deltodesco
@@ -57,6 +57,8 @@ function update() {
 
 ## API Reference
 
+> Full API documentation: [TypeDoc Reference](https://newkrok.github.io/nape-js/api/)
+
 ### Core Classes
 
 | Class | Description |
@@ -75,6 +77,7 @@ function update() {
 |-------|-------------|
 | `Circle` | Circular shape |
 | `Polygon` | Convex polygon (with `Polygon.box()`, `Polygon.rect()`, `Polygon.regular()`) |
+| `Capsule` | Capsule shape (`Capsule.create()`, `Capsule.createVertical()`) |
 | `Shape` | Base class with material, filter, sensor support |
 
 ### Physics Properties
@@ -139,12 +142,44 @@ bootstrap when unused. The snapshot captures bodies, shapes, materials, interact
 filters, fluid properties, all constraint types (except `UserConstraint`), and compounds.
 Arbiters and broadphase tree state are reconstructed automatically on the first step.
 
+### Web Worker
+
+Run physics off the main thread for smooth rendering even with hundreds of bodies.
+
+```typescript
+import "@newkrok/nape-js";
+import { PhysicsWorkerManager } from "@newkrok/nape-js/worker";
+
+const mgr = new PhysicsWorkerManager({ gravityY: 600, maxBodies: 256 });
+await mgr.init();
+
+const id = mgr.addBody("dynamic", 100, 50, [{ type: "circle", radius: 20 }]);
+mgr.start();
+
+// Read transforms on the main thread (zero-copy with SharedArrayBuffer)
+function render() {
+  const t = mgr.getTransform(id);
+  if (t) drawCircle(t.x, t.y, t.rotation);
+  requestAnimationFrame(render);
+}
+render();
+```
+
+Uses SharedArrayBuffer for zero-copy transform sharing when COOP/COEP headers are
+present, with automatic `postMessage` fallback otherwise.
+
+## Known Issues
+
+- **Zero-friction tunneling** — Bodies with zero-friction material and horizontal
+  velocity may tunnel through floors. This affects all shape types (circles,
+  polygons, capsules). **Workaround:** use small friction values (e.g. `0.01`).
+
 ## Development
 
 ```bash
 npm install
 npm run build      # tsup → dist/ (ESM + CJS + DTS)
-npm test           # vitest — 3784 tests across 176 files
+npm test           # vitest — 3806 tests across 177 files
 npm run benchmark  # Performance benchmarks
 ```
 

package/dist/{ConvexResult-Bidh5SbE.d.cts → ConvexResult-DS8b-aK-.d.cts}

@@ -2673,4 +2673,4 @@ declare class ConvexResult {
     toString(): string;
 }
 
-export { AABB as A, Body as B, CollisionArbiter as C, DebugDraw as D, Edge as E, FluidArbiter as F, GravMassMode as G, Polygon as H, InteractionFilter as I, RayResult as J, type RayResultList as K, Listener as L, Material as M, NapeList as N, type ShapeList as O, PreFlag as P, ShapeType as Q, Ray as R, Shape as S, Space as T, type TypedListLike as U, Vec2 as V, Vec3 as a, CbEvent as b, Interactor as c, InteractionType as d, Constraint as e, Arbiter as f, MatMN as g, type ArbiterList as h, ArbiterType as i, type BodyList as j, BodyType as k, Broadphase as l, type CbTypeSet as m, Compound as n, type CompoundList as o, type ConstraintList as p, ConvexResult as q, type ConvexResultList as r, type DebugVec2 as s, FluidProperties as t, InertiaMode as u, InteractionGroup as v, type ListenerList as w, ListenerType as x, MassMode as y, Mat23 as z };
+export { AABB as A, Body as B, CollisionArbiter as C, DebugDraw as D, Edge as E, FluidArbiter as F, GravMassMode as G, Polygon as H, InteractionFilter as I, RayResult as J, type RayResultList as K, Listener as L, Material as M, NapeList as N, type ShapeList as O, PreFlag as P, ShapeType as Q, Ray as R, Shape as S, Space as T, type TypedListLike as U, Vec2 as V, Vec3 as a, CbEvent as b, Interactor as c, InteractionType as d, Constraint as e, Arbiter as f, MatMN as g, BodyType as h, type ArbiterList as i, ArbiterType as j, type BodyList as k, Broadphase as l, type CbTypeSet as m, Compound as n, type CompoundList as o, type ConstraintList as p, ConvexResult as q, type ConvexResultList as r, type DebugVec2 as s, FluidProperties as t, InertiaMode as u, InteractionGroup as v, type ListenerList as w, ListenerType as x, MassMode as y, Mat23 as z };

package/dist/{ConvexResult-Bidh5SbE.d.ts → ConvexResult-DS8b-aK-.d.ts}

@@ -2673,4 +2673,4 @@ declare class ConvexResult {
     toString(): string;
 }
 
-export { AABB as A, Body as B, CollisionArbiter as C, DebugDraw as D, Edge as E, FluidArbiter as F, GravMassMode as G, Polygon as H, InteractionFilter as I, RayResult as J, type RayResultList as K, Listener as L, Material as M, NapeList as N, type ShapeList as O, PreFlag as P, ShapeType as Q, Ray as R, Shape as S, Space as T, type TypedListLike as U, Vec2 as V, Vec3 as a, CbEvent as b, Interactor as c, InteractionType as d, Constraint as e, Arbiter as f, MatMN as g, type ArbiterList as h, ArbiterType as i, type BodyList as j, BodyType as k, Broadphase as l, type CbTypeSet as m, Compound as n, type CompoundList as o, type ConstraintList as p, ConvexResult as q, type ConvexResultList as r, type DebugVec2 as s, FluidProperties as t, InertiaMode as u, InteractionGroup as v, type ListenerList as w, ListenerType as x, MassMode as y, Mat23 as z };
+export { AABB as A, Body as B, CollisionArbiter as C, DebugDraw as D, Edge as E, FluidArbiter as F, GravMassMode as G, Polygon as H, InteractionFilter as I, RayResult as J, type RayResultList as K, Listener as L, Material as M, NapeList as N, type ShapeList as O, PreFlag as P, ShapeType as Q, Ray as R, Shape as S, Space as T, type TypedListLike as U, Vec2 as V, Vec3 as a, CbEvent as b, Interactor as c, InteractionType as d, Constraint as e, Arbiter as f, MatMN as g, BodyType as h, type ArbiterList as i, ArbiterType as j, type BodyList as k, Broadphase as l, type CbTypeSet as m, Compound as n, type CompoundList as o, type ConstraintList as p, ConvexResult as q, type ConvexResultList as r, type DebugVec2 as s, FluidProperties as t, InertiaMode as u, InteractionGroup as v, type ListenerList as w, ListenerType as x, MassMode as y, Mat23 as z };