toaimin-indie-engine 1.0.0

package/dist/physics/Narrowphase.d.ts

@@ -0,0 +1,25 @@
+import { Collider2D } from './Collider2D';
+import { CircleCollider2D } from './CircleCollider2D';
+import { BoxCollider2D } from './BoxCollider2D';
+import { ContactManifold } from './ContactSolver';
+import { Ray2D, RaycastHit2D } from './Raycast';
+export declare class Narrowphase {
+    private static readonly _vertsA;
+    private static readonly _vertsB;
+    private static readonly _axesA;
+    private static readonly _axesB;
+    static test(colliderA: Collider2D, colliderB: Collider2D): ContactManifold | null;
+    static collide(colliderA: Collider2D, colliderB: Collider2D): ContactManifold | null;
+    static testCircleCircle(circleA: CircleCollider2D, circleB: CircleCollider2D): ContactManifold | null;
+    static collideCircleVsCircle(circleA: CircleCollider2D, circleB: CircleCollider2D): ContactManifold | null;
+    static testCircleBox(circle: CircleCollider2D, box: BoxCollider2D): ContactManifold | null;
+    static collideCircleVsBox(circle: CircleCollider2D, box: BoxCollider2D): ContactManifold | null;
+    static testBoxBox(boxA: BoxCollider2D, boxB: BoxCollider2D): ContactManifold | null;
+    static collideBoxVsBox(boxA: BoxCollider2D, boxB: BoxCollider2D): ContactManifold | null;
+    private static projectBox;
+    private static clipSegment;
+    static raycast(ray: Ray2D, collider: Collider2D): RaycastHit2D | null;
+    static raycastCircle(ray: Ray2D, circle: CircleCollider2D): RaycastHit2D | null;
+    static raycastBox(ray: Ray2D, box: BoxCollider2D): RaycastHit2D | null;
+}
+//# sourceMappingURL=Narrowphase.d.ts.map

package/dist/physics/Narrowphase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Narrowphase.d.ts","sourceRoot":"","sources":["../../src/physics/Narrowphase.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,YAAY,EAAW,MAAM,WAAW,CAAC;AAEzD,qBAAa,WAAW;IAEtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAA2E;IAC1G,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAA2E;IAC1G,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAA6C;IAC3E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAA6C;WAE7D,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI;WAI1E,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI;WA2B7E,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,GAAG,eAAe,GAAG,IAAI;WAI9F,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,GAAG,eAAe,GAAG,IAAI;WAkDnG,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,aAAa,GAAG,eAAe,GAAG,IAAI;WAInF,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,aAAa,GAAG,eAAe,GAAG,IAAI;WAmGxF,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,eAAe,GAAG,IAAI;WAI5E,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,eAAe,GAAG,IAAI;IAqJ/F,OAAO,CAAC,MAAM,CAAC,UAAU;IAWzB,OAAO,CAAC,MAAM,CAAC,WAAW;WA2BZ,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI;WAI9D,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,GAAG,YAAY,GAAG,IAAI;WAIxE,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI;CAG9E"}

package/dist/physics/PhysicsWorld2D.d.ts

