@phalanx-engine/ecs 0.1.0

package/dist/debug/types.d.ts

@@ -0,0 +1,47 @@
+import type { PoolStats } from '../pool/types';
+import type { SoAFieldType } from '../SoASchema';
+export interface DebugComponentSnapshot {
+    typeName: string;
+    typeSymbol: symbol;
+    data: Record<string, unknown>;
+}
+export interface DebugEntitySnapshot {
+    id: number;
+    destroyed: boolean;
+    components: DebugComponentSnapshot[];
+}
+export interface DebugSoAStoreSnapshot {
+    name: string;
+    fieldNames: string[];
+    fieldTypes: Record<string, SoAFieldType>;
+    count: number;
+    capacity: number;
+    bytesPerEntity: number;
+    entities: {
+        entityId: number;
+        fields: Record<string, number | bigint>;
+    }[];
+}
+export interface DebugPoolSnapshot {
+    typeKey: string;
+    stats: PoolStats;
+}
+export interface DebugSnapshot {
+    timestamp: number;
+    world: {
+        entityCount: number;
+        soaStoreCount: number;
+        paused: boolean;
+    };
+    entities: DebugEntitySnapshot[];
+    soaStores: DebugSoAStoreSnapshot[];
+    pools: DebugPoolSnapshot[];
+}
+export interface DebugDataProviderConfig {
+    updateInterval?: number;
+}
+export interface DebugPanelConfig {
+    toggleKey?: string;
+    startCollapsed?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/debug/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/debug/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAKjD,MAAM,WAAW,sBAAsB;IAErC,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;IAEnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAKD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAKD,MAAM,WAAW,qBAAqB;IAEpC,IAAI,EAAE,MAAM,CAAC;IAEb,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAEzC,KAAK,EAAE,MAAM,CAAC;IAEd,QAAQ,EAAE,MAAM,CAAC;IAEjB,cAAc,EAAE,MAAM,CAAC;IAEvB,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;KACzC,EAAE,CAAC;CACL;AAKD,MAAM,WAAW,iBAAiB;IAEhC,OAAO,EAAE,MAAM,CAAC;IAEhB,KAAK,EAAE,SAAS,CAAC;CAClB;AASD,MAAM,WAAW,aAAa;IAE5B,SAAS,EAAE,MAAM,CAAC;IAGlB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IAGF,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAGhC,SAAS,EAAE,qBAAqB,EAAE,CAAC;IAGnC,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAKD,MAAM,WAAW,uBAAuB;IAMtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAKD,MAAM,WAAW,gBAAgB;IAE/B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/debug/types.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export { EntityManager } from './EntityManager';
+export { EventBus, globalEventBus } from './EventBus';
+export { SystemRegistry } from './SystemRegistry';
+export { SystemContext } from './SystemContext';
+export { GameSystem } from './GameSystem';
+export { GameWorld, GameWorldEvents } from './GameWorld';
+export type { GameWorldConfig, GameWorldHooks } from './GameWorld';
+export { Entity, resetEntityIdCounter, nextEntityId } from './Entity';
+export { IComponent, createComponentTypeRegistry } from './Component';
+export type { IComponent as Component } from './Component';
+export { ObjectPool, EntityPool, PoolManager, isPoolableComponent, } from './pool';
+export type { IPoolable, IPoolableEntity, SpawnArgsOf, IPoolableComponent, PoolConfig, PoolStats, EntityTypeConfig, PoolingConfig, } from './pool';
+export { SoAComponentStore } from './SoAComponentStore';
+export type { SoAComponentStoreOptions } from './SoAComponentStore';
+export { SoAComponent } from './SoAComponent';
+export { defineSoASchema, calculateSchemaByteSize, TYPED_ARRAY_CONSTRUCTORS, FIELD_BYTE_SIZES, } from './SoASchema';
+export type { SoASchema, SoASchemaDefinition, SoAFieldType, SoAFieldsOf, SoAArraysOf, SoAValueType, SoAArrayType, TypedArrayLike, } from './SoASchema';
+export { DebugDataProvider, DebugPanel } from './debug';
+export type { DebugSnapshot, DebugEntitySnapshot, DebugComponentSnapshot, DebugSoAStoreSnapshot, DebugPoolSnapshot, DebugDataProviderConfig, DebugPanelConfig, } from './debug';
+export type { IBeforeTick, IAfterTick, IBeforeFrame, IAfterFrame } from './ISystemLifecycleHooks';
+export { isBeforeTick, isAfterTick, isBeforeFrame, isAfterFrame } from './ISystemLifecycleHooks';
+export type { IAbilitySystem } from './IAbilitySystem';
+export type { IPhysicsWorld, InterpolatedTransformSample } from './IPhysicsWorld';
+export { TickFrameManager } from './TickFrameManager';
+export type { TickFrameManagerConfig } from './TickFrameManager';
+export type { ITickFrameProvider, TickHandler, FrameHandler, Unsubscribe, CommandsBatch, PlayerCommand, PauseHandler, } from './ITickFrameProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGnE,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EAAE,UAAU,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EACL,UAAU,EACV,UAAU,EACV,WAAW,EACX,mBAAmB,GACpB,MAAM,QAAQ,CAAC;AAChB,YAAY,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,GACd,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACxD,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGjG,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,YAAY,EAAE,aAAa,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAGlF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export { EntityManager } from './EntityManager';
+export { EventBus, globalEventBus } from './EventBus';
+export { SystemRegistry } from './SystemRegistry';
+export { SystemContext } from './SystemContext';
+export { GameSystem } from './GameSystem';
+export { GameWorld, GameWorldEvents } from './GameWorld';
+export { Entity, resetEntityIdCounter, nextEntityId } from './Entity';
+export { createComponentTypeRegistry } from './Component';
+export { ObjectPool, EntityPool, PoolManager, isPoolableComponent, } from './pool';
+export { SoAComponentStore } from './SoAComponentStore';
+export { SoAComponent } from './SoAComponent';
+export { defineSoASchema, calculateSchemaByteSize, TYPED_ARRAY_CONSTRUCTORS, FIELD_BYTE_SIZES, } from './SoASchema';
+export { DebugDataProvider, DebugPanel } from './debug';
+export { isBeforeTick, isAfterTick, isBeforeFrame, isAfterFrame } from './ISystemLifecycleHooks';
+export { TickFrameManager } from './TickFrameManager';

package/dist/pool/EntityPool.d.ts

@@ -0,0 +1,21 @@
+import type { Entity } from '../Entity';
+import type { PoolConfig, PoolStats } from './types';
+export declare class EntityPool<T extends Entity = Entity> {
+    private readonly available;
+    private readonly entityFactory;
+    private readonly config;
+    private _totalCreated;
+    private _acquireCount;
+    private _releaseCount;
+    private _missCount;
+    constructor(entityFactory: () => T, config?: PoolConfig);
+    acquire(): T;
+    release(entity: T): void;
+    prewarm(count: number): void;
+    drain(): void;
+    get availableCount(): number;
+    get stats(): PoolStats;
+    private createEntity;
+    private growBatch;
+}
+//# sourceMappingURL=EntityPool.d.ts.map

package/dist/pool/EntityPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityPool.d.ts","sourceRoot":"","sources":["../../src/pool/EntityPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAsB,MAAM,SAAS,CAAC;AAWzE,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,UAAU,CAAa;gBAEnB,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,UAAU;IASvD,OAAO,IAAI,CAAC;IAgCZ,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI;IAYxB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAW5B,KAAK,IAAI,IAAI;IAIb,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,KAAK,IAAI,SAAS,CAQrB;IAED,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,SAAS;CASlB"}

package/dist/pool/EntityPool.js

@@ -0,0 +1,86 @@
+import { resolvePoolConfig } from './types';
+export class EntityPool {
+    available = [];
+    entityFactory;
+    config;
+    _totalCreated = 0;
+    _acquireCount = 0;
+    _releaseCount = 0;
+    _missCount = 0;
+    constructor(entityFactory, config) {
+        this.entityFactory = entityFactory;
+        this.config = resolvePoolConfig(config);
+    }
+    acquire() {
+        this._acquireCount++;
+        let entity;
+        let fromPool = false;
+        if (this.available.length > 0) {
+            entity = this.available.pop();
+            fromPool = true;
+        }
+        else {
+            this._missCount++;
+            if (this.config.growthStrategy === 'grow') {
+                this.growBatch();
+            }
+            if (this.available.length > 0) {
+                entity = this.available.pop();
+                fromPool = true;
+            }
+            else {
+                entity = this.createEntity();
+            }
+        }
+        if (fromPool) {
+            entity._revive();
+        }
+        return entity;
+    }
+    release(entity) {
+        this._releaseCount++;
+        if (this.config.maxSize > 0 && this.available.length >= this.config.maxSize) {
+            entity.dispose();
+            return;
+        }
+        this.available.push(entity);
+    }
+    prewarm(count) {
+        const toCreate = count - this.available.length;
+        for (let i = 0; i < toCreate; i++) {
+            if (this.config.maxSize > 0 && this.available.length >= this.config.maxSize) {
+                break;
+            }
+            this.available.push(this.createEntity());
+        }
+    }
+    drain() {
+        this.available.length = 0;
+    }
+    get availableCount() {
+        return this.available.length;
+    }
+    get stats() {
+        return {
+            available: this.available.length,
+            totalCreated: this._totalCreated,
+            acquireCount: this._acquireCount,
+            releaseCount: this._releaseCount,
+            missCount: this._missCount,
+        };
+    }
+    createEntity() {
+        const entity = this.entityFactory();
+        this._totalCreated++;
+        return entity;
+    }
+    growBatch() {
+        const batchSize = this.config.growthBatchSize;
+        for (let i = 0; i < batchSize; i++) {
+            if (this.config.maxSize > 0 && this.available.length >= this.config.maxSize) {
+                break;
+            }
+            this.available.push(this.createEntity());
+        }
+    }
+}

package/dist/pool/IPoolable.d.ts

@@ -0,0 +1,4 @@
+export interface IPoolable {
+    reset(): void;
+}
+//# sourceMappingURL=IPoolable.d.ts.map

package/dist/pool/IPoolable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPoolable.d.ts","sourceRoot":"","sources":["../../src/pool/IPoolable.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IAMxB,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/pool/IPoolable.js

@@ -0,0 +1 @@
+export {};

package/dist/pool/IPoolableComponent.d.ts

@@ -0,0 +1,7 @@
+import type { IComponent } from '../Component';
+export interface IPoolableComponent extends IComponent {
+    onSpawn(): void;
+    onDespawn(): void;
+}
+export declare function isPoolableComponent(c: IComponent): c is IPoolableComponent;
+//# sourceMappingURL=IPoolableComponent.d.ts.map

package/dist/pool/IPoolableComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPoolableComponent.d.ts","sourceRoot":"","sources":["../../src/pool/IPoolableComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAU/C,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IAEpD,OAAO,IAAI,IAAI,CAAC;IAEhB,SAAS,IAAI,IAAI,CAAC;CACnB;AAGD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,IAAI,kBAAkB,CAG1E"}

package/dist/pool/IPoolableComponent.js

@@ -0,0 +1,4 @@
+export function isPoolableComponent(c) {
+    return typeof c.onSpawn === 'function'
+        && typeof c.onDespawn === 'function';
+}

package/dist/pool/IPoolableEntity.d.ts

@@ -0,0 +1,6 @@
+export interface IPoolableEntity<TSpawnArgs = void> {
+    onSpawn(args: TSpawnArgs): void;
+    onDespawn(): void;
+}
+export type SpawnArgsOf<T> = T extends IPoolableEntity<infer A> ? (A extends void ? [] : [args: A]) : never;
+//# sourceMappingURL=IPoolableEntity.d.ts.map

package/dist/pool/IPoolableEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPoolableEntity.d.ts","sourceRoot":"","sources":["../../src/pool/IPoolableEntity.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe,CAAC,UAAU,GAAG,IAAI;IAOhD,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAOhC,SAAS,IAAI,IAAI,CAAC;CACnB;AAGD,MAAM,MAAM,WAAW,CAAC,CAAC,IACvB,CAAC,SAAS,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,IAAI,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC"}

package/dist/pool/IPoolableEntity.js

@@ -0,0 +1 @@
+export {};

package/dist/pool/ObjectPool.d.ts

@@ -0,0 +1,20 @@
+import type { IPoolable } from './IPoolable';
+import type { PoolConfig, PoolStats } from './types';
+export declare class ObjectPool<T extends IPoolable> {
+    private readonly available;
+    private readonly factory;
+    private readonly config;
+    private _totalCreated;
+    private _acquireCount;
+    private _releaseCount;
+    private _missCount;
+    constructor(factory: () => T, config?: PoolConfig);
+    acquire(): T;
+    release(obj: T): void;
+    prewarm(count: number): void;
+    drain(): void;
+    get availableCount(): number;
+    get totalCreated(): number;
+    get stats(): PoolStats;
+}
+//# sourceMappingURL=ObjectPool.d.ts.map

package/dist/pool/ObjectPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectPool.d.ts","sourceRoot":"","sources":["../../src/pool/ObjectPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAsB,MAAM,SAAS,CAAC;AAOzE,qBAAa,UAAU,CAAC,CAAC,SAAS,SAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,UAAU,CAAa;gBAEnB,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,UAAU;IAMjD,OAAO,IAAI,CAAC;IAiCZ,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAWrB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAY5B,KAAK,IAAI,IAAI;IAIb,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,KAAK,IAAI,SAAS,CAQrB;CACF"}

package/dist/pool/ObjectPool.js

@@ -0,0 +1,76 @@
+import { resolvePoolConfig } from './types';
+export class ObjectPool {
+    available = [];
+    factory;
+    config;
+    _totalCreated = 0;
+    _acquireCount = 0;
+    _releaseCount = 0;
+    _missCount = 0;
+    constructor(factory, config) {
+        this.factory = factory;
+        this.config = resolvePoolConfig(config);
+    }
+    acquire() {
+        this._acquireCount++;
+        if (this.available.length === 0) {
+            this._missCount++;
+            if (this.config.growthStrategy === 'grow') {
+                const batch = this.config.growthBatchSize;
+                for (let i = 0; i < batch; i++) {
+                    if (this.config.maxSize > 0 && this.available.length >= this.config.maxSize)
+                        break;
+                    const obj = this.factory();
+                    obj.reset();
+                    this._totalCreated++;
+                    this.available.push(obj);
+                }
+            }
+            if (this.available.length === 0) {
+                this._totalCreated++;
+                const obj = this.factory();
+                obj.reset();
+                return obj;
+            }
+        }
+        const obj = this.available.pop();
+        obj.reset();
+        return obj;
+    }
+    release(obj) {
+        this._releaseCount++;
+        obj.reset();
+        if (this.config.maxSize === 0 || this.available.length < this.config.maxSize) {
+            this.available.push(obj);
+        }
+    }
+    prewarm(count) {
+        const toCreate = count - this.available.length;
+        for (let i = 0; i < toCreate; i++) {
+            if (this.config.maxSize > 0 && this.available.length >= this.config.maxSize)
+                break;
+            const obj = this.factory();
+            obj.reset();
+            this._totalCreated++;
+            this.available.push(obj);
+        }
+    }
+    drain() {
+        this.available.length = 0;
+    }
+    get availableCount() {
+        return this.available.length;
+    }
+    get totalCreated() {
+        return this._totalCreated;
+    }
+    get stats() {
+        return {
+            available: this.available.length,
+            totalCreated: this._totalCreated,
+            acquireCount: this._acquireCount,
+            releaseCount: this._releaseCount,
+            missCount: this._missCount,
+        };
+    }
+}

package/dist/pool/PoolManager.d.ts

@@ -0,0 +1,20 @@
+import type { Entity } from '../Entity';
+import type { EntityManager } from '../EntityManager';
+import type { IPoolableEntity, SpawnArgsOf } from './IPoolableEntity';
+import type { EntityTypeConfig, PoolStats } from './types';
+export declare class PoolManager {
+    private readonly entityManager;
+    private readonly pools;
+    private readonly initialSizes;
+    constructor(entityManager: EntityManager);
+    registerEntityType<T extends Entity & IPoolableEntity<any>>(typeKey: string, config: EntityTypeConfig<T>): void;
+    spawn<T extends Entity & IPoolableEntity<any>>(typeKey: string, ...args: SpawnArgsOf<T>): T;
+    despawn(entity: Entity): void;
+    prewarmAll(): void;
+    prewarm(typeKey: string, count: number): void;
+    drainAll(): void;
+    getStats(): Map<string, PoolStats>;
+    getPoolStats(typeKey: string): PoolStats | undefined;
+    private runDespawnHooks;
+}
+//# sourceMappingURL=PoolManager.d.ts.map

package/dist/pool/PoolManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolManager.d.ts","sourceRoot":"","sources":["../../src/pool/PoolManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAS3D,qBAAa,WAAW;IAIV,OAAO,CAAC,QAAQ,CAAC,aAAa;IAH1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8C;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;gBAElC,aAAa,EAAE,aAAa;IAOzD,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,EACxD,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC1B,IAAI;IAkBP,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,EAC3C,OAAO,EAAE,MAAM,EACf,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GACtB,CAAC;IAqBJ,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAiB7B,UAAU,IAAI,IAAI;IAYlB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAS7C,QAAQ,IAAI,IAAI;IAOhB,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;IASlC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAKpD,OAAO,CAAC,eAAe;CAMxB"}

package/dist/pool/PoolManager.js

@@ -0,0 +1,92 @@
+import { isPoolableComponent } from './IPoolableComponent';
+import { EntityPool } from './EntityPool';
+export class PoolManager {
+    entityManager;
+    pools = new Map();
+    initialSizes = new Map();
+    constructor(entityManager) {
+        this.entityManager = entityManager;
+    }
+    registerEntityType(typeKey, config) {
+        if (this.pools.has(typeKey)) {
+            throw new Error(`Pool '${typeKey}' is already registered`);
+        }
+        const factory = () => {
+            const entity = config.factory();
+            entity._poolTypeKey = typeKey;
+            entity._inPool = true;
+            this.runDespawnHooks(entity);
+            return entity;
+        };
+        this.pools.set(typeKey, new EntityPool(factory, config.pool));
+        this.initialSizes.set(typeKey, config.pool?.initialSize ?? 0);
+    }
+    spawn(typeKey, ...args) {
+        const pool = this.pools.get(typeKey);
+        if (!pool) {
+            throw new Error(`Pool '${typeKey}' is not registered`);
+        }
+        const entity = pool.acquire();
+        entity._inPool = false;
+        for (const component of entity.getComponents().values()) {
+            if (isPoolableComponent(component))
+                component.onSpawn();
+        }
+        entity.onSpawn(args[0]);
+        this.entityManager.addEntity(entity);
+        return entity;
+    }
+    despawn(entity) {
+        const typeKey = entity._poolTypeKey;
+        if (!typeKey) {
+            throw new Error('despawn() called on an entity that was not created by PoolManager');
+        }
+        if (entity._inPool) {
+            return;
+        }
+        const pool = this.pools.get(typeKey);
+        this.entityManager.removeEntity(entity);
+        this.runDespawnHooks(entity);
+        entity._inPool = true;
+        pool.release(entity);
+    }
+    prewarmAll() {
+        for (const [typeKey, initialSize] of this.initialSizes) {
+            if (initialSize > 0) {
+                const pool = this.pools.get(typeKey);
+                if (pool) {
+                    pool.prewarm(initialSize);
+                }
+            }
+        }
+    }
+    prewarm(typeKey, count) {
+        const pool = this.pools.get(typeKey);
+        if (!pool) {
+            throw new Error(`Pool '${typeKey}' is not registered`);
+        }
+        pool.prewarm(count);
+    }
+    drainAll() {
+        for (const pool of this.pools.values()) {
+            pool.drain();
+        }
+    }
+    getStats() {
+        const result = new Map();
+        for (const [key, pool] of this.pools) {
+            result.set(key, pool.stats);
+        }
+        return result;
+    }
+    getPoolStats(typeKey) {
+        return this.pools.get(typeKey)?.stats;
+    }
+    runDespawnHooks(entity) {
+        entity.onDespawn();
+        for (const component of entity.getComponents().values()) {
+            if (isPoolableComponent(component))
+                component.onDespawn();
+        }
+    }
+}

package/dist/pool/index.d.ts

@@ -0,0 +1,10 @@
+export type { IPoolable } from './IPoolable';
+export type { IPoolableEntity, SpawnArgsOf } from './IPoolableEntity';
+export type { IPoolableComponent } from './IPoolableComponent';
+export { isPoolableComponent } from './IPoolableComponent';
+export type { PoolConfig, PoolStats, EntityTypeConfig, PoolingConfig, ResolvedPoolConfig, } from './types';
+export { resolvePoolConfig } from './types';
+export { ObjectPool } from './ObjectPool';
+export { EntityPool } from './EntityPool';
+export { PoolManager } from './PoolManager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pool/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EACV,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/pool/index.js

@@ -0,0 +1,5 @@
+export { isPoolableComponent } from './IPoolableComponent';
+export { resolvePoolConfig } from './types';
+export { ObjectPool } from './ObjectPool';
+export { EntityPool } from './EntityPool';
+export { PoolManager } from './PoolManager';

package/dist/pool/types.d.ts

@@ -0,0 +1,31 @@
+import type { Entity } from '../Entity';
+import type { IPoolableEntity } from './IPoolableEntity';
+export interface PoolConfig {
+    initialSize?: number;
+    maxSize?: number;
+    growthStrategy?: 'create' | 'grow';
+    growthBatchSize?: number;
+}
+export interface PoolStats {
+    available: number;
+    totalCreated: number;
+    acquireCount: number;
+    releaseCount: number;
+    missCount: number;
+}
+export interface EntityTypeConfig<T extends Entity & IPoolableEntity<any> = Entity & IPoolableEntity<any>> {
+    factory: () => T;
+    pool?: PoolConfig;
+}
+export interface PoolingConfig {
+    entityTypes: Record<string, EntityTypeConfig>;
+    autoPrewarm?: boolean;
+}
+export interface ResolvedPoolConfig {
+    initialSize: number;
+    maxSize: number;
+    growthStrategy: 'create' | 'grow';
+    growthBatchSize: number;
+}
+export declare function resolvePoolConfig(config?: PoolConfig): ResolvedPoolConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/pool/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pool/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,UAAU;IAEzB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEnC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC;IACvG,OAAO,EAAE,MAAM,CAAC,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAE9C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,kBAAkB,CAOzE"}

package/dist/pool/types.js

@@ -0,0 +1,8 @@
+export function resolvePoolConfig(config) {
+    return {
+        initialSize: config?.initialSize ?? 0,
+        maxSize: config?.maxSize ?? 0,
+        growthStrategy: config?.growthStrategy ?? 'create',
+        growthBatchSize: config?.growthBatchSize ?? 8,
+    };
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@phalanx-engine/ecs",
+  "version": "0.1.0",
+  "description": "Lightweight, renderer-agnostic Entity-Component-System library with optional multiplayer support via Phalanx Engine",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "keywords": [
+    "ecs",
+    "entity-component-system",
+    "game-engine",
+    "phalanx"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/phaeton-forge/phalanx-engine.git",
+    "directory": "phalanx-ecs"
+  },
+  "bugs": "https://github.com/phaeton-forge/phalanx-engine/issues",
+  "homepage": "https://github.com/phaeton-forge/phalanx-engine/tree/main/phalanx-ecs#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "happy-dom": "^20.8.4",
+    "typescript": "~5.9.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "rebuild": "npm run clean && npm run build",
+    "test": "vitest run"
+  }
+}