@newkrok/nape-js 3.3.44 → 3.4.0

package/dist/index.d.ts

@@ -7,7 +7,7 @@
  *
  * Converted from nape-compiled.js lines 32346–32733.
  */
-type Any$12 = any;
+type Any$17 = any;
 declare class ZPP_IContact {
     static __name__: string[];
     length: number;
@@ -29,7 +29,7 @@ declare class ZPP_IContact {
     lr1y: number;
     lr2x: number;
     lr2y: number;
-    __class__: Any$12;
+    __class__: Any$17;
     elem(): this;
     begin(): ZPP_IContact | null;
     setbegin(i: ZPP_IContact | null): void;
@@ -73,19 +73,19 @@ declare class ZPP_IContact {
  * Converted from nape-compiled.js lines 31853–32345, 81644–81645.
  */
 
-type Any$11 = any;
+type Any$16 = any;
 declare class ZPP_Contact {
     static __name__: string[];
-    static _nape: Any$11;
-    static _zpp: Any$11;
+    static _nape: Any$16;
+    static _zpp: Any$16;
     static zpp_pool: ZPP_Contact | null;
     static internal: boolean;
-    static _wrapFn: ((zpp: ZPP_Contact) => Any$11) | null;
-    outer: Any$11;
+    static _wrapFn: ((zpp: ZPP_Contact) => Any$16) | null;
+    outer: Any$16;
     px: number;
     py: number;
-    wrap_position: Any$11;
-    arbiter: Any$11;
+    wrap_position: Any$16;
+    arbiter: Any$16;
     inner: ZPP_IContact;
     active: boolean;
     posOnly: boolean;
@@ -99,9 +99,9 @@ declare class ZPP_Contact {
     modified: boolean;
     _inuse: boolean;
     next: ZPP_Contact | null;
-    __class__: Any$11;
+    __class__: Any$16;
     constructor();
-    wrapper(): Any$11;
+    wrapper(): Any$16;
     position_validate(): void;
     getposition(): void;
     inactiveme(): boolean;
@@ -166,13 +166,13 @@ declare function getNape(): any;
  *
  * Converted from nape-compiled.js lines 83820–84273, 134996.
  */
-type Any$10 = any;
+type Any$15 = any;
 declare class ZPP_Vec2 {
     static zpp_pool: ZPP_Vec2 | null;
     static __name__: string[];
-    static _nape: Any$10;
-    static _zpp: Any$10;
-    static _wrapFn: ((zpp: ZPP_Vec2) => Any$10) | null;
+    static _nape: Any$15;
+    static _zpp: Any$15;
+    static _wrapFn: ((zpp: ZPP_Vec2) => Any$15) | null;
     x: number;
     y: number;
     next: ZPP_Vec2 | null;
@@ -181,18 +181,18 @@ declare class ZPP_Vec2 {
     pushmod: boolean;
     _inuse: boolean;
     weak: boolean;
-    outer: Any$10;
+    outer: Any$15;
     _immutable: boolean;
     _isimmutable: (() => void) | null;
     _validate: (() => void) | null;
     _invalidate: ((self: ZPP_Vec2) => void) | null;
-    __class__: Any$10;
+    __class__: Any$15;
     /** 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$10;
+    wrapper(): Any$15;
     free(): void;
     alloc(): void;
     elem(): ZPP_Vec2;
@@ -344,20 +344,20 @@ type NapeInner = any;
  *
  * Converted from nape-compiled.js lines 83412–83434.
  */
-type Any$$ = any;
+type Any$14 = any;
 declare class ZPP_Vec3 {
     static __name__: string[];
-    static _zpp: Any$$;
-    static _wrapFn: ((zpp: ZPP_Vec3) => Any$$) | null;
-    outer: Any$$;
+    static _zpp: Any$14;
+    static _wrapFn: ((zpp: ZPP_Vec3) => Any$14) | null;
+    outer: Any$14;
     x: number;
     y: number;
     z: number;
     immutable: boolean;
     _validate: (() => void) | null;
-    __class__: Any$$;
+    __class__: Any$14;
     validate(): void;
-    wrapper(): Any$$;
+    wrapper(): Any$14;
 }
 
 /**
@@ -421,13 +421,13 @@ declare class Vec3 {
  *
  * Converted from nape-compiled.js lines 73495–73561, 133826.
  */
-type Any$_ = any;
+type Any$13 = any;
 declare class ZPP_Mat23 {
     static __name__: string[];
-    static _nape: Any$_;
-    static _wrapFn: ((zpp: ZPP_Mat23) => Any$_) | null;
+    static _nape: Any$13;
+    static _wrapFn: ((zpp: ZPP_Mat23) => Any$13) | null;
     static zpp_pool: ZPP_Mat23 | null;
-    outer: Any$_;
+    outer: Any$13;
     a: number;
     b: number;
     c: number;
@@ -436,13 +436,13 @@ declare class ZPP_Mat23 {
     ty: number;
     _invalidate: (() => void) | null;
     next: ZPP_Mat23 | null;
-    __class__: Any$_;
+    __class__: Any$13;
     /** 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$_;
+    wrapper(): Any$13;
     invalidate(): void;
     set(m: ZPP_Mat23): void;
     setas(a: number, b: number, c: number, d: number, tx: number, ty: number): void;
@@ -503,13 +503,13 @@ declare class Mat23 {
  *
  * Converted from nape-compiled.js lines 69554–69563.
  */
-type Any$Z = any;
+type Any$12 = any;
 declare class ZPP_GeomPoly {
     static __name__: string[];
-    outer: Any$Z;
-    vertices: Any$Z;
-    __class__: Any$Z;
-    constructor(outer?: Any$Z);
+    outer: Any$12;
+    vertices: Any$12;
+    __class__: Any$12;
+    constructor(outer?: Any$12);
 }
 
 /**
@@ -533,7 +533,7 @@ declare class Winding {
     toString(): string;
 }
 
-type Any$Y = any;
+type Any$11 = any;
 /**
  * A polygon represented as a circular doubly-linked list of vertices.
  *
@@ -548,8 +548,8 @@ declare class GeomPoly {
     zpp_inner: ZPP_GeomPoly;
     zpp_pool: GeomPoly | null;
     zpp_disp: boolean;
-    get _inner(): Any$Y;
-    constructor(vertices?: Any$Y);
+    get _inner(): Any$11;
+    constructor(vertices?: Any$11);
     private _checkDisposed;
     /** @internal Get compiled ZPP_GeomVert class */
     private static _gvClass;
@@ -575,12 +575,12 @@ declare class GeomPoly {
     private static _addVertices;
     /** @internal After copying, dispose weak Vec2 inputs */
     private static _disposeWeakInputs;
-    static get(vertices?: Any$Y): GeomPoly;
+    static get(vertices?: Any$11): GeomPoly;
     empty(): boolean;
     size(): number;
-    iterator(): Any$Y;
-    forwardIterator(): Any$Y;
-    backwardsIterator(): Any$Y;
+    iterator(): Any$11;
+    forwardIterator(): Any$11;
+    backwardsIterator(): Any$11;
     current(): Vec2;
     push(vertex: Vec2): this;
     pop(): this;
@@ -593,7 +593,7 @@ declare class GeomPoly {
     copy(): GeomPoly;
     dispose(): void;
     area(): number;
-    winding(): Any$Y;
+    winding(): Any$11;
     contains(point: Vec2): boolean;
     isClockwise(): boolean;
     isConvex(): boolean;
@@ -601,14 +601,14 @@ declare class GeomPoly {
     isMonotone(): boolean;
     isDegenerate(): boolean;
     simplify(epsilon: number): GeomPoly;
-    simpleDecomposition(output?: Any$Y): Any$Y;
-    monotoneDecomposition(output?: Any$Y): Any$Y;
-    convexDecomposition(delaunay?: boolean, output?: Any$Y): Any$Y;
-    triangularDecomposition(delaunay?: boolean, output?: Any$Y): Any$Y;
+    simpleDecomposition(output?: Any$11): Any$11;
+    monotoneDecomposition(output?: Any$11): Any$11;
+    convexDecomposition(delaunay?: boolean, output?: Any$11): Any$11;
+    triangularDecomposition(delaunay?: boolean, output?: Any$11): Any$11;
     inflate(inflation: number): GeomPoly;
-    cut(start: Vec2, end: Vec2, boundedStart?: boolean, boundedEnd?: boolean, output?: Any$Y): Any$Y;
-    transform(matrix: Any$Y): this;
-    bounds(): Any$Y;
+    cut(start: Vec2, end: Vec2, boundedStart?: boolean, boundedEnd?: boolean, output?: Any$11): Any$11;
+    transform(matrix: Any$11): this;
+    bounds(): Any$11;
     top(): Vec2;
     bottom(): Vec2;
     left(): Vec2;
@@ -624,30 +624,30 @@ declare class GeomPoly {
  *
  * Converted from nape-compiled.js lines 63546–63965, 134951.
  */
-type Any$X = any;
+type Any$10 = any;
 declare class ZPP_AABB {
     static zpp_pool: ZPP_AABB | null;
     static __name__: string[];
-    static _nape: Any$X;
-    static _zpp: Any$X;
-    static _wrapFn: ((zpp: ZPP_AABB) => Any$X) | null;
+    static _nape: Any$10;
+    static _zpp: Any$10;
+    static _wrapFn: ((zpp: ZPP_AABB) => Any$10) | null;
     _invalidate: ((self: ZPP_AABB) => void) | null;
     _validate: (() => void) | null;
     _immutable: boolean;
-    outer: Any$X;
+    outer: Any$10;
     next: ZPP_AABB | null;
     minx: number;
     miny: number;
     maxx: number;
     maxy: number;
-    wrap_min: Any$X;
-    wrap_max: Any$X;
-    __class__: Any$X;
+    wrap_min: Any$10;
+    wrap_max: Any$10;
+    __class__: Any$10;
     /** Static factory with pooling. */
     static get(minx: number, miny: number, maxx: number, maxy: number): ZPP_AABB;
     validate(): void;
     invalidate(): void;
-    wrapper(): Any$X;
+    wrapper(): Any$10;
     alloc(): void;
     free(): void;
     copy(): ZPP_AABB;
@@ -658,10 +658,10 @@ declare class ZPP_AABB {
     private static _makeVec2Wrapper;
     getmin(): void;
     dom_min(): void;
-    mod_min(min: Any$X): void;
+    mod_min(min: Any$10): void;
     getmax(): void;
     dom_max(): void;
-    mod_max(max: Any$X): void;
+    mod_max(max: Any$10): void;
     intersectX(x: ZPP_AABB): boolean;
     intersectY(x: ZPP_AABB): boolean;
     intersect(x: ZPP_AABB): boolean;
@@ -725,18 +725,18 @@ declare class AABB {
  *
  * Converted from nape-compiled.js lines 72949–72972.
  */
-type Any$W = any;
+type Any$$ = any;
 declare class ZPP_MatMN {
     static __name__: string[];
-    outer: Any$W;
+    outer: Any$$;
     m: number;
     n: number;
     x: number[];
-    __class__: Any$W;
+    __class__: Any$$;
     constructor(m: number, n: number);
 }
 
-type Any$V = any;
+type Any$_ = any;
 /**
  * Variable-sized M×N matrix.
  *
@@ -747,7 +747,7 @@ declare class MatMN {
     zpp_inner: ZPP_MatMN;
     get _inner(): NapeInner;
     constructor(rows: number, cols: number);
-    static _wrap(inner: Any$V): MatMN;
+    static _wrap(inner: Any$_): MatMN;
     get rows(): number;
     get cols(): number;
     x(row: number, col: number): number;
@@ -757,7 +757,7 @@ declare class MatMN {
     mul(matrix: MatMN): MatMN;
 }
 
-type Any$U = any;
+type Any$Z = any;
 /**
  * Isosurface extraction using the marching squares algorithm.
  *
@@ -780,7 +780,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$U): Any$U;
+    static run(iso: (x: number, y: number) => number, bounds: AABB, cellsize: Vec2, quality?: number, subgrid?: Vec2 | null, combine?: boolean, output?: Any$Z): Any$Z;
 }
 
 /**
@@ -792,7 +792,7 @@ declare class MarchingSquares {
  * Converted from nape-compiled.js lines 31239–33172, 65896.
  */
 
-type Any$T = any;
+type Any$Y = any;
 declare class ZPP_Ray {
     static __name__: string[];
     static internal: boolean;
@@ -807,30 +807,30 @@ declare class ZPP_Ray {
     dirx: number;
     originy: number;
     originx: number;
-    userData: Any$T;
+    userData: Any$Y;
     maxdist: number;
-    direction: Any$T;
-    origin: Any$T;
-    __class__: Any$T;
+    direction: Any$Y;
+    origin: Any$Y;
+    __class__: Any$Y;
     constructor();
-    origin_invalidate(x: Any$T): void;
-    direction_invalidate(x: Any$T): void;
+    origin_invalidate(x: Any$Y): void;
+    direction_invalidate(x: Any$Y): void;
     invalidate_dir(): void;
     validate_dir(): void;
     rayAABB(): ZPP_AABB;
-    aabbtest(a: Any$T): boolean;
-    aabbsect(a: Any$T): number;
+    aabbtest(a: Any$Y): boolean;
+    aabbsect(a: Any$Y): number;
     private static _allocVec2;
     private static _validateWorldCOM;
     private _circleNormal;
     private static _insertSorted;
-    circlesect(c: Any$T, inner: boolean, mint: number): Any$T;
-    circlesect2(c: Any$T, inner: boolean, list: Any$T): void;
-    polysect(p: Any$T, inner: boolean, mint: number): Any$T;
-    polysect2(p: Any$T, inner: boolean, list: Any$T): void;
+    circlesect(c: Any$Y, inner: boolean, mint: number): Any$Y;
+    circlesect2(c: Any$Y, inner: boolean, list: Any$Y): void;
+    polysect(p: Any$Y, inner: boolean, mint: number): Any$Y;
+    polysect2(p: Any$Y, inner: boolean, list: Any$Y): void;
 }
 
-type Any$S = any;
+type Any$X = any;
 /**
  * A ray for raycasting queries.
  *
@@ -844,7 +844,7 @@ declare class Ray {
     get _inner(): this;
     constructor(origin: Vec2, direction: Vec2);
     /** @internal */
-    static _wrap(inner: Any$S): Ray;
+    static _wrap(inner: Any$X): Ray;
     static fromSegment(start: Vec2, end: Vec2): Ray;
     get origin(): Vec2;
     set origin(value: Vec2);
@@ -862,7 +862,7 @@ declare class Ray {
     /** @internal */ set_direction(v: Vec2): Vec2;
     /** @internal */ get_maxDistance(): number;
     /** @internal */ set_maxDistance(v: number): number;
-    /** @internal */ get_userData(): Any$S;
+    /** @internal */ get_userData(): Any$X;
 }
 
 /**
@@ -873,31 +873,31 @@ declare class Ray {
  *
  * Converted from nape-compiled.js lines 38897–39076, 86860–86862.
  */
-type Any$R = any;
+type Any$W = any;
 declare class ZPP_ConvexRayResult {
     static __name__: string[];
     static rayPool: ZPP_ConvexRayResult | null;
     static convexPool: ZPP_ConvexRayResult | null;
     static internal: boolean;
-    static _createRayResult: (() => Any$R) | null;
-    static _createConvexResult: (() => Any$R) | null;
-    normal: Any$R;
-    shape: Any$R;
-    convex: Any$R;
-    position: Any$R;
-    ray: Any$R;
+    static _createRayResult: (() => Any$W) | null;
+    static _createConvexResult: (() => Any$W) | null;
+    normal: Any$W;
+    shape: Any$W;
+    convex: Any$W;
+    position: Any$W;
+    ray: Any$W;
     inner: boolean;
     next: ZPP_ConvexRayResult | null;
     toiDistance: number;
-    __class__: Any$R;
-    static getRay(normal: Any$R, time: number, inner: boolean, shape: Any$R): Any$R;
-    static getConvex(normal: Any$R, position: Any$R, toiDistance: number, shape: Any$R): Any$R;
+    __class__: Any$W;
+    static getRay(normal: Any$W, time: number, inner: boolean, shape: Any$W): Any$W;
+    static getConvex(normal: Any$W, position: Any$W, toiDistance: number, shape: Any$W): Any$W;
     disposed(): void;
     free(): void;
     private static _disposeVec2;
 }
 
-type Any$Q = any;
+type Any$V = any;
 /**
  * Result from a convex-cast query.
  *
@@ -912,18 +912,18 @@ declare class ConvexResult {
     get _inner(): NapeInner;
     constructor();
     /** @internal */
-    static _wrap(inner: Any$Q): ConvexResult;
+    static _wrap(inner: Any$V): ConvexResult;
     get normal(): Vec2;
     get position(): Vec2;
     get toi(): number;
-    get shape(): Any$Q;
+    get shape(): Any$V;
     dispose(): void;
     toString(): string;
     /** @internal */
     private _disposed;
 }
 
-type Any$P = any;
+type Any$U = any;
 /**
  * Result from a raycast query.
  *
@@ -938,11 +938,11 @@ declare class RayResult {
     get _inner(): NapeInner;
     constructor();
     /** @internal */
-    static _wrap(inner: Any$P): RayResult;
+    static _wrap(inner: Any$U): RayResult;
     get normal(): Vec2;
     get distance(): number;
     get inner(): boolean;
-    get shape(): Any$P;
+    get shape(): Any$U;
     dispose(): void;
     toString(): string;
     /** @internal */
@@ -1010,7 +1010,7 @@ declare class NapeList<T> implements Iterable<T> {
  *
  * Converted from nape-compiled.js lines 21424–21827.
  */
-type Any$O = any;
+type Any$T = any;
 declare class ZPP_Constraint {
     static __name__: string[];
     /**
@@ -1018,13 +1018,13 @@ declare class ZPP_Constraint {
      * _nape = the `nape` public namespace (for CbTypeIterator in copyto)
      * _zpp = the `zpp_nape` internal namespace (for ZNPList_*, ZPP_CbSet, etc.)
      */
-    static _nape: Any$O;
-    static _zpp: Any$O;
-    outer: Any$O;
+    static _nape: Any$T;
+    static _zpp: Any$T;
+    outer: Any$T;
     id: number;
-    userData: Any$O;
-    compound: Any$O;
-    space: Any$O;
+    userData: Any$T;
+    compound: Any$T;
+    space: Any$T;
     active: boolean;
     stiff: boolean;
     frequency: number;
@@ -1034,14 +1034,14 @@ declare class ZPP_Constraint {
     breakUnderForce: boolean;
     breakUnderError: boolean;
     removeOnBreak: boolean;
-    component: Any$O;
+    component: Any$T;
     ignore: boolean;
     __velocity: boolean;
-    cbTypes: Any$O;
-    cbSet: Any$O;
-    wrap_cbTypes: Any$O;
+    cbTypes: Any$T;
+    cbSet: Any$T;
+    wrap_cbTypes: Any$T;
     pre_dt: number;
-    __class__: Any$O;
+    __class__: Any$T;
     constructor();
     /**
      * Initialise base constraint fields.
@@ -1059,18 +1059,18 @@ declare class ZPP_Constraint {
     forest(): void;
     broken(): void;
     warmStart(): void;
-    draw(_g: Any$O): void;
-    pair_exists(_id: Any$O, _di: Any$O): boolean;
+    draw(_g: Any$T): void;
+    pair_exists(_id: Any$T, _di: Any$T): boolean;
     preStep(_dt: number): boolean;
     applyImpulseVel(): boolean;
     applyImpulsePos(): boolean;
-    copy(_dict?: Any$O, _todo?: Any$O): Any$O;
+    copy(_dict?: Any$T, _todo?: Any$T): Any$T;
     immutable_midstep(name: string): void;
     setupcbTypes(): void;
     immutable_cbTypes(): void;
-    wrap_cbTypes_subber(pcb: Any$O): void;
-    wrap_cbTypes_adder(cb: Any$O): boolean;
-    insert_cbtype(cb: Any$O): void;
+    wrap_cbTypes_subber(pcb: Any$T): void;
+    wrap_cbTypes_adder(cb: Any$T): boolean;
+    insert_cbtype(cb: Any$T): void;
     alloc_cbSet(): void;
     dealloc_cbSet(): void;
     activate(): void;
@@ -1080,12 +1080,12 @@ declare class ZPP_Constraint {
     activeInSpace(): void;
     inactiveOrOutSpace(): void;
     wake(): void;
-    copyto(ret: Any$O): void;
-    static _findRoot(comp: Any$O): Any$O;
-    static _unionComponents(a: Any$O, b: Any$O): void;
+    copyto(ret: Any$T): void;
+    static _findRoot(comp: Any$T): Any$T;
+    static _unionComponents(a: Any$T, b: Any$T): void;
 }
 
-type Any$N = any;
+type Any$S = any;
 /**
  * Base class for all constraints / joints.
  *
@@ -1094,6 +1094,7 @@ type Any$N = any;
  */
 declare class Constraint {
     static __name__: string[];
+    static zpp_internalAlloc: boolean;
     /** Direct access to the extracted internal ZPP_Constraint. */
     zpp_inner: ZPP_Constraint;
     /**
@@ -1102,16 +1103,16 @@ declare class Constraint {
      * are fully modernized. Also serves as backward compat for compiled code.
      * @internal
      */
-    _inner: Any$N;
+    _inner: Any$S;
     debugDraw: boolean;
     /** @internal */
     protected constructor();
     /** @internal */
-    static _wrap(inner: Any$N): Constraint;
+    static _wrap(inner: Any$S): Constraint;
     get space(): Space | null;
     set space(value: Space | null);
-    get compound(): Any$N;
-    set compound(value: Any$N);
+    get compound(): Any$S;
+    set compound(value: Any$S);
     get active(): boolean;
     set active(value: boolean);
     get ignore(): boolean;
@@ -1134,17 +1135,17 @@ declare class Constraint {
     set removeOnBreak(value: boolean);
     get isSleeping(): boolean;
     get userData(): Record<string, unknown>;
-    get cbTypes(): Any$N;
-    impulse(): Any$N;
-    bodyImpulse(_body: Body): Any$N;
+    get cbTypes(): Any$S;
+    impulse(): Any$S;
+    bodyImpulse(_body: Body): Any$S;
     visitBodies(_fn: (body: Body) => void): void;
     copy(): Constraint;
     toString(): string;
-    /** @internal */ get_userData(): Any$N;
-    /** @internal */ get_compound(): Any$N;
-    /** @internal */ set_compound(v: Any$N): Any$N;
-    /** @internal */ get_space(): Any$N;
-    /** @internal */ set_space(v: Any$N): Any$N;
+    /** @internal */ get_userData(): Any$S;
+    /** @internal */ get_compound(): Any$S;
+    /** @internal */ set_compound(v: Any$S): Any$S;
+    /** @internal */ get_space(): Any$S;
+    /** @internal */ set_space(v: Any$S): Any$S;
     /** @internal */ get_isSleeping(): boolean;
     /** @internal */ get_active(): boolean;
     /** @internal */ set_active(v: boolean): boolean;
@@ -1166,179 +1167,369 @@ declare class Constraint {
     /** @internal */ set_breakUnderError(v: boolean): boolean;
     /** @internal */ get_removeOnBreak(): boolean;
     /** @internal */ set_removeOnBreak(v: boolean): boolean;
-    /** @internal */ get_cbTypes(): Any$N;
+    /** @internal */ get_cbTypes(): Any$S;
 }
 
 /**
- * ZPP_Listener — Internal listener base class for the nape physics engine.
+ * ZPP_InteractionFilter — Internal interaction filter 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.
+ * Stores collision/sensor/fluid group and mask bitmasks that determine
+ * which shapes interact with each other.
  *
- * Converted from nape-compiled.js lines 27259–27304, 112053–112139.
+ * Converted from nape-compiled.js lines 63255–63366, 135329.
  */
-type Any$M = any;
-declare class ZPP_Listener {
+type Any$R = any;
+declare class ZPP_InteractionFilter {
+    static zpp_pool: ZPP_InteractionFilter | null;
     static __name__: string[];
-    static _nape: Any$M;
-    static _zpp: Any$M;
-    static internal: boolean;
-    static types: Any$M[];
-    static events: Any$M[];
-    space: Any$M;
-    interaction: Any$M;
-    constraint: Any$M;
-    body: Any$M;
-    precedence: number;
-    event: number;
-    type: number;
-    id: number;
-    outer: Any$M;
-    __class__: Any$M;
+    static _nape: Any$R;
+    static _zpp: Any$R;
+    static _wrapFn: ((zpp: ZPP_InteractionFilter) => Any$R) | null;
+    collisionGroup: number;
+    collisionMask: number;
+    sensorGroup: number;
+    sensorMask: number;
+    fluidGroup: number;
+    fluidMask: number;
+    shapes: Any$R;
+    wrap_shapes: Any$R;
+    outer: Any$R;
+    userData: Any$R;
+    next: ZPP_InteractionFilter | null;
+    __class__: Any$R;
     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;
+    /** Create/return the public nape.dynamics.InteractionFilter wrapper. */
+    wrapper(): Any$R;
+    free(): void;
+    alloc(): void;
+    feature_cons(): void;
+    addShape(shape: Any$R): void;
+    remShape(shape: Any$R): void;
+    /** Create a copy with object pooling. */
+    copy(): ZPP_InteractionFilter;
+    /** Test whether two filters allow collision between their shapes. */
+    shouldCollide(x: ZPP_InteractionFilter): boolean;
+    /** Test whether two filters allow sensor interaction. */
+    shouldSense(x: ZPP_InteractionFilter): boolean;
+    /** Test whether two filters allow fluid interaction. */
+    shouldFlow(x: ZPP_InteractionFilter): boolean;
+    /** Notify all shapes that the filter changed. */
+    invalidate(): void;
 }
 
 /**
- * Callback event types.
+ * Bit-mask based interaction filter for controlling which shapes
+ * collide, sense, or interact as fluids.
  *
- * - `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
+ * Internally wraps a ZPP_InteractionFilter and is registered as
+ * the public `nape.dynamics.InteractionFilter` class in the compiled namespace.
  *
- * Converted from nape-compiled.js lines 516–657.
+ * Converted from nape-compiled.js lines 14361–14640.
  */
-declare class CbEvent {
+declare class InteractionFilter {
     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;
+    /** @internal The internal ZPP_InteractionFilter this wrapper owns. */
+    zpp_inner: ZPP_InteractionFilter;
+    /**
+     * Backward-compatible accessor — returns `this` so that compiled engine
+     * code that receives `filter._inner` can still access `zpp_inner`.
+     * @internal
+     */
+    get _inner(): NapeInner;
+    constructor(collisionGroup?: number, collisionMask?: number, sensorGroup?: number, sensorMask?: number, fluidGroup?: number, fluidMask?: number);
+    /** @internal Wrap a ZPP_InteractionFilter (or legacy compiled InteractionFilter) with caching. */
+    static _wrap(inner: any): InteractionFilter;
+    get collisionGroup(): number;
+    set collisionGroup(value: number);
+    get collisionMask(): number;
+    set collisionMask(value: number);
+    get sensorGroup(): number;
+    set sensorGroup(value: number);
+    get sensorMask(): number;
+    set sensorMask(value: number);
+    get fluidGroup(): number;
+    set fluidGroup(value: number);
+    get fluidMask(): number;
+    set fluidMask(value: number);
+    get userData(): Record<string, unknown>;
+    get shapes(): any;
+    shouldCollide(filter: InteractionFilter): boolean;
+    shouldSense(filter: InteractionFilter): boolean;
+    shouldFlow(filter: InteractionFilter): boolean;
+    copy(): InteractionFilter;
     toString(): string;
 }
 
 /**
- * Listener type classification.
+ * ZPP_Callback — Internal callback data holder for the nape physics engine.
  *
- * - `BODY`        — body event listener
- * - `CONSTRAINT`  — constraint event listener
- * - `INTERACTION` — interaction event listener
- * - `PRE`         — pre-interaction listener
+ * Stores callback event information (listener, event type, interactors, etc.)
+ * and forms a doubly-linked list for callback queue management.
  *
- * Converted from nape-compiled.js lines 2554–2646.
+ * Converted from nape-compiled.js lines 44587–44794, 133299–133300.
  */
-declare class ListenerType {
+type Any$Q = any;
+declare class ZPP_Callback {
     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;
+    static _nape: Any$Q;
+    static _zpp: Any$Q;
+    static internal: boolean;
+    static zpp_pool: ZPP_Callback | null;
+    outer_body: Any$Q;
+    outer_con: Any$Q;
+    outer_int: Any$Q;
+    event: number;
+    listener: Any$Q;
+    space: Any$Q;
+    index: number;
+    next: ZPP_Callback | null;
+    prev: ZPP_Callback | null;
+    length: number;
+    int1: Any$Q;
+    int2: Any$Q;
+    set: Any$Q;
+    wrap_arbiters: Any$Q;
+    pre_arbiter: Any$Q;
+    pre_swapped: boolean;
+    body: Any$Q;
+    constraint: Any$Q;
+    __class__: Any$Q;
+    wrapper_body(): Any$Q;
+    wrapper_con(): Any$Q;
+    wrapper_int(): Any$Q;
+    push(obj: ZPP_Callback): void;
+    push_rev(obj: ZPP_Callback): void;
+    pop(): ZPP_Callback;
+    pop_rev(): ZPP_Callback;
+    empty(): boolean;
+    clear(): void;
+    splice(o: ZPP_Callback): ZPP_Callback | null;
+    rotateL(): void;
+    rotateR(): void;
+    cycleNext(o: ZPP_Callback): ZPP_Callback | null;
+    cyclePrev(o: ZPP_Callback): ZPP_Callback | null;
+    at(i: number): ZPP_Callback;
+    rev_at(i: number): ZPP_Callback;
+    free(): void;
+    alloc(): void;
+    genarbs(): void;
 }
 
 /**
- * Listener — Base class for all physics event listeners.
- *
- * Provides common properties (type, event, precedence, space) and
- * toString() for all listener subclasses.
+ * ZPP_Space -- Internal space implementation (core simulation loop).
+ * Converted from nape-compiled.js lines 30236-43690.
  *
- * Fully modernized from nape-compiled.js lines 231–433.
+ * This is the largest and most complex class in the engine (~13,450 lines).
+ * It handles integration, constraint solving, broadphase management,
+ * sleeping/waking, and callback dispatch.
  */
 
-type Any$L = any;
-declare class Listener {
+type Any$P = any;
+declare class ZPP_Space {
     static __name__: string[];
-    zpp_inner: ZPP_Listener;
-    get _inner(): Any$L;
-    constructor();
-    static _wrap(inner: Any$L): Listener;
-    get type(): ListenerType;
-    get event(): CbEvent;
-    set event(event: CbEvent);
-    get precedence(): number;
-    set precedence(precedence: number);
-    get space(): Space | null;
-    set space(space: Space | Any$L | null);
-    toString(): string;
+    static _zpp: Any$P;
+    static _nape: Any$P;
+    outer: Any$P;
+    userData: Any$P;
+    gravityx: Any$P;
+    gravityy: Any$P;
+    wrap_gravity: Any$P;
+    bodies: Any$P;
+    wrap_bodies: Any$P;
+    compounds: Any$P;
+    wrap_compounds: Any$P;
+    constraints: Any$P;
+    wrap_constraints: Any$P;
+    kinematics: Any$P;
+    bphase: Any$P;
+    __static: Any$P;
+    global_lin_drag: Any$P;
+    global_ang_drag: Any$P;
+    stamp: Any$P;
+    midstep: Any$P;
+    time: Any$P;
+    sortcontacts: Any$P;
+    c_arbiters_true: Any$P;
+    c_arbiters_false: Any$P;
+    f_arbiters: Any$P;
+    s_arbiters: Any$P;
+    wrap_arbiters: Any$P;
+    live: Any$P;
+    wrap_live: Any$P;
+    live_constraints: Any$P;
+    wrap_livecon: Any$P;
+    staticsleep: Any$P;
+    islands: Any$P;
+    listeners: Any$P;
+    wrap_listeners: Any$P;
+    callbacks: Any$P;
+    callbackset_list: Any$P;
+    cbsets: Any$P;
+    convexShapeList: Any$P;
+    pre_dt: Any$P;
+    toiEvents: Any$P;
+    continuous: Any$P;
+    precb: Any$P;
+    prelisteners: Any$P;
+    mrca1: Any$P;
+    mrca2: Any$P;
+    __class__: Any$P;
+    constructor(gravity?: Any$P, broadphase?: Any$P);
+    getgravity(): void;
+    gravity_invalidate(x: Any$P): void;
+    gravity_validate(): void;
+    clear(): void;
+    bodies_adder(x: Any$P): boolean;
+    bodies_subber(x: Any$P): void;
+    bodies_modifiable(): void;
+    compounds_adder(x: Any$P): boolean;
+    compounds_subber(x: Any$P): void;
+    compounds_modifiable(): void;
+    constraints_adder(x: Any$P): boolean;
+    constraints_subber(x: Any$P): void;
+    constraints_modifiable(): void;
+    listeners_adder(x: Any$P): boolean;
+    listeners_subber(x: Any$P): void;
+    listeners_modifiable(): void;
+    revoke_listener(x: Any$P): void;
+    unrevoke_listener(x: Any$P): void;
+    addListener(x: Any$P): void;
+    remListener(x: Any$P): void;
+    add_callbackset(cb: Any$P): void;
+    remove_callbackset(cb: Any$P): void;
+    transmitType(p: Any$P, new_type: Any$P): void;
+    added_shape(s: Any$P, dontwake: Any$P): void;
+    removed_shape(s: Any$P, deleting: Any$P): void;
+    addConstraint(con: Any$P): void;
+    remConstraint(con: Any$P): void;
+    addCompound(x: Any$P): void;
+    remCompound(x: Any$P): void;
+    addBody(body: Any$P, flag?: Any$P): void;
+    remBody(body: Any$P, flag?: Any$P): void;
+    shapesUnderPoint(x: Any$P, y: Any$P, filter: Any$P, output: Any$P): any;
+    bodiesUnderPoint(x: Any$P, y: Any$P, filter: Any$P, output: Any$P): any;
+    shapesInAABB(aabb: Any$P, strict: Any$P, cont: Any$P, filter: Any$P, output: Any$P): any;
+    bodiesInAABB(aabb: Any$P, strict: Any$P, cont: Any$P, filter: Any$P, output: Any$P): any;
+    shapesInCircle(pos: Any$P, rad: Any$P, cont: Any$P, filter: Any$P, output: Any$P): any;
+    bodiesInCircle(pos: Any$P, rad: Any$P, cont: Any$P, filter: Any$P, output: Any$P): any;
+    shapesInShape(shape: Any$P, cont: Any$P, filter: Any$P, output: Any$P): any;
+    bodiesInShape(shape: Any$P, cont: Any$P, filter: Any$P, output: Any$P): any;
+    rayCast(ray: Any$P, inner: Any$P, filter: Any$P): any;
+    rayMultiCast(ray: Any$P, inner: Any$P, filter: Any$P, output: Any$P): any;
+    convexCast(shape: Any$P, deltaTime: Any$P, filter: Any$P, dynamics: Any$P): any;
+    prepareCast(s: Any$P): void;
+    convexMultiCast(shape: Any$P, deltaTime: Any$P, filter: Any$P, dynamics: Any$P, output: Any$P): any;
+    push_callback(i: Any$P): ZPP_Callback;
+    step(deltaTime: Any$P, velocityIterations: Any$P, positionIterations: Any$P): void;
+    continuousCollisions(deltaTime: Any$P): void;
+    continuousEvent(s1: Any$P, s2: Any$P, stat: Any$P, in_arb: Any$P, _: Any$P): any;
+    bodyCbWake(b: Any$P): void;
+    bodyCbSleep(b: Any$P): void;
+    constraintCbWake(con: Any$P): void;
+    constraintCbSleep(con: Any$P): void;
+    constraintCbBreak(con: Any$P): void;
+    nullListenerType(cb1: Any$P, cb2: Any$P): void;
+    nullInteractorType(intx: Any$P, me: Any$P): void;
+    freshListenerType(cb1: Any$P, cb2: Any$P): void;
+    freshInteractorType(intx: Any$P, me: Any$P): void;
+    wakeCompound(x: Any$P): void;
+    wakeIsland(i: Any$P): void;
+    non_inlined_wake(o: Any$P, fst?: Any$P): void;
+    really_wake(o: Any$P, fst?: Any$P): void;
+    wake_constraint(con: Any$P, fst?: Any$P): boolean;
+    doForests(dt: Any$P): void;
+    sleepArbiters(): void;
+    static_validation(body: Any$P): void;
+    validation(): void;
+    updateVel(dt: Any$P): void;
+    updatePos(dt: Any$P): void;
+    presteparb(arb: Any$P, dt: Any$P, cont?: Any$P): boolean;
+    prestep(dt: Any$P): void;
+    warmStart(): void;
+    iterateVel(times: Any$P): void;
+    iteratePos(times: Any$P): void;
+    group_ignore(s1: Any$P, s2: Any$P): boolean;
+    interactionType(s1: Any$P, s2: Any$P, b1: Any$P, b2: Any$P): 2 | 0 | 1 | -1;
+    narrowPhase(s1: Any$P, s2: Any$P, stat: Any$P, in_arb: Any$P, continuous: Any$P): any;
+    MRCA_chains(s1: Any$P, s2: Any$P): void;
+    inlined_MRCA_chains(s1: Any$P, s2: Any$P): void;
 }
 
+type Any$O = any;
 /**
  * The physics world. Add bodies and constraints, then call `step()` each frame.
+ *
+ * Fully modernized — uses ZPP_Space directly (extracted to TypeScript).
  */
 declare class Space {
+    zpp_inner: ZPP_Space;
+    constructor(gravity?: Vec2, broadphase?: Any$O);
     /** @internal */
-    readonly _inner: NapeInner;
-    constructor(gravity?: Vec2);
+    get _inner(): Any$O;
     /** @internal */
     static _wrap(inner: NapeInner): Space;
+    get userData(): Record<string, unknown>;
     get gravity(): Vec2;
     set gravity(value: Vec2);
-    get worldLinearDrag(): number;
-    set worldLinearDrag(value: number);
-    get worldAngularDrag(): number;
-    set worldAngularDrag(value: number);
+    get broadphase(): Any$O;
     get sortContacts(): boolean;
     set sortContacts(value: boolean);
-    get bodies(): NapeList<Body>;
-    get liveBodies(): NapeList<Body>;
-    get constraints(): NapeList<Constraint>;
-    get liveConstraints(): NapeList<Constraint>;
-    get arbiters(): NapeInner;
-    get listeners(): NapeList<Listener>;
-    get compounds(): NapeInner;
-    /** The static world body (always present, immovable). */
+    get worldAngularDrag(): number;
+    set worldAngularDrag(value: number);
+    get worldLinearDrag(): number;
+    set worldLinearDrag(value: number);
+    get compounds(): Any$O;
+    get bodies(): Any$O;
+    get liveBodies(): Any$O;
+    get constraints(): Any$O;
+    get liveConstraints(): Any$O;
     get world(): Body;
+    get arbiters(): Any$O;
+    get listeners(): Any$O;
     get timeStamp(): number;
     get elapsedTime(): number;
-    get broadphase(): NapeInner;
-    get userData(): Record<string, unknown>;
     step(deltaTime: number, velocityIterations?: number, positionIterations?: number): void;
     clear(): void;
-    visitBodies(fn: (body: Body) => void): void;
-    visitConstraints(fn: (constraint: Constraint) => void): void;
-    visitCompounds(fn: (compound: NapeInner) => void): void;
-    shapesUnderPoint(point: Vec2, filter?: InteractionFilterLike, output?: NapeInner): NapeInner;
-    bodiesUnderPoint(point: Vec2, filter?: InteractionFilterLike, output?: NapeInner): NapeInner;
-    shapesInAABB(aabb: AABB, containment?: boolean, strict?: boolean, filter?: InteractionFilterLike, output?: NapeInner): NapeInner;
-    bodiesInAABB(aabb: AABB, containment?: boolean, strict?: boolean, filter?: InteractionFilterLike, output?: NapeInner): NapeInner;
-    rayCast(ray: {
-        _inner: NapeInner;
-    } | NapeInner, inner?: boolean, filter?: InteractionFilterLike): NapeInner;
-    rayMultiCast(ray: {
-        _inner: NapeInner;
-    } | NapeInner, inner?: boolean, filter?: InteractionFilterLike, output?: NapeInner): NapeInner;
+    visitBodies(lambda: (body: Body) => void): void;
+    visitConstraints(lambda: (constraint: Constraint) => void): void;
+    visitCompounds(lambda: (compound: Any$O) => void): void;
+    interactionType(shape1: Shape, shape2: Shape): Any$O;
+    shapesUnderPoint(point: Vec2, filter?: InteractionFilter | Any$O, output?: Any$O): Any$O;
+    bodiesUnderPoint(point: Vec2, filter?: InteractionFilter | Any$O, output?: Any$O): Any$O;
+    shapesInAABB(aabb: AABB, containment?: boolean, strict?: boolean, filter?: InteractionFilter | Any$O, output?: Any$O): Any$O;
+    bodiesInAABB(aabb: AABB, containment?: boolean, strict?: boolean, filter?: InteractionFilter | Any$O, output?: Any$O): Any$O;
+    shapesInCircle(position: Vec2, radius: number, containment?: boolean, filter?: InteractionFilter | Any$O, output?: Any$O): Any$O;
+    bodiesInCircle(position: Vec2, radius: number, containment?: boolean, filter?: InteractionFilter | Any$O, output?: Any$O): Any$O;
+    shapesInShape(shape: Shape, containment?: boolean, filter?: InteractionFilter | Any$O, output?: Any$O): Any$O;
+    bodiesInShape(shape: Shape, containment?: boolean, filter?: InteractionFilter | Any$O, output?: Any$O): Any$O;
+    shapesInBody(body: Body, filter?: InteractionFilter | Any$O, output?: Any$O): Any$O;
+    bodiesInBody(body: Body, filter?: InteractionFilter | Any$O, output?: Any$O): Any$O;
+    convexCast(shape: Shape, deltaTime: number, liveSweep?: boolean, filter?: InteractionFilter | Any$O): Any$O;
+    convexMultiCast(shape: Shape, deltaTime: number, liveSweep?: boolean, filter?: InteractionFilter | Any$O, output?: Any$O): Any$O;
+    rayCast(ray: Ray | Any$O, inner?: boolean, filter?: InteractionFilter | Any$O): Any$O;
+    rayMultiCast(ray: Ray | Any$O, inner?: boolean, filter?: InteractionFilter | Any$O, output?: Any$O): Any$O;
     toString(): string;
+    /** @internal */ get_userData(): Any$O;
+    /** @internal */ get_gravity(): Any$O;
+    /** @internal */ set_gravity(v: Any$O): Any$O;
+    /** @internal */ get_broadphase(): Any$O;
+    /** @internal */ get_sortContacts(): boolean;
+    /** @internal */ set_sortContacts(v: boolean): boolean;
+    /** @internal */ get_worldAngularDrag(): number;
+    /** @internal */ set_worldAngularDrag(v: number): number;
+    /** @internal */ get_worldLinearDrag(): number;
+    /** @internal */ set_worldLinearDrag(v: number): number;
+    /** @internal */ get_compounds(): Any$O;
+    /** @internal */ get_bodies(): Any$O;
+    /** @internal */ get_liveBodies(): Any$O;
+    /** @internal */ get_constraints(): Any$O;
+    /** @internal */ get_liveConstraints(): Any$O;
+    /** @internal */ get_world(): Any$O;
+    /** @internal */ get_arbiters(): Any$O;
+    /** @internal */ get_listeners(): Any$O;
+    /** @internal */ get_timeStamp(): number;
+    /** @internal */ get_elapsedTime(): number;
 }
-/** @internal Helper type for filter-like parameters. */
-type InteractionFilterLike = {
-    _inner: NapeInner;
-} | NapeInner | undefined;
 
 /**
  * Body type enumeration.
@@ -1369,22 +1560,22 @@ declare class BodyType {
  *
  * Converted from nape-compiled.js lines 63367–63463, 135330–135331.
  */
-type Any$K = any;
+type Any$N = any;
 declare class ZPP_InteractionGroup {
     static SHAPE: number;
     static BODY: number;
     static __name__: string[];
-    static _zpp: Any$K;
-    static _wrapFn: ((zpp: ZPP_InteractionGroup) => Any$K) | null;
-    outer: Any$K;
+    static _zpp: Any$N;
+    static _wrapFn: ((zpp: ZPP_InteractionGroup) => Any$N) | null;
+    outer: Any$N;
     ignore: boolean;
     group: ZPP_InteractionGroup | null;
-    groups: Any$K;
-    wrap_groups: Any$K;
-    interactors: Any$K;
-    wrap_interactors: Any$K;
+    groups: Any$N;
+    wrap_groups: Any$N;
+    interactors: Any$N;
+    wrap_interactors: Any$N;
     depth: number;
-    __class__: Any$K;
+    __class__: Any$N;
     constructor();
     /** Set or change the parent group. */
     setGroup(group: ZPP_InteractionGroup | null): void;
@@ -1395,9 +1586,9 @@ declare class ZPP_InteractionGroup {
     /** Remove a child group. */
     remGroup(group: ZPP_InteractionGroup): void;
     /** Register an interactor in this group. */
-    addInteractor(intx: Any$K): void;
+    addInteractor(intx: Any$N): void;
     /** Unregister an interactor from this group. */
-    remInteractor(intx: Any$K, flag?: number): void;
+    remInteractor(intx: Any$N, flag?: number): void;
 }
 
 /**
@@ -1492,46 +1683,46 @@ declare class Interactor {
  * Converted from nape-compiled.js lines 52431–54547.
  */
 
-type Any$J = any;
+type Any$M = any;
 declare class ZPP_Body {
     static __name__: string[];
-    static __super__: Any$J;
+    static __super__: Any$M;
     /**
      * Namespace references, set by the compiled module after import.
      * _nape = the `nape` public namespace
      * _zpp = the `zpp_nape` internal namespace
      */
-    static _nape: Any$J;
-    static _zpp: Any$J;
-    static types: Any$J[];
-    static bodystack: Any$J;
-    static bodyset: Any$J;
+    static _nape: Any$M;
+    static _zpp: Any$M;
+    static types: Any$M[];
+    static bodystack: Any$M;
+    static bodyset: Any$M;
     static cur_graph_depth: number;
-    static bodysetlt(a: Any$J, b: Any$J): boolean;
-    static __static(): Any$J;
-    outer_i: Any$J;
+    static bodysetlt(a: Any$M, b: Any$M): boolean;
+    static __static(): Any$M;
+    outer_i: Any$M;
     id: number;
-    userData: Any$J;
-    ishape: Any$J;
-    ibody: Any$J;
-    icompound: Any$J;
-    wrap_cbTypes: Any$J;
-    cbSet: Any$J;
-    cbTypes: Any$J;
-    group: Any$J;
-    cbsets: Any$J;
-    outer: Any$J;
+    userData: Any$M;
+    ishape: Any$M;
+    ibody: Any$M;
+    icompound: Any$M;
+    wrap_cbTypes: Any$M;
+    cbSet: Any$M;
+    cbTypes: Any$M;
+    group: Any$M;
+    cbsets: Any$M;
+    outer: Any$M;
     world: boolean;
     type: number;
-    compound: Any$J;
-    shapes: Any$J;
-    wrap_shapes: Any$J;
-    space: Any$J;
-    arbiters: Any$J;
-    wrap_arbiters: Any$J;
-    constraints: Any$J;
-    wrap_constraints: Any$J;
-    component: Any$J;
+    compound: Any$M;
+    shapes: Any$M;
+    wrap_shapes: Any$M;
+    space: Any$M;
+    arbiters: Any$M;
+    wrap_arbiters: Any$M;
+    constraints: Any$M;
+    wrap_constraints: Any$M;
+    component: Any$M;
     graph_depth: number;
     sweepTime: number;
     sweep_angvel: number;
@@ -1544,20 +1735,20 @@ declare class ZPP_Body {
     pre_posy: number;
     posx: number;
     posy: number;
-    wrap_pos: Any$J;
+    wrap_pos: Any$M;
     velx: number;
     vely: number;
-    wrap_vel: Any$J;
+    wrap_vel: Any$M;
     forcex: number;
     forcey: number;
-    wrap_force: Any$J;
+    wrap_force: Any$M;
     kinvelx: number;
     kinvely: number;
-    wrap_kinvel: Any$J;
+    wrap_kinvel: Any$M;
     svelx: number;
     svely: number;
-    wrap_svel: Any$J;
-    wrapcvel: Any$J;
+    wrap_svel: Any$M;
+    wrapcvel: Any$M;
     angvel: number;
     torque: number;
     kinangvel: number;
@@ -1594,9 +1785,9 @@ declare class ZPP_Body {
     worldCOMx: number;
     worldCOMy: number;
     zip_worldCOM: boolean;
-    wrap_localCOM: Any$J;
-    wrap_worldCOM: Any$J;
-    __class__: Any$J;
+    wrap_localCOM: Any$M;
+    wrap_worldCOM: Any$M;
+    __class__: Any$M;
     constructor();
     isStatic(): boolean;
     isDynamic(): boolean;
@@ -1604,23 +1795,23 @@ declare class ZPP_Body {
     invalidate_type(): void;
     invalidate_shapes(): void;
     init_bodysetlist(): void;
-    connectedBodies_cont(b: Any$J): void;
-    connectedBodies(depth: number, output: Any$J): Any$J;
-    interactingBodies(type: number, output: Any$J): Any$J;
+    connectedBodies_cont(b: Any$M): void;
+    connectedBodies(depth: number, output: Any$M): Any$M;
+    interactingBodies(type: number, output: Any$M): Any$M;
     atRest(dt: number): boolean;
     refreshArbiters(): void;
     sweepIntegrate(dt: number): void;
-    sweepValidate(s: Any$J): void;
+    sweepValidate(s: Any$M): void;
     invalidate_pos(): void;
-    pos_invalidate(pos: Any$J): void;
+    pos_invalidate(pos: Any$M): void;
     pos_validate(): void;
-    vel_invalidate(vel: Any$J): void;
+    vel_invalidate(vel: Any$M): void;
     vel_validate(): void;
-    kinvel_invalidate(vel: Any$J): void;
+    kinvel_invalidate(vel: Any$M): void;
     kinvel_validate(): void;
-    svel_invalidate(vel: Any$J): void;
+    svel_invalidate(vel: Any$M): void;
     svel_validate(): void;
-    force_invalidate(force: Any$J): void;
+    force_invalidate(force: Any$M): void;
     force_validate(): void;
     private _setupVec2Wrapper;
     setupPosition(): void;
@@ -1657,37 +1848,37 @@ declare class ZPP_Body {
     getworldCOM(): void;
     __immutable_midstep(): void;
     clear(): void;
-    shapes_adder(s: Any$J): boolean;
-    shapes_subber(s: Any$J): void;
-    shapes_invalidate(_param: Any$J): void;
+    shapes_adder(s: Any$M): boolean;
+    shapes_subber(s: Any$M): void;
+    shapes_invalidate(_param: Any$M): void;
     shapes_modifiable(): void;
     addedToSpace(): void;
     removedFromSpace(): void;
     private _removeArbiterFromList;
-    copy(): Any$J;
+    copy(): Any$M;
     wake: () => void;
     __iaddedToSpace: () => void;
     __iremovedFromSpace: () => void;
     immutable_midstep: (name: string) => void;
-    copyto: (ret: Any$J) => void;
-    insert_cbtype: (cb: Any$J) => void;
+    copyto: (ret: Any$M) => void;
+    insert_cbtype: (cb: Any$M) => void;
     alloc_cbSet: () => void;
     dealloc_cbSet: () => void;
     setupcbTypes: () => void;
     immutable_cbTypes: () => void;
-    wrap_cbTypes_subber: (pcb: Any$J) => void;
-    wrap_cbTypes_adder: (cb: Any$J) => void;
-    setGroup: (group: Any$J) => void;
-    lookup_group: () => Any$J;
-    getSpace: () => Any$J;
+    wrap_cbTypes_subber: (pcb: Any$M) => void;
+    wrap_cbTypes_adder: (cb: Any$M) => void;
+    setGroup: (group: Any$M) => void;
+    lookup_group: () => Any$M;
+    getSpace: () => Any$M;
     isShape: () => boolean;
     isBody: () => boolean;
     isCompound: () => boolean;
     static _initialized: boolean;
-    static _init(zpp: Any$J, nape: Any$J): void;
+    static _init(zpp: Any$M, nape: Any$M): void;
 }
 
-type Any$I = any;
+type Any$L = any;
 /**
  * A rigid body in the physics simulation.
  *
@@ -1695,7 +1886,7 @@ type Any$I = any;
  */
 declare class Body extends Interactor {
     static __name__: string[];
-    static __super__: Any$I;
+    static __super__: Any$L;
     /** Direct access to the extracted internal ZPP_Body. */
     zpp_inner: ZPP_Body;
     debugDraw: boolean;
@@ -1747,47 +1938,47 @@ declare class Body extends Interactor {
     get shapes(): NapeList<Shape>;
     get space(): Space;
     set space(value: Space | null);
-    get compound(): Any$I;
-    set compound(value: Any$I);
+    get compound(): Any$L;
+    set compound(value: Any$L);
     get bounds(): AABB;
     get constraintVelocity(): Vec2;
     get localCOM(): Vec2;
     get worldCOM(): Vec2;
-    get massMode(): Any$I;
-    set massMode(value: Any$I);
-    get inertiaMode(): Any$I;
-    set inertiaMode(value: Any$I);
-    get gravMassMode(): Any$I;
-    set gravMassMode(value: Any$I);
+    get massMode(): Any$L;
+    set massMode(value: Any$L);
+    get inertiaMode(): Any$L;
+    set inertiaMode(value: Any$L);
+    get gravMassMode(): Any$L;
+    set gravMassMode(value: Any$L);
     copy(): Body;
     toString(): string;
-    get_type(): Any$I;
-    set_type(type: Any$I): Any$I;
-    get_shapes(): Any$I;
+    get_type(): Any$L;
+    set_type(type: Any$L): Any$L;
+    get_shapes(): Any$L;
     get_isBullet(): boolean;
     set_isBullet(v: boolean): boolean;
     get_disableCCD(): boolean;
     set_disableCCD(v: boolean): boolean;
-    get_position(): Any$I;
-    set_position(position: Any$I): Any$I;
-    get_velocity(): Any$I;
-    set_velocity(velocity: Any$I): Any$I;
+    get_position(): Any$L;
+    set_position(position: Any$L): Any$L;
+    get_velocity(): Any$L;
+    set_velocity(velocity: Any$L): Any$L;
     get_rotation(): number;
     set_rotation(rotation: number): number;
     get_angularVel(): number;
     set_angularVel(angularVel: number): number;
-    get_kinematicVel(): Any$I;
-    set_kinematicVel(kinematicVel: Any$I): Any$I;
+    get_kinematicVel(): Any$L;
+    set_kinematicVel(kinematicVel: Any$L): Any$L;
     get_kinAngVel(): number;
     set_kinAngVel(kinAngVel: number): number;
-    get_surfaceVel(): Any$I;
-    set_surfaceVel(surfaceVel: Any$I): Any$I;
-    get_force(): Any$I;
-    set_force(force: Any$I): Any$I;
+    get_surfaceVel(): Any$L;
+    set_surfaceVel(surfaceVel: Any$L): Any$L;
+    get_force(): Any$L;
+    set_force(force: Any$L): Any$L;
     get_torque(): number;
     set_torque(torque: number): number;
-    get_bounds(): Any$I;
-    get_constraintVelocity(): Any$I;
+    get_bounds(): Any$L;
+    get_constraintVelocity(): Any$L;
     get_constraintMass(): number;
     get_constraintInertia(): number;
     get_allowMovement(): boolean;
@@ -1795,28 +1986,28 @@ declare class Body extends Interactor {
     get_allowRotation(): boolean;
     set_allowRotation(allowRotation: boolean): boolean;
     get_isSleeping(): boolean;
-    get_compound(): Any$I;
-    set_compound(compound: Any$I): Any$I;
-    get_space(): Any$I;
-    set_space(space: Any$I): Any$I;
-    get_arbiters(): Any$I;
-    get_constraints(): Any$I;
-    get_massMode(): Any$I;
-    set_massMode(massMode: Any$I): Any$I;
+    get_compound(): Any$L;
+    set_compound(compound: Any$L): Any$L;
+    get_space(): Any$L;
+    set_space(space: Any$L): Any$L;
+    get_arbiters(): Any$L;
+    get_constraints(): Any$L;
+    get_massMode(): Any$L;
+    set_massMode(massMode: Any$L): Any$L;
     get_mass(): number;
     set_mass(mass: number): number;
-    get_gravMassMode(): Any$I;
-    set_gravMassMode(gravMassMode: Any$I): Any$I;
+    get_gravMassMode(): Any$L;
+    set_gravMassMode(gravMassMode: Any$L): Any$L;
     get_gravMass(): number;
     set_gravMass(gravMass: number): number;
     get_gravMassScale(): number;
     set_gravMassScale(gravMassScale: number): number;
-    get_inertiaMode(): Any$I;
-    set_inertiaMode(inertiaMode: Any$I): Any$I;
+    get_inertiaMode(): Any$L;
+    set_inertiaMode(inertiaMode: Any$L): Any$L;
     get_inertia(): number;
     set_inertia(inertia: number): number;
-    get_localCOM(): Any$I;
-    get_worldCOM(): Any$I;
+    get_localCOM(): Any$L;
+    get_worldCOM(): Any$L;
     integrate(deltaTime: number): Body;
     localPointToWorld(point: Vec2, weak?: boolean): Vec2;
     worldPointToLocal(point: Vec2, weak?: boolean): Vec2;
@@ -1828,24 +2019,24 @@ declare class Body extends Interactor {
     translateShapes(translation: Vec2): Body;
     rotateShapes(angle: number): Body;
     scaleShapes(scaleX: number, scaleY: number): Body;
-    transformShapes(matrix: Any$I): Body;
+    transformShapes(matrix: Any$L): Body;
     align(): Body;
     rotate(centre: Vec2, angle: number): Body;
-    setShapeMaterials(material: Any$I): Body;
-    setShapeFilters(filter: Any$I): Body;
-    setShapeFluidProperties(fluidProperties: Any$I): Body;
+    setShapeMaterials(material: Any$L): Body;
+    setShapeFilters(filter: Any$L): Body;
+    setShapeFluidProperties(fluidProperties: Any$L): Body;
     contains(point: Vec2): boolean;
-    connectedBodies(depth?: number, output?: Any$I): Any$I;
-    interactingBodies(type?: Any$I, depth?: number, output?: Any$I): Any$I;
-    normalImpulse(body?: Any$I, freshOnly?: boolean): Vec3;
-    tangentImpulse(body?: Any$I, freshOnly?: boolean): Vec3;
-    totalContactsImpulse(body?: Any$I, freshOnly?: boolean): Vec3;
-    rollingImpulse(body?: Any$I, freshOnly?: boolean): number;
-    buoyancyImpulse(body?: Any$I): Vec3;
-    dragImpulse(body?: Any$I): Vec3;
-    totalFluidImpulse(body?: Any$I): Vec3;
+    connectedBodies(depth?: number, output?: Any$L): Any$L;
+    interactingBodies(type?: Any$L, depth?: number, output?: Any$L): Any$L;
+    normalImpulse(body?: Any$L, freshOnly?: boolean): Vec3;
+    tangentImpulse(body?: Any$L, freshOnly?: boolean): Vec3;
+    totalContactsImpulse(body?: Any$L, freshOnly?: boolean): Vec3;
+    rollingImpulse(body?: Any$L, freshOnly?: boolean): number;
+    buoyancyImpulse(body?: Any$L): Vec3;
+    dragImpulse(body?: Any$L): Vec3;
+    totalFluidImpulse(body?: Any$L): Vec3;
     constraintsImpulse(): Vec3;
-    totalImpulse(body?: Any$I, freshOnly?: boolean): Vec3;
+    totalImpulse(body?: Any$L, freshOnly?: boolean): Vec3;
     crushFactor(): number;
     private _arbiterImpulseQuery;
 }
@@ -1858,7 +2049,7 @@ declare class Body extends Interactor {
  *
  * Converted from nape-compiled.js lines 87523–87601, 135477–135481.
  */
-type Any$H = any;
+type Any$K = any;
 declare class ZPP_Material {
     static zpp_pool: ZPP_Material | null;
     static WAKE: number;
@@ -1871,27 +2062,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$H;
-    static _zpp: Any$H;
+    static _nape: Any$K;
+    static _zpp: Any$K;
     /**
      * 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$H) | null;
+    static _wrapFn: ((zpp: ZPP_Material) => Any$K) | null;
     elasticity: number;
     dynamicFriction: number;
     staticFriction: number;
     density: number;
     rollingFriction: number;
-    shapes: Any$H;
-    wrap_shapes: Any$H;
-    outer: Any$H;
-    userData: Any$H;
+    shapes: Any$K;
+    wrap_shapes: Any$K;
+    outer: Any$K;
+    userData: Any$K;
     next: ZPP_Material | null;
-    __class__: Any$H;
+    __class__: Any$K;
     constructor();
     /** Create/return the public nape.phys.Material wrapper for this internal object. */
-    wrapper(): Any$H;
+    wrapper(): Any$K;
     /** Called when this object is returned to the pool. */
     free(): void;
     /** Called when this object is taken from the pool. */
@@ -1899,9 +2090,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$H): void;
+    addShape(shape: Any$K): void;
     /** Unregister a shape that no longer uses this material. */
-    remShape(shape: Any$H): void;
+    remShape(shape: Any$K): void;
     /** Create a copy with the same property values. */
     copy(): ZPP_Material;
     /** Copy all property values from another ZPP_Material. */
@@ -1961,36 +2152,36 @@ declare class Material {
  *
  * Converted from nape-compiled.js lines 87335–87523, 135403.
  */
-type Any$G = any;
+type Any$J = any;
 declare class ZPP_FluidProperties {
     static zpp_pool: ZPP_FluidProperties | null;
     static __name__: string[];
-    static _nape: Any$G;
-    static _zpp: Any$G;
-    static _wrapFn: ((zpp: ZPP_FluidProperties) => Any$G) | null;
+    static _nape: Any$J;
+    static _zpp: Any$J;
+    static _wrapFn: ((zpp: ZPP_FluidProperties) => Any$J) | null;
     viscosity: number;
     density: number;
     gravityx: number;
     gravityy: number;
-    wrap_gravity: Any$G;
-    shapes: Any$G;
-    wrap_shapes: Any$G;
-    outer: Any$G;
-    userData: Any$G;
+    wrap_gravity: Any$J;
+    shapes: Any$J;
+    wrap_shapes: Any$J;
+    outer: Any$J;
+    userData: Any$J;
     next: ZPP_FluidProperties | null;
-    __class__: Any$G;
+    __class__: Any$J;
     constructor();
     /** Create/return the public nape.phys.FluidProperties wrapper. */
-    wrapper(): Any$G;
+    wrapper(): Any$J;
     free(): void;
     alloc(): void;
     feature_cons(): void;
-    addShape(shape: Any$G): void;
-    remShape(shape: Any$G): void;
+    addShape(shape: Any$J): void;
+    remShape(shape: Any$J): void;
     /** Copy with object pooling. */
     copy(): ZPP_FluidProperties;
     /** Called when gravity Vec2 wrapper is invalidated (user set new gravity). */
-    gravity_invalidate(x: Any$G): void;
+    gravity_invalidate(x: Any$J): void;
     /** Sync the gravity Vec2 wrapper with internal values. */
     gravity_validate(): void;
     /** Lazily create and return the gravity Vec2 wrapper. */
@@ -2033,96 +2224,6 @@ declare class FluidProperties {
     toString(): string;
 }
 
-/**
- * ZPP_InteractionFilter — Internal interaction filter for the nape physics engine.
- *
- * Stores collision/sensor/fluid group and mask bitmasks that determine
- * which shapes interact with each other.
- *
- * Converted from nape-compiled.js lines 63255–63366, 135329.
- */
-type Any$F = any;
-declare class ZPP_InteractionFilter {
-    static zpp_pool: ZPP_InteractionFilter | null;
-    static __name__: string[];
-    static _nape: Any$F;
-    static _zpp: Any$F;
-    static _wrapFn: ((zpp: ZPP_InteractionFilter) => Any$F) | null;
-    collisionGroup: number;
-    collisionMask: number;
-    sensorGroup: number;
-    sensorMask: number;
-    fluidGroup: number;
-    fluidMask: number;
-    shapes: Any$F;
-    wrap_shapes: Any$F;
-    outer: Any$F;
-    userData: Any$F;
-    next: ZPP_InteractionFilter | null;
-    __class__: Any$F;
-    constructor();
-    /** Create/return the public nape.dynamics.InteractionFilter wrapper. */
-    wrapper(): Any$F;
-    free(): void;
-    alloc(): void;
-    feature_cons(): void;
-    addShape(shape: Any$F): void;
-    remShape(shape: Any$F): void;
-    /** Create a copy with object pooling. */
-    copy(): ZPP_InteractionFilter;
-    /** Test whether two filters allow collision between their shapes. */
-    shouldCollide(x: ZPP_InteractionFilter): boolean;
-    /** Test whether two filters allow sensor interaction. */
-    shouldSense(x: ZPP_InteractionFilter): boolean;
-    /** Test whether two filters allow fluid interaction. */
-    shouldFlow(x: ZPP_InteractionFilter): boolean;
-    /** Notify all shapes that the filter changed. */
-    invalidate(): void;
-}
-
-/**
- * Bit-mask based interaction filter for controlling which shapes
- * collide, sense, or interact as fluids.
- *
- * Internally wraps a ZPP_InteractionFilter and is registered as
- * the public `nape.dynamics.InteractionFilter` class in the compiled namespace.
- *
- * Converted from nape-compiled.js lines 14361–14640.
- */
-declare class InteractionFilter {
-    static __name__: string[];
-    /** @internal The internal ZPP_InteractionFilter this wrapper owns. */
-    zpp_inner: ZPP_InteractionFilter;
-    /**
-     * Backward-compatible accessor — returns `this` so that compiled engine
-     * code that receives `filter._inner` can still access `zpp_inner`.
-     * @internal
-     */
-    get _inner(): NapeInner;
-    constructor(collisionGroup?: number, collisionMask?: number, sensorGroup?: number, sensorMask?: number, fluidGroup?: number, fluidMask?: number);
-    /** @internal Wrap a ZPP_InteractionFilter (or legacy compiled InteractionFilter) with caching. */
-    static _wrap(inner: any): InteractionFilter;
-    get collisionGroup(): number;
-    set collisionGroup(value: number);
-    get collisionMask(): number;
-    set collisionMask(value: number);
-    get sensorGroup(): number;
-    set sensorGroup(value: number);
-    get sensorMask(): number;
-    set sensorMask(value: number);
-    get fluidGroup(): number;
-    set fluidGroup(value: number);
-    get fluidMask(): number;
-    set fluidMask(value: number);
-    get userData(): Record<string, unknown>;
-    get shapes(): any;
-    shouldCollide(filter: InteractionFilter): boolean;
-    shouldSense(filter: InteractionFilter): boolean;
-    shouldFlow(filter: InteractionFilter): boolean;
-    copy(): InteractionFilter;
-    toString(): string;
-}
-
 /**
  * Shape type classification.
  *
@@ -2264,77 +2365,77 @@ declare class Geom {
  *
  * Converted from nape-compiled.js lines 55195–55521.
  */
-type Any$E = any;
+type Any$I = any;
 declare class ZPP_Compound {
     static __name__: string[];
-    static __super__: Any$E;
+    static __super__: Any$I;
     /**
      * Namespace references, set by the compiled module after import.
      * _nape = the `nape` public namespace (for wrapper creation in copy())
      * _zpp = the `zpp_nape` internal namespace (for ZNPList_*, ZPP_BodyList, etc.)
      */
-    static _nape: Any$E;
-    static _zpp: Any$E;
+    static _nape: Any$I;
+    static _zpp: Any$I;
     /**
      * Wrapper factory callback, registered by the modernized Compound class.
      * When set, wrapper() uses this instead of the compiled Compound constructor.
      */
-    static _wrapFn: ((zpp: ZPP_Compound) => Any$E) | null;
-    outer_i: Any$E;
+    static _wrapFn: ((zpp: ZPP_Compound) => Any$I) | null;
+    outer_i: Any$I;
     id: number;
-    userData: Any$E;
-    ishape: Any$E;
-    ibody: Any$E;
-    icompound: Any$E;
-    wrap_cbTypes: Any$E;
-    cbSet: Any$E;
-    cbTypes: Any$E;
-    group: Any$E;
-    cbsets: Any$E;
-    outer: Any$E;
-    bodies: Any$E;
-    constraints: Any$E;
-    compounds: Any$E;
-    wrap_bodies: Any$E;
-    wrap_constraints: Any$E;
-    wrap_compounds: Any$E;
+    userData: Any$I;
+    ishape: Any$I;
+    ibody: Any$I;
+    icompound: Any$I;
+    wrap_cbTypes: Any$I;
+    cbSet: Any$I;
+    cbTypes: Any$I;
+    group: Any$I;
+    cbsets: Any$I;
+    outer: Any$I;
+    bodies: Any$I;
+    constraints: Any$I;
+    compounds: Any$I;
+    wrap_bodies: Any$I;
+    wrap_constraints: Any$I;
+    wrap_compounds: Any$I;
     depth: number;
-    compound: Any$E;
-    space: Any$E;
-    __class__: Any$E;
+    compound: Any$I;
+    space: Any$I;
+    __class__: Any$I;
     constructor();
     __imutable_midstep(name: string): void;
     addedToSpace(): void;
     removedFromSpace(): void;
     breakApart(): void;
     private static _zppOf;
-    bodies_adder(x: Any$E): boolean;
-    bodies_subber(x: Any$E): void;
+    bodies_adder(x: Any$I): boolean;
+    bodies_subber(x: Any$I): void;
     bodies_modifiable(): void;
-    constraints_adder(x: Any$E): boolean;
-    constraints_subber(x: Any$E): void;
+    constraints_adder(x: Any$I): boolean;
+    constraints_subber(x: Any$I): void;
     constraints_modifiable(): void;
-    compounds_adder(x: Any$E): boolean;
-    compounds_subber(x: Any$E): void;
+    compounds_adder(x: Any$I): boolean;
+    compounds_subber(x: Any$I): void;
     compounds_modifiable(): void;
-    copy(dict?: Any$E[], todo?: Any$E[]): Any$E;
+    copy(dict?: Any$I[], todo?: Any$I[]): Any$I;
     isShape: () => boolean;
     isBody: () => boolean;
     isCompound: () => boolean;
     __iaddedToSpace: () => void;
     __iremovedFromSpace: () => void;
     wake: () => void;
-    getSpace: () => Any$E;
+    getSpace: () => Any$I;
     setupcbTypes: () => void;
     immutable_cbTypes: () => void;
-    wrap_cbTypes_subber: (pcb: Any$E) => void;
-    wrap_cbTypes_adder: (cb: Any$E) => boolean;
-    insert_cbtype: (cb: Any$E) => void;
+    wrap_cbTypes_subber: (pcb: Any$I) => void;
+    wrap_cbTypes_adder: (cb: Any$I) => boolean;
+    insert_cbtype: (cb: Any$I) => void;
     alloc_cbSet: () => void;
     dealloc_cbSet: () => void;
     immutable_midstep: (name: string) => void;
-    copyto: (ret: Any$E) => void;
-    lookup_group: () => Any$E;
+    copyto: (ret: Any$I) => void;
+    lookup_group: () => Any$I;
     /**
      * Initialize prototype by copying ZPP_Interactor methods.
      * Must be called after _zpp is set (during compiled module init).
@@ -2342,7 +2443,7 @@ declare class ZPP_Compound {
     static _init(): void;
 }
 
-type Any$D = any;
+type Any$H = any;
 /**
  * A compound physics object — a hierarchical grouping of Bodies, Constraints,
  * and other Compounds.
@@ -2351,18 +2452,18 @@ type Any$D = any;
  */
 declare class Compound extends Interactor {
     static __name__: string[];
-    static __super__: Any$D;
+    static __super__: Any$H;
     /** Direct access to the extracted internal ZPP_Compound. */
     zpp_inner: ZPP_Compound;
     constructor();
     /** @internal */
     static _wrap(inner: NapeInner): Compound;
     /** Bodies in this compound. */
-    get bodies(): Any$D;
+    get bodies(): Any$H;
     /** Constraints in this compound. */
-    get constraints(): Any$D;
+    get constraints(): Any$H;
     /** Child compounds in this compound. */
-    get compounds(): Any$D;
+    get compounds(): Any$H;
     /** Parent compound, or null if this is a root compound. */
     get compound(): Compound | null;
     set compound(value: Compound | null);
@@ -2376,7 +2477,7 @@ declare class Compound extends Interactor {
     /** Recursively visit all bodies in this compound and its sub-compounds. */
     visitBodies(lambda: (body: Body) => void): void;
     /** Recursively visit all constraints in this compound and its sub-compounds. */
-    visitConstraints(lambda: (constraint: Any$D) => void): void;
+    visitConstraints(lambda: (constraint: Any$H) => void): void;
     /** Recursively visit all sub-compounds in this compound. */
     visitCompounds(lambda: (compound: Compound) => void): void;
     /** Calculate the center of mass of all bodies in this compound. */
@@ -2386,13 +2487,13 @@ declare class Compound extends Interactor {
     /** Rotate all bodies in this compound around the given centre point. */
     rotate(centre: Vec2, angle: number): Compound;
     toString(): string;
-    get_bodies(): Any$D;
-    get_constraints(): Any$D;
-    get_compounds(): Any$D;
-    get_compound(): Any$D;
-    set_compound(compound: Any$D): Any$D;
-    get_space(): Any$D;
-    set_space(space: Any$D): Any$D;
+    get_bodies(): Any$H;
+    get_constraints(): Any$H;
+    get_compounds(): Any$H;
+    get_compound(): Any$H;
+    set_compound(compound: Any$H): Any$H;
+    get_space(): Any$H;
+    set_space(space: Any$H): Any$H;
 }
 
 /**
@@ -2460,21 +2561,21 @@ declare class MassMode {
  *
  * Converted from nape-compiled.js lines 41496–41827.
  */
-type Any$C = any;
+type Any$G = any;
 declare class ZPP_Circle {
     static __name__: string[];
-    static __super__: Any$C;
-    static _nape: Any$C;
-    static _zpp: Any$C;
+    static __super__: Any$G;
+    static _nape: Any$G;
+    static _zpp: Any$G;
     static _initialized: boolean;
     radius: number;
-    outer_zn: Any$C;
-    __class__: Any$C;
-    body: Any$C;
+    outer_zn: Any$G;
+    __class__: Any$G;
+    body: Any$G;
     type: number;
-    circle: Any$C;
-    polygon: Any$C;
-    aabb: Any$C;
+    circle: Any$G;
+    polygon: Any$G;
+    aabb: Any$G;
     localCOMx: number;
     localCOMy: number;
     worldCOMx: number;
@@ -2488,25 +2589,25 @@ declare class ZPP_Circle {
     angDrag: number;
     sweepCoef: number;
     sweepRadius: number;
-    material: Any$C;
-    filter: Any$C;
-    wrap_localCOM: Any$C;
-    outer: Any$C;
-    outer_i: Any$C;
-    space: Any$C;
+    material: Any$G;
+    filter: Any$G;
+    wrap_localCOM: Any$G;
+    outer: Any$G;
+    outer_i: Any$G;
+    space: Any$G;
     invalidate_area_inertia: () => void;
     invalidate_angDrag: () => void;
     invalidate_localCOM: () => void;
     immutable_midstep: (name: string) => void;
-    setMaterial: (mat: Any$C) => void;
-    setFilter: (filt: Any$C) => void;
-    insert_cbtype: (cb: Any$C) => void;
+    setMaterial: (mat: Any$G) => void;
+    setFilter: (filt: Any$G) => void;
+    insert_cbtype: (cb: Any$G) => void;
     constructor();
     static _init(): void;
     __clear(): void;
     invalidate_radius(): void;
     localCOM_validate(): void;
-    localCOM_invalidate(x: Any$C): void;
+    localCOM_invalidate(x: Any$G): void;
     localCOM_immutable(): void;
     setupLocalCOM(): void;
     __validate_aabb(): void;
@@ -2517,11 +2618,11 @@ declare class ZPP_Circle {
     __scale(sx: number, sy: number): void;
     __translate(x: number, y: number): void;
     __rotate(x: number, y: number): void;
-    __transform(m: Any$C): void;
-    __copy(): Any$C;
+    __transform(m: Any$G): void;
+    __copy(): Any$G;
 }
 
-type Any$B = any;
+type Any$F = any;
 /**
  * A circular physics shape.
  *
@@ -2531,7 +2632,7 @@ type Any$B = any;
  */
 declare class Circle extends Shape {
     static __name__: string[];
-    static __super__: Any$B;
+    static __super__: Any$F;
     /** Direct access to the extracted internal ZPP_Circle. */
     zpp_inner_zn: ZPP_Circle;
     constructor(radius?: number, localCOM?: Vec2, material?: Material, filter?: InteractionFilter);
@@ -2541,26 +2642,152 @@ declare class Circle extends Shape {
     set radius(value: number);
 }
 
+/**
+ * ZPP_Polygon — Internal polygon shape for the nape physics engine.
+ *
+ * Extends ZPP_Shape (type=1). Manages vertex rings (local/world),
+ * edge lists, validation, and polygon-specific physics calculations.
+ *
+ * Converted from nape-compiled.js lines 42176–43786.
+ */
+type Any$E = any;
+declare class ZPP_Polygon {
+    static __name__: string[];
+    static __super__: Any$E;
+    static _nape: Any$E;
+    static _zpp: Any$E;
+    static _initialized: boolean;
+    outer_zn: Any$E;
+    lverts: Any$E;
+    wrap_lverts: Any$E;
+    gverts: Any$E;
+    wrap_gverts: Any$E;
+    edges: Any$E;
+    wrap_edges: Any$E;
+    edgeCnt: number;
+    reverse_flag: boolean;
+    zip_lverts: boolean;
+    zip_laxi: boolean;
+    zip_gverts: boolean;
+    zip_gaxi: boolean;
+    zip_valid: boolean;
+    zip_sanitation: boolean;
+    validation: Any$E;
+    __class__: Any$E;
+    body: Any$E;
+    type: number;
+    circle: Any$E;
+    polygon: Any$E;
+    aabb: Any$E;
+    localCOMx: number;
+    localCOMy: number;
+    worldCOMx: number;
+    worldCOMy: number;
+    zip_localCOM: boolean;
+    zip_worldCOM: boolean;
+    zip_aabb: boolean;
+    zip_sweepRadius: boolean;
+    zip_area_inertia: boolean;
+    zip_angDrag: boolean;
+    area: number;
+    inertia: number;
+    angDrag: number;
+    sweepCoef: number;
+    sweepRadius: number;
+    material: Any$E;
+    filter: Any$E;
+    wrap_localCOM: Any$E;
+    outer: Any$E;
+    outer_i: Any$E;
+    invalidate_area_inertia: () => void;
+    invalidate_angDrag: () => void;
+    invalidate_localCOM: () => void;
+    invalidate_worldCOM: () => void;
+    validate_area_inertia: () => void;
+    validate_localCOM: () => void;
+    immutable_midstep: (name: string) => void;
+    wake: () => void;
+    setMaterial: (m: Any$E) => void;
+    setFilter: (f: Any$E) => void;
+    insert_cbtype: (cb: Any$E) => void;
+    constructor();
+    static _init(): void;
+    __clear(): void;
+    lverts_pa_invalidate(_x: Any$E): void;
+    lverts_pa_immutable(): void;
+    gverts_pa_validate(): void;
+    lverts_post_adder(x: Any$E): void;
+    lverts_subber(x: Any$E): void;
+    lverts_invalidate(_: Any$E): void;
+    lverts_validate(): void;
+    lverts_modifiable(): void;
+    gverts_validate(): void;
+    edges_validate(): void;
+    getlverts(): void;
+    getgverts(): void;
+    getedges(): void;
+    invalidate_lverts(): void;
+    invalidate_laxi(): void;
+    invalidate_gverts(): void;
+    invalidate_gaxi(): void;
+    validate_lverts(): void;
+    validate_laxi(): void;
+    validate_gverts(): void;
+    validate_gaxi(): void;
+    /** Internal helper: recompute world vertex positions from local verts + body transform */
+    private _validateGverts;
+    cleanup_lvert(x: Any$E): void;
+    splice_collinear(): void;
+    splice_collinear_real(): void;
+    reverse_vertices(): void;
+    valid(): Any$E;
+    /** Helper: check if two edges (u1→v1) and (a→b) do NOT intersect */
+    private _checkNoIntersection;
+    __validate_aabb(): void;
+    _force_validate_aabb(): void;
+    __validate_sweepRadius(): void;
+    __validate_area_inertia(): void;
+    __validate_angDrag(): void;
+    __validate_localCOM(): void;
+    localCOM_validate(): void;
+    localCOM_invalidate(x: Any$E): void;
+    setupLocalCOM(): void;
+    __translate(dx: number, dy: number): void;
+    __scale(sx: number, sy: number): void;
+    __rotate(ax: number, ay: number): void;
+    __transform(mat: Any$E): void;
+    __copy(): Any$E;
+}
+
+type Any$D = any;
 /**
  * A convex polygon physics shape.
  *
+ * Fully modernized — uses ZPP_Polygon directly (extracted to TypeScript).
  * Use the static helper methods (`box`, `rect`, `regular`) for common shapes.
  */
 declare class Polygon extends Shape {
-    constructor(vertices?: Vec2[] | NapeInner, material?: Material, filter?: InteractionFilter);
+    static __name__: string[];
+    static __super__: Any$D;
+    /** Direct access to the extracted internal ZPP_Polygon. */
+    zpp_inner_zn: ZPP_Polygon;
+    constructor(localVerts?: Vec2[] | Any$D, material?: Material, filter?: InteractionFilter);
     /** @internal */
     static _wrap(inner: NapeInner): Polygon;
-    static box(width: number, height: number, weak?: boolean): NapeInner;
-    static rect(x: number, y: number, width: number, height: number, weak?: boolean): NapeInner;
-    static regular(xRadius: number, yRadius: number, sides: number, angle?: number, weak?: boolean): NapeInner;
+    static rect(x: number, y: number, width: number, height: number, weak?: boolean): Vec2[];
+    static box(width: number, height?: number, weak?: boolean): Vec2[];
+    static regular(xRadius: number, yRadius: number, edgeCount: number, angleOffset?: number, weak?: boolean): Vec2[];
     /** Read-only list of local-space vertices. */
-    get localVerts(): NapeInner;
+    get localVerts(): Any$D;
     /** Read-only list of world-space vertices (computed after stepping). */
-    get worldVerts(): NapeInner;
+    get worldVerts(): Any$D;
     /** Read-only edge list. */
-    get edges(): NapeInner;
+    get edges(): Any$D;
     /** Validate the polygon geometry. */
-    validity(): NapeInner;
+    validity(): Any$D;
+    /** @internal */ get_localVerts(): Any$D;
+    /** @internal */ get_worldVerts(): Any$D;
+    /** @internal */ get_edges(): Any$D;
 }
 
 /**
@@ -2571,44 +2798,44 @@ declare class Polygon extends Shape {
  *
  * Converted from nape-compiled.js lines 41828–42175.
  */
-type Any$A = any;
+type Any$C = any;
 declare class ZPP_Edge {
     static __name__: string[];
     static zpp_pool: ZPP_Edge | null;
     static internal: boolean;
-    static _nape: Any$A;
-    static _zpp: Any$A;
-    static _wrapFn: ((zpp: ZPP_Edge) => Any$A) | null;
+    static _nape: Any$C;
+    static _zpp: Any$C;
+    static _wrapFn: ((zpp: ZPP_Edge) => Any$C) | null;
     next: ZPP_Edge | null;
-    polygon: Any$A;
-    outer: Any$A;
+    polygon: Any$C;
+    outer: Any$C;
     lnormx: number;
     lnormy: number;
-    wrap_lnorm: Any$A;
+    wrap_lnorm: Any$C;
     gnormx: number;
     gnormy: number;
-    wrap_gnorm: Any$A;
+    wrap_gnorm: Any$C;
     length: number;
     lprojection: number;
     gprojection: number;
-    lp0: Any$A;
-    gp0: Any$A;
-    lp1: Any$A;
-    gp1: Any$A;
+    lp0: Any$C;
+    gp0: Any$C;
+    lp1: Any$C;
+    gp1: Any$C;
     tp0: number;
     tp1: number;
-    __class__: Any$A;
+    __class__: Any$C;
     constructor();
     free(): void;
     alloc(): void;
-    wrapper(): Any$A;
+    wrapper(): Any$C;
     lnorm_validate(): void;
     gnorm_validate(): void;
     getlnorm(): void;
     getgnorm(): void;
 }
 
-type Any$z = any;
+type Any$B = any;
 /**
  * An edge of a polygon shape.
  *
@@ -2623,9 +2850,9 @@ declare class Edge {
     zpp_inner: ZPP_Edge;
     constructor();
     /** @internal */
-    static _wrap(inner: Any$z): Edge;
+    static _wrap(inner: Any$B): Edge;
     /** Parent polygon (as compiled Polygon wrapper). */
-    get polygon(): Any$z;
+    get polygon(): Any$B;
     /** Local-space normal vector (immutable Vec2). */
     get localNormal(): Vec2;
     /** World-space normal vector (immutable Vec2). Requires polygon in a body. */
@@ -2724,17 +2951,17 @@ declare class ArbiterType {
  *
  * Converted from nape-compiled.js lines 29044–29362, 80738–80766.
  */
-type Any$y = any;
+type Any$A = any;
 declare class ZPP_Arbiter {
     static __name__: string[];
-    static _nape: Any$y;
-    static _zpp: Any$y;
+    static _nape: Any$A;
+    static _zpp: Any$A;
     static internal: boolean;
     static COL: number;
     static FLUID: number;
     static SENSOR: number;
-    static types: Any$y[];
-    outer: Any$y;
+    static types: Any$A[];
+    outer: Any$A;
     hnext: ZPP_Arbiter | null;
     id: number;
     di: number;
@@ -2752,31 +2979,31 @@ declare class ZPP_Arbiter {
     fresh: boolean;
     immState: number;
     invalidated: boolean;
-    b1: Any$y;
-    b2: Any$y;
-    ws1: Any$y;
-    ws2: Any$y;
-    pair: Any$y;
+    b1: Any$A;
+    b2: Any$A;
+    ws1: Any$A;
+    ws2: Any$A;
+    pair: Any$A;
     type: number;
-    colarb: Any$y;
-    fluidarb: Any$y;
-    sensorarb: Any$y;
-    __class__: Any$y;
+    colarb: Any$A;
+    fluidarb: Any$A;
+    sensorarb: Any$A;
+    __class__: Any$A;
     constructor();
-    wrapper(): Any$y;
+    wrapper(): Any$A;
     inactiveme(): boolean;
     acting(): boolean;
     swap_features(): void;
-    lazyRetire(s: Any$y, b: Any$y): void;
-    sup_assign(s1: Any$y, s2: Any$y, id: number, di: number): void;
+    lazyRetire(s: Any$A, b: Any$A): void;
+    sup_assign(s1: Any$A, s2: Any$A, id: number, di: number): void;
     sup_retire(): void;
     /** Remove this arbiter from a ZNPList_ZPP_Arbiter */
-    static _removeFromArbiterList(list: Any$y, arb: ZPP_Arbiter, zpp: Any$y): void;
+    static _removeFromArbiterList(list: Any$A, arb: ZPP_Arbiter, zpp: Any$A): void;
     /** Add this arbiter to a ZNPList_ZPP_Arbiter */
-    static _addToArbiterList(list: Any$y, arb: ZPP_Arbiter, zpp: Any$y): void;
+    static _addToArbiterList(list: Any$A, arb: ZPP_Arbiter, zpp: Any$A): void;
 }
 
-type Any$x = any;
+type Any$z = any;
 /**
  * Represents an interaction arbiter between two shapes.
  *
@@ -2795,21 +3022,21 @@ declare class Arbiter {
     /** Whether this arbiter is currently sleeping. */
     get isSleeping(): boolean;
     /** The type of this arbiter (COLLISION, SENSOR, or FLUID). */
-    get type(): Any$x;
+    get type(): Any$z;
     /** Cast to CollisionArbiter if this is a collision, else null. */
-    get collisionArbiter(): Any$x;
+    get collisionArbiter(): Any$z;
     /** Cast to FluidArbiter if this is a fluid interaction, else null. */
-    get fluidArbiter(): Any$x;
+    get fluidArbiter(): Any$z;
     /** First shape (lower id). */
-    get shape1(): Any$x;
+    get shape1(): Any$z;
     /** Second shape (higher id). */
-    get shape2(): Any$x;
+    get shape2(): Any$z;
     /** Body of shape1. */
-    get body1(): Any$x;
+    get body1(): Any$z;
     /** Body of shape2. */
-    get body2(): Any$x;
+    get body2(): Any$z;
     /** The pre-handler state of this arbiter. */
-    get state(): Any$x;
+    get state(): Any$z;
     /** Whether this is a collision arbiter. */
     isCollisionArbiter(): boolean;
     /** Whether this is a fluid arbiter. */
@@ -2820,15 +3047,15 @@ declare class Arbiter {
      * Total impulse of this arbiter. Base implementation returns Vec3(0,0,0).
      * Overridden by CollisionArbiter and FluidArbiter.
      */
-    totalImpulse(body?: Any$x, _freshOnly?: boolean): Vec3;
+    totalImpulse(body?: Any$z, _freshOnly?: boolean): Vec3;
     toString(): string;
     /** @internal */
     protected _activeCheck(): void;
     /** @internal */
-    protected _checkBody(body: Any$x): void;
+    protected _checkBody(body: Any$z): void;
 }
 
-type Any$w = any;
+type Any$y = any;
 /**
  * A collision arbiter between two shapes in contact.
  *
@@ -2842,15 +3069,15 @@ declare class CollisionArbiter extends Arbiter {
     static __super__: typeof Arbiter;
     constructor();
     /** Contact points for this collision. */
-    get contacts(): Any$w;
+    get contacts(): Any$y;
     /** Collision normal vector. */
-    get normal(): Any$w;
+    get normal(): Any$y;
     /** Sum of the radii of the two shapes at the collision point. */
     get radius(): number;
     /** Reference edge of shape1 (if polygon), or null. */
-    get referenceEdge1(): Any$w;
+    get referenceEdge1(): Any$y;
     /** Reference edge of shape2 (if polygon), or null. */
-    get referenceEdge2(): Any$w;
+    get referenceEdge2(): Any$y;
     /** Coefficient of restitution (elasticity). Mutable in pre-handler only. */
     get elasticity(): number;
     set elasticity(value: number);
@@ -2868,20 +3095,20 @@ declare class CollisionArbiter extends Arbiter {
     /** Whether the second contact point lies on a polygon vertex (poly-circle only). */
     secondVertex(): boolean;
     /** Normal impulse accumulated across all contacts. */
-    normalImpulse(body?: Any$w, freshOnly?: boolean): Vec3;
+    normalImpulse(body?: Any$y, freshOnly?: boolean): Vec3;
     /** Tangent (friction) impulse accumulated across all contacts. */
-    tangentImpulse(body?: Any$w, freshOnly?: boolean): Vec3;
+    tangentImpulse(body?: Any$y, freshOnly?: boolean): Vec3;
     /** Total impulse (normal + tangent + rolling) accumulated across all contacts. */
-    totalImpulse(body?: Any$w, freshOnly?: boolean): Vec3;
+    totalImpulse(body?: Any$y, freshOnly?: boolean): Vec3;
     /** Rolling impulse for this collision. */
-    rollingImpulse(body?: Any$w, freshOnly?: boolean): number;
+    rollingImpulse(body?: Any$y, freshOnly?: boolean): number;
     /** @internal Throw if not in pre-handler mutable window. */
     private _mutableCheck;
     /** @internal Accumulate impulse from contacts. */
     private _accumulateImpulse;
 }
 
-type Any$v = any;
+type Any$x = any;
 /**
  * A fluid arbiter between two shapes with fluid interaction.
  *
@@ -2901,14 +3128,14 @@ declare class FluidArbiter extends Arbiter {
     get overlap(): number;
     set overlap(value: number);
     /** Buoyancy impulse applied by this fluid arbiter. */
-    buoyancyImpulse(body?: Any$v): Vec3;
+    buoyancyImpulse(body?: Any$x): Vec3;
     /** Drag impulse applied by this fluid arbiter. */
-    dragImpulse(body?: Any$v): Vec3;
+    dragImpulse(body?: Any$x): Vec3;
     /** Total impulse (buoyancy + drag). */
-    totalImpulse(body?: Any$v, _freshOnly?: boolean): Vec3;
+    totalImpulse(body?: Any$x, _freshOnly?: boolean): Vec3;
 }
 
-type Any$u = any;
+type Any$w = any;
 /**
  * Represents a contact point between two colliding shapes.
  *
@@ -2925,7 +3152,7 @@ declare class Contact {
     get _inner(): NapeInner;
     constructor();
     /** The collision arbiter this contact belongs to, or null. */
-    get arbiter(): Any$u;
+    get arbiter(): Any$w;
     /** Penetration depth of this contact (positive = overlapping). */
     get penetration(): number;
     /** World-space position of this contact point. */
@@ -2939,25 +3166,25 @@ declare class Contact {
      * @param body - If null, returns world-frame impulse. Otherwise returns
      *               impulse on the given body (must be one of the two in contact).
      */
-    normalImpulse(body?: Any$u): Vec3;
+    normalImpulse(body?: Any$w): Vec3;
     /**
      * Tangent impulse at this contact point.
      * @param body - If null, returns world-frame impulse. Otherwise returns
      *               impulse on the given body.
      */
-    tangentImpulse(body?: Any$u): Vec3;
+    tangentImpulse(body?: Any$w): Vec3;
     /**
      * Rolling impulse at this contact point.
      * @param body - If null, returns total rolling impulse. Otherwise returns
      *               rolling impulse on the given body.
      */
-    rollingImpulse(body?: Any$u): number;
+    rollingImpulse(body?: Any$w): number;
     /**
      * Total impulse (normal + tangent + rolling) at this contact point.
      * @param body - If null, returns world-frame impulse. Otherwise returns
      *               impulse on the given body.
      */
-    totalImpulse(body?: Any$u): Vec3;
+    totalImpulse(body?: Any$w): Vec3;
     toString(): string;
     /** @internal */
     private _inactiveCheck;
@@ -2965,6 +3192,39 @@ declare class Contact {
     private _checkBody;
 }
 
+/**
+ * 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.
  *
@@ -2974,41 +3234,41 @@ declare class Contact {
  *
  * Converted from nape-compiled.js lines 48256–48482.
  */
-type Any$t = any;
+type Any$v = any;
 declare class ZPP_CbType {
     static __name__: string[];
-    static _zpp: Any$t;
-    outer: Any$t;
-    userData: Any$t;
+    static _zpp: Any$v;
+    outer: Any$v;
+    userData: Any$v;
     id: number;
-    cbsets: Any$t;
-    interactors: Any$t;
-    wrap_interactors: Any$t;
-    constraints: Any$t;
-    wrap_constraints: Any$t;
-    listeners: Any$t;
-    bodylisteners: Any$t;
-    conlisteners: Any$t;
-    __class__: Any$t;
+    cbsets: Any$v;
+    interactors: Any$v;
+    wrap_interactors: Any$v;
+    constraints: Any$v;
+    wrap_constraints: Any$v;
+    listeners: Any$v;
+    bodylisteners: Any$v;
+    conlisteners: Any$v;
+    __class__: Any$v;
     constructor();
     /** Sort comparator by id. */
     static setlt(a: ZPP_CbType, b: ZPP_CbType): boolean;
-    addInteractor(intx: Any$t): void;
-    remInteractor(intx: Any$t): void;
-    addConstraint(con: Any$t): void;
-    remConstraint(con: Any$t): void;
-    addint(x: Any$t): void;
-    removeint(x: Any$t): void;
+    addInteractor(intx: Any$v): void;
+    remInteractor(intx: Any$v): void;
+    addConstraint(con: Any$v): void;
+    remConstraint(con: Any$v): void;
+    addint(x: Any$v): void;
+    removeint(x: Any$v): void;
     invalidateint(): void;
-    addbody(x: Any$t): void;
-    removebody(x: Any$t): void;
+    addbody(x: Any$v): void;
+    removebody(x: Any$v): void;
     invalidatebody(): void;
-    addconstraint(x: Any$t): void;
-    removeconstraint(x: Any$t): void;
+    addconstraint(x: Any$v): void;
+    removeconstraint(x: Any$v): void;
     invalidateconstraint(): void;
 }
 
-type Any$s = any;
+type Any$u = any;
 /**
  * Callback type — used to tag interactors so that listeners
  * can filter which interactions they respond to.
@@ -3029,11 +3289,11 @@ declare class CbType {
     static get_ANY_SHAPE(): CbType;
     static get_ANY_COMPOUND(): CbType;
     get id(): number;
-    get userData(): Any$s;
-    get interactors(): Any$s;
-    get constraints(): Any$s;
-    including(includes: Any$s): Any$s;
-    excluding(excludes: Any$s): Any$s;
+    get userData(): Any$u;
+    get interactors(): Any$u;
+    get constraints(): Any$u;
+    including(includes: Any$u): Any$u;
+    excluding(excludes: Any$u): Any$u;
     toString(): string;
     static _wrap(inner: any): CbType;
 }
@@ -3094,37 +3354,37 @@ declare class PreFlag {
  *
  * Converted from nape-compiled.js lines 51337–51655.
  */
-type Any$r = any;
+type Any$t = any;
 declare class ZPP_OptionType {
     static __name__: string[];
-    static _nape: Any$r;
-    static _zpp: Any$r;
-    outer: Any$r;
-    handler: ((val: Any$r, included: boolean, added: boolean) => void) | null;
-    includes: Any$r;
-    excludes: Any$r;
-    wrap_includes: Any$r;
-    wrap_excludes: Any$r;
-    __class__: Any$r;
+    static _nape: Any$t;
+    static _zpp: Any$t;
+    outer: Any$t;
+    handler: ((val: Any$t, included: boolean, added: boolean) => void) | null;
+    includes: Any$t;
+    excludes: Any$t;
+    wrap_includes: Any$t;
+    wrap_excludes: Any$t;
+    __class__: Any$t;
     constructor();
     /** Coerce a value to OptionType (null → new, OptionType → pass-through, CbType → including). */
-    static argument(val: Any$r): Any$r;
+    static argument(val: Any$t): Any$t;
     setup_includes(): void;
     setup_excludes(): void;
-    excluded(xs: Any$r): boolean;
-    included(xs: Any$r): boolean;
-    compatible(xs: Any$r): boolean;
+    excluded(xs: Any$t): boolean;
+    included(xs: Any$t): boolean;
+    compatible(xs: Any$t): boolean;
     /** Check whether two sorted-by-id lists share any element. */
-    nonemptyintersection(xs: Any$r, ys: Any$r): boolean;
+    nonemptyintersection(xs: Any$t, ys: Any$t): boolean;
     /** Insert into the ordered include or exclude list, using pool nodes. */
     private insertOrdered;
-    effect_change(val: Any$r, included: boolean, added: boolean): void;
-    append_type(list: Any$r, val: Any$r): void;
+    effect_change(val: Any$t, included: boolean, added: boolean): void;
+    append_type(list: Any$t, val: Any$t): void;
     set(options: ZPP_OptionType): this;
-    append(list: Any$r, val: Any$r): void;
+    append(list: Any$t, val: Any$t): void;
 }
 
-type Any$q = any;
+type Any$s = any;
 /**
  * Composite callback option type — allows including and excluding CbTypes.
  *
@@ -3134,17 +3394,103 @@ declare class OptionType {
     static __name__: string[];
     zpp_inner: ZPP_OptionType;
     get _inner(): NapeInner;
-    constructor(includes?: Any$q, excludes?: Any$q);
-    get includes(): Any$q;
-    get excludes(): Any$q;
-    get_includes(): Any$q;
-    get_excludes(): Any$q;
-    including(includes: Any$q): this;
-    excluding(excludes: Any$q): this;
+    constructor(includes?: Any$s, excludes?: Any$s);
+    get includes(): Any$s;
+    get excludes(): Any$s;
+    get_includes(): Any$s;
+    get_excludes(): Any$s;
+    including(includes: Any$s): this;
+    excluding(excludes: Any$s): this;
     toString(): string;
     static _wrap(inner: any): OptionType;
 }
 
+/**
+ * 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$r = any;
+declare class ZPP_Listener {
+    static __name__: string[];
+    static _nape: Any$r;
+    static _zpp: Any$r;
+    static internal: boolean;
+    static types: Any$r[];
+    static events: Any$r[];
+    space: Any$r;
+    interaction: Any$r;
+    constraint: Any$r;
+    body: Any$r;
+    precedence: number;
+    event: number;
+    type: number;
+    id: number;
+    outer: Any$r;
+    __class__: Any$r;
+    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;
+}
+
+/**
+ * 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$q = any;
+declare class Listener {
+    static __name__: string[];
+    zpp_inner: ZPP_Listener;
+    get _inner(): Any$q;
+    constructor();
+    static _wrap(inner: Any$q): Listener;
+    get type(): ListenerType;
+    get event(): CbEvent;
+    set event(event: CbEvent);
+    get precedence(): number;
+    set precedence(precedence: number);
+    get space(): Space | null;
+    set space(space: Space | Any$q | null);
+    toString(): string;
+}
+
 /**
  * ZPP_BodyListener — Internal body listener for the nape physics engine.
  *
@@ -3324,62 +3670,7 @@ declare class PreListener extends Listener {
     set interactionType(interactionType: InteractionType | null);
 }
 
-/**
- * ZPP_Callback — Internal callback data holder for the nape physics engine.
- *
- * Stores callback event information (listener, event type, interactors, etc.)
- * and forms a doubly-linked list for callback queue management.
- *
- * Converted from nape-compiled.js lines 44587–44794, 133299–133300.
- */
 type Any$i = any;
-declare class ZPP_Callback {
-    static __name__: string[];
-    static _nape: Any$i;
-    static _zpp: Any$i;
-    static internal: boolean;
-    static zpp_pool: ZPP_Callback | null;
-    outer_body: Any$i;
-    outer_con: Any$i;
-    outer_int: Any$i;
-    event: number;
-    listener: Any$i;
-    space: Any$i;
-    index: number;
-    next: ZPP_Callback | null;
-    prev: ZPP_Callback | null;
-    length: number;
-    int1: Any$i;
-    int2: Any$i;
-    set: Any$i;
-    wrap_arbiters: Any$i;
-    pre_arbiter: Any$i;
-    pre_swapped: boolean;
-    body: Any$i;
-    constraint: Any$i;
-    __class__: Any$i;
-    wrapper_body(): Any$i;
-    wrapper_con(): Any$i;
-    wrapper_int(): Any$i;
-    push(obj: ZPP_Callback): void;
-    push_rev(obj: ZPP_Callback): void;
-    pop(): ZPP_Callback;
-    pop_rev(): ZPP_Callback;
-    empty(): boolean;
-    clear(): void;
-    splice(o: ZPP_Callback): ZPP_Callback | null;
-    rotateL(): void;
-    rotateR(): void;
-    cycleNext(o: ZPP_Callback): ZPP_Callback | null;
-    cyclePrev(o: ZPP_Callback): ZPP_Callback | null;
-    at(i: number): ZPP_Callback;
-    rev_at(i: number): ZPP_Callback;
-    free(): void;
-    alloc(): void;
-    genarbs(): void;
-}
-
-type Any$h = any;
 /**
  * Base class for all physics engine callbacks.
  *
@@ -3392,12 +3683,12 @@ declare class Callback {
     static __name__: string[];
     zpp_inner: ZPP_Callback | null;
     constructor();
-    get event(): Any$h;
-    get listener(): Any$h;
+    get event(): Any$i;
+    get listener(): Any$i;
     toString(): string;
 }
 
-type Any$g = any;
+type Any$h = any;
 /**
  * Callback for body events (WAKE/SLEEP).
  *
@@ -3407,11 +3698,11 @@ type Any$g = any;
  */
 declare class BodyCallback extends Callback {
     static __name__: string[];
-    get body(): Any$g;
+    get body(): Any$h;
     toString(): string;
 }
 
-type Any$f = any;
+type Any$g = any;
 /**
  * Callback for constraint events (WAKE/SLEEP/BREAK).
  *
@@ -3421,11 +3712,11 @@ type Any$f = any;
  */
 declare class ConstraintCallback extends Callback {
     static __name__: string[];
-    get constraint(): Any$f;
+    get constraint(): Any$g;
     toString(): string;
 }
 
-type Any$e = any;
+type Any$f = any;
 /**
  * Callback for interaction events (BEGIN/END/ONGOING).
  *
@@ -3435,13 +3726,13 @@ type Any$e = any;
  */
 declare class InteractionCallback extends Callback {
     static __name__: string[];
-    get int1(): Any$e;
-    get int2(): Any$e;
-    get arbiters(): Any$e;
+    get int1(): Any$f;
+    get int2(): Any$f;
+    get arbiters(): Any$f;
     toString(): string;
 }
 
-type Any$d = any;
+type Any$e = any;
 /**
  * Callback for pre-interaction events.
  *
@@ -3451,9 +3742,9 @@ type Any$d = any;
  */
 declare class PreCallback extends Callback {
     static __name__: string[];
-    get arbiter(): Any$d;
-    get int1(): Any$d;
-    get int2(): Any$d;
+    get arbiter(): Any$e;
+    get int1(): Any$e;
+    get int2(): Any$e;
     get swapped(): boolean;
     toString(): string;
 }
@@ -3468,24 +3759,24 @@ declare class PreCallback extends Callback {
  * Converted from nape-compiled.js lines 24611–25474.
  */
 
-type Any$c = any;
+type Any$d = any;
 declare class ZPP_PivotJoint extends ZPP_Constraint {
     static __name__: string[];
     static __super__: typeof ZPP_Constraint;
-    static _wrapFn: ((zpp: ZPP_PivotJoint) => Any$c) | null;
-    outer_zn: Any$c;
-    b1: Any$c;
-    b2: Any$c;
+    static _wrapFn: ((zpp: ZPP_PivotJoint) => Any$d) | null;
+    outer_zn: Any$d;
+    b1: Any$d;
+    b2: Any$d;
     a1localx: number;
     a1localy: number;
     a1relx: number;
     a1rely: number;
-    wrap_a1: Any$c;
+    wrap_a1: Any$d;
     a2localx: number;
     a2localy: number;
     a2relx: number;
     a2rely: number;
-    wrap_a2: Any$c;
+    wrap_a2: Any$d;
     kMassa: number;
     kMassb: number;
     kMassc: number;
@@ -3496,18 +3787,18 @@ declare class ZPP_PivotJoint extends ZPP_Constraint {
     biasx: number;
     biasy: number;
     stepped: boolean;
-    __class__: Any$c;
+    __class__: Any$d;
     constructor();
-    bodyImpulse(b: Any$c): Any$c;
+    bodyImpulse(b: Any$d): Any$d;
     activeBodies(): void;
     inactiveBodies(): void;
     validate_a1(): void;
-    invalidate_a1(x: Any$c): void;
+    invalidate_a1(x: Any$d): void;
     setup_a1(): void;
     validate_a2(): void;
-    invalidate_a2(x: Any$c): void;
+    invalidate_a2(x: Any$d): void;
     setup_a2(): void;
-    copy(dict: Any$c, todo: Any$c): Any$c;
+    copy(dict: Any$d, todo: Any$d): Any$d;
     validate(): void;
     wake_connected(): void;
     forest(): void;
@@ -3517,10 +3808,10 @@ declare class ZPP_PivotJoint extends ZPP_Constraint {
     warmStart(): void;
     applyImpulseVel(): boolean;
     applyImpulsePos(): boolean;
-    draw(_g: Any$c): void;
+    draw(_g: Any$d): void;
 }
 
-type Any$b = any;
+type Any$c = any;
 /**
  * A pivot (pin) joint that constrains two bodies to share an anchor point.
  *
@@ -3530,7 +3821,7 @@ declare class PivotJoint extends Constraint {
     zpp_inner: ZPP_PivotJoint;
     constructor(body1: Body | null, body2: Body | null, anchor1: Vec2, anchor2: Vec2);
     /** @internal */
-    static _wrap(inner: Any$b): PivotJoint;
+    static _wrap(inner: Any$c): PivotJoint;
     get body1(): Body;
     set body1(value: Body | null);
     /** @internal */
@@ -3543,17 +3834,17 @@ declare class PivotJoint extends Constraint {
     set anchor1(value: Vec2);
     get anchor2(): Vec2;
     set anchor2(value: Vec2);
-    impulse(): Any$b;
-    bodyImpulse(body: Body): Any$b;
+    impulse(): Any$c;
+    bodyImpulse(body: Body): Any$c;
     visitBodies(lambda: (body: Body) => void): void;
-    /** @internal */ get_body1(): Any$b;
-    /** @internal */ set_body1(v: Any$b): Any$b;
-    /** @internal */ get_body2(): Any$b;
-    /** @internal */ set_body2(v: Any$b): Any$b;
-    /** @internal */ get_anchor1(): Any$b;
-    /** @internal */ set_anchor1(v: Any$b): Any$b;
-    /** @internal */ get_anchor2(): Any$b;
-    /** @internal */ set_anchor2(v: Any$b): Any$b;
+    /** @internal */ get_body1(): Any$c;
+    /** @internal */ set_body1(v: Any$c): Any$c;
+    /** @internal */ get_body2(): Any$c;
+    /** @internal */ set_body2(v: Any$c): Any$c;
+    /** @internal */ get_anchor1(): Any$c;
+    /** @internal */ set_anchor1(v: Any$c): Any$c;
+    /** @internal */ get_anchor2(): Any$c;
+    /** @internal */ set_anchor2(v: Any$c): Any$c;
     /** @internal backward compat alias for zpp_inner */
     get zpp_inner_zn(): ZPP_PivotJoint;
     set zpp_inner_zn(v: ZPP_PivotJoint);
@@ -3569,12 +3860,12 @@ declare class PivotJoint extends Constraint {
  * Converted from nape-compiled.js lines 22329–23204.
  */
 
-type Any$a = any;
+type Any$b = any;
 declare class ZPP_DistanceJoint extends ZPP_Constraint {
     static __name__: string[];
     static __super__: typeof ZPP_Constraint;
-    static _wrapFn: ((zpp: ZPP_DistanceJoint) => Any$a) | null;
-    outer_zn: Any$a;
+    static _wrapFn: ((zpp: ZPP_DistanceJoint) => Any$b) | null;
+    outer_zn: Any$b;
     jointMin: number;
     jointMax: number;
     slack: boolean;
@@ -3583,8 +3874,8 @@ declare class ZPP_DistanceJoint extends ZPP_Constraint {
     ny: number;
     cx1: number;
     cx2: number;
-    b1: Any$a;
-    b2: Any$a;
+    b1: Any$b;
+    b2: Any$b;
     a1localx: number;
     a1localy: number;
     a1relx: number;
@@ -3593,27 +3884,27 @@ declare class ZPP_DistanceJoint extends ZPP_Constraint {
     a2localy: number;
     a2relx: number;
     a2rely: number;
-    wrap_a1: Any$a;
-    wrap_a2: Any$a;
+    wrap_a1: Any$b;
+    wrap_a2: Any$b;
     kMass: number;
     jAcc: number;
     jMax: number;
     gamma: number;
     bias: number;
     stepped: boolean;
-    __class__: Any$a;
+    __class__: Any$b;
     constructor();
     is_slack(): boolean;
-    bodyImpulse(b: Any$a): Any$a;
+    bodyImpulse(b: Any$b): Any$b;
     activeBodies(): void;
     inactiveBodies(): void;
     validate_a1(): void;
-    invalidate_a1(x: Any$a): void;
+    invalidate_a1(x: Any$b): void;
     setup_a1(): void;
     validate_a2(): void;
-    invalidate_a2(x: Any$a): void;
+    invalidate_a2(x: Any$b): void;
     setup_a2(): void;
-    copy(dict: Any$a, todo: Any$a): Any$a;
+    copy(dict: Any$b, todo: Any$b): Any$b;
     validate(): void;
     wake_connected(): void;
     forest(): void;
@@ -3623,7 +3914,7 @@ declare class ZPP_DistanceJoint extends ZPP_Constraint {
     warmStart(): void;
     applyImpulseVel(): boolean;
     applyImpulsePos(): boolean;
-    draw(_g: Any$a): void;
+    draw(_g: Any$b): void;
     /**
      * Creates (or reuses from pool) a public Vec2 wrapper for a constraint anchor
      * point stored as (localx, localy). Installs the given validate and invalidate
@@ -3631,10 +3922,10 @@ declare class ZPP_DistanceJoint extends ZPP_Constraint {
      *
      * Shared by all anchor-based joints (DistanceJoint, PivotJoint, LineJoint, etc.)
      */
-    static _setupAnchorVec2(localx: number, localy: number, validateFn: (() => void) | null, invalidateFn: ((vec: Any$a) => void) | null): Any$a;
+    static _setupAnchorVec2(localx: number, localy: number, validateFn: (() => void) | null, invalidateFn: ((vec: Any$b) => void) | null): Any$b;
 }
 
-type Any$9 = any;
+type Any$a = any;
 /**
  * Constrains the distance between two anchor points on two bodies.
  *
@@ -3644,7 +3935,7 @@ declare class DistanceJoint extends Constraint {
     zpp_inner: ZPP_DistanceJoint;
     constructor(body1: Body | null, body2: Body | null, anchor1: Vec2, anchor2: Vec2, jointMin: number, jointMax: number);
     /** @internal */
-    static _wrap(inner: Any$9): DistanceJoint;
+    static _wrap(inner: Any$a): DistanceJoint;
     get body1(): Body;
     set body1(value: Body | null);
     /** @internal */
@@ -3662,17 +3953,17 @@ declare class DistanceJoint extends Constraint {
     get jointMax(): number;
     set jointMax(value: number);
     isSlack(): boolean;
-    impulse(): Any$9;
-    bodyImpulse(body: Body): Any$9;
+    impulse(): Any$a;
+    bodyImpulse(body: Body): Any$a;
     visitBodies(lambda: (body: Body) => void): void;
-    /** @internal */ get_body1(): Any$9;
-    /** @internal */ set_body1(v: Any$9): Any$9;
-    /** @internal */ get_body2(): Any$9;
-    /** @internal */ set_body2(v: Any$9): Any$9;
-    /** @internal */ get_anchor1(): Any$9;
-    /** @internal */ set_anchor1(v: Any$9): Any$9;
-    /** @internal */ get_anchor2(): Any$9;
-    /** @internal */ set_anchor2(v: Any$9): Any$9;
+    /** @internal */ get_body1(): Any$a;
+    /** @internal */ set_body1(v: Any$a): Any$a;
+    /** @internal */ get_body2(): Any$a;
+    /** @internal */ set_body2(v: Any$a): Any$a;
+    /** @internal */ get_anchor1(): Any$a;
+    /** @internal */ set_anchor1(v: Any$a): Any$a;
+    /** @internal */ get_anchor2(): Any$a;
+    /** @internal */ set_anchor2(v: Any$a): Any$a;
     /** @internal */ get_jointMin(): number;
     /** @internal */ set_jointMin(v: number): number;
     /** @internal */ get_jointMax(): number;
@@ -3691,53 +3982,53 @@ declare class DistanceJoint extends Constraint {
  * Converted from nape-compiled.js lines 21441–21912.
  */
 
-type Any$8 = any;
+type Any$9 = any;
 declare class ZPP_AngleJoint extends ZPP_Constraint {
     static __name__: string[];
-    static _wrapFn: ((zpp: ZPP_AngleJoint) => Any$8) | null;
-    outer_zn: Any$8;
+    static _wrapFn: ((zpp: ZPP_AngleJoint) => Any$9) | null;
+    outer_zn: Any$9;
     ratio: number;
     jointMin: number;
     jointMax: number;
     slack: boolean;
     equal: boolean;
     scale: number;
-    b1: Any$8;
-    b2: Any$8;
+    b1: Any$9;
+    b2: Any$9;
     kMass: number;
     jAcc: number;
     jMax: number;
     gamma: number;
     bias: number;
     stepped: boolean;
-    __class__: Any$8;
+    __class__: Any$9;
     constructor();
     is_slack(): boolean;
-    bodyImpulse(b: Any$8): Any$8;
+    bodyImpulse(b: Any$9): Any$9;
     activeBodies(): void;
     inactiveBodies(): void;
-    copy(dict?: Any$8, todo?: Any$8): Any$8;
+    copy(dict?: Any$9, todo?: Any$9): Any$9;
     validate(): void;
     wake_connected(): void;
     forest(): void;
-    pair_exists(id: Any$8, di: Any$8): boolean;
+    pair_exists(id: Any$9, di: Any$9): boolean;
     clearcache(): void;
     preStep(dt: number): boolean;
     warmStart(): void;
     applyImpulseVel(): boolean;
     applyImpulsePos(): boolean;
-    draw(_g: Any$8): void;
+    draw(_g: Any$9): void;
     /**
      * Small-angle-optimized body rotation. Used by all joints' applyImpulsePos.
      */
-    static _rotateBody(body: Any$8, dr: number): void;
+    static _rotateBody(body: Any$9, dr: number): void;
     /**
      * Dict-lookup / deferred-todo body copying. Used by all joints' copy().
      */
-    static _copyBody(dict: Any$8, todo: Any$8, srcBody: Any$8, ret: Any$8, field: string): void;
+    static _copyBody(dict: Any$9, todo: Any$9, srcBody: Any$9, ret: Any$9, field: string): void;
 }
 
-type Any$7 = any;
+type Any$8 = any;
 /**
  * Constrains the relative angle between two bodies.
  *
@@ -3747,7 +4038,7 @@ declare class AngleJoint extends Constraint {
     zpp_inner: ZPP_AngleJoint;
     constructor(body1: Body | null, body2: Body | null, jointMin: number, jointMax: number, ratio?: number);
     /** @internal */
-    static _wrap(inner: Any$7): AngleJoint;
+    static _wrap(inner: Any$8): AngleJoint;
     get body1(): Body;
     set body1(value: Body | null);
     /** @internal */
@@ -3763,13 +4054,13 @@ declare class AngleJoint extends Constraint {
     get ratio(): number;
     set ratio(value: number);
     isSlack(): boolean;
-    impulse(): Any$7;
-    bodyImpulse(body: Body): Any$7;
+    impulse(): Any$8;
+    bodyImpulse(body: Body): Any$8;
     visitBodies(lambda: (body: Body) => void): void;
-    /** @internal */ get_body1(): Any$7;
-    /** @internal */ set_body1(v: Any$7): Any$7;
-    /** @internal */ get_body2(): Any$7;
-    /** @internal */ set_body2(v: Any$7): Any$7;
+    /** @internal */ get_body1(): Any$8;
+    /** @internal */ set_body1(v: Any$8): Any$8;
+    /** @internal */ get_body2(): Any$8;
+    /** @internal */ set_body2(v: Any$8): Any$8;
     /** @internal */ get_jointMin(): number;
     /** @internal */ set_jointMin(v: number): number;
     /** @internal */ get_jointMax(): number;
@@ -3791,24 +4082,24 @@ declare class AngleJoint extends Constraint {
  * Converted from nape-compiled.js lines 28055–29046.
  */
 
-type Any$6 = any;
+type Any$7 = any;
 declare class ZPP_WeldJoint extends ZPP_Constraint {
     static __name__: string[];
     static __super__: typeof ZPP_Constraint;
-    static _wrapFn: ((zpp: ZPP_WeldJoint) => Any$6) | null;
-    outer_zn: Any$6;
-    b1: Any$6;
-    b2: Any$6;
+    static _wrapFn: ((zpp: ZPP_WeldJoint) => Any$7) | null;
+    outer_zn: Any$7;
+    b1: Any$7;
+    b2: Any$7;
     a1localx: number;
     a1localy: number;
     a1relx: number;
     a1rely: number;
-    wrap_a1: Any$6;
+    wrap_a1: Any$7;
     a2localx: number;
     a2localy: number;
     a2relx: number;
     a2rely: number;
-    wrap_a2: Any$6;
+    wrap_a2: Any$7;
     phase: number;
     kMassa: number;
     kMassb: number;
@@ -3825,18 +4116,18 @@ declare class ZPP_WeldJoint extends ZPP_Constraint {
     biasy: number;
     biasz: number;
     stepped: boolean;
-    __class__: Any$6;
+    __class__: Any$7;
     constructor();
-    bodyImpulse(b: Any$6): Any$6;
+    bodyImpulse(b: Any$7): Any$7;
     activeBodies(): void;
     inactiveBodies(): void;
     validate_a1(): void;
-    invalidate_a1(x: Any$6): void;
+    invalidate_a1(x: Any$7): void;
     setup_a1(): void;
     validate_a2(): void;
-    invalidate_a2(x: Any$6): void;
+    invalidate_a2(x: Any$7): void;
     setup_a2(): void;
-    copy(dict: Any$6, todo: Any$6): Any$6;
+    copy(dict: Any$7, todo: Any$7): Any$7;
     validate(): void;
     wake_connected(): void;
     forest(): void;
@@ -3846,10 +4137,10 @@ declare class ZPP_WeldJoint extends ZPP_Constraint {
     warmStart(): void;
     applyImpulseVel(): boolean;
     applyImpulsePos(): boolean;
-    draw(_g: Any$6): void;
+    draw(_g: Any$7): void;
 }
 
-type Any$5 = any;
+type Any$6 = any;
 /**
  * Weld joint — constrains two bodies to maintain a fixed relative
  * position and angle (like gluing them together).
@@ -3860,7 +4151,7 @@ declare class WeldJoint extends Constraint {
     zpp_inner: ZPP_WeldJoint;
     constructor(body1: Body | null, body2: Body | null, anchor1: Vec2, anchor2: Vec2, phase?: number);
     /** @internal */
-    static _wrap(inner: Any$5): WeldJoint;
+    static _wrap(inner: Any$6): WeldJoint;
     get body1(): Body;
     set body1(value: Body | null);
     /** @internal */
@@ -3875,17 +4166,17 @@ declare class WeldJoint extends Constraint {
     set anchor2(value: Vec2);
     get phase(): number;
     set phase(value: number);
-    impulse(): Any$5;
-    bodyImpulse(body: Body): Any$5;
+    impulse(): Any$6;
+    bodyImpulse(body: Body): Any$6;
     visitBodies(lambda: (body: Body) => void): void;
-    /** @internal */ get_body1(): Any$5;
-    /** @internal */ set_body1(v: Any$5): Any$5;
-    /** @internal */ get_body2(): Any$5;
-    /** @internal */ set_body2(v: Any$5): Any$5;
-    /** @internal */ get_anchor1(): Any$5;
-    /** @internal */ set_anchor1(v: Any$5): Any$5;
-    /** @internal */ get_anchor2(): Any$5;
-    /** @internal */ set_anchor2(v: Any$5): Any$5;
+    /** @internal */ get_body1(): Any$6;
+    /** @internal */ set_body1(v: Any$6): Any$6;
+    /** @internal */ get_body2(): Any$6;
+    /** @internal */ set_body2(v: Any$6): Any$6;
+    /** @internal */ get_anchor1(): Any$6;
+    /** @internal */ set_anchor1(v: Any$6): Any$6;
+    /** @internal */ get_anchor2(): Any$6;
+    /** @internal */ set_anchor2(v: Any$6): Any$6;
     /** @internal */ get_phase(): number;
     /** @internal */ set_phase(v: number): number;
     /** @internal backward compat alias for zpp_inner */
@@ -3902,29 +4193,29 @@ declare class WeldJoint extends Constraint {
  * Converted from nape-compiled.js lines 23892–24197.
  */
 
-type Any$4 = any;
+type Any$5 = any;
 declare class ZPP_MotorJoint extends ZPP_Constraint {
     static __name__: string[];
-    static _wrapFn: ((zpp: ZPP_MotorJoint) => Any$4) | null;
-    outer_zn: Any$4;
+    static _wrapFn: ((zpp: ZPP_MotorJoint) => Any$5) | null;
+    outer_zn: Any$5;
     ratio: number;
     rate: number;
-    b1: Any$4;
-    b2: Any$4;
+    b1: Any$5;
+    b2: Any$5;
     kMass: number;
     jAcc: number;
     jMax: number;
     stepped: boolean;
-    __class__: Any$4;
+    __class__: Any$5;
     constructor();
-    bodyImpulse(b: Any$4): Any$4;
+    bodyImpulse(b: Any$5): Any$5;
     activeBodies(): void;
     inactiveBodies(): void;
-    copy(dict?: Any$4, todo?: Any$4): Any$4;
+    copy(dict?: Any$5, todo?: Any$5): Any$5;
     validate(): void;
     wake_connected(): void;
     forest(): void;
-    pair_exists(id: Any$4, di: Any$4): boolean;
+    pair_exists(id: Any$5, di: Any$5): boolean;
     clearcache(): void;
     preStep(dt: number): boolean;
     warmStart(): void;
@@ -3932,7 +4223,7 @@ declare class ZPP_MotorJoint extends ZPP_Constraint {
     applyImpulsePos(): boolean;
 }
 
-type Any$3 = any;
+type Any$4 = any;
 /**
  * Motor joint — applies angular velocity to rotate bodies relative to each other.
  *
@@ -3942,7 +4233,7 @@ declare class MotorJoint extends Constraint {
     zpp_inner: ZPP_MotorJoint;
     constructor(body1: Body | null, body2: Body | null, rate?: number, ratio?: number);
     /** @internal */
-    static _wrap(inner: Any$3): MotorJoint;
+    static _wrap(inner: Any$4): MotorJoint;
     get body1(): Body;
     set body1(value: Body | null);
     /** @internal */
@@ -3955,13 +4246,13 @@ declare class MotorJoint extends Constraint {
     set rate(value: number);
     get ratio(): number;
     set ratio(value: number);
-    impulse(): Any$3;
-    bodyImpulse(body: Body): Any$3;
+    impulse(): Any$4;
+    bodyImpulse(body: Body): Any$4;
     visitBodies(lambda: (body: Body) => void): void;
-    /** @internal */ get_body1(): Any$3;
-    /** @internal */ set_body1(v: Any$3): Any$3;
-    /** @internal */ get_body2(): Any$3;
-    /** @internal */ set_body2(v: Any$3): Any$3;
+    /** @internal */ get_body1(): Any$4;
+    /** @internal */ set_body1(v: Any$4): Any$4;
+    /** @internal */ get_body2(): Any$4;
+    /** @internal */ set_body2(v: Any$4): Any$4;
     /** @internal */ get_rate(): number;
     /** @internal */ set_rate(v: number): number;
     /** @internal */ get_ratio(): number;
@@ -3981,12 +4272,12 @@ declare class MotorJoint extends Constraint {
  * Converted from nape-compiled.js lines 23205–23304.
  */
 
-type Any$2 = any;
+type Any$3 = any;
 declare class ZPP_LineJoint extends ZPP_Constraint {
     static __name__: string[];
     static __super__: typeof ZPP_Constraint;
-    static _wrapFn: ((zpp: ZPP_LineJoint) => Any$2) | null;
-    outer_zn: Any$2;
+    static _wrapFn: ((zpp: ZPP_LineJoint) => Any$3) | null;
+    outer_zn: Any$3;
     scale: number;
     jointMin: number;
     jointMax: number;
@@ -3995,35 +4286,35 @@ declare class ZPP_LineJoint extends ZPP_Constraint {
     dot2: number;
     cx1: number;
     cx2: number;
-    b1: Any$2;
+    b1: Any$3;
     a1localx: number;
     a1localy: number;
     a1relx: number;
     a1rely: number;
-    wrap_a1: Any$2;
-    b2: Any$2;
+    wrap_a1: Any$3;
+    b2: Any$3;
     a2localx: number;
     a2localy: number;
     a2relx: number;
     a2rely: number;
-    wrap_a2: Any$2;
-    zip_n: Any$2;
+    wrap_a2: Any$3;
+    zip_n: Any$3;
     nlocalx: number;
     nlocaly: number;
     nrelx: number;
     nrely: number;
-    wrap_n: Any$2;
+    wrap_n: Any$3;
     kMassa: number;
     kMassb: number;
     kMassc: number;
     jAccx: number;
     jAccy: number;
-    jMax: Any$2;
-    gamma: Any$2;
+    jMax: Any$3;
+    gamma: Any$3;
     biasx: number;
     biasy: number;
     stepped: boolean;
-    __class__: Any$2;
+    __class__: Any$3;
     constructor();
     /**
      * Creates or recycles a Vec2 from the public pool, sets its x/y,
@@ -4032,19 +4323,19 @@ declare class ZPP_LineJoint extends ZPP_Constraint {
      */
     private _setupVec2;
     validate_a1(): void;
-    invalidate_a1(x: Any$2): void;
+    invalidate_a1(x: Any$3): void;
     setup_a1(): void;
     validate_a2(): void;
-    invalidate_a2(x: Any$2): void;
+    invalidate_a2(x: Any$3): void;
     setup_a2(): void;
     validate_n(): void;
-    invalidate_n(x: Any$2): void;
+    invalidate_n(x: Any$3): void;
     setup_n(): void;
     validate_norm(): void;
-    bodyImpulse(b: Any$2): Any$2;
+    bodyImpulse(b: Any$3): Any$3;
     activeBodies(): void;
     inactiveBodies(): void;
-    copy(dict: Any$2, todo: Any$2): Any$2;
+    copy(dict: Any$3, todo: Any$3): Any$3;
     validate(): void;
     wake_connected(): void;
     forest(): void;
@@ -4054,10 +4345,10 @@ declare class ZPP_LineJoint extends ZPP_Constraint {
     warmStart(): void;
     applyImpulseVel(): boolean;
     applyImpulsePos(): boolean;
-    draw(_g: Any$2): void;
+    draw(_g: Any$3): void;
 }
 
-type Any$1 = any;
+type Any$2 = any;
 /**
  * Line joint — constrains body2's anchor to slide along a line
  * defined by body1's anchor and direction.
@@ -4068,7 +4359,7 @@ declare class LineJoint extends Constraint {
     zpp_inner: ZPP_LineJoint;
     constructor(body1: Body | null, body2: Body | null, anchor1: Vec2, anchor2: Vec2, direction: Vec2, jointMin: number, jointMax: number);
     /** @internal */
-    static _wrap(inner: Any$1): LineJoint;
+    static _wrap(inner: Any$2): LineJoint;
     get body1(): Body;
     set body1(value: Body | null);
     /** @internal */
@@ -4087,19 +4378,19 @@ declare class LineJoint extends Constraint {
     set jointMin(value: number);
     get jointMax(): number;
     set jointMax(value: number);
-    impulse(): Any$1;
-    bodyImpulse(body: Body): Any$1;
+    impulse(): Any$2;
+    bodyImpulse(body: Body): Any$2;
     visitBodies(lambda: (body: Body) => void): void;
-    /** @internal */ get_body1(): Any$1;
-    /** @internal */ set_body1(v: Any$1): Any$1;
-    /** @internal */ get_body2(): Any$1;
-    /** @internal */ set_body2(v: Any$1): Any$1;
-    /** @internal */ get_anchor1(): Any$1;
-    /** @internal */ set_anchor1(v: Any$1): Any$1;
-    /** @internal */ get_anchor2(): Any$1;
-    /** @internal */ set_anchor2(v: Any$1): Any$1;
-    /** @internal */ get_direction(): Any$1;
-    /** @internal */ set_direction(v: Any$1): Any$1;
+    /** @internal */ get_body1(): Any$2;
+    /** @internal */ set_body1(v: Any$2): Any$2;
+    /** @internal */ get_body2(): Any$2;
+    /** @internal */ set_body2(v: Any$2): Any$2;
+    /** @internal */ get_anchor1(): Any$2;
+    /** @internal */ set_anchor1(v: Any$2): Any$2;
+    /** @internal */ get_anchor2(): Any$2;
+    /** @internal */ set_anchor2(v: Any$2): Any$2;
+    /** @internal */ get_direction(): Any$2;
+    /** @internal */ set_direction(v: Any$2): Any$2;
     /** @internal */ get_jointMin(): number;
     /** @internal */ set_jointMin(v: number): number;
     /** @internal */ get_jointMax(): number;
@@ -4109,13 +4400,108 @@ declare class LineJoint extends Constraint {
     set zpp_inner_zn(v: ZPP_LineJoint);
 }
 
+/**
+ * ZPP_PulleyJoint — Internal 4-body, 1-DOF pulley constraint.
+ *
+ * Constrains (dist(b1,b2) + ratio * dist(b3,b4)) to [jointMin, jointMax].
+ * Supports mechanical advantage ratio, slack detection, stiffness/damping,
+ * and large-error pre-correction in applyImpulsePos.
+ *
+ * Converted from nape-compiled.js lines 25475–25367.
+ */
+
+type Any$1 = any;
+declare class ZPP_PulleyJoint extends ZPP_Constraint {
+    static __name__: string[];
+    static __super__: typeof ZPP_Constraint;
+    static _wrapFn: ((zpp: ZPP_PulleyJoint) => Any$1) | null;
+    outer_zn: Any$1;
+    ratio: number;
+    jointMin: number;
+    jointMax: number;
+    slack: boolean;
+    equal: boolean;
+    n12x: number;
+    n12y: number;
+    n34x: number;
+    n34y: number;
+    cx1: number;
+    cx2: number;
+    cx3: number;
+    cx4: number;
+    b1: Any$1;
+    a1localx: number;
+    a1localy: number;
+    a1relx: number;
+    a1rely: number;
+    wrap_a1: Any$1;
+    b2: Any$1;
+    a2localx: number;
+    a2localy: number;
+    a2relx: number;
+    a2rely: number;
+    wrap_a2: Any$1;
+    b3: Any$1;
+    a3localx: number;
+    a3localy: number;
+    a3relx: number;
+    a3rely: number;
+    wrap_a3: Any$1;
+    b4: Any$1;
+    a4localx: number;
+    a4localy: number;
+    a4relx: number;
+    a4rely: number;
+    wrap_a4: Any$1;
+    kMass: number;
+    jAcc: number;
+    jMax: number;
+    gamma: number;
+    bias: number;
+    stepped: boolean;
+    __class__: Any$1;
+    constructor();
+    is_slack(): boolean;
+    bodyImpulse(b: Any$1): Any$1;
+    activeBodies(): void;
+    inactiveBodies(): void;
+    validate_a1(): void;
+    invalidate_a1(x: Any$1): void;
+    setup_a1(): void;
+    validate_a2(): void;
+    invalidate_a2(x: Any$1): void;
+    setup_a2(): void;
+    validate_a3(): void;
+    invalidate_a3(x: Any$1): void;
+    setup_a3(): void;
+    validate_a4(): void;
+    invalidate_a4(x: Any$1): void;
+    setup_a4(): void;
+    copy(dict: Any$1, todo: Any$1): Any$1;
+    validate(): void;
+    wake_connected(): void;
+    forest(): void;
+    pair_exists(id: number, di: number): boolean;
+    clearcache(): void;
+    preStep(dt: number): boolean;
+    warmStart(): void;
+    applyImpulseVel(): boolean;
+    applyImpulsePos(): boolean;
+    draw(_g: Any$1): void;
+}
+
 type Any = any;
 /**
- * Pulley joint — constrains the sum of distances between four anchor points
- * on four bodies.
+ * Pulley joint — constrains the weighted sum of distances between
+ * four anchor points on four bodies.
+ *
+ * Fully modernized — uses ZPP_PulleyJoint directly (extracted to TypeScript).
  */
 declare class PulleyJoint extends Constraint {
+    zpp_inner: ZPP_PulleyJoint;
     constructor(body1: Body | null, body2: Body | null, body3: Body | null, body4: Body | null, anchor1: Vec2, anchor2: Vec2, anchor3: Vec2, anchor4: Vec2, jointMin: number, jointMax: number, ratio?: number);
+    /** @internal Helper to set an anchor during construction. */
+    private _setAnchorInit;
     /** @internal */
     static _wrap(inner: Any): PulleyJoint;
     get body1(): Body;
@@ -4126,6 +4512,14 @@ declare class PulleyJoint extends Constraint {
     set body3(value: Body | null);
     get body4(): Body;
     set body4(value: Body | null);
+    /** @internal */
+    private _setBody1;
+    /** @internal */
+    private _setBody2;
+    /** @internal */
+    private _setBody3;
+    /** @internal */
+    private _setBody4;
     get anchor1(): Vec2;
     set anchor1(value: Vec2);
     get anchor2(): Vec2;
@@ -4140,6 +4534,35 @@ declare class PulleyJoint extends Constraint {
     set jointMax(value: number);
     get ratio(): number;
     set ratio(value: number);
+    isSlack(): boolean;
+    impulse(): Any;
+    bodyImpulse(body: Body): Any;
+    visitBodies(lambda: (body: Body) => void): void;
+    /** @internal */ get_body1(): Any;
+    /** @internal */ set_body1(v: Any): Any;
+    /** @internal */ get_body2(): Any;
+    /** @internal */ set_body2(v: Any): Any;
+    /** @internal */ get_body3(): Any;
+    /** @internal */ set_body3(v: Any): Any;
+    /** @internal */ get_body4(): Any;
+    /** @internal */ set_body4(v: Any): Any;
+    /** @internal */ get_anchor1(): Any;
+    /** @internal */ set_anchor1(v: Any): Any;
+    /** @internal */ get_anchor2(): Any;
+    /** @internal */ set_anchor2(v: Any): Any;
+    /** @internal */ get_anchor3(): Any;
+    /** @internal */ set_anchor3(v: Any): Any;
+    /** @internal */ get_anchor4(): Any;
+    /** @internal */ set_anchor4(v: Any): Any;
+    /** @internal */ get_jointMin(): number;
+    /** @internal */ set_jointMin(v: number): number;
+    /** @internal */ get_jointMax(): number;
+    /** @internal */ set_jointMax(v: number): number;
+    /** @internal */ get_ratio(): number;
+    /** @internal */ set_ratio(v: number): number;
+    /** @internal backward compat alias for zpp_inner */
+    get zpp_inner_zn(): ZPP_PulleyJoint;
+    set zpp_inner_zn(v: ZPP_PulleyJoint);
 }
 
 declare const VERSION: string;