@@ -0,0 +1,75 @@
+import { Vector2 } from '../math/Vector2';
+import { EventEmitter } from '../core/EventEmitter';
+import { RigidBody2D } from './RigidBody2D';
+import { Collider2D } from './Collider2D';
+import { CollisionFSMEvents } from './CollisionFSM';
+import { Ray2D, RaycastHit2D } from './Raycast';
+export interface PhysicsWorldConfig {
+    gravity?: Vector2;
+    velocityIterations?: number;
+    positionIterations?: number;
+    subSteps?: number;
+    fixedDeltaTime?: number;
+    allowSleep?: boolean;
+    baumgarte?: number;
+    penetrationSlop?: number;
+    restitutionVelocityThreshold?: number;
+    spatialCellSize?: number;
+    enableWarmStarting?: boolean;
+}
+export interface PhysicsWorldEvents extends CollisionFSMEvents {
+    'step:pre': {
+        dt: number;
+        subStep: number;
+    };
+    'step:post': {
+        dt: number;
+        subStep: number;
+    };
+    'body:add': {
+        body: RigidBody2D;
+    };
+    'body:remove': {
+        body: RigidBody2D;
+    };
+    'collider:add': {
+        collider: Collider2D;
+    };
+    'collider:remove': {
+        collider: Collider2D;
+    };
+}
+/**
+ * Master 2D Physics World orchestrator managing the 11-step simulation pipeline,
+ * sub-stepping, spatial indexing, collision lifecycle, and spatial queries.
+ */
+export declare class PhysicsWorld2D extends EventEmitter<PhysicsWorldEvents> {
+    gravity: Vector2;
+    velocityIterations: number;
+    positionIterations: number;
+    subSteps: number;
+    fixedDeltaTime: number;
+    allowSleep: boolean;
+    private _bodies;
+    private _colliders;
+    private _spatialGrid;
+    private _contactSolver;
+    private _collisionFSM;
+    constructor(config?: PhysicsWorldConfig);
+    addBody(body: RigidBody2D): this;
+    removeBody(body: RigidBody2D): this;
+    addCollider(collider: Collider2D): this;
+    removeCollider(collider: Collider2D): this;
+    getBodies(): readonly RigidBody2D[];
+    getColliders(): readonly Collider2D[];
+    getBodyById(id: number): RigidBody2D | undefined;
+    clear<K extends keyof PhysicsWorldEvents>(event?: K): this;
+    step(dt?: number): void;
+    private _internalSubStep;
+    raycast(ray: Ray2D, mask?: number): RaycastHit2D | null;
+    raycastAll(ray: Ray2D, mask?: number): RaycastHit2D[];
+    overlapCircle(center: Vector2, radius: number, mask?: number): Collider2D[];
+    overlapBox(center: Vector2, width: number, height: number, rotation?: number, mask?: number): Collider2D[];
+    overlapPoint(point: Vector2, mask?: number): Collider2D[];
+}
+//# sourceMappingURL=PhysicsWorld2D.d.ts.map

package/dist/physics/PhysicsWorld2D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhysicsWorld2D.d.ts","sourceRoot":"","sources":["../../src/physics/PhysicsWorld2D.ts"],"names":[],"mappings":"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"}

package/dist/physics/Raycast.d.ts

@@ -0,0 +1,38 @@
+import { Vector2 } from '../math/Vector2';
+import type { Collider2D } from './Collider2D';
+import type { RigidBody2D } from './RigidBody2D';
+export declare class Ray2D {
+    origin: Vector2;
+    direction: Vector2;
+    maxDistance: number;
+    constructor(origin?: Vector2, direction?: Vector2, maxDistance?: number);
+    set(origin: Vector2, direction: Vector2, maxDistance?: number): this;
+    getPoint(t: number, out?: Vector2): Vector2;
+}
+export interface RaycastHit2D {
+    collider: Collider2D;
+    body: RigidBody2D | null;
+    point: Vector2;
+    normal: Vector2;
+    fraction: number;
+    distance: number;
+}
+export declare class Raycast {
+    /**
+     * Evaluates ray intersection against a Circle.
+     */
+    static intersectCircle(ray: Ray2D, center: Vector2, radius: number): {
+        fraction: number;
+        point: Vector2;
+        normal: Vector2;
+    } | null;
+    /**
+     * Evaluates ray intersection against an Oriented Bounding Box (OBB).
+     */
+    static intersectBox(ray: Ray2D, center: Vector2, halfWidth: number, halfHeight: number, rotation?: number): {
+        fraction: number;
+        point: Vector2;
+        normal: Vector2;
+    } | null;
+}
+//# sourceMappingURL=Raycast.d.ts.map

