@cyclonium/physics-2d 0.0.104 → 1.0.0

package/lib/body-collider-link.js

@@ -22,7 +22,7 @@ export class BodyColliderLink {
         this._colliders.length = 0;
     }
     linkCollider(collider) {
-        if (this._colliders.indexOf(collider) >= 0) {
+        if (this._colliders.includes(collider)) {
             throw new Error(`Collider ${collider.name} already joined to body ${this._rigidBody?.name}.`);
         }
         this._colliders.push(collider);

package/lib/character-controller-2d.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { editable, idem, idemBy, serializable } from '@cyclonium/core/legacy-decorator';
+import { editable, idem, idemBy, stored } from '@cyclonium/core/legacy-decorator';
 import { Vec2 } from '@cyclonium/core/math/vec2';
 import { fromPx2ImplVec2, toPx2ImplVec2 } from './exchange.js';
 import { px2Impl } from './px2-impl.js';
@@ -134,7 +134,7 @@ let KinematicCharacterController2D = class KinematicCharacterController2D extend
             return;
         }
         const collider = Collider2D.ofOrNull(this);
-        if (!collider || !collider.impl_internal) {
+        if (!collider?.impl_internal) {
             return;
         }
         const world = this.world;
@@ -145,7 +145,7 @@ let KinematicCharacterController2D = class KinematicCharacterController2D extend
         const movement = fromPx2ImplVec2(impl.computedMovement());
         Vec2.assign(this._lastMovement, movement);
         const rigidBody = collider.attachedRigidBody;
-        if (!rigidBody || !rigidBody.impl) {
+        if (!rigidBody?.impl) {
             const newPosition = fromPx2ImplVec2(collider.impl_internal.translation()).add(movement);
             Transform2DComponent.of(collider).position = newPosition;
             collider.impl_internal.setTranslation(toPx2ImplVec2(newPosition));
@@ -156,8 +156,7 @@ let KinematicCharacterController2D = class KinematicCharacterController2D extend
         else {
             const currentPosition = fromPx2ImplVec2(rigidBody.impl.nextTranslation());
             const newPosition = fromPx2ImplVec2(currentPosition).add(movement);
-            Transform2DComponent.of(collider).position = newPosition;
-            rigidBody.impl.setNextKinematicTranslation(toPx2ImplVec2(newPosition));
+            rigidBody.setNextKinematicPosition(newPosition);
         }
         this._emitCharacterCollisionEvents(impl, world);
     }
@@ -295,7 +294,7 @@ __decorate([
 ], KinematicCharacterController2D.prototype, "skinWidth", null);
 __decorate([
     editable,
-    idemBy(Vec2.strictEquals)
+    idemBy((left, right) => Vec2.strictEquals(left, right))
 ], KinematicCharacterController2D.prototype, "up", null);
 __decorate([
     editable,
@@ -338,40 +337,40 @@ __decorate([
     idem
 ], KinematicCharacterController2D.prototype, "applyImpulsesToDynamicBodies", null);
 __decorate([
-    serializable
+    stored
 ], KinematicCharacterController2D.prototype, "_skinWidth", void 0);
 __decorate([
-    serializable
+    stored
 ], KinematicCharacterController2D.prototype, "_up", void 0);
 __decorate([
-    serializable
+    stored
 ], KinematicCharacterController2D.prototype, "_slideEnabled", void 0);
 __decorate([
-    serializable
+    stored
 ], KinematicCharacterController2D.prototype, "_minSlopeSlideAngle", void 0);
 __decorate([
-    serializable
+    stored
 ], KinematicCharacterController2D.prototype, "_maxSlopeClimbAngle", void 0);
 __decorate([
-    serializable
+    stored
 ], KinematicCharacterController2D.prototype, "_autoStepEnabled", void 0);
 __decorate([
-    serializable
+    stored
 ], KinematicCharacterController2D.prototype, "_autoStepMaxHeight", void 0);
 __decorate([
-    serializable
+    stored
 ], KinematicCharacterController2D.prototype, "_autoStepMinWidth", void 0);
 __decorate([
-    serializable
+    stored
 ], KinematicCharacterController2D.prototype, "_autoStepIncludeDynamicBodies", void 0);
 __decorate([
-    serializable
+    stored
 ], KinematicCharacterController2D.prototype, "_snapToGroundEnabled", void 0);
 __decorate([
-    serializable
+    stored
 ], KinematicCharacterController2D.prototype, "_snapToGroundDistance", void 0);
 __decorate([
-    serializable
+    stored
 ], KinematicCharacterController2D.prototype, "_applyImpulsesToDynamicBodies", void 0);
 KinematicCharacterController2D = __decorate([
     cycloBuiltinClass('KinematicCharacterController2D')

package/lib/collider-2d.d.ts

@@ -6,44 +6,20 @@ import { ColliderShapeCastHit, ColliderShapeIntersection, RayColliderIntersectio
 import type { Ray2D } from '@cyclonium/core/math/ray';
 import { Bounds2D } from '@cyclonium/core/math/bounds-2d';
 export declare abstract class Collider2D extends PhysicsComponent2DBase {
+    onContactBegin: import("@cyclonium/event").ManagedEventEmitter<[Collider2D, Collider2D, Contact2DInfo]>;
+    onContactStay: import("@cyclonium/event").ManagedEventEmitter<[Collider2D, Collider2D, Contact2DInfo]>;
+    onContactEnd: import("@cyclonium/event").ManagedEventEmitter<[Collider2D, Collider2D, Contact2DInfo]>;
     get attachedRigidBody(): import("./rigid-body-2d.js").RigidBody2D | null;
     get isSensor(): boolean;
     set isSensor(value: boolean);
     get center(): Vec2;
     set center(value: Vec2);
     get bounds(): Bounds2D;
-    /**
-     * Test only.
-     * @internal
-     */
-    get impl_internal(): px2Impl.Collider | undefined;
-    onContactBegin: import("@cyclonium/event").ManagedEventEmitter<[Collider2D, Collider2D, Contact2DInfo]>;
-    onContactStay: import("@cyclonium/event").ManagedEventEmitter<[Collider2D, Collider2D, Contact2DInfo]>;
-    onContactEnd: import("@cyclonium/event").ManagedEventEmitter<[Collider2D, Collider2D, Contact2DInfo]>;
     intersect(opts: ShapeIntersectionQueryOptions): ColliderShapeIntersection | undefined;
     cast(opts: ShapeCastQueryOptions): ColliderShapeCastHit | undefined;
     castRay(ray: Ray2D, maxDistance: number, solid?: boolean): RayColliderIntersection | undefined;
-    /**
-     * @internal
-     */
-    _enableCollisionEventsSinceBody(value: boolean): void;
-    /**
-     * @internal
-     */
-    _responseToBodyActiveCollisionTypes(value: number): void;
-    /**
-     * @internal
-     */
-    _responseToBodyCollisionGroups(value: number): void;
-    /**
-     * @internal
-     */
-    _responseToBodySolverGroups(value: number): void;
-    /**
-     * @internal
-     */
-    _responseToAttachedRigidBodyChanged(): void;
     protected get _implCollider(): px2Impl.Collider | undefined;
+    protected get sceneGraphScale(): Vec2;
     protected recreateCollider(): void;
     protected onAttachToWorld(): void;
     protected onDetachFromWorld(): void;
@@ -52,7 +28,6 @@ export declare abstract class Collider2D extends PhysicsComponent2DBase {
     protected onSyncTransforms(forceTransform: boolean, forceScale: boolean): void;
     protected abstract getShape(): px2Impl.Shape | undefined;
     protected abstract computeShapeBounds(out: Bounds2D): void;
-    protected get sceneGraphScale(): Vec2;
     protected updateSceneGraphScale(): void;
     private _isSensor;
     private _center;

package/lib/collider-2d.js

@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { Transform2DComponent, TransformChangeFlagsObserver, TransformFlag } from '@cyclonium/core/2d';
-import { editable, requiresComponent, serializable } from '@cyclonium/core/legacy-decorator';
+import { editable, requiresComponent, stored } from '@cyclonium/core/legacy-decorator';
 import { cycloBuiltinClass } from '@cyclonium/core/internal';
 import { Vec2 } from '@cyclonium/core/math/vec2';
 import {} from './contact.js';
@@ -19,6 +19,15 @@ import { getZRotation } from './utils/3-to-2.js';
 import { ColliderShapeCastHit, ColliderShapeIntersection, RayColliderIntersection } from './scene-query.js';
 import { Bounds2D } from '@cyclonium/core/math/bounds-2d';
 let Collider2D = class Collider2D extends PhysicsComponent2DBase {
+    onContactBegin = createCollisionEventEmitter((hasAnyListener) => {
+        this._updateListenerFlag(ContactEventListenerFlagIndex.begin, hasAnyListener);
+    });
+    onContactStay = createCollisionEventEmitter((hasAnyListener) => {
+        this._updateListenerFlag(ContactEventListenerFlagIndex.stay, hasAnyListener);
+    });
+    onContactEnd = createCollisionEventEmitter((hasAnyListener) => {
+        this._updateListenerFlag(ContactEventListenerFlagIndex.end, hasAnyListener);
+    });
     get attachedRigidBody() {
         return this._handle?.attachedRigidBody ?? null;
     }
@@ -48,15 +57,6 @@ let Collider2D = class Collider2D extends PhysicsComponent2DBase {
     get impl_internal() {
         return this._implCollider;
     }
-    onContactBegin = createCollisionEventEmitter((hasAnyListener) => {
-        this._updateListenerFlag(ContactEventListenerFlagIndex.begin, hasAnyListener);
-    });
-    onContactStay = createCollisionEventEmitter((hasAnyListener) => {
-        this._updateListenerFlag(ContactEventListenerFlagIndex.stay, hasAnyListener);
-    });
-    onContactEnd = createCollisionEventEmitter((hasAnyListener) => {
-        this._updateListenerFlag(ContactEventListenerFlagIndex.end, hasAnyListener);
-    });
     intersect(opts) {
         const world = this.world;
         if (!world) {
@@ -167,6 +167,9 @@ let Collider2D = class Collider2D extends PhysicsComponent2DBase {
     get _implCollider() {
         return this._handle?.impl ?? undefined;
     }
+    get sceneGraphScale() {
+        return this._transform.scale;
+    }
     recreateCollider() {
         this._destroyCollider();
         const handle = this._handle;
@@ -219,9 +222,6 @@ let Collider2D = class Collider2D extends PhysicsComponent2DBase {
             this._updateTransform();
         }
     }
-    get sceneGraphScale() {
-        return this._transform.scale;
-    }
     updateSceneGraphScale() {
         const implCollider = this._implCollider;
         if (!implCollider) {
@@ -340,10 +340,10 @@ __decorate([
     editable
 ], Collider2D.prototype, "center", null);
 __decorate([
-    serializable
+    stored
 ], Collider2D.prototype, "_isSensor", void 0);
 __decorate([
-    serializable
+    stored
 ], Collider2D.prototype, "_center", void 0);
 __decorate([
     requiresComponent(Transform2DComponent)

package/lib/colliders/box-collider-2d.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { editable, executeInEditMode, idem, serializable } from '@cyclonium/core/legacy-decorator';
+import { editable, executeInEditMode, idem, stored } from '@cyclonium/core/legacy-decorator';
 import { Collider2D } from '../collider-2d.js';
 import { px2Impl } from '../px2-impl.js';
 import { EDITOR_NOT_IN_PREVIEW } from 'cc/env';
@@ -71,10 +71,10 @@ __decorate([
     idem
 ], BoxCollider2D.prototype, "height", null);
 __decorate([
-    serializable
+    stored
 ], BoxCollider2D.prototype, "_halfWidth", void 0);
 __decorate([
-    serializable
+    stored
 ], BoxCollider2D.prototype, "_halfHeight", void 0);
 BoxCollider2D = __decorate([
     cycloBuiltinClass('BoxCollider2D'),

package/lib/colliders/capsule-collider-2d.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { editable, executeInEditMode, idem, serializable } from '@cyclonium/core/legacy-decorator';
+import { editable, executeInEditMode, idem, stored } from '@cyclonium/core/legacy-decorator';
 import { Collider2D } from '../collider-2d.js';
 import { px2Impl } from '../px2-impl.js';
 import { EDITOR_NOT_IN_PREVIEW } from 'cc/env';
@@ -65,10 +65,10 @@ __decorate([
     idem
 ], CapsuleCollider2D.prototype, "halfHeight", null);
 __decorate([
-    serializable
+    stored
 ], CapsuleCollider2D.prototype, "_radius", void 0);
 __decorate([
-    serializable
+    stored
 ], CapsuleCollider2D.prototype, "_halfHeight", void 0);
 CapsuleCollider2D = __decorate([
     cycloBuiltinClass('CapsuleCollider2D'),

package/lib/colliders/circle-collider-2d.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { editable, executeInEditMode, idem, serializable } from '@cyclonium/core/legacy-decorator';
+import { editable, executeInEditMode, idem, stored } from '@cyclonium/core/legacy-decorator';
 import { Collider2D } from '../collider-2d.js';
 import { px2Impl } from '../px2-impl.js';
 import { EDITOR_NOT_IN_PREVIEW } from 'cc/env';
@@ -49,7 +49,7 @@ __decorate([
     idem
 ], CircleCollider2D.prototype, "radius", null);
 __decorate([
-    serializable
+    stored
 ], CircleCollider2D.prototype, "_radius", void 0);
 CircleCollider2D = __decorate([
     cycloBuiltinClass('CircleCollider2D'),

package/lib/colliders/polygon-collider-2d.js

@@ -28,8 +28,7 @@ let PolygonCollider2D = class PolygonCollider2D extends Collider2D {
         const scale = this.sceneGraphScale;
         out.setMinMax(Vec2.POSITIVE_INFINITY, Vec2.NEGATIVE_INFINITY);
         const p = new Vec2();
-        for (let i = 0; i < this._points.length; i++) {
-            const point = this._points[i];
+        for (const point of this._points) {
             out.extend(p.copyFrom(point).mulSelf(scale));
         }
     }

package/lib/collision-matrix.d.ts

@@ -1,12 +1,12 @@
 export declare class CollisionMatrix {
     static readonly EXTENT = 16;
-    private get values();
-    private set values(value);
     clone(): CollisionMatrix;
     get(i: number, j: number): boolean;
     set(i: number, j: number, value: boolean): void;
     getCollisionsBitsOf(i: number): number;
     private _values;
+    private get values();
+    private set values(value);
     private _locate;
 }
 //# sourceMappingURL=collision-matrix.d.ts.map

package/lib/collision-matrix.js

@@ -5,19 +5,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 var CollisionMatrix_1;
-import { editable, serializable } from '@cyclonium/core/legacy-decorator';
+import { editable, stored } from '@cyclonium/core/legacy-decorator';
 import { cycloBuiltinClass } from '@cyclonium/core/internal';
 import { dumpRaw } from '@cyclonium/core/utils';
 const EXTENT = 16;
 let CollisionMatrix = class CollisionMatrix {
     static { CollisionMatrix_1 = this; }
     static EXTENT = EXTENT;
-    get values() {
-        return this._values;
-    }
-    set values(values) {
-        this._values = [...values];
-    }
     clone() {
         const clone = new CollisionMatrix_1();
         clone._values = this._values.slice();
@@ -45,6 +39,13 @@ let CollisionMatrix = class CollisionMatrix {
         return bits;
     }
     _values = new Array(EXTENT * (EXTENT + 1) / 2).fill(false);
+    get values() {
+        return this._values;
+    }
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- The private accessor name is part of the serialized editor dump schema.
+    set values(values) {
+        this._values = [...values];
+    }
     _locate(i, j) {
         if (i < 0 || i >= EXTENT || j < 0 || j >= EXTENT) {
             throw new Error(`Index out of range.`);
@@ -56,13 +57,14 @@ let CollisionMatrix = class CollisionMatrix {
         return rowStart + j;
     }
 };
+__decorate([
+    stored
+], CollisionMatrix.prototype, "_values", void 0);
 __decorate([
     editable,
     dumpRaw
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- The private accessor name is part of the serialized editor dump schema.
 ], CollisionMatrix.prototype, "values", null);
-__decorate([
-    serializable
-], CollisionMatrix.prototype, "_values", void 0);
 CollisionMatrix = CollisionMatrix_1 = __decorate([
     cycloBuiltinClass('CollisionMatrix')
 ], CollisionMatrix);

package/lib/gizmo-headless.js

@@ -1,7 +1,19 @@
-export function drawBoxCollider2DGizmo() { }
-export function drawCircleCollider2DGizmo() { }
-export function drawCapsuleCollider2DGizmo() { }
-export function drawBoxSceneQueryProbe2DGizmo() { }
-export function drawCircleSceneQueryProbe2DGizmo() { }
-export function drawCapsuleSceneQueryProbe2DGizmo() { }
+export function drawBoxCollider2DGizmo() {
+    // Gizmos are intentionally disabled in headless builds.
+}
+export function drawCircleCollider2DGizmo() {
+    // Gizmos are intentionally disabled in headless builds.
+}
+export function drawCapsuleCollider2DGizmo() {
+    // Gizmos are intentionally disabled in headless builds.
+}
+export function drawBoxSceneQueryProbe2DGizmo() {
+    // Gizmos are intentionally disabled in headless builds.
+}
+export function drawCircleSceneQueryProbe2DGizmo() {
+    // Gizmos are intentionally disabled in headless builds.
+}
+export function drawCapsuleSceneQueryProbe2DGizmo() {
+    // Gizmos are intentionally disabled in headless builds.
+}
 //# sourceMappingURL=gizmo-headless.js.map

package/lib/physics-2d-debugger-headless.d.ts

@@ -1,5 +1,4 @@
 export declare class Physics2DDebugger {
-    constructor();
     destroy(): void;
     render(): void;
 }

package/lib/physics-2d-debugger-headless.js

@@ -1,9 +1,9 @@
 export class Physics2DDebugger {
-    constructor() {
-    }
     destroy() {
+        // No render resources exist in headless builds.
     }
     render() {
+        // Debug rendering is intentionally disabled in headless builds.
     }
 }
 //# sourceMappingURL=physics-2d-debugger-headless.js.map

package/lib/physics-2d-debugger.js

@@ -16,16 +16,6 @@ class Physics2DDebugRenderer extends Renderer {
         this._material = material;
         this._loadMaterial();
     }
-    onEnable() {
-        if (this._renderRecord) {
-            this._renderRecord.model.enabled = true;
-        }
-    }
-    onDisable() {
-        if (this._renderRecord) {
-            this._renderRecord.model.enabled = false;
-        }
-    }
     render(world) {
         const { vertices, colors } = world.debugRender();
         const vertexCount = vertices.length / 2;
@@ -42,6 +32,16 @@ class Physics2DDebugRenderer extends Renderer {
             renderRecord.colorVertexBuffer.update(colors, colors.byteLength);
         }
     }
+    onEnable() {
+        if (this._renderRecord) {
+            this._renderRecord.model.enabled = true;
+        }
+    }
+    onDisable() {
+        if (this._renderRecord) {
+            this._renderRecord.model.enabled = false;
+        }
+    }
     _material;
     _materialLoaded = false;
     _renderRecord;

package/lib/physics-2d-settings.d.ts

@@ -2,12 +2,13 @@ import { Asset } from 'cc';
 import { CollisionMatrix } from './collision-matrix.js';
 export declare class Physics2DSettings extends Asset {
     fps: number;
+    maxSubsteps: number;
     get tags(): Record<string, number>;
-    private get tags_editor();
-    private set tags_editor(value);
     get collisionMatrix(): CollisionMatrix;
     findTagIndex(tag: string): number;
     private _tags;
     private _collisionMatrix;
+    private get tags_editor();
+    private set tags_editor(value);
 }
 //# sourceMappingURL=physics-2d-settings.d.ts.map

package/lib/physics-2d-settings.js

@@ -4,22 +4,17 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { Asset } from 'cc';
-import { editable, serializable } from '@cyclonium/core/legacy-decorator';
+import { Asset, CCInteger } from 'cc';
+import { editable, stored } from '@cyclonium/core/legacy-decorator';
 import { cycloBuiltinClass } from '@cyclonium/core/internal';
 import { CollisionMatrix } from './collision-matrix.js';
 import { dumpRaw } from '@cyclonium/core/utils';
 let Physics2DSettings = class Physics2DSettings extends Asset {
     fps = 60;
+    maxSubsteps = 4;
     get tags() {
         return this._tags;
     }
-    get tags_editor() {
-        return this._tags;
-    }
-    set tags_editor(value) {
-        this._tags = { ...value };
-    }
     get collisionMatrix() {
         return this._collisionMatrix;
     }
@@ -28,24 +23,36 @@ let Physics2DSettings = class Physics2DSettings extends Asset {
     }
     _tags = {};
     _collisionMatrix = new CollisionMatrix();
+    get tags_editor() {
+        return this._tags;
+    }
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- Cocos editor inspectors consume this serialized compatibility property by name.
+    set tags_editor(value) {
+        this._tags = { ...value };
+    }
 };
 __decorate([
-    serializable,
-    editable
+    stored,
+    editable({ min: 1 })
 ], Physics2DSettings.prototype, "fps", void 0);
 __decorate([
-    editable,
-    dumpRaw
-], Physics2DSettings.prototype, "tags_editor", null);
+    stored,
+    editable({ type: CCInteger, min: 1, step: 1 })
+], Physics2DSettings.prototype, "maxSubsteps", void 0);
 __decorate([
     editable
 ], Physics2DSettings.prototype, "collisionMatrix", null);
 __decorate([
-    serializable
+    stored
 ], Physics2DSettings.prototype, "_tags", void 0);
 __decorate([
-    serializable
+    stored
 ], Physics2DSettings.prototype, "_collisionMatrix", void 0);
+__decorate([
+    editable,
+    dumpRaw
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- Cocos editor inspectors consume this serialized compatibility property by name.
+], Physics2DSettings.prototype, "tags_editor", null);
 Physics2DSettings = __decorate([
     cycloBuiltinClass('Physics2DSettings')
 ], Physics2DSettings);

package/lib/physics-component-2d-base.js

@@ -20,8 +20,12 @@ let PhysicsComponent2DBase = class PhysicsComponent2DBase extends CycloComponent
     get world() {
         return this._physicsWorld;
     }
-    onSyncTransforms(_forceTransform, _forceScale) { }
-    onAfterPhysicsStep() { }
+    onSyncTransforms(_forceTransform, _forceScale) {
+        // Optional synchronization hook for physics components.
+    }
+    onAfterPhysicsStep() {
+        // Optional post-step hook for physics components.
+    }
     onAwake() {
         if (!this._attached) {
             this._tryAttach();
@@ -47,14 +51,14 @@ let PhysicsComponent2DBase = class PhysicsComponent2DBase extends CycloComponent
     _physicsWorld = null;
     _firstEnabled = true;
     _attached = false;
-    _handleAncestorChange() {
+    _handleAncestorChange = () => {
         if (this.node) {
             this._tryAttach();
         }
         else {
             this._tryDetach();
         }
-    }
+    };
     _tryAttach() {
         const node = this.node;
         const physicsWorld = getPhysicsWorld(node.scene);

package/lib/physics-world-2d-scene-component.d.ts

@@ -1,18 +1,21 @@
 import { CycloComponent } from '@cyclonium/core/framework';
-import { PhysicsWorld2D } from './physics-world-2d.js';
 import { Physics2DSettings } from './physics-2d-settings.js';
+import { PhysicsWorld2D } from './physics-world-2d.js';
 export declare class PhysicsWorld2DSceneComponent extends CycloComponent {
     get debug(): boolean;
     set debug(v: boolean);
     get settings(): Physics2DSettings | null;
     set settings(value: Physics2DSettings | null);
+    get physicsWorld(): PhysicsWorld2D | null;
     protected onAwake(): void;
     protected onDestroy(): void;
     protected onUpdate(deltaTime: number): void;
-    get physicsWorld(): PhysicsWorld2D | null;
     private _physicsWorld;
     private _physicsDebugger;
     private _lastUpdateFrame;
+    private _maxSubsteps;
+    private _timeAccumulator;
+    private _overloading;
     private _debug;
     private _settings;
     private _updateFrame;