@newkrok/nape-js 3.3.11 → 3.3.13

package/dist/index.d.cts

@@ -25,13 +25,13 @@ declare function getNape(): any;
  *
  * Converted from nape-compiled.js lines 83820–84273, 134996.
  */
-type Any$o = any;
+type Any$x = any;
 declare class ZPP_Vec2 {
     static zpp_pool: ZPP_Vec2 | null;
     static __name__: string[];
-    static _nape: Any$o;
-    static _zpp: Any$o;
-    static _wrapFn: ((zpp: ZPP_Vec2) => Any$o) | null;
+    static _nape: Any$x;
+    static _zpp: Any$x;
+    static _wrapFn: ((zpp: ZPP_Vec2) => Any$x) | null;
     x: number;
     y: number;
     next: ZPP_Vec2 | null;
@@ -40,18 +40,18 @@ declare class ZPP_Vec2 {
     pushmod: boolean;
     _inuse: boolean;
     weak: boolean;
-    outer: Any$o;
+    outer: Any$x;
     _immutable: boolean;
     _isimmutable: (() => void) | null;
     _validate: (() => void) | null;
     _invalidate: ((self: ZPP_Vec2) => void) | null;
-    __class__: Any$o;
+    __class__: Any$x;
     /** Static factory with optional pooling and immutability. */
     static get(x: number, y: number, immutable?: boolean): ZPP_Vec2;
     validate(): void;
     invalidate(): void;
     immutable(): void;
-    wrapper(): Any$o;
+    wrapper(): Any$x;
     free(): void;
     alloc(): void;
     elem(): ZPP_Vec2;
@@ -203,20 +203,20 @@ type NapeInner = any;
  *
  * Converted from nape-compiled.js lines 83412–83434.
  */
-type Any$n = any;
+type Any$w = any;
 declare class ZPP_Vec3 {
     static __name__: string[];
-    static _zpp: Any$n;
-    static _wrapFn: ((zpp: ZPP_Vec3) => Any$n) | null;
-    outer: Any$n;
+    static _zpp: Any$w;
+    static _wrapFn: ((zpp: ZPP_Vec3) => Any$w) | null;
+    outer: Any$w;
     x: number;
     y: number;
     z: number;
     immutable: boolean;
     _validate: (() => void) | null;
-    __class__: Any$n;
+    __class__: Any$w;
     validate(): void;
-    wrapper(): Any$n;
+    wrapper(): Any$w;
 }
 
 /**
@@ -280,13 +280,13 @@ declare class Vec3 {
  *
  * Converted from nape-compiled.js lines 73495–73561, 133826.
  */
-type Any$m = any;
+type Any$v = any;
 declare class ZPP_Mat23 {
     static __name__: string[];
-    static _nape: Any$m;
-    static _wrapFn: ((zpp: ZPP_Mat23) => Any$m) | null;
+    static _nape: Any$v;
+    static _wrapFn: ((zpp: ZPP_Mat23) => Any$v) | null;
     static zpp_pool: ZPP_Mat23 | null;
-    outer: Any$m;
+    outer: Any$v;
     a: number;
     b: number;
     c: number;
@@ -295,13 +295,13 @@ declare class ZPP_Mat23 {
     ty: number;
     _invalidate: (() => void) | null;
     next: ZPP_Mat23 | null;
-    __class__: Any$m;
+    __class__: Any$v;
     /** Static factory with pooling. */
     static get(): ZPP_Mat23;
     /** Create an identity matrix from pool. */
     static identity(): ZPP_Mat23;
     /** Create a public wrapper, recycling any existing inner. */
-    wrapper(): Any$m;
+    wrapper(): Any$v;
     invalidate(): void;
     set(m: ZPP_Mat23): void;
     setas(a: number, b: number, c: number, d: number, tx: number, ty: number): void;
@@ -362,13 +362,13 @@ declare class Mat23 {
  *
  * Converted from nape-compiled.js lines 69554–69563.
  */
-type Any$l = any;
+type Any$u = any;
 declare class ZPP_GeomPoly {
     static __name__: string[];
-    outer: Any$l;
-    vertices: Any$l;
-    __class__: Any$l;
-    constructor(outer?: Any$l);
+    outer: Any$u;
+    vertices: Any$u;
+    __class__: Any$u;
+    constructor(outer?: Any$u);
 }
 
 /**
@@ -392,7 +392,7 @@ declare class Winding {
     toString(): string;
 }
 
-type Any$k = any;
+type Any$t = any;
 /**
  * A polygon represented as a circular doubly-linked list of vertices.
  *
@@ -407,8 +407,8 @@ declare class GeomPoly {
     zpp_inner: ZPP_GeomPoly;
     zpp_pool: GeomPoly | null;
     zpp_disp: boolean;
-    get _inner(): Any$k;
-    constructor(vertices?: Any$k);
+    get _inner(): Any$t;
+    constructor(vertices?: Any$t);
     private _checkDisposed;
     /** @internal Get compiled ZPP_GeomVert class */
     private static _gvClass;
@@ -434,12 +434,12 @@ declare class GeomPoly {
     private static _addVertices;
     /** @internal After copying, dispose weak Vec2 inputs */
     private static _disposeWeakInputs;
-    static get(vertices?: Any$k): GeomPoly;
+    static get(vertices?: Any$t): GeomPoly;
     empty(): boolean;
     size(): number;
-    iterator(): Any$k;
-    forwardIterator(): Any$k;
-    backwardsIterator(): Any$k;
+    iterator(): Any$t;
+    forwardIterator(): Any$t;
+    backwardsIterator(): Any$t;
     current(): Vec2;
     push(vertex: Vec2): this;
     pop(): this;
@@ -452,7 +452,7 @@ declare class GeomPoly {
     copy(): GeomPoly;
     dispose(): void;
     area(): number;
-    winding(): Any$k;
+    winding(): Any$t;
     contains(point: Vec2): boolean;
     isClockwise(): boolean;
     isConvex(): boolean;
@@ -460,14 +460,14 @@ declare class GeomPoly {
     isMonotone(): boolean;
     isDegenerate(): boolean;
     simplify(epsilon: number): GeomPoly;
-    simpleDecomposition(output?: Any$k): Any$k;
-    monotoneDecomposition(output?: Any$k): Any$k;
-    convexDecomposition(delaunay?: boolean, output?: Any$k): Any$k;
-    triangularDecomposition(delaunay?: boolean, output?: Any$k): Any$k;
+    simpleDecomposition(output?: Any$t): Any$t;
+    monotoneDecomposition(output?: Any$t): Any$t;
+    convexDecomposition(delaunay?: boolean, output?: Any$t): Any$t;
+    triangularDecomposition(delaunay?: boolean, output?: Any$t): Any$t;
     inflate(inflation: number): GeomPoly;
-    cut(start: Vec2, end: Vec2, boundedStart?: boolean, boundedEnd?: boolean, output?: Any$k): Any$k;
-    transform(matrix: Any$k): this;
-    bounds(): Any$k;
+    cut(start: Vec2, end: Vec2, boundedStart?: boolean, boundedEnd?: boolean, output?: Any$t): Any$t;
+    transform(matrix: Any$t): this;
+    bounds(): Any$t;
     top(): Vec2;
     bottom(): Vec2;
     left(): Vec2;
@@ -483,30 +483,30 @@ declare class GeomPoly {
  *
  * Converted from nape-compiled.js lines 63546–63965, 134951.
  */
-type Any$j = any;
+type Any$s = any;
 declare class ZPP_AABB {
     static zpp_pool: ZPP_AABB | null;
     static __name__: string[];
-    static _nape: Any$j;
-    static _zpp: Any$j;
-    static _wrapFn: ((zpp: ZPP_AABB) => Any$j) | null;
+    static _nape: Any$s;
+    static _zpp: Any$s;
+    static _wrapFn: ((zpp: ZPP_AABB) => Any$s) | null;
     _invalidate: ((self: ZPP_AABB) => void) | null;
     _validate: (() => void) | null;
     _immutable: boolean;
-    outer: Any$j;
+    outer: Any$s;
     next: ZPP_AABB | null;
     minx: number;
     miny: number;
     maxx: number;
     maxy: number;
-    wrap_min: Any$j;
-    wrap_max: Any$j;
-    __class__: Any$j;
+    wrap_min: Any$s;
+    wrap_max: Any$s;
+    __class__: Any$s;
     /** Static factory with pooling. */
     static get(minx: number, miny: number, maxx: number, maxy: number): ZPP_AABB;
     validate(): void;
     invalidate(): void;
-    wrapper(): Any$j;
+    wrapper(): Any$s;
     alloc(): void;
     free(): void;
     copy(): ZPP_AABB;
@@ -517,10 +517,10 @@ declare class ZPP_AABB {
     private static _makeVec2Wrapper;
     getmin(): void;
     dom_min(): void;
-    mod_min(min: Any$j): void;
+    mod_min(min: Any$s): void;
     getmax(): void;
     dom_max(): void;
-    mod_max(max: Any$j): void;
+    mod_max(max: Any$s): void;
     intersectX(x: ZPP_AABB): boolean;
     intersectY(x: ZPP_AABB): boolean;
     intersect(x: ZPP_AABB): boolean;
@@ -584,18 +584,18 @@ declare class AABB {
  *
  * Converted from nape-compiled.js lines 72949–72972.
  */
-type Any$i = any;
+type Any$r = any;
 declare class ZPP_MatMN {
     static __name__: string[];
-    outer: Any$i;
+    outer: Any$r;
     m: number;
     n: number;
     x: number[];
-    __class__: Any$i;
+    __class__: Any$r;
     constructor(m: number, n: number);
 }
 
-type Any$h = any;
+type Any$q = any;
 /**
  * Variable-sized M×N matrix.
  *
@@ -606,7 +606,7 @@ declare class MatMN {
     zpp_inner: ZPP_MatMN;
     get _inner(): NapeInner;
     constructor(rows: number, cols: number);
-    static _wrap(inner: Any$h): MatMN;
+    static _wrap(inner: Any$q): MatMN;
     get rows(): number;
     get cols(): number;
     x(row: number, col: number): number;
@@ -616,7 +616,7 @@ declare class MatMN {
     mul(matrix: MatMN): MatMN;
 }
 
-type Any$g = any;
+type Any$p = any;
 /**
  * Isosurface extraction using the marching squares algorithm.
  *
@@ -639,7 +639,7 @@ declare class MarchingSquares {
      * @param output - Optional GeomPolyList to populate. If null, a new one is created.
      * @returns The populated GeomPolyList.
      */
-    static run(iso: (x: number, y: number) => number, bounds: AABB, cellsize: Vec2, quality?: number, subgrid?: Vec2 | null, combine?: boolean, output?: Any$g): Any$g;
+    static run(iso: (x: number, y: number) => number, bounds: AABB, cellsize: Vec2, quality?: number, subgrid?: Vec2 | null, combine?: boolean, output?: Any$p): Any$p;
 }
 
 /**
@@ -667,7 +667,7 @@ declare class Ray {
     copy(): Ray;
 }
 
-type Any$f = any;
+type Any$o = any;
 /**
  * Result from a convex-cast query.
  *
@@ -676,23 +676,23 @@ type Any$f = any;
 declare class ConvexResult {
     static __name__: string[];
     /** @internal */
-    zpp_inner: Any$f;
+    zpp_inner: Any$o;
     /** @internal Backward-compat: compiled code accesses `obj.zpp_inner`. */
     get _inner(): NapeInner;
     constructor();
     /** @internal */
-    static _wrap(inner: Any$f): ConvexResult;
+    static _wrap(inner: Any$o): ConvexResult;
     get normal(): Vec2;
     get position(): Vec2;
     get toi(): number;
-    get shape(): Any$f;
+    get shape(): Any$o;
     dispose(): void;
     toString(): string;
     /** @internal */
     private _disposed;
 }
 
-type Any$e = any;
+type Any$n = any;
 /**
  * Result from a raycast query.
  *
@@ -701,16 +701,16 @@ type Any$e = any;
 declare class RayResult {
     static __name__: string[];
     /** @internal */
-    zpp_inner: Any$e;
+    zpp_inner: Any$n;
     /** @internal Backward-compat: compiled code accesses `obj.zpp_inner`. */
     get _inner(): NapeInner;
     constructor();
     /** @internal */
-    static _wrap(inner: Any$e): RayResult;
+    static _wrap(inner: Any$n): RayResult;
     get normal(): Vec2;
     get distance(): number;
     get inner(): boolean;
-    get shape(): Any$e;
+    get shape(): Any$n;
     dispose(): void;
     toString(): string;
     /** @internal */
@@ -778,7 +778,7 @@ declare class NapeList<T> implements Iterable<T> {
  *
  * Converted from nape-compiled.js lines 87523–87601, 135477–135481.
  */
-type Any$d = any;
+type Any$m = any;
 declare class ZPP_Material {
     static zpp_pool: ZPP_Material | null;
     static WAKE: number;
@@ -791,27 +791,27 @@ declare class ZPP_Material {
      * _nape  = the `nape` public namespace (for wrapper creation)
      * _zpp   = the `zpp_nape` internal namespace (for ZNPList_ZPP_Shape)
      */
-    static _nape: Any$d;
-    static _zpp: Any$d;
+    static _nape: Any$m;
+    static _zpp: Any$m;
     /**
      * Wrapper factory callback, registered by the modernized Material class.
      * When set, wrapper() uses this instead of creating a compiled Material.
      */
-    static _wrapFn: ((zpp: ZPP_Material) => Any$d) | null;
+    static _wrapFn: ((zpp: ZPP_Material) => Any$m) | null;
     elasticity: number;
     dynamicFriction: number;
     staticFriction: number;
     density: number;
     rollingFriction: number;
-    shapes: Any$d;
-    wrap_shapes: Any$d;
-    outer: Any$d;
-    userData: Any$d;
+    shapes: Any$m;
+    wrap_shapes: Any$m;
+    outer: Any$m;
+    userData: Any$m;
     next: ZPP_Material | null;
-    __class__: Any$d;
+    __class__: Any$m;
     constructor();
     /** Create/return the public nape.phys.Material wrapper for this internal object. */
-    wrapper(): Any$d;
+    wrapper(): Any$m;
     /** Called when this object is returned to the pool. */
     free(): void;
     /** Called when this object is taken from the pool. */
@@ -819,9 +819,9 @@ declare class ZPP_Material {
     /** Initialize the shapes list (called during feature construction). */
     feature_cons(): void;
     /** Register a shape that uses this material. */
-    addShape(shape: Any$d): void;
+    addShape(shape: Any$m): void;
     /** Unregister a shape that no longer uses this material. */
-    remShape(shape: Any$d): void;
+    remShape(shape: Any$m): void;
     /** Create a copy with the same property values. */
     copy(): ZPP_Material;
     /** Copy all property values from another ZPP_Material. */
@@ -881,36 +881,36 @@ declare class Material {
  *
  * Converted from nape-compiled.js lines 87335–87523, 135403.
  */
-type Any$c = any;
+type Any$l = any;
 declare class ZPP_FluidProperties {
     static zpp_pool: ZPP_FluidProperties | null;
     static __name__: string[];
-    static _nape: Any$c;
-    static _zpp: Any$c;
-    static _wrapFn: ((zpp: ZPP_FluidProperties) => Any$c) | null;
+    static _nape: Any$l;
+    static _zpp: Any$l;
+    static _wrapFn: ((zpp: ZPP_FluidProperties) => Any$l) | null;
     viscosity: number;
     density: number;
     gravityx: number;
     gravityy: number;
-    wrap_gravity: Any$c;
-    shapes: Any$c;
-    wrap_shapes: Any$c;
-    outer: Any$c;
-    userData: Any$c;
+    wrap_gravity: Any$l;
+    shapes: Any$l;
+    wrap_shapes: Any$l;
+    outer: Any$l;
+    userData: Any$l;
     next: ZPP_FluidProperties | null;
-    __class__: Any$c;
+    __class__: Any$l;
     constructor();
     /** Create/return the public nape.phys.FluidProperties wrapper. */
-    wrapper(): Any$c;
+    wrapper(): Any$l;
     free(): void;
     alloc(): void;
     feature_cons(): void;
-    addShape(shape: Any$c): void;
-    remShape(shape: Any$c): void;
+    addShape(shape: Any$l): void;
+    remShape(shape: Any$l): void;
     /** Copy with object pooling. */
     copy(): ZPP_FluidProperties;
     /** Called when gravity Vec2 wrapper is invalidated (user set new gravity). */
-    gravity_invalidate(x: Any$c): void;
+    gravity_invalidate(x: Any$l): void;
     /** Sync the gravity Vec2 wrapper with internal values. */
     gravity_validate(): void;
     /** Lazily create and return the gravity Vec2 wrapper. */
@@ -961,33 +961,33 @@ declare class FluidProperties {
  *
  * Converted from nape-compiled.js lines 63255–63366, 135329.
  */
-type Any$b = any;
+type Any$k = any;
 declare class ZPP_InteractionFilter {
     static zpp_pool: ZPP_InteractionFilter | null;
     static __name__: string[];
-    static _nape: Any$b;
-    static _zpp: Any$b;
-    static _wrapFn: ((zpp: ZPP_InteractionFilter) => Any$b) | null;
+    static _nape: Any$k;
+    static _zpp: Any$k;
+    static _wrapFn: ((zpp: ZPP_InteractionFilter) => Any$k) | null;
     collisionGroup: number;
     collisionMask: number;
     sensorGroup: number;
     sensorMask: number;
     fluidGroup: number;
     fluidMask: number;
-    shapes: Any$b;
-    wrap_shapes: Any$b;
-    outer: Any$b;
-    userData: Any$b;
+    shapes: Any$k;
+    wrap_shapes: Any$k;
+    outer: Any$k;
+    userData: Any$k;
     next: ZPP_InteractionFilter | null;
-    __class__: Any$b;
+    __class__: Any$k;
     constructor();
     /** Create/return the public nape.dynamics.InteractionFilter wrapper. */
-    wrapper(): Any$b;
+    wrapper(): Any$k;
     free(): void;
     alloc(): void;
     feature_cons(): void;
-    addShape(shape: Any$b): void;
-    remShape(shape: Any$b): void;
+    addShape(shape: Any$k): void;
+    remShape(shape: Any$k): void;
     /** Create a copy with object pooling. */
     copy(): ZPP_InteractionFilter;
     /** Test whether two filters allow collision between their shapes. */
@@ -1043,6 +1043,114 @@ declare class InteractionFilter {
     toString(): string;
 }
 
+/**
+ * ZPP_InteractionGroup — Internal interaction group for the nape physics engine.
+ *
+ * Hierarchical groups that can override interaction filters. When two shapes
+ * share a common group with `ignore = true`, their interaction is suppressed.
+ *
+ * Converted from nape-compiled.js lines 63367–63463, 135330–135331.
+ */
+type Any$j = any;
+declare class ZPP_InteractionGroup {
+    static SHAPE: number;
+    static BODY: number;
+    static __name__: string[];
+    static _zpp: Any$j;
+    static _wrapFn: ((zpp: ZPP_InteractionGroup) => Any$j) | null;
+    outer: Any$j;
+    ignore: boolean;
+    group: ZPP_InteractionGroup | null;
+    groups: Any$j;
+    wrap_groups: Any$j;
+    interactors: Any$j;
+    wrap_interactors: Any$j;
+    depth: number;
+    __class__: Any$j;
+    constructor();
+    /** Set or change the parent group. */
+    setGroup(group: ZPP_InteractionGroup | null): void;
+    /** Wake all interactors and propagate to child groups. */
+    invalidate(force?: boolean): void;
+    /** Add a child group. */
+    addGroup(group: ZPP_InteractionGroup): void;
+    /** Remove a child group. */
+    remGroup(group: ZPP_InteractionGroup): void;
+    /** Register an interactor in this group. */
+    addInteractor(intx: Any$j): void;
+    /** Unregister an interactor from this group. */
+    remInteractor(intx: Any$j, flag?: number): void;
+}
+
+/**
+ * Hierarchical interaction group for controlling interactions
+ * between sets of interactors.
+ *
+ * Internally wraps a ZPP_InteractionGroup and is registered as
+ * the public `nape.dynamics.InteractionGroup` class in the compiled namespace.
+ *
+ * Converted from nape-compiled.js lines 14641–14733.
+ */
+declare class InteractionGroup {
+    static __name__: string[];
+    /** @internal The internal ZPP_InteractionGroup this wrapper owns. */
+    zpp_inner: ZPP_InteractionGroup;
+    /**
+     * Backward-compatible accessor — returns `this` so that compiled engine
+     * code that receives `group._inner` can still access `zpp_inner`.
+     * @internal
+     */
+    get _inner(): NapeInner;
+    constructor(ignore?: boolean);
+    /** @internal Wrap a ZPP_InteractionGroup (or legacy compiled InteractionGroup) with caching. */
+    static _wrap(inner: any): InteractionGroup;
+    get group(): InteractionGroup | null;
+    set group(value: InteractionGroup | null);
+    get ignore(): boolean;
+    set ignore(value: boolean);
+    get interactors(): any;
+    get groups(): any;
+    toString(): string;
+}
+
+/**
+ * Base class for all interactable physics objects (Body, Shape, Compound).
+ *
+ * Cannot be instantiated directly — only via Body, Shape, or Compound.
+ * Provides shared properties: id, userData, group, cbTypes, and type
+ * casting methods (castBody, castShape, castCompound).
+ */
+declare class Interactor {
+    /** @internal */
+    readonly _inner: NapeInner;
+    /** @internal – only subclasses may construct. */
+    protected constructor();
+    /** @internal Wrap a compiled Interactor (Body/Shape/Compound) instance. */
+    static _wrap(inner: NapeInner): Interactor;
+    /** Unique numeric identifier for this interactor. */
+    get id(): number;
+    /** User-defined data storage object. */
+    get userData(): Record<string, unknown>;
+    /** The interaction group this interactor belongs to. */
+    get group(): InteractionGroup | null;
+    set group(value: InteractionGroup | null);
+    /** Callback types assigned to this interactor. */
+    get cbTypes(): NapeInner;
+    /** Cast to Body — returns the Body wrapper if this is a Body, else null. */
+    get castBody(): any;
+    /** Cast to Shape — returns the Shape wrapper if this is a Shape, else null. */
+    get castShape(): any;
+    /** Cast to Compound — returns the Compound wrapper if this is a Compound, else null. */
+    get castCompound(): any;
+    /** Returns true if this interactor is a Shape. */
+    isShape(): boolean;
+    /** Returns true if this interactor is a Body. */
+    isBody(): boolean;
+    /** Returns true if this interactor is a Compound. */
+    isCompound(): boolean;
+    toString(): string;
+}
+
 /**
  * Shape type classification.
  *
@@ -1064,9 +1172,7 @@ declare class ShapeType {
 /**
  * Base class for physics shapes (Circle, Polygon).
  */
-declare class Shape {
-    /** @internal */
-    readonly _inner: NapeInner;
+declare class Shape extends Interactor {
     /** @internal – shapes are created via Circle or Polygon constructors. */
     protected constructor();
     /** @internal */
@@ -1172,22 +1278,121 @@ declare class Constraint {
 }
 
 /**
- * Base class for all listener types.
- * Not instantiated directly — use BodyListener, InteractionListener, etc.
+ * ZPP_Listener — Internal listener base class for the nape physics engine.
+ *
+ * Base class for ZPP_BodyListener, ZPP_ConstraintListener, and
+ * ZPP_InteractionListener. Holds common properties (space, precedence,
+ * event type, listener type) and provides stub methods for subclass override.
+ *
+ * Converted from nape-compiled.js lines 27259–27304, 112053–112139.
+ */
+type Any$i = any;
+declare class ZPP_Listener {
+    static __name__: string[];
+    static _nape: Any$i;
+    static _zpp: Any$i;
+    static internal: boolean;
+    static types: Any$i[];
+    static events: Any$i[];
+    space: Any$i;
+    interaction: Any$i;
+    constraint: Any$i;
+    body: Any$i;
+    precedence: number;
+    event: number;
+    type: number;
+    id: number;
+    outer: Any$i;
+    __class__: Any$i;
+    constructor();
+    /** Sort comparator: higher precedence first, then by id descending. */
+    static setlt(a: ZPP_Listener, b: ZPP_Listener): boolean;
+    swapEvent(_event: number): void;
+    invalidate_precedence(): void;
+    addedToSpace(): void;
+    removedFromSpace(): void;
+}
+
+/**
+ * Callback event types.
+ *
+ * - `BEGIN`   — interaction just started
+ * - `ONGOING` — interaction continues
+ * - `END`     — interaction just ended
+ * - `WAKE`    — body/constraint woke up
+ * - `SLEEP`   — body/constraint went to sleep
+ * - `BREAK`   — constraint was broken
+ * - `PRE`     — pre-interaction callback
+ *
+ * Converted from nape-compiled.js lines 516–657.
+ */
+declare class CbEvent {
+    static __name__: string[];
+    constructor();
+    static get BEGIN(): CbEvent;
+    static get ONGOING(): CbEvent;
+    static get END(): CbEvent;
+    static get WAKE(): CbEvent;
+    static get SLEEP(): CbEvent;
+    static get BREAK(): CbEvent;
+    static get PRE(): CbEvent;
+    static get_BEGIN(): CbEvent;
+    static get_ONGOING(): CbEvent;
+    static get_END(): CbEvent;
+    static get_WAKE(): CbEvent;
+    static get_SLEEP(): CbEvent;
+    static get_BREAK(): CbEvent;
+    static get_PRE(): CbEvent;
+    toString(): string;
+}
+
+/**
+ * Listener type classification.
+ *
+ * - `BODY`        — body event listener
+ * - `CONSTRAINT`  — constraint event listener
+ * - `INTERACTION` — interaction event listener
+ * - `PRE`         — pre-interaction listener
+ *
+ * Converted from nape-compiled.js lines 2554–2646.
+ */
+declare class ListenerType {
+    static __name__: string[];
+    static BODY: ListenerType | null;
+    static CONSTRAINT: ListenerType | null;
+    static INTERACTION: ListenerType | null;
+    static PRE: ListenerType | null;
+    constructor();
+    static get_BODY(): ListenerType;
+    static get_CONSTRAINT(): ListenerType;
+    static get_INTERACTION(): ListenerType;
+    static get_PRE(): ListenerType;
+    toString(): string;
+}
+
+/**
+ * Listener — Base class for all physics event listeners.
+ *
+ * Provides common properties (type, event, precedence, space) and
+ * toString() for all listener subclasses.
+ *
+ * Fully modernized from nape-compiled.js lines 231–433.
  */
+
+type Any$h = any;
 declare class Listener {
-    /** @internal */
-    readonly _inner: NapeInner;
-    /** @internal */
-    protected constructor();
-    /** @internal */
-    static _wrap(inner: NapeInner): Listener;
-    get space(): Space;
-    set space(value: Space | null);
+    static __name__: string[];
+    zpp_inner: ZPP_Listener;
+    get _inner(): Any$h;
+    constructor();
+    static _wrap(inner: Any$h): Listener;
+    get type(): ListenerType;
+    get event(): CbEvent;
+    set event(event: CbEvent);
     get precedence(): number;
-    set precedence(value: number);
-    get enabled(): boolean;
-    set enabled(value: boolean);
+    set precedence(precedence: number);
+    get space(): Space | null;
+    set space(space: Space | Any$h | null);
     toString(): string;
 }
 
@@ -1267,9 +1472,7 @@ declare class BodyType {
 /**
  * A rigid body in the physics simulation.
  */
-declare class Body {
-    /** @internal */
-    readonly _inner: NapeInner;
+declare class Body extends Interactor {
     constructor(type?: BodyType, position?: Vec2);
     /** @internal */
     static _wrap(inner: NapeInner): Body;
@@ -1326,7 +1529,6 @@ declare class Body {
     get constraintVelocity(): Vec2;
     get localCOM(): Vec2;
     get worldCOM(): Vec2;
-    get userData(): Record<string, unknown>;
     integrate(deltaTime: number): void;
     applyImpulse(impulse: Vec2, pos?: Vec2, sleepable?: boolean): void;
     applyAngularImpulse(impulse: number, sleepable?: boolean): void;
@@ -1481,76 +1683,6 @@ declare class Broadphase {
     toString(): string;
 }
 
-/**
- * ZPP_InteractionGroup — Internal interaction group for the nape physics engine.
- *
- * Hierarchical groups that can override interaction filters. When two shapes
- * share a common group with `ignore = true`, their interaction is suppressed.
- *
- * Converted from nape-compiled.js lines 63367–63463, 135330–135331.
- */
-type Any$a = any;
-declare class ZPP_InteractionGroup {
-    static SHAPE: number;
-    static BODY: number;
-    static __name__: string[];
-    static _zpp: Any$a;
-    static _wrapFn: ((zpp: ZPP_InteractionGroup) => Any$a) | null;
-    outer: Any$a;
-    ignore: boolean;
-    group: ZPP_InteractionGroup | null;
-    groups: Any$a;
-    wrap_groups: Any$a;
-    interactors: Any$a;
-    wrap_interactors: Any$a;
-    depth: number;
-    __class__: Any$a;
-    constructor();
-    /** Set or change the parent group. */
-    setGroup(group: ZPP_InteractionGroup | null): void;
-    /** Wake all interactors and propagate to child groups. */
-    invalidate(force?: boolean): void;
-    /** Add a child group. */
-    addGroup(group: ZPP_InteractionGroup): void;
-    /** Remove a child group. */
-    remGroup(group: ZPP_InteractionGroup): void;
-    /** Register an interactor in this group. */
-    addInteractor(intx: Any$a): void;
-    /** Unregister an interactor from this group. */
-    remInteractor(intx: Any$a, flag?: number): void;
-}
-
-/**
- * Hierarchical interaction group for controlling interactions
- * between sets of interactors.
- *
- * Internally wraps a ZPP_InteractionGroup and is registered as
- * the public `nape.dynamics.InteractionGroup` class in the compiled namespace.
- *
- * Converted from nape-compiled.js lines 14641–14733.
- */
-declare class InteractionGroup {
-    static __name__: string[];
-    /** @internal The internal ZPP_InteractionGroup this wrapper owns. */
-    zpp_inner: ZPP_InteractionGroup;
-    /**
-     * Backward-compatible accessor — returns `this` so that compiled engine
-     * code that receives `group._inner` can still access `zpp_inner`.
-     * @internal
-     */
-    get _inner(): NapeInner;
-    constructor(ignore?: boolean);
-    /** @internal Wrap a ZPP_InteractionGroup (or legacy compiled InteractionGroup) with caching. */
-    static _wrap(inner: any): InteractionGroup;
-    get group(): InteractionGroup | null;
-    set group(value: InteractionGroup | null);
-    get ignore(): boolean;
-    set ignore(value: boolean);
-    get interactors(): any;
-    get groups(): any;
-    toString(): string;
-}
-
 /**
  * Arbiter type classification.
  *
@@ -1572,39 +1704,6 @@ declare class ArbiterType {
     toString(): string;
 }
 
-/**
- * Callback event types.
- *
- * - `BEGIN`   — interaction just started
- * - `ONGOING` — interaction continues
- * - `END`     — interaction just ended
- * - `WAKE`    — body/constraint woke up
- * - `SLEEP`   — body/constraint went to sleep
- * - `BREAK`   — constraint was broken
- * - `PRE`     — pre-interaction callback
- *
- * Converted from nape-compiled.js lines 516–657.
- */
-declare class CbEvent {
-    static __name__: string[];
-    constructor();
-    static get BEGIN(): CbEvent;
-    static get ONGOING(): CbEvent;
-    static get END(): CbEvent;
-    static get WAKE(): CbEvent;
-    static get SLEEP(): CbEvent;
-    static get BREAK(): CbEvent;
-    static get PRE(): CbEvent;
-    static get_BEGIN(): CbEvent;
-    static get_ONGOING(): CbEvent;
-    static get_END(): CbEvent;
-    static get_WAKE(): CbEvent;
-    static get_SLEEP(): CbEvent;
-    static get_BREAK(): CbEvent;
-    static get_PRE(): CbEvent;
-    toString(): string;
-}
-
 /**
  * ZPP_CbType — Internal callback type for the nape physics engine.
  *
@@ -1614,41 +1713,41 @@ declare class CbEvent {
  *
  * Converted from nape-compiled.js lines 48256–48482.
  */
-type Any$9 = any;
+type Any$g = any;
 declare class ZPP_CbType {
     static __name__: string[];
-    static _zpp: Any$9;
-    outer: Any$9;
-    userData: Any$9;
+    static _zpp: Any$g;
+    outer: Any$g;
+    userData: Any$g;
     id: number;
-    cbsets: Any$9;
-    interactors: Any$9;
-    wrap_interactors: Any$9;
-    constraints: Any$9;
-    wrap_constraints: Any$9;
-    listeners: Any$9;
-    bodylisteners: Any$9;
-    conlisteners: Any$9;
-    __class__: Any$9;
+    cbsets: Any$g;
+    interactors: Any$g;
+    wrap_interactors: Any$g;
+    constraints: Any$g;
+    wrap_constraints: Any$g;
+    listeners: Any$g;
+    bodylisteners: Any$g;
+    conlisteners: Any$g;
+    __class__: Any$g;
     constructor();
     /** Sort comparator by id. */
     static setlt(a: ZPP_CbType, b: ZPP_CbType): boolean;
-    addInteractor(intx: Any$9): void;
-    remInteractor(intx: Any$9): void;
-    addConstraint(con: Any$9): void;
-    remConstraint(con: Any$9): void;
-    addint(x: Any$9): void;
-    removeint(x: Any$9): void;
+    addInteractor(intx: Any$g): void;
+    remInteractor(intx: Any$g): void;
+    addConstraint(con: Any$g): void;
+    remConstraint(con: Any$g): void;
+    addint(x: Any$g): void;
+    removeint(x: Any$g): void;
     invalidateint(): void;
-    addbody(x: Any$9): void;
-    removebody(x: Any$9): void;
+    addbody(x: Any$g): void;
+    removebody(x: Any$g): void;
     invalidatebody(): void;
-    addconstraint(x: Any$9): void;
-    removeconstraint(x: Any$9): void;
+    addconstraint(x: Any$g): void;
+    removeconstraint(x: Any$g): void;
     invalidateconstraint(): void;
 }
 
-type Any$8 = any;
+type Any$f = any;
 /**
  * Callback type — used to tag interactors so that listeners
  * can filter which interactions they respond to.
@@ -1669,11 +1768,11 @@ declare class CbType {
     static get_ANY_SHAPE(): CbType;
     static get_ANY_COMPOUND(): CbType;
     get id(): number;
-    get userData(): Any$8;
-    get interactors(): Any$8;
-    get constraints(): Any$8;
-    including(includes: Any$8): Any$8;
-    excluding(excludes: Any$8): Any$8;
+    get userData(): Any$f;
+    get interactors(): Any$f;
+    get constraints(): Any$f;
+    including(includes: Any$f): Any$f;
+    excluding(excludes: Any$f): Any$f;
     toString(): string;
     static _wrap(inner: any): CbType;
 }
@@ -1734,37 +1833,37 @@ declare class PreFlag {
  *
  * Converted from nape-compiled.js lines 51337–51655.
  */
-type Any$7 = any;
+type Any$e = any;
 declare class ZPP_OptionType {
     static __name__: string[];
-    static _nape: Any$7;
-    static _zpp: Any$7;
-    outer: Any$7;
-    handler: ((val: Any$7, included: boolean, added: boolean) => void) | null;
-    includes: Any$7;
-    excludes: Any$7;
-    wrap_includes: Any$7;
-    wrap_excludes: Any$7;
-    __class__: Any$7;
+    static _nape: Any$e;
+    static _zpp: Any$e;
+    outer: Any$e;
+    handler: ((val: Any$e, included: boolean, added: boolean) => void) | null;
+    includes: Any$e;
+    excludes: Any$e;
+    wrap_includes: Any$e;
+    wrap_excludes: Any$e;
+    __class__: Any$e;
     constructor();
     /** Coerce a value to OptionType (null → new, OptionType → pass-through, CbType → including). */
-    static argument(val: Any$7): Any$7;
+    static argument(val: Any$e): Any$e;
     setup_includes(): void;
     setup_excludes(): void;
-    excluded(xs: Any$7): boolean;
-    included(xs: Any$7): boolean;
-    compatible(xs: Any$7): boolean;
+    excluded(xs: Any$e): boolean;
+    included(xs: Any$e): boolean;
+    compatible(xs: Any$e): boolean;
     /** Check whether two sorted-by-id lists share any element. */
-    nonemptyintersection(xs: Any$7, ys: Any$7): boolean;
+    nonemptyintersection(xs: Any$e, ys: Any$e): boolean;
     /** Insert into the ordered include or exclude list, using pool nodes. */
     private insertOrdered;
-    effect_change(val: Any$7, included: boolean, added: boolean): void;
-    append_type(list: Any$7, val: Any$7): void;
+    effect_change(val: Any$e, included: boolean, added: boolean): void;
+    append_type(list: Any$e, val: Any$e): void;
     set(options: ZPP_OptionType): this;
-    append(list: Any$7, val: Any$7): void;
+    append(list: Any$e, val: Any$e): void;
 }
 
-type Any$6 = any;
+type Any$d = any;
 /**
  * Composite callback option type — allows including and excluding CbTypes.
  *
@@ -1774,90 +1873,194 @@ declare class OptionType {
     static __name__: string[];
     zpp_inner: ZPP_OptionType;
     get _inner(): NapeInner;
-    constructor(includes?: Any$6, excludes?: Any$6);
-    get includes(): Any$6;
-    get excludes(): Any$6;
-    get_includes(): Any$6;
-    get_excludes(): Any$6;
-    including(includes: Any$6): this;
-    excluding(excludes: Any$6): this;
+    constructor(includes?: Any$d, excludes?: Any$d);
+    get includes(): Any$d;
+    get excludes(): Any$d;
+    get_includes(): Any$d;
+    get_excludes(): Any$d;
+    including(includes: Any$d): this;
+    excluding(excludes: Any$d): this;
     toString(): string;
     static _wrap(inner: any): OptionType;
 }
 
 /**
- * Listener that fires when a body wakes, sleeps, etc.
+ * ZPP_BodyListener — Internal body listener for the nape physics engine.
+ *
+ * Manages body event listeners (WAKE/SLEEP) with priority-ordered insertion
+ * into CbType listener lists. Handles option changes and re-registration.
+ *
+ * Converted from nape-compiled.js lines 27305–27497.
+ */
+
+type Any$c = any;
+declare class ZPP_BodyListener extends ZPP_Listener {
+    static __name__: string[];
+    handler: Any$c;
+    options: Any$c;
+    outer_zn: Any$c;
+    __class__: Any$c;
+    constructor(options: Any$c, event: number, handler: Any$c);
+    immutable_options(): void;
+    addedToSpace(): void;
+    removedFromSpace(): void;
+    cbtype_change(cb: Any$c, included: boolean, added: boolean): void;
+    invalidate_precedence(): void;
+    swapEvent(newev: number): void;
+}
+
+/**
+ * BodyListener — Listens for body events (WAKE/SLEEP).
+ *
+ * Fully modernized from nape-compiled.js lines 434–515.
  */
+
+type Any$b = any;
 declare class BodyListener extends Listener {
-    /**
-     * @param event     The event to listen for (WAKE, SLEEP).
-     * @param options   CbType or OptionType to filter which bodies trigger this.
-     * @param handler   Callback function receiving a BodyCallback.
-     * @param precedence  Lower precedence listeners fire first (default 0).
-     */
-    constructor(event: CbEvent, options: CbType | OptionType, handler: (callback: any) => void, precedence?: number);
-    /** @internal */
-    static _wrap(inner: NapeInner): BodyListener;
+    static __name__: string[];
+    zpp_inner_zn: ZPP_BodyListener;
+    constructor(event: CbEvent, options: Any$b, handler: (cb: Any$b) => void, precedence?: number);
+    get options(): Any$b;
+    set options(options: Any$b);
+    get handler(): (cb: Any$b) => void;
+    set handler(handler: (cb: Any$b) => void);
 }
 
 /**
- * Listener that fires on collision/sensor/fluid interactions between bodies.
+ * ZPP_InteractionListener — Internal interaction/pre listener for the nape physics engine.
+ *
+ * Manages interaction event listeners (BEGIN/END/ONGOING/PRE) with dual handler
+ * support (handleri for InteractionListener, handlerp for PreListener).
+ * Contains complex set intersection logic for CbType/CbSet pair operations.
+ *
+ * Converted from nape-compiled.js lines 28138–30352, 112140–112151.
  */
+
+type Any$a = any;
+declare class ZPP_InteractionListener extends ZPP_Listener {
+    static __name__: string[];
+    static UCbSet: Any$a;
+    static VCbSet: Any$a;
+    static WCbSet: Any$a;
+    static UCbType: Any$a;
+    static VCbType: Any$a;
+    static WCbType: Any$a;
+    outer_zni: Any$a;
+    outer_znp: Any$a;
+    itype: number;
+    options1: Any$a;
+    options2: Any$a;
+    handleri: Any$a;
+    allowSleepingCallbacks: boolean;
+    pure: boolean;
+    handlerp: Any$a;
+    __class__: Any$a;
+    constructor(options1: Any$a, options2: Any$a, event: number, type: number);
+    setInteractionType(itype: number): void;
+    wake(): void;
+    CbSetset(A: Any$a, B: Any$a, lambda: (a: Any$a, b: Any$a) => void): void;
+    CbTypeset(A: Any$a, B: Any$a, lambda: (a: Any$a, b: Any$a) => void): void;
+    with_uniquesets(fresh: boolean): void;
+    with_union(lambda: (cb: Any$a) => void): void;
+    addedToSpace(): void;
+    removedFromSpace(): void;
+    invalidate_precedence(): void;
+    cbtype_change1(cb: Any$a, included: boolean, added: boolean): void;
+    cbtype_change2(cb: Any$a, included: boolean, added: boolean): void;
+    cbtype_change(options: Any$a, cb: Any$a, included: boolean, added: boolean): void;
+    swapEvent(newev: number): void;
+    private _allocCbSetNode;
+    private _allocCbTypeNode;
+}
+
+/**
+ * InteractionListener — Listens for interaction events (BEGIN/END/ONGOING).
+ *
+ * Fully modernized from nape-compiled.js lines 659–1091.
+ */
+
+type Any$9 = any;
 declare class InteractionListener extends Listener {
-    /**
-     * @param event           BEGIN, ONGOING, or END.
-     * @param interactionType COLLISION, SENSOR, FLUID, or ANY.
-     * @param options1        CbType/OptionType for the first interactor.
-     * @param options2        CbType/OptionType for the second interactor.
-     * @param handler         Callback receiving an InteractionCallback.
-     * @param precedence      Lower values fire first (default 0).
-     */
-    constructor(event: CbEvent, interactionType: InteractionType, options1: CbType | OptionType, options2: CbType | OptionType, handler: (callback: any) => void, precedence?: number);
-    /** @internal */
-    static _wrap(inner: NapeInner): InteractionListener;
+    static __name__: string[];
+    zpp_inner_zn: ZPP_InteractionListener;
+    constructor(event: CbEvent, interactionType: InteractionType, options1: Any$9, options2: Any$9, handler: (cb: Any$9) => void, precedence?: number);
+    get options1(): Any$9;
+    set options1(options1: Any$9);
+    get options2(): Any$9;
+    set options2(options2: Any$9);
+    get handler(): (cb: Any$9) => void;
+    set handler(handler: (cb: Any$9) => void);
+    get interactionType(): InteractionType | null;
+    set interactionType(interactionType: InteractionType | null);
+    get allowSleepingCallbacks(): boolean;
+    set allowSleepingCallbacks(value: boolean);
 }
 
 /**
- * Listener that fires on constraint events (WAKE, SLEEP, BREAK).
+ * ZPP_ConstraintListener — Internal constraint listener for the nape physics engine.
+ *
+ * Manages constraint event listeners (WAKE/SLEEP/BREAK) with priority-ordered
+ * insertion into CbType listener lists.
+ *
+ * Converted from nape-compiled.js lines 27498–27694.
  */
-declare class ConstraintListener extends Listener {
-    constructor(event: CbEvent, options: CbType | OptionType, handler: (callback: any) => void, precedence?: number);
-    /** @internal */
-    static _wrap(inner: NapeInner): ConstraintListener;
+
+type Any$8 = any;
+declare class ZPP_ConstraintListener extends ZPP_Listener {
+    static __name__: string[];
+    handler: Any$8;
+    options: Any$8;
+    outer_zn: Any$8;
+    __class__: Any$8;
+    constructor(options: Any$8, event: number, handler: Any$8);
+    immutable_options(): void;
+    addedToSpace(): void;
+    removedFromSpace(): void;
+    cbtype_change(cb: Any$8, included: boolean, added: boolean): void;
+    invalidate_precedence(): void;
+    swapEvent(newev: number): void;
 }
 
 /**
- * Listener that fires before collision resolution, allowing
- * the handler to accept/ignore the interaction.
+ * ConstraintListener — Listens for constraint events (WAKE/SLEEP/BREAK).
+ *
+ * Fully modernized from nape-compiled.js lines 546–649.
  */
-declare class PreListener extends Listener {
-    constructor(interactionType: InteractionType, options1: CbType | OptionType, options2: CbType | OptionType, handler: (callback: NapeInner) => PreFlag | NapeInner, precedence?: number, pure?: boolean);
-    /** @internal */
-    static _wrap(inner: NapeInner): PreListener;
+
+type Any$7 = any;
+declare class ConstraintListener extends Listener {
+    static __name__: string[];
+    zpp_inner_zn: ZPP_ConstraintListener;
+    constructor(event: CbEvent, options: Any$7, handler: (cb: Any$7) => void, precedence?: number);
+    get options(): Any$7;
+    set options(options: Any$7);
+    get handler(): (cb: Any$7) => void;
+    set handler(handler: (cb: Any$7) => void);
 }
 
 /**
- * Listener type classification.
+ * PreListener — Listens for pre-interaction events.
  *
- * - `BODY`        — body event listener
- * - `CONSTRAINT`  — constraint event listener
- * - `INTERACTION` — interaction event listener
- * - `PRE`         — pre-interaction listener
+ * Allows the handler to accept/ignore interactions before collision resolution.
  *
- * Converted from nape-compiled.js lines 2554–2646.
+ * Fully modernized from nape-compiled.js lines 1142–1338.
  */
-declare class ListenerType {
+
+type Any$6 = any;
+declare class PreListener extends Listener {
     static __name__: string[];
-    static BODY: ListenerType | null;
-    static CONSTRAINT: ListenerType | null;
-    static INTERACTION: ListenerType | null;
-    static PRE: ListenerType | null;
-    constructor();
-    static get_BODY(): ListenerType;
-    static get_CONSTRAINT(): ListenerType;
-    static get_INTERACTION(): ListenerType;
-    static get_PRE(): ListenerType;
-    toString(): string;
+    zpp_inner_zn: ZPP_InteractionListener;
+    constructor(interactionType: InteractionType, options1: Any$6, options2: Any$6, handler: (cb: Any$6) => Any$6, precedence?: number, pure?: boolean);
+    get options1(): Any$6;
+    set options1(options1: Any$6);
+    get options2(): Any$6;
+    set options2(options2: Any$6);
+    get handler(): (cb: Any$6) => Any$6;
+    set handler(handler: (cb: Any$6) => Any$6);
+    get pure(): boolean;
+    set pure(pure: boolean);
+    get interactionType(): InteractionType | null;
+    set interactionType(interactionType: InteractionType | null);
 }
 
 /**
@@ -2146,4 +2349,4 @@ declare class PulleyJoint extends Constraint {
 
 declare const VERSION = "3.3.6";
 
-export { AABB, AngleJoint, ArbiterType, Body, BodyCallback, BodyListener, BodyType, Broadphase, Callback, CbEvent, CbType, Circle, Constraint, ConstraintCallback, ConstraintListener, ConvexResult, DistanceJoint, FluidProperties, GeomPoly, GravMassMode, InertiaMode, InteractionCallback, InteractionFilter, InteractionGroup, InteractionListener, InteractionType, LineJoint, Listener, ListenerType, MarchingSquares, MassMode, Mat23, MatMN, Material, MotorJoint, NapeList, OptionType, PivotJoint, Polygon, PreCallback, PreFlag, PreListener, PulleyJoint, Ray, RayResult, Shape, ShapeType, Space, VERSION, ValidationResult, Vec2, Vec3, WeldJoint, Winding, getNape };
+export { AABB, AngleJoint, ArbiterType, Body, BodyCallback, BodyListener, BodyType, Broadphase, Callback, CbEvent, CbType, Circle, Constraint, ConstraintCallback, ConstraintListener, ConvexResult, DistanceJoint, FluidProperties, GeomPoly, GravMassMode, InertiaMode, InteractionCallback, InteractionFilter, InteractionGroup, InteractionListener, InteractionType, Interactor, LineJoint, Listener, ListenerType, MarchingSquares, MassMode, Mat23, MatMN, Material, MotorJoint, NapeList, OptionType, PivotJoint, Polygon, PreCallback, PreFlag, PreListener, PulleyJoint, Ray, RayResult, Shape, ShapeType, Space, VERSION, ValidationResult, Vec2, Vec3, WeldJoint, Winding, getNape };