package/dist/physics/Raycast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Raycast.d.ts","sourceRoot":"","sources":["../../src/physics/Raycast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,qBAAa,KAAK;IACT,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;gBAGzB,MAAM,GAAE,OAA2B,EACnC,SAAS,GAAE,OAA2B,EACtC,WAAW,GAAE,MAAiB;IAOzB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAE,MAAyB,GAAG,IAAI;IAOtF,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO;CAMnD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,OAAO;IAClB;;OAEG;WACW,eAAe,CAC3B,GAAG,EAAE,KAAK,EACV,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GACb;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IA8C/D;;OAEG;WACW,YAAY,CACxB,GAAG,EAAE,KAAK,EACV,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAU,GACnB;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;CAiGhE"}

package/dist/physics/RigidBody2D.d.ts

@@ -0,0 +1,118 @@
+import { Vector2 } from '../math/Vector2';
+import { Transform2D } from '../math/Transform2D';
+export declare enum BodyType {
+    Dynamic = "dynamic",
+    Static = "static",
+    Kinematic = "kinematic"
+}
+export interface RigidBodyConfig {
+    bodyType?: BodyType;
+    position?: Vector2;
+    velocity?: Vector2;
+    acceleration?: Vector2;
+    rotation?: number;
+    angularVelocity?: number;
+    mass?: number;
+    inertia?: number;
+    fixedRotation?: boolean;
+    linearDamping?: number;
+    angularDamping?: number;
+    gravityScale?: number;
+    restitution?: number;
+    friction?: number;
+    isBullet?: boolean;
+    canSleep?: boolean;
+}
+/**
+ * Production-grade 2D RigidBody implementing Symplectic Euler integration,
+ * accurate inertia tensor calculation, force/impulse APIs, and Transform2D sync.
+ */
+export declare class RigidBody2D {
+    private static _nextId;
+    readonly id: number;
+    bodyType: BodyType;
+    readonly position: Vector2;
+    readonly velocity: Vector2;
+    readonly acceleration: Vector2;
+    readonly force: Vector2;
+    rotation: number;
+    angularVelocity: number;
+    torque: number;
+    private _mass;
+    private _invMass;
+    private _inertia;
+    private _invInertia;
+    fixedRotation: boolean;
+    linearDamping: number;
+    angularDamping: number;
+    gravityScale: number;
+    restitution: number;
+    friction: number;
+    isBullet: boolean;
+    isSleeping: boolean;
+    canSleep: boolean;
+    sleepTimer: number;
+    static linearSleepTolerance: number;
+    static angularSleepTolerance: number;
+    static timeToSleep: number;
+    transform: Transform2D | null;
+    userData: any;
+    onCollisionEnter?: (other: RigidBody2D | null, myCollider: any, otherCollider: any, manifold: any) => void;
+    onCollisionStay?: (other: RigidBody2D | null, myCollider: any, otherCollider: any, manifold: any) => void;
+    onCollisionExit?: (other: RigidBody2D | null, myCollider: any, otherCollider: any) => void;
+    onTriggerEnter?: (other: RigidBody2D | null, myCollider: any, otherCollider: any) => void;
+    onTriggerStay?: (other: RigidBody2D | null, myCollider: any, otherCollider: any) => void;
+    onTriggerExit?: (other: RigidBody2D | null, myCollider: any, otherCollider: any) => void;
+    hasCustomInertia: boolean;
+    constructor(config?: RigidBodyConfig);
+    get mass(): number;
+    get invMass(): number;
+    get inertia(): number;
+    get invInertia(): number;
+    setMass(mass: number): this;
+    setInertia(inertia: number): this;
+    setMassAndInertia(mass: number, inertia: number): this;
+    /**
+     * Helper to configure moment of inertia for uniform circular disk:
+     * I = 0.5 * M * R^2 + M * d^2 (Parallel Axis Theorem)
+     */
+    setCircleMass(mass: number, radius: number, offset?: Vector2): this;
+    /**
+     * Helper to configure moment of inertia for uniform box:
+     * I = (1/12) * M * (W^2 + H^2) + M * d^2 (Parallel Axis Theorem)
+     */
+    setBoxMass(mass: number, width: number, height: number, offset?: Vector2): this;
+    /**
+     * Applies continuous linear force (e.g. thruster, wind, attraction).
+     * If point is specified (in world space), generates rotational torque via r x F.
+     */
+    applyForce(force: Vector2, point?: Vector2): void;
+    /**
+     * Applies instantaneous linear impulse (e.g. jump, explosion, projectile impact).
+     * Modifies velocity immediately.
+     */
+    applyImpulse(impulse: Vector2, point?: Vector2): void;
+    applyTorque(torque: number): void;
+    applyAngularImpulse(impulse: number): void;
+    clearForces(): void;
+    /**
+     * Phase 1 of Symplectic Euler: Integrate velocities from forces, gravity, and damping.
+     * Run BEFORE ContactSolver.
+     */
+    integrateVelocities(dt: number, worldGravity: Vector2): void;
+    /**
+     * Phase 2 of Symplectic Euler: Provisional position integration from integrated velocities.
+     * Run prior to narrowphase collision detection and ContactSolver resolution.
+     */
+    integratePositions(dt: number): void;
+    /**
+     * Evaluates sleep state machine against post-solver settled velocities.
+     * Called at Phase 9 of PhysicsWorld2D._internalSubStep after contact resolution.
+     */
+    updateSleep(dt: number): void;
+    sleep(): void;
+    wakeUp(): void;
+    syncFromTransform(): void;
+    syncToTransform(): void;
+}
+//# sourceMappingURL=RigidBody2D.d.ts.map

