@newkrok/nape-js 3.3.3 → 3.3.4

package/dist/index.d.cts

@@ -15,76 +15,263 @@
  */
 declare function getNape(): any;
 
+/**
+ * ZPP_Vec2 — Internal 2D vector AND intrusive linked list for the nape physics engine.
+ *
+ * Serves three roles simultaneously (Haxe ZNPList template expansion):
+ *   1. 2D vector data: x, y coordinates
+ *   2. Intrusive linked list container: add/remove/insert/pop (head via `next`)
+ *   3. Pooled object with wrapper/validation pattern
+ *
+ * Converted from nape-compiled.js lines 83820–84273, 134996.
+ */
+type Any$6 = any;
+declare class ZPP_Vec2 {
+    static zpp_pool: ZPP_Vec2 | null;
+    static __name__: string[];
+    static _nape: Any$6;
+    static _zpp: Any$6;
+    static _wrapFn: ((zpp: ZPP_Vec2) => Any$6) | null;
+    x: number;
+    y: number;
+    next: ZPP_Vec2 | null;
+    length: number;
+    modified: boolean;
+    pushmod: boolean;
+    _inuse: boolean;
+    weak: boolean;
+    outer: Any$6;
+    _immutable: boolean;
+    _isimmutable: (() => void) | null;
+    _validate: (() => void) | null;
+    _invalidate: ((self: ZPP_Vec2) => void) | null;
+    __class__: Any$6;
+    /** 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$6;
+    free(): void;
+    alloc(): void;
+    elem(): ZPP_Vec2;
+    begin(): ZPP_Vec2 | null;
+    setbegin(i: ZPP_Vec2 | null): void;
+    add(o: ZPP_Vec2): ZPP_Vec2;
+    inlined_add(o: ZPP_Vec2): ZPP_Vec2;
+    addAll(x: ZPP_Vec2): void;
+    insert(cur: ZPP_Vec2 | null, o: ZPP_Vec2): ZPP_Vec2;
+    inlined_insert(cur: ZPP_Vec2 | null, o: ZPP_Vec2): ZPP_Vec2;
+    pop(): void;
+    inlined_pop(): void;
+    pop_unsafe(): ZPP_Vec2;
+    inlined_pop_unsafe(): ZPP_Vec2;
+    remove(obj: ZPP_Vec2): void;
+    try_remove(obj: ZPP_Vec2): boolean;
+    inlined_remove(obj: ZPP_Vec2): void;
+    inlined_try_remove(obj: ZPP_Vec2): boolean;
+    erase(pre: ZPP_Vec2 | null): ZPP_Vec2 | null;
+    inlined_erase(pre: ZPP_Vec2 | null): ZPP_Vec2 | null;
+    splice(pre: ZPP_Vec2, n: number): ZPP_Vec2 | null;
+    clear(): void;
+    inlined_clear(): void;
+    reverse(): void;
+    empty(): boolean;
+    size(): number;
+    has(obj: ZPP_Vec2): boolean;
+    inlined_has(obj: ZPP_Vec2): boolean;
+    front(): ZPP_Vec2 | null;
+    back(): ZPP_Vec2 | null;
+    iterator_at(ind: number): ZPP_Vec2 | null;
+    at(ind: number): ZPP_Vec2 | null;
+    copy(): ZPP_Vec2;
+    toString(): string;
+}
+
 /**
  * 2D vector used for positions, velocities, forces, and other 2D quantities.
  *
- * Many methods return a new Vec2 unless noted as "in-place".
+ * Supports object pooling via `Vec2.get()` / `dispose()`, weak references
+ * that auto-dispose after a single use, and immutability guards.
+ *
+ * Converted from nape-compiled.js lines 23448–27180.
  */
 declare class Vec2 {
-    /** @internal Raw Haxe nape Vec2 object. */
-    readonly _inner: NapeInner;
+    static __name__: string[];
+    /** @internal The internal ZPP_Vec2 this wrapper owns. */
+    zpp_inner: ZPP_Vec2;
+    /** @internal Public Vec2 pool link. */
+    zpp_pool: Vec2 | null;
+    /** @internal Whether this Vec2 has been disposed. */
+    zpp_disp: boolean;
+    /**
+     * Backward-compatible accessor — returns `this` so that compiled engine
+     * code that receives `vec._inner` can still access `zpp_inner`.
+     * @internal
+     */
+    get _inner(): NapeInner;
     constructor(x?: number, y?: number);
-    /** @internal Wrap an existing Haxe Vec2 with caching. */
-    static _wrap(inner: NapeInner): Vec2;
+    /** @internal Check that this Vec2 has not been disposed. */
+    private _checkDisposed;
+    /** @internal Check immutability. */
+    private _checkImmutable;
+    /** @internal Validate (lazy evaluation callback). */
+    private _validate;
+    /** @internal Invalidate (notify dependents). */
+    private _invalidate;
+    /** @internal Dispose a weak Vec2 argument after use. */
+    private static _disposeWeak;
+    /**
+     * @internal Set x and y on zpp_inner with validation/invalidation.
+     * Only invalidates if values actually changed.
+     */
+    private _setXY;
+    /** @internal Get a Vec2 from the public pool or create a new one. */
+    private static _poolGet;
+    /** @internal Wrap a ZPP_Vec2 (or legacy compiled Vec2) with caching. */
+    static _wrap(inner: any): Vec2;
+    /** Obtain a Vec2 from the object pool (or create a new one). */
+    static get(x?: number, y?: number, weak?: boolean): Vec2;
+    /** Obtain a weak Vec2 that auto-disposes after a single use. */
+    static weak(x?: number, y?: number): Vec2;
+    /** Create a Vec2 from polar coordinates. */
+    static fromPolar(length: number, angle: number, weak?: boolean): Vec2;
+    /** Squared distance between two Vec2s. */
+    static dsq(a: Vec2, b: Vec2): number;
+    /** Euclidean distance between two Vec2s. */
+    static distance(a: Vec2, b: Vec2): number;
     get x(): number;
     set x(value: number);
     get y(): number;
     set y(value: number);
-    /** Magnitude of the vector. Setting this scales the vector to the given length. */
+    /** Magnitude of the vector. */
     get length(): number;
+    /** Setting length scales the vector to the given magnitude. */
     set length(value: number);
     /** Angle of the vector in radians (measured from the +x axis). */
     get angle(): number;
+    /** Setting angle preserves magnitude but rotates to the given angle. */
     set angle(value: number);
     /** Squared length — avoids a square root when only comparison is needed. */
     lsq(): number;
-    /** Copy values from another vector into this one (in-place). */
-    set(other: Vec2): this;
-    /** Set both components at once (in-place). */
+    /** Copy values from another vector into this one (in-place). Returns this. */
+    set(vector: Vec2): this;
+    /** Set both components at once (in-place). Returns this. */
     setxy(x: number, y: number): this;
     /** Return a new copy of this vector. */
     copy(weak?: boolean): Vec2;
-    /** Rotate this vector by the given angle in radians (in-place). */
+    /** Rotate this vector by the given angle in radians (in-place). Returns this. */
     rotate(angle: number): this;
     /** Reflect this vector about the given axis vector (returns new Vec2). */
-    reflect(axis: Vec2, weak?: boolean): Vec2;
-    /** Normalize this vector to unit length (in-place). Returns original length. */
-    normalise(): number;
+    reflect(vec: Vec2, weak?: boolean): Vec2;
+    /** Normalize this vector to unit length (in-place). Returns this. */
+    normalise(): this;
     /** Return a new unit-length vector with the same direction. */
     unit(weak?: boolean): Vec2;
     /** Return a new vector = this + other. */
-    add(other: Vec2, weak?: boolean): Vec2;
+    add(vector: Vec2, weak?: boolean): Vec2;
     /** Return a new vector = this + other * scalar. */
-    addMul(other: Vec2, scalar: number, weak?: boolean): Vec2;
-    /** Return a new vector = this − other. */
-    sub(other: Vec2, weak?: boolean): Vec2;
+    addMul(vector: Vec2, scalar: number, weak?: boolean): Vec2;
+    /** Return a new vector = this - other. */
+    sub(vector: Vec2, weak?: boolean): Vec2;
     /** Return a new vector = this * scalar. */
     mul(scalar: number, weak?: boolean): Vec2;
-    /** this += other (in-place). */
-    addeq(other: Vec2): this;
-    /** this -= other (in-place). */
-    subeq(other: Vec2): this;
-    /** this *= scalar (in-place). */
+    /** this += other (in-place). Returns this. */
+    addeq(vector: Vec2): this;
+    /** this -= other (in-place). Returns this. */
+    subeq(vector: Vec2): this;
+    /** this *= scalar (in-place). Returns this. */
     muleq(scalar: number): this;
     /** Dot product of this and other. */
-    dot(other: Vec2): number;
-    /** 2D cross product (returns scalar: this.x*other.y − this.y*other.x). */
-    cross(other: Vec2): number;
-    /** Return the perpendicular vector (rotated 90° counter-clockwise). */
+    dot(vector: Vec2): number;
+    /** 2D cross product (returns scalar: this.x*other.y - this.y*other.x). */
+    cross(vector: Vec2): number;
+    /** Return the perpendicular vector (rotated 90deg counter-clockwise). */
     perp(weak?: boolean): Vec2;
     /** Release this vector back to the object pool. */
     dispose(): void;
     toString(): string;
-    /** Obtain a Vec2 from the object pool (or create a new one). */
-    static get(x?: number, y?: number, weak?: boolean): Vec2;
-    /** Obtain a weak Vec2 that auto-disposes after a single use. */
-    static weak(x?: number, y?: number): Vec2;
-    /** Create a Vec2 from polar coordinates. */
-    static fromPolar(length: number, angle: number, weak?: boolean): Vec2;
 }
 /** @internal Opaque handle for any Haxe-compiled nape object. */
 type NapeInner = any;
 
+/**
+ * ZPP_Vec3 — Internal 3D vector for the nape physics engine.
+ *
+ * Simple x, y, z data container with optional validation callback.
+ * Used internally for constraint anchor points and similar 3-component values.
+ *
+ * Converted from nape-compiled.js lines 83412–83434.
+ */
+type Any$5 = any;
+declare class ZPP_Vec3 {
+    static __name__: string[];
+    static _zpp: Any$5;
+    static _wrapFn: ((zpp: ZPP_Vec3) => Any$5) | null;
+    outer: Any$5;
+    x: number;
+    y: number;
+    z: number;
+    immutable: boolean;
+    _validate: (() => void) | null;
+    __class__: Any$5;
+    validate(): void;
+    wrapper(): Any$5;
+}
+
+/**
+ * 3D vector used for constraint impulses and other 3-component values.
+ *
+ * Supports object pooling via `Vec3.get()` / `dispose()`.
+ *
+ * Converted from nape-compiled.js lines 24120–25040.
+ */
+declare class Vec3 {
+    static __name__: string[];
+    /** @internal The internal ZPP_Vec3 this wrapper owns. */
+    zpp_inner: ZPP_Vec3;
+    /** @internal Public Vec3 pool link. */
+    zpp_pool: Vec3 | null;
+    /** @internal Whether this Vec3 has been disposed. */
+    zpp_disp: boolean;
+    /**
+     * Backward-compatible accessor — returns `this` so that compiled engine
+     * code that receives `v3._inner` can still access `zpp_inner`.
+     * @internal
+     */
+    get _inner(): NapeInner;
+    constructor(x?: number, y?: number, z?: number);
+    /** @internal Check that this Vec3 has not been disposed. */
+    private _checkDisposed;
+    /** @internal Check immutability. */
+    private _checkImmutable;
+    /** @internal Wrap a ZPP_Vec3 (or legacy compiled Vec3) with caching. */
+    static _wrap(inner: any): Vec3;
+    /** Obtain a Vec3 from the object pool (or create a new one). */
+    static get(x?: number, y?: number, z?: number): Vec3;
+    get x(): number;
+    set x(value: number);
+    get y(): number;
+    set y(value: number);
+    get z(): number;
+    set z(value: number);
+    /** Magnitude of the 3D vector. */
+    get length(): number;
+    /** Setting length scales the vector to the given magnitude. */
+    set length(value: number);
+    /** Squared length — avoids a square root when only comparison is needed. */
+    lsq(): number;
+    /** Copy values from another Vec3 into this one (in-place). Returns this. */
+    set(vector: Vec3): this;
+    /** Set all three components at once (in-place). Returns this. */
+    setxyz(x: number, y: number, z: number): this;
+    /** Return the x,y components as a Vec2. */
+    xy(weak?: boolean): Vec2;
+    /** Release this Vec3 back to the object pool. */
+    dispose(): void;
+    toString(): string;
+}
+
 /**
  * ZPP_AABB — Internal axis-aligned bounding box for the nape physics engine.
  *
@@ -1166,4 +1353,4 @@ declare class PulleyJoint extends Constraint {
     set ratio(value: number);
 }
 
-export { AABB, AngleJoint, Body, BodyListener, BodyType, CbEvent, CbType, Circle, Constraint, ConstraintListener, DistanceJoint, FluidProperties, InteractionFilter, InteractionGroup, InteractionListener, InteractionType, LineJoint, Listener, Material, MotorJoint, NapeList, OptionType, PivotJoint, Polygon, PreFlag, PreListener, PulleyJoint, Shape, ShapeType, Space, Vec2, WeldJoint, getNape };
+export { AABB, AngleJoint, Body, BodyListener, BodyType, CbEvent, CbType, Circle, Constraint, ConstraintListener, DistanceJoint, FluidProperties, InteractionFilter, InteractionGroup, InteractionListener, InteractionType, LineJoint, Listener, Material, MotorJoint, NapeList, OptionType, PivotJoint, Polygon, PreFlag, PreListener, PulleyJoint, Shape, ShapeType, Space, Vec2, Vec3, WeldJoint, getNape };

package/dist/index.d.ts

@@ -15,76 +15,263 @@
  */
 declare function getNape(): any;
 
+/**
+ * ZPP_Vec2 — Internal 2D vector AND intrusive linked list for the nape physics engine.
+ *
+ * Serves three roles simultaneously (Haxe ZNPList template expansion):
+ *   1. 2D vector data: x, y coordinates
+ *   2. Intrusive linked list container: add/remove/insert/pop (head via `next`)
+ *   3. Pooled object with wrapper/validation pattern
+ *
+ * Converted from nape-compiled.js lines 83820–84273, 134996.
+ */
+type Any$6 = any;
+declare class ZPP_Vec2 {
+    static zpp_pool: ZPP_Vec2 | null;
+    static __name__: string[];
+    static _nape: Any$6;
+    static _zpp: Any$6;
+    static _wrapFn: ((zpp: ZPP_Vec2) => Any$6) | null;
+    x: number;
+    y: number;
+    next: ZPP_Vec2 | null;
+    length: number;
+    modified: boolean;
+    pushmod: boolean;
+    _inuse: boolean;
+    weak: boolean;
+    outer: Any$6;
+    _immutable: boolean;
+    _isimmutable: (() => void) | null;
+    _validate: (() => void) | null;
+    _invalidate: ((self: ZPP_Vec2) => void) | null;
+    __class__: Any$6;
+    /** 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$6;
+    free(): void;
+    alloc(): void;
+    elem(): ZPP_Vec2;
+    begin(): ZPP_Vec2 | null;
+    setbegin(i: ZPP_Vec2 | null): void;
+    add(o: ZPP_Vec2): ZPP_Vec2;
+    inlined_add(o: ZPP_Vec2): ZPP_Vec2;
+    addAll(x: ZPP_Vec2): void;
+    insert(cur: ZPP_Vec2 | null, o: ZPP_Vec2): ZPP_Vec2;
+    inlined_insert(cur: ZPP_Vec2 | null, o: ZPP_Vec2): ZPP_Vec2;
+    pop(): void;
+    inlined_pop(): void;
+    pop_unsafe(): ZPP_Vec2;
+    inlined_pop_unsafe(): ZPP_Vec2;
+    remove(obj: ZPP_Vec2): void;
+    try_remove(obj: ZPP_Vec2): boolean;
+    inlined_remove(obj: ZPP_Vec2): void;
+    inlined_try_remove(obj: ZPP_Vec2): boolean;
+    erase(pre: ZPP_Vec2 | null): ZPP_Vec2 | null;
+    inlined_erase(pre: ZPP_Vec2 | null): ZPP_Vec2 | null;
+    splice(pre: ZPP_Vec2, n: number): ZPP_Vec2 | null;
+    clear(): void;
+    inlined_clear(): void;
+    reverse(): void;
+    empty(): boolean;
+    size(): number;
+    has(obj: ZPP_Vec2): boolean;
+    inlined_has(obj: ZPP_Vec2): boolean;
+    front(): ZPP_Vec2 | null;
+    back(): ZPP_Vec2 | null;
+    iterator_at(ind: number): ZPP_Vec2 | null;
+    at(ind: number): ZPP_Vec2 | null;
+    copy(): ZPP_Vec2;
+    toString(): string;
+}
+
 /**
  * 2D vector used for positions, velocities, forces, and other 2D quantities.
  *
- * Many methods return a new Vec2 unless noted as "in-place".
+ * Supports object pooling via `Vec2.get()` / `dispose()`, weak references
+ * that auto-dispose after a single use, and immutability guards.
+ *
+ * Converted from nape-compiled.js lines 23448–27180.
  */
 declare class Vec2 {
-    /** @internal Raw Haxe nape Vec2 object. */
-    readonly _inner: NapeInner;
+    static __name__: string[];
+    /** @internal The internal ZPP_Vec2 this wrapper owns. */
+    zpp_inner: ZPP_Vec2;
+    /** @internal Public Vec2 pool link. */
+    zpp_pool: Vec2 | null;
+    /** @internal Whether this Vec2 has been disposed. */
+    zpp_disp: boolean;
+    /**
+     * Backward-compatible accessor — returns `this` so that compiled engine
+     * code that receives `vec._inner` can still access `zpp_inner`.
+     * @internal
+     */
+    get _inner(): NapeInner;
     constructor(x?: number, y?: number);
-    /** @internal Wrap an existing Haxe Vec2 with caching. */
-    static _wrap(inner: NapeInner): Vec2;
+    /** @internal Check that this Vec2 has not been disposed. */
+    private _checkDisposed;
+    /** @internal Check immutability. */
+    private _checkImmutable;
+    /** @internal Validate (lazy evaluation callback). */
+    private _validate;
+    /** @internal Invalidate (notify dependents). */
+    private _invalidate;
+    /** @internal Dispose a weak Vec2 argument after use. */
+    private static _disposeWeak;
+    /**
+     * @internal Set x and y on zpp_inner with validation/invalidation.
+     * Only invalidates if values actually changed.
+     */
+    private _setXY;
+    /** @internal Get a Vec2 from the public pool or create a new one. */
+    private static _poolGet;
+    /** @internal Wrap a ZPP_Vec2 (or legacy compiled Vec2) with caching. */
+    static _wrap(inner: any): Vec2;
+    /** Obtain a Vec2 from the object pool (or create a new one). */
+    static get(x?: number, y?: number, weak?: boolean): Vec2;
+    /** Obtain a weak Vec2 that auto-disposes after a single use. */
+    static weak(x?: number, y?: number): Vec2;
+    /** Create a Vec2 from polar coordinates. */
+    static fromPolar(length: number, angle: number, weak?: boolean): Vec2;
+    /** Squared distance between two Vec2s. */
+    static dsq(a: Vec2, b: Vec2): number;
+    /** Euclidean distance between two Vec2s. */
+    static distance(a: Vec2, b: Vec2): number;
     get x(): number;
     set x(value: number);
     get y(): number;
     set y(value: number);
-    /** Magnitude of the vector. Setting this scales the vector to the given length. */
+    /** Magnitude of the vector. */
     get length(): number;
+    /** Setting length scales the vector to the given magnitude. */
     set length(value: number);
     /** Angle of the vector in radians (measured from the +x axis). */
     get angle(): number;
+    /** Setting angle preserves magnitude but rotates to the given angle. */
     set angle(value: number);
     /** Squared length — avoids a square root when only comparison is needed. */
     lsq(): number;
-    /** Copy values from another vector into this one (in-place). */
-    set(other: Vec2): this;
-    /** Set both components at once (in-place). */
+    /** Copy values from another vector into this one (in-place). Returns this. */
+    set(vector: Vec2): this;
+    /** Set both components at once (in-place). Returns this. */
     setxy(x: number, y: number): this;
     /** Return a new copy of this vector. */
     copy(weak?: boolean): Vec2;
-    /** Rotate this vector by the given angle in radians (in-place). */
+    /** Rotate this vector by the given angle in radians (in-place). Returns this. */
     rotate(angle: number): this;
     /** Reflect this vector about the given axis vector (returns new Vec2). */
-    reflect(axis: Vec2, weak?: boolean): Vec2;
-    /** Normalize this vector to unit length (in-place). Returns original length. */
-    normalise(): number;
+    reflect(vec: Vec2, weak?: boolean): Vec2;
+    /** Normalize this vector to unit length (in-place). Returns this. */
+    normalise(): this;
     /** Return a new unit-length vector with the same direction. */
     unit(weak?: boolean): Vec2;
     /** Return a new vector = this + other. */
-    add(other: Vec2, weak?: boolean): Vec2;
+    add(vector: Vec2, weak?: boolean): Vec2;
     /** Return a new vector = this + other * scalar. */
-    addMul(other: Vec2, scalar: number, weak?: boolean): Vec2;
-    /** Return a new vector = this − other. */
-    sub(other: Vec2, weak?: boolean): Vec2;
+    addMul(vector: Vec2, scalar: number, weak?: boolean): Vec2;
+    /** Return a new vector = this - other. */
+    sub(vector: Vec2, weak?: boolean): Vec2;
     /** Return a new vector = this * scalar. */
     mul(scalar: number, weak?: boolean): Vec2;
-    /** this += other (in-place). */
-    addeq(other: Vec2): this;
-    /** this -= other (in-place). */
-    subeq(other: Vec2): this;
-    /** this *= scalar (in-place). */
+    /** this += other (in-place). Returns this. */
+    addeq(vector: Vec2): this;
+    /** this -= other (in-place). Returns this. */
+    subeq(vector: Vec2): this;
+    /** this *= scalar (in-place). Returns this. */
     muleq(scalar: number): this;
     /** Dot product of this and other. */
-    dot(other: Vec2): number;
-    /** 2D cross product (returns scalar: this.x*other.y − this.y*other.x). */
-    cross(other: Vec2): number;
-    /** Return the perpendicular vector (rotated 90° counter-clockwise). */
+    dot(vector: Vec2): number;
+    /** 2D cross product (returns scalar: this.x*other.y - this.y*other.x). */
+    cross(vector: Vec2): number;
+    /** Return the perpendicular vector (rotated 90deg counter-clockwise). */
     perp(weak?: boolean): Vec2;
     /** Release this vector back to the object pool. */
     dispose(): void;
     toString(): string;
-    /** Obtain a Vec2 from the object pool (or create a new one). */
-    static get(x?: number, y?: number, weak?: boolean): Vec2;
-    /** Obtain a weak Vec2 that auto-disposes after a single use. */
-    static weak(x?: number, y?: number): Vec2;
-    /** Create a Vec2 from polar coordinates. */
-    static fromPolar(length: number, angle: number, weak?: boolean): Vec2;
 }
 /** @internal Opaque handle for any Haxe-compiled nape object. */
 type NapeInner = any;
 
+/**
+ * ZPP_Vec3 — Internal 3D vector for the nape physics engine.
+ *
+ * Simple x, y, z data container with optional validation callback.
+ * Used internally for constraint anchor points and similar 3-component values.
+ *
+ * Converted from nape-compiled.js lines 83412–83434.
+ */
+type Any$5 = any;
+declare class ZPP_Vec3 {
+    static __name__: string[];
+    static _zpp: Any$5;
+    static _wrapFn: ((zpp: ZPP_Vec3) => Any$5) | null;
+    outer: Any$5;
+    x: number;
+    y: number;
+    z: number;
+    immutable: boolean;
+    _validate: (() => void) | null;
+    __class__: Any$5;
+    validate(): void;
+    wrapper(): Any$5;
+}
+
+/**
+ * 3D vector used for constraint impulses and other 3-component values.
+ *
+ * Supports object pooling via `Vec3.get()` / `dispose()`.
+ *
+ * Converted from nape-compiled.js lines 24120–25040.
+ */
+declare class Vec3 {
+    static __name__: string[];
+    /** @internal The internal ZPP_Vec3 this wrapper owns. */
+    zpp_inner: ZPP_Vec3;
+    /** @internal Public Vec3 pool link. */
+    zpp_pool: Vec3 | null;
+    /** @internal Whether this Vec3 has been disposed. */
+    zpp_disp: boolean;
+    /**
+     * Backward-compatible accessor — returns `this` so that compiled engine
+     * code that receives `v3._inner` can still access `zpp_inner`.
+     * @internal
+     */
+    get _inner(): NapeInner;
+    constructor(x?: number, y?: number, z?: number);
+    /** @internal Check that this Vec3 has not been disposed. */
+    private _checkDisposed;
+    /** @internal Check immutability. */
+    private _checkImmutable;
+    /** @internal Wrap a ZPP_Vec3 (or legacy compiled Vec3) with caching. */
+    static _wrap(inner: any): Vec3;
+    /** Obtain a Vec3 from the object pool (or create a new one). */
+    static get(x?: number, y?: number, z?: number): Vec3;
+    get x(): number;
+    set x(value: number);
+    get y(): number;
+    set y(value: number);
+    get z(): number;
+    set z(value: number);
+    /** Magnitude of the 3D vector. */
+    get length(): number;
+    /** Setting length scales the vector to the given magnitude. */
+    set length(value: number);
+    /** Squared length — avoids a square root when only comparison is needed. */
+    lsq(): number;
+    /** Copy values from another Vec3 into this one (in-place). Returns this. */
+    set(vector: Vec3): this;
+    /** Set all three components at once (in-place). Returns this. */
+    setxyz(x: number, y: number, z: number): this;
+    /** Return the x,y components as a Vec2. */
+    xy(weak?: boolean): Vec2;
+    /** Release this Vec3 back to the object pool. */
+    dispose(): void;
+    toString(): string;
+}
+
 /**
  * ZPP_AABB — Internal axis-aligned bounding box for the nape physics engine.
  *
@@ -1166,4 +1353,4 @@ declare class PulleyJoint extends Constraint {
     set ratio(value: number);
 }
 
-export { AABB, AngleJoint, Body, BodyListener, BodyType, CbEvent, CbType, Circle, Constraint, ConstraintListener, DistanceJoint, FluidProperties, InteractionFilter, InteractionGroup, InteractionListener, InteractionType, LineJoint, Listener, Material, MotorJoint, NapeList, OptionType, PivotJoint, Polygon, PreFlag, PreListener, PulleyJoint, Shape, ShapeType, Space, Vec2, WeldJoint, getNape };
+export { AABB, AngleJoint, Body, BodyListener, BodyType, CbEvent, CbType, Circle, Constraint, ConstraintListener, DistanceJoint, FluidProperties, InteractionFilter, InteractionGroup, InteractionListener, InteractionType, LineJoint, Listener, Material, MotorJoint, NapeList, OptionType, PivotJoint, Polygon, PreFlag, PreListener, PulleyJoint, Shape, ShapeType, Space, Vec2, Vec3, WeldJoint, getNape };