package/dist/physics/RigidBody2D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RigidBody2D.d.ts","sourceRoot":"","sources":["../../src/physics/RigidBody2D.ts"],"names":[],"mappings":"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"}

package/dist/physics/SpatialGrid.d.ts

@@ -0,0 +1,78 @@
+import { Vector2 } from '../math/Vector2';
+import { Rect } from '../math/Rect';
+import { Collider2D } from './Collider2D';
+import { Ray2D } from './Raycast';
+export declare class ColliderPair {
+    colliderA: Collider2D;
+    colliderB: Collider2D;
+    get 0(): Collider2D;
+    get 1(): Collider2D;
+    [Symbol.iterator](): Generator<Collider2D>;
+}
+export declare class GridCell {
+    key: number;
+    cx: number;
+    cy: number;
+    readonly colliders: Collider2D[];
+    clear(): void;
+}
+export interface SpatialGridConfig {
+    cellSize?: number;
+    initialCapacity?: number;
+}
+/**
+ * Production-grade, zero-allocation Broadphase Spatial Hash Grid.
+ * Employs 32-bit packed SMI keys, Minimum Shared Cell deduplication,
+ * and Amanatides-Woo Fast Voxel Traversal for raycasting.
+ */
+export declare class SpatialGrid {
+    readonly cellSize: number;
+    readonly invCellSize: number;
+    private readonly _cells;
+    private readonly _activeCells;
+    private readonly _cellPool;
+    private readonly _pairs;
+    private _pairCount;
+    private _queryStamp;
+    constructor(config?: SpatialGridConfig);
+    /**
+     * Encodes 2D cell coordinates (cx, cy) into a single 32-bit signed integer.
+     * Coordinates in [-32768, 32767] produce Small Integers (SMIs) in V8.
+     */
+    getCellKey(cx: number, cy: number): number;
+    /**
+     * Registers a collider across all grid cells overlapping its AABB bounds.
+     */
+    insert(collider: Collider2D): void;
+    /**
+     * Removes a collider from all currently occupied cells via fast swap-and-pop.
+     */
+    remove(collider: Collider2D): void;
+    /**
+     * Updates collider cell occupancy. Exits in O(1) if cell boundaries were not crossed.
+     */
+    update(collider: Collider2D): void;
+    /**
+     * Clears all cells and recycles them to pool.
+     */
+    clear(): void;
+    /**
+     * Generates candidate pairs for narrowphase collision detection.
+     * Employs Minimum Shared Cell deduplication and full bitfield/sleeping pruning.
+     */
+    generateCandidatePairs(): readonly ColliderPair[];
+    private addPair;
+    queryAABB(aabb: Rect, out?: Collider2D[]): Collider2D[];
+    queryPoint(point: Vector2, out?: Collider2D[]): Collider2D[];
+    /**
+     * Raycast query using Amanatides & Woo Fast Voxel Traversal (DDA).
+     * Traverses intersected cells in strict front-to-back ray order.
+     * Hardened against Infinity, NaN, non-positive distances, and infinite loops.
+     */
+    queryRay(ray: Ray2D, maxDistance?: number, out?: Collider2D[]): Collider2D[];
+    private acquireCell;
+    private releaseCell;
+    get activeCellCount(): number;
+    get pooledCellCount(): number;
+}
+//# sourceMappingURL=SpatialGrid.d.ts.map

package/dist/physics/SpatialGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpatialGrid.d.ts","sourceRoot":"","sources":["../../src/physics/SpatialGrid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGlC,qBAAa,YAAY;IAChB,SAAS,EAAG,UAAU,CAAC;IACvB,SAAS,EAAG,UAAU,CAAC;IAE9B,IAAW,CAAC,IAAI,UAAU,CAEzB;IAED,IAAW,CAAC,IAAI,UAAU,CAEzB;IAEO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC;CAInD;AAED,qBAAa,QAAQ;IACZ,GAAG,EAAE,MAAM,CAAK;IAChB,EAAE,EAAE,MAAM,CAAK;IACf,EAAE,EAAE,MAAM,CAAK;IACtB,SAAgB,SAAS,EAAE,UAAU,EAAE,CAAM;IAEtC,KAAK,IAAI,IAAI;CAGrB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,WAAW,EAAE,MAAM,CAAC;IAGpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAG/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,UAAU,CAAa;IAG/B,OAAO,CAAC,WAAW,CAAa;gBAEpB,MAAM,GAAE,iBAAsB;IAe1C;;;OAGG;IACI,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAQjD;;OAEG;IACI,MAAM,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;IA0BzC;;OAEG;IACI,MAAM,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;IAmCzC;;OAEG;IACI,MAAM,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;IAqBzC;;OAEG;IACI,KAAK,IAAI,IAAI;IAapB;;;OAGG;IACI,sBAAsB,IAAI,SAAS,YAAY,EAAE;IAuExD,OAAO,CAAC,OAAO;IAeR,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAE,UAAU,EAAO,GAAG,UAAU,EAAE;IA8B3D,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,UAAU,EAAO,GAAG,UAAU,EAAE;IAmBvE;;;;OAIG;IACI,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,GAAE,MAAa,EAAE,GAAG,GAAE,UAAU,EAAO,GAAG,UAAU,EAAE;IAgH7F,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,WAAW;IAKnB,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED,IAAW,eAAe,IAAI,MAAM,CAEnC;CACF"}

package/dist/physics/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 2D Physics Engine Subsystem
+ */
+export * from './RigidBody2D';
+export * from './Collider2D';
+export * from './CircleCollider2D';
+export * from './BoxCollider2D';
+export * from './Narrowphase';
+export * from './Raycast';
+export * from './SpatialGrid';
+export * from './ContactSolver';
+export * from './CollisionFSM';
+export * from './PhysicsWorld2D';
+//# sourceMappingURL=index.d.ts.map

package/dist/physics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/physics/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

package/dist/rendering/Animation.d.ts

@@ -0,0 +1,62 @@
+import { Rect } from '../math/Rect';
+import { Vector2 } from '../math/Vector2';
+import { Sprite } from './Sprite';
+export interface AnimationFrame {
+    /** Index in the clip */
+    index: number;
+    /** Sub-rectangle coordinates on texture atlas */
+    sourceRect: Rect;
+    /** Frame duration in seconds (default: 1 / clip.fps) */
+    duration: number;
+    /** Optional frame-specific anchor override */
+    anchor?: Vector2;
+}
+export type PlaybackMode = 'loop' | 'once' | 'ping-pong' | 'reverse';
+export interface AnimationClipConfig {
+    name: string;
+    frames: AnimationFrame[];
+    fps?: number;
+    wrapMode?: PlaybackMode;
+}
+export declare class AnimationClip {
+    readonly name: string;
+    readonly frames: AnimationFrame[];
+    readonly fps: number;
+    readonly wrapMode: PlaybackMode;
+    readonly totalDuration: number;
+    constructor(config: AnimationClipConfig);
+}
+/**
+ * Animation controller for driving sprite animation playback.
+ */
+export declare class Animation {
+    private _clips;
+    currentClip: AnimationClip | null;
+    currentFrameIndex: number;
+    currentTime: number;
+    playbackSpeed: number;
+    isPlaying: boolean;
+    isPaused: boolean;
+    isFinished: boolean;
+    private _direction;
+    targetSprite: Sprite | null;
+    onFrame?: (frameIndex: number, frame: AnimationFrame) => void;
+    onComplete?: () => void;
+    onLoop?: () => void;
+    constructor(targetSprite?: Sprite);
+    addClip(clip: AnimationClip): this;
+    getClip(name: string): AnimationClip | undefined;
+    hasClip(name: string): boolean;
+    play(clipName: string, restart?: boolean): this;
+    pause(): this;
+    resume(): this;
+    stop(): this;
+    gotoAndStop(frameIndex: number): this;
+    gotoAndPlay(frameIndex: number): this;
+    /**
+     * Advances the animation timeline. Zero per-frame memory allocation.
+     */
+    update(dt?: number): void;
+    private _applyFrame;
+}
+//# sourceMappingURL=Animation.d.ts.map

package/dist/rendering/Animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Animation.d.ts","sourceRoot":"","sources":["../../src/rendering/Animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,UAAU,EAAE,IAAI,CAAC;IACjB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,qBAAa,aAAa;IACxB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzC,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,QAAQ,EAAE,YAAY,CAAC;IACvC,SAAgB,aAAa,EAAE,MAAM,CAAC;gBAE1B,MAAM,EAAE,mBAAmB;CAYxC;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAyC;IAChD,WAAW,EAAE,aAAa,GAAG,IAAI,CAAQ;IACzC,iBAAiB,EAAE,MAAM,CAAK;IAC9B,WAAW,EAAE,MAAM,CAAK;IACxB,aAAa,EAAE,MAAM,CAAO;IAC5B,SAAS,EAAE,OAAO,CAAS;IAC3B,QAAQ,EAAE,OAAO,CAAS;IAC1B,UAAU,EAAE,OAAO,CAAS;IAEnC,OAAO,CAAC,UAAU,CAAa;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGnC,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9D,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;gBAEf,YAAY,CAAC,EAAE,MAAM;IAM1B,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAKlC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIhD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe,GAAG,IAAI;IA2BtD,KAAK,IAAI,IAAI;IAKb,MAAM,IAAI,IAAI;IAQd,IAAI,IAAI,IAAI;IAQZ,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAQrC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAM5C;;OAEG;IACI,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IA0EhC,OAAO,CAAC,WAAW;CAWpB"}

package/dist/rendering/AssetLoader.d.ts

@@ -0,0 +1,35 @@
+import { Color } from '../math/Color';
+export declare class AssetLoader {
+    private _textures;
+    private _inFlight;
+    loadedCount: number;
+    totalCount: number;
+    get isLoading(): boolean;
+    get progress(): number;
+    /**
+     * Loads an image asynchronously with zero crash risk.
+     * If the file is missing or network fails, logs a warning and returns a procedural fallback.
+     */
+    loadTexture(key: string, url: string): Promise<CanvasImageSource>;
+    /**
+     * Batch loads multiple textures with optional progress callback.
+     */
+    loadTextures(manifest: Record<string, string>, onProgress?: (progress: number) => void): Promise<Map<string, CanvasImageSource>>;
+    getTexture(key: string): CanvasImageSource | undefined;
+    hasTexture(key: string): boolean;
+    registerTexture(key: string, texture: CanvasImageSource): void;
+    /**
+     * Generates a high-contrast magenta/black checkerboard fallback texture.
+     */
+    createCheckerboardTexture(width?: number, height?: number, color1?: Color | string, color2?: Color | string, tileSize?: number): CanvasImageSource;
+    /**
+     * Generates a solid 1x1 or custom size color texture.
+     */
+    createSolidTexture(width?: number, height?: number, color?: Color | string): CanvasImageSource;
+    /**
+     * Generates a smooth circular gradient texture (ideal for particle systems).
+     */
+    createCircleTexture(radius?: number, color?: Color | string): CanvasImageSource;
+    clear(): void;
+}
+//# sourceMappingURL=AssetLoader.d.ts.map

package/dist/rendering/AssetLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetLoader.d.ts","sourceRoot":"","sources":["../../src/rendering/AssetLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,SAAS,CAAsD;IAEhE,WAAW,EAAE,MAAM,CAAK;IACxB,UAAU,EAAE,MAAM,CAAK;IAE9B,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED;;;OAGG;IACI,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiDxE;;OAEG;IACU,YAAY,CACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAcnC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAItD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIrE;;OAEG;IACI,yBAAyB,CAC9B,KAAK,GAAE,MAAW,EAClB,MAAM,GAAE,MAAW,EACnB,MAAM,GAAE,KAAK,GAAG,MAAkB,EAClC,MAAM,GAAE,KAAK,GAAG,MAAkB,EAClC,QAAQ,GAAE,MAAU,GACnB,iBAAiB;IAqCpB;;OAEG;IACI,kBAAkB,CACvB,KAAK,GAAE,MAAU,EACjB,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,KAAK,GAAG,MAAoB,GAClC,iBAAiB;IAsBpB;;OAEG;IACI,mBAAmB,CACxB,MAAM,GAAE,MAAW,EACnB,KAAK,GAAE,KAAK,GAAG,MAAoB,GAClC,iBAAiB;IA+Bb,KAAK,IAAI,IAAI;CAMrB"}

package/dist/rendering/Camera2D.d.ts

@@ -0,0 +1,109 @@
+import { Vector2 } from '../math/Vector2';
+import { Matrix2D } from '../math/Matrix2D';
+import { Rect } from '../math/Rect';
+import { CanvasContext } from './CanvasContext';
+import { ICanvasRenderingContext2D } from './CanvasMock';
+export interface CameraFollowTarget {
+    position: Vector2;
+}
+export interface Camera2DConfig {
+    viewportWidth: number;
+    viewportHeight: number;
+    x?: number;
+    y?: number;
+    zoom?: number;
+    rotation?: number;
+    originX?: number;
+    originY?: number;
+    bounds?: Rect;
+}
+/**
+ * 2D Camera subsystem handling viewport transformation, smooth target follow with deadzone,
+ * screen-to-world unprojection, trauma screen shake, and frustum culling queries.
+ */
+export declare class Camera2D {
+    readonly position: Vector2;
+    readonly origin: Vector2;
+    readonly offset: Vector2;
+    viewportWidth: number;
+    viewportHeight: number;
+    private _zoom;
+    private _rotation;
+    target: Vector2 | CameraFollowTarget | null;
+    followLerp: number;
+    deadzone: Rect | null;
+    bounds: Rect | null;
+    trauma: number;
+    traumaDecay: number;
+    maxShakeOffset: number;
+    maxShakeAngle: number;
+    private readonly _viewMatrix;
+    private readonly _invViewMatrix;
+    private readonly _visibleBounds;
+    private _isDirty;
+    private _boundsDirty;
+    private static readonly _scratchScreenTL;
+    private static readonly _scratchScreenTR;
+    private static readonly _scratchScreenBR;
+    private static readonly _scratchScreenBL;
+    private static readonly _scratchWorldTL;
+    private static readonly _scratchWorldTR;
+    private static readonly _scratchWorldBR;
+    private static readonly _scratchWorldBL;
+    private _lastPosX;
+    private _lastPosY;
+    private _lastOriginX;
+    private _lastOriginY;
+    private _lastOffsetX;
+    private _lastOffsetY;
+    private _lastViewportW;
+    private _lastViewportH;
+    private _shakeOffsetX;
+    private _shakeOffsetY;
+    private _shakeAngle;
+    constructor(config: Camera2DConfig);
+    get zoom(): number;
+    set zoom(value: number);
+    get rotation(): number;
+    set rotation(radians: number);
+    setPosition(x: number, y: number): this;
+    setViewportSize(width: number, height: number): this;
+    markDirty(): this;
+    follow(target: Vector2 | CameraFollowTarget | null, lerp?: number, deadzone?: Rect): this;
+    update(dt: number): void;
+    addTrauma(amount: number): this;
+    clampToBounds(): void;
+    /**
+     * Updates cached view matrix and inverse matrix.
+     */
+    updateMatrix(): void;
+    getViewMatrix(): Matrix2D;
+    getInverseViewMatrix(): Matrix2D;
+    /**
+     * Transforms world coordinates into screen coordinates.
+     */
+    worldToScreen(worldPos: Vector2, out?: Vector2): Vector2;
+    /**
+     * Transforms screen / viewport coordinates into world coordinates.
+     */
+    screenToWorld(screenPos: Vector2, out?: Vector2): Vector2;
+    /**
+     * Applies camera transformation matrix to CanvasContext or raw context.
+     */
+    applyToContext(ctx: CanvasContext | ICanvasRenderingContext2D | any): void;
+    /**
+     * Recomputes cached visible bounds using pre-allocated scratch vectors.
+     * Zero heap allocations.
+     */
+    private _recomputeVisibleBounds;
+    /**
+     * Returns Axis-Aligned Bounding Box (AABB) in world space of the visible camera area.
+     * Cached to eliminate recalculation and object allocation during frustum culling.
+     */
+    getVisibleBounds(out?: Rect): Rect;
+    /**
+     * Checks whether a bounding box in world space intersects the camera's visible frustum.
+     */
+    isVisible(bounds: Rect): boolean;
+}
+//# sourceMappingURL=Camera2D.d.ts.map

package/dist/rendering/Camera2D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Camera2D.d.ts","sourceRoot":"","sources":["../../src/rendering/Camera2D.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,QAAQ;IACnB,SAAgB,QAAQ,EAAE,OAAO,CAAqB;IACtD,SAAgB,MAAM,EAAE,OAAO,CAAyB;IACxD,SAAgB,MAAM,EAAE,OAAO,CAAqB;IAE7C,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IAE9B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,SAAS,CAAa;IAGvB,MAAM,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAAQ;IACnD,UAAU,EAAE,MAAM,CAAO;IACzB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAQ;IAC7B,MAAM,EAAE,IAAI,GAAG,IAAI,CAAQ;IAG3B,MAAM,EAAE,MAAM,CAAK;IACnB,WAAW,EAAE,MAAM,CAAO;IAC1B,cAAc,EAAE,MAAM,CAAM;IAC5B,aAAa,EAAE,MAAM,CAAQ;IAGpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,YAAY,CAAiB;IAGrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAElE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAA0B;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAA0B;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAA0B;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAA0B;IAEjE,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,cAAc,CAAe;IACrC,OAAO,CAAC,cAAc,CAAe;IAGrC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,WAAW,CAAa;gBAEpB,MAAM,EAAE,cAAc;IAyBlC,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,EAO5B;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,QAAQ,CAAC,OAAO,EAAE,MAAM,EAMlC;IAEM,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IASvC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAUpD,SAAS,IAAI,IAAI;IAUjB,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,EAAE,IAAI,GAAE,MAAY,EAAE,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI;IAO9F,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAsDxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,aAAa,IAAI,IAAI;IAsC5B;;OAEG;IACI,YAAY,IAAI,IAAI;IA6DpB,aAAa,IAAI,QAAQ;IAKzB,oBAAoB,IAAI,QAAQ;IAKvC;;OAEG;IACI,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO;IAK/D;;OAEG;IACI,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO;IAKhE;;OAEG;IACI,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,yBAAyB,GAAG,GAAG,GAAG,IAAI;IAajF;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAmC/B;;;OAGG;IACI,gBAAgB,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI;IAazC;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO;CAGxC"}