@phalanx-engine/ecs 0.1.0

package/dist/GameWorld.js

@@ -0,0 +1,237 @@
+import { SystemRegistry } from './SystemRegistry';
+import { TickFrameManager } from './TickFrameManager';
+import { SoAComponent } from './SoAComponent';
+import { PoolManager } from './pool/PoolManager';
+import { DebugDataProvider } from './debug/DebugDataProvider';
+import { DebugPanel } from './debug/DebugPanel';
+import { resetEntityIdCounter } from "./Entity";
+import { isBeforeTick, isAfterTick, isBeforeFrame, isAfterFrame, } from './ISystemLifecycleHooks';
+export const GameWorldEvents = {
+    PAUSED: 'gameWorld:paused',
+    RESUMED: 'gameWorld:resumed',
+};
+export class GameWorld {
+    systemRegistry;
+    provider;
+    ownsProvider;
+    _pools;
+    _poolingConfig;
+    _debugProvider;
+    _debugPanelConfig;
+    _debugPanel = null;
+    beforeTickSystems = [];
+    afterTickSystems = [];
+    beforeFrameSystems = [];
+    afterFrameSystems = [];
+    unsubscribeTick = null;
+    unsubscribeFrame = null;
+    unsubscribePause = null;
+    unsubscribeResume = null;
+    _paused = false;
+    constructor(config) {
+        resetEntityIdCounter();
+        this.systemRegistry = new SystemRegistry(config.componentTypes);
+        SoAComponent.useEntityManager(this.systemRegistry.entityManager);
+        if (config.pooling) {
+            this._poolingConfig = config.pooling;
+            this._pools = new PoolManager(this.systemRegistry.entityManager);
+            for (const [typeKey, typeConfig] of Object.entries(config.pooling.entityTypes)) {
+                this._pools.registerEntityType(typeKey, typeConfig);
+            }
+        }
+        else {
+            this._poolingConfig = undefined;
+            this._pools = null;
+        }
+        this.systemRegistry.getContext().pools = this._pools;
+        if (config.tickFrameProvider) {
+            this.provider = config.tickFrameProvider;
+            this.ownsProvider = false;
+        }
+        else {
+            this.provider = new TickFrameManager({
+                tickRate: config.tickRate,
+                maxFrameTime: config.maxFrameTime,
+            });
+            this.ownsProvider = true;
+        }
+        if (config.debug) {
+            this._debugProvider = new DebugDataProvider(this.systemRegistry.entityManager, this._pools, config.debugConfig);
+            this._debugPanelConfig = config.debugPanelConfig;
+        }
+        else {
+            this._debugProvider = null;
+            this._debugPanelConfig = undefined;
+        }
+    }
+    get paused() {
+        return this._paused;
+    }
+    pause() {
+        if (this._paused)
+            return;
+        if (this.provider.requestPause) {
+            this.provider.requestPause();
+        }
+        else {
+            this._paused = true;
+            if (this._debugProvider)
+                this._debugProvider.paused = true;
+            this.systemRegistry.eventBus.emit(GameWorldEvents.PAUSED, {});
+        }
+    }
+    resume() {
+        if (!this._paused)
+            return;
+        if (this.provider.requestResume) {
+            this.provider.requestResume();
+        }
+        else {
+            this._paused = false;
+            if (this._debugProvider)
+                this._debugProvider.paused = false;
+            this.systemRegistry.eventBus.emit(GameWorldEvents.RESUMED, {});
+        }
+    }
+    get eventBus() {
+        return this.systemRegistry.eventBus;
+    }
+    get entityManager() {
+        return this.systemRegistry.entityManager;
+    }
+    get pools() {
+        return this._pools;
+    }
+    get debugProvider() {
+        return this._debugProvider;
+    }
+    get debugPanel() {
+        return this._debugPanel;
+    }
+    get context() {
+        return this.systemRegistry.getContext();
+    }
+    getSystem(systemClass) {
+        return this.systemRegistry.getContext().getSystem(systemClass);
+    }
+    registerSystems(tickSystems, frameSystems) {
+        this.systemRegistry.registerSystems(tickSystems, frameSystems);
+        this.buildLifecycleCaches();
+    }
+    buildLifecycleCaches() {
+        this.beforeTickSystems = [];
+        this.afterTickSystems = [];
+        this.beforeFrameSystems = [];
+        this.afterFrameSystems = [];
+        for (const system of this.systemRegistry.getAllSystems()) {
+            if (isBeforeTick(system))
+                this.beforeTickSystems.push(system);
+            if (isAfterTick(system))
+                this.afterTickSystems.push(system);
+            if (isBeforeFrame(system))
+                this.beforeFrameSystems.push(system);
+            if (isAfterFrame(system))
+                this.afterFrameSystems.push(system);
+        }
+    }
+    addFrameSystem(system) {
+        this.systemRegistry.addFrameSystem(system);
+    }
+    processAllTicks(tick) {
+        this.systemRegistry.processAllTicks(tick);
+    }
+    updateAll(dt) {
+        this.systemRegistry.updateAll(dt);
+    }
+    start(hooks) {
+        if (this._pools && this._poolingConfig?.autoPrewarm !== false) {
+            this._pools.prewarmAll();
+        }
+        if (this.provider.onPause) {
+            this.unsubscribePause = this.provider.onPause(() => {
+                this._paused = true;
+                if (this._debugProvider)
+                    this._debugProvider.paused = true;
+                this.systemRegistry.eventBus.emit(GameWorldEvents.PAUSED, {});
+            });
+        }
+        if (this.provider.onResume) {
+            this.unsubscribeResume = this.provider.onResume(() => {
+                this._paused = false;
+                if (this._debugProvider)
+                    this._debugProvider.paused = false;
+                this.systemRegistry.eventBus.emit(GameWorldEvents.RESUMED, {});
+            });
+        }
+        this.unsubscribeTick = this.provider.onTick((tick, commands) => {
+            if (this._paused)
+                return;
+            for (const s of this.beforeTickSystems)
+                s.beforeTick(tick, commands);
+            hooks?.beforeTick?.(tick, commands);
+            this.processAllTicks(tick);
+            for (const s of this.afterTickSystems)
+                s.afterTick(tick);
+            hooks?.afterTick?.(tick);
+        });
+        this.unsubscribeFrame = this.provider.onFrame((alpha, dt) => {
+            if (this._paused)
+                return;
+            for (const s of this.beforeFrameSystems)
+                s.beforeFrame(alpha, dt);
+            hooks?.beforeFrame?.(alpha, dt);
+            this.updateAll(dt);
+            for (const s of this.afterFrameSystems)
+                s.afterFrame(alpha, dt);
+            hooks?.afterFrame?.(alpha, dt);
+        });
+        if (this.ownsProvider && this.provider instanceof TickFrameManager) {
+            this.provider.start();
+        }
+        if (this._debugProvider) {
+            this._debugProvider.start();
+            if (this._debugPanelConfig !== undefined && typeof document !== 'undefined') {
+                this._debugPanel = new DebugPanel(this._debugProvider, this._debugPanelConfig);
+            }
+        }
+    }
+    stop() {
+        if (this.unsubscribeTick) {
+            this.unsubscribeTick();
+            this.unsubscribeTick = null;
+        }
+        if (this.unsubscribeFrame) {
+            this.unsubscribeFrame();
+            this.unsubscribeFrame = null;
+        }
+        if (this.unsubscribePause) {
+            this.unsubscribePause();
+            this.unsubscribePause = null;
+        }
+        if (this.unsubscribeResume) {
+            this.unsubscribeResume();
+            this.unsubscribeResume = null;
+        }
+        if (this.ownsProvider && this.provider instanceof TickFrameManager) {
+            this.provider.stop();
+        }
+        if (this._debugPanel) {
+            this._debugPanel.destroy();
+            this._debugPanel = null;
+        }
+        if (this._debugProvider) {
+            this._debugProvider.stop();
+        }
+    }
+    dispose() {
+        this.stop();
+        if (this._debugProvider) {
+            this._debugProvider.dispose();
+        }
+        if (this._pools) {
+            this._pools.drainAll();
+        }
+        this.systemRegistry.dispose();
+        SoAComponent.resetContext();
+    }
+}

package/dist/IAbilitySystem.d.ts

@@ -0,0 +1,18 @@
+import type { GameSystem } from "./GameSystem";
+export interface IAbilitySystem {
+    activateAbility(casterEntityId: number, abilityId: string, providedTarget?: unknown): boolean;
+    applyEffect(targetEntityId: number, effectId: string, sourceEntityId?: number): void;
+    tryGetAttribute(entityId: number, attrId: string): {
+        base: unknown;
+        current: unknown;
+    } | undefined;
+    getAttribute(entityId: number, attrId: string): {
+        base: unknown;
+        current: unknown;
+    };
+    hasTag(entityId: number, tag: string): boolean;
+    addTag(entityId: number, tag: string): void;
+    removeTag(entityId: number, tag: string): boolean;
+    readonly tickSystems: readonly GameSystem[];
+}
+//# sourceMappingURL=IAbilitySystem.d.ts.map

package/dist/IAbilitySystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAbilitySystem.d.ts","sourceRoot":"","sources":["../src/IAbilitySystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAc7C,MAAM,WAAW,cAAc;IAC7B,eAAe,CACb,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC;IAEX,WAAW,CACT,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI,CAAC;IAER,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IAEnD,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAEvC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE/C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAElD,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C"}

package/dist/IAbilitySystem.js

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

package/dist/IPhysicsWorld.d.ts

@@ -0,0 +1,21 @@
+export interface InterpolatedTransformSample {
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    rotation: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+export interface IPhysicsWorld {
+    getInterpolatedTransform(entityId: number): InterpolatedTransformSample | undefined;
+    getEntityPosition(entityId: number): {
+        x: unknown;
+        z: unknown;
+    } | undefined;
+    applyImpulse(entityId: number, vx: unknown, vz: unknown): void;
+}
+//# sourceMappingURL=IPhysicsWorld.d.ts.map

package/dist/IPhysicsWorld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPhysicsWorld.d.ts","sourceRoot":"","sources":["../src/IPhysicsWorld.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAeD,MAAM,WAAW,aAAa;IAI5B,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS,CAAC;IAKpF,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,OAAO,CAAC;QAAC,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IAG5E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;CAChE"}

package/dist/IPhysicsWorld.js

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

package/dist/ISystemLifecycleHooks.d.ts

@@ -0,0 +1,18 @@
+import type { CommandsBatch } from './ITickFrameProvider';
+export interface IBeforeTick {
+    beforeTick(tick: number, commands: CommandsBatch): void;
+}
+export interface IAfterTick {
+    afterTick(tick: number): void;
+}
+export interface IBeforeFrame {
+    beforeFrame(alpha: number, dt: number): void;
+}
+export interface IAfterFrame {
+    afterFrame(alpha: number, dt: number): void;
+}
+export declare function isBeforeTick(system: object): system is IBeforeTick;
+export declare function isAfterTick(system: object): system is IAfterTick;
+export declare function isBeforeFrame(system: object): system is IBeforeFrame;
+export declare function isAfterFrame(system: object): system is IAfterFrame;
+//# sourceMappingURL=ISystemLifecycleHooks.d.ts.map

package/dist/ISystemLifecycleHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISystemLifecycleHooks.d.ts","sourceRoot":"","sources":["../src/ISystemLifecycleHooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAoB1D,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,WAAW,CAElE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,UAAU,CAEhE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,YAAY,CAEpE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,WAAW,CAElE"}

package/dist/ISystemLifecycleHooks.js

@@ -0,0 +1,12 @@
+export function isBeforeTick(system) {
+    return typeof system.beforeTick === 'function';
+}
+export function isAfterTick(system) {
+    return typeof system.afterTick === 'function';
+}
+export function isBeforeFrame(system) {
+    return typeof system.beforeFrame === 'function';
+}
+export function isAfterFrame(system) {
+    return typeof system.afterFrame === 'function';
+}

package/dist/ITickFrameProvider.d.ts

@@ -0,0 +1,24 @@
+export interface CommandsBatch {
+    tick: number;
+    commands: {
+        [playerId: string]: PlayerCommand[];
+    };
+}
+export interface PlayerCommand {
+    type: string;
+    data?: any;
+    playerId?: string;
+}
+export type TickHandler = (tick: number, commands: CommandsBatch) => void;
+export type FrameHandler = (alpha: number, dt: number) => void;
+export type Unsubscribe = () => void;
+export type PauseHandler = () => void;
+export interface ITickFrameProvider {
+    onTick(handler: TickHandler): Unsubscribe;
+    onFrame(handler: FrameHandler): Unsubscribe;
+    requestPause?(): void;
+    requestResume?(): void;
+    onPause?(handler: PauseHandler): Unsubscribe;
+    onResume?(handler: PauseHandler): Unsubscribe;
+}
+//# sourceMappingURL=ITickFrameProvider.d.ts.map

package/dist/ITickFrameProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITickFrameProvider.d.ts","sourceRoot":"","sources":["../src/ITickFrameProvider.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;KACrC,CAAC;CACH;AAKD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;AAO1E,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;AAK/D,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAKrC,MAAM,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC;AAkBtC,MAAM,WAAW,kBAAkB;IAMjC,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAAC;IAO1C,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAAC;IAS5C,YAAY,CAAC,IAAI,IAAI,CAAC;IAMtB,aAAa,CAAC,IAAI,IAAI,CAAC;IAQvB,OAAO,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAAC;IAM7C,QAAQ,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAAC;CAC/C"}

package/dist/ITickFrameProvider.js

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

package/dist/SoAComponent.d.ts

@@ -0,0 +1,22 @@
+import type { IComponent } from './Component';
+import type { IPoolableComponent } from './pool/IPoolableComponent';
+import type { SoASchemaDefinition, SoASchema, SoAFieldsOf } from './SoASchema';
+import type { SoAComponentStore } from './SoAComponentStore';
+import type { EntityManager } from './EntityManager';
+export declare abstract class SoAComponent<S extends SoASchemaDefinition> implements IComponent, IPoolableComponent {
+    abstract readonly type: symbol;
+    protected readonly store: SoAComponentStore<S>;
+    protected readonly entityId: number;
+    private _cachedIndex;
+    private readonly _spawnDefaults;
+    private static _entityManager;
+    static useEntityManager(em: EntityManager): void;
+    static resetContext(): void;
+    constructor(schema: SoASchema<S>, entityId: number, initialValues: SoAFieldsOf<S>);
+    onSpawn(): void;
+    onDespawn(): void;
+    protected getIndex(): number;
+    protected getField<K extends keyof S & string>(fieldName: K): SoAFieldsOf<S>[K];
+    protected setField<K extends keyof S & string>(fieldName: K, value: SoAFieldsOf<S>[K]): void;
+}
+//# sourceMappingURL=SoAComponent.d.ts.map

package/dist/SoAComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoAComponent.d.ts","sourceRoot":"","sources":["../src/SoAComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA6BrD,8BAAsB,YAAY,CAAC,CAAC,SAAS,mBAAmB,CAAE,YAAW,UAAU,EAAE,kBAAkB;IACzG,kBAAyB,IAAI,EAAE,MAAM,CAAC;IAGtC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAG/C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAGpC,OAAO,CAAC,YAAY,CAAc;IAGlC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAIhD,OAAO,CAAC,MAAM,CAAC,cAAc,CAA8B;WAM7C,gBAAgB,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;WAOzC,YAAY,IAAI,IAAI;gBAMtB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;IAyB1E,OAAO,IAAI,IAAI;IAgBf,SAAS,IAAI,IAAI;IAWxB,SAAS,CAAC,QAAQ,IAAI,MAAM;IAY5B,SAAS,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAQ/E,SAAS,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;CAS7F"}

package/dist/SoAComponent.js

@@ -0,0 +1,59 @@
+const DEFAULT_STORE_CAPACITY = 1024;
+export class SoAComponent {
+    store;
+    entityId;
+    _cachedIndex = -1;
+    _spawnDefaults;
+    static _entityManager = null;
+    static useEntityManager(em) {
+        SoAComponent._entityManager = em;
+    }
+    static resetContext() {
+        SoAComponent._entityManager = null;
+    }
+    constructor(schema, entityId, initialValues) {
+        if (!SoAComponent._entityManager) {
+            throw new Error('SoAComponent: No EntityManager context. Ensure GameWorld is created before instantiating SoA components.');
+        }
+        this.entityId = entityId;
+        this.store = SoAComponent._entityManager.getOrCreateSoAStore(schema, DEFAULT_STORE_CAPACITY);
+        this._spawnDefaults = initialValues;
+        this.store.add(entityId, initialValues);
+        this._cachedIndex = this.store.indexOf(entityId);
+    }
+    onSpawn() {
+        if (this.store.indexOf(this.entityId) === -1) {
+            this.store.add(this.entityId, this._spawnDefaults);
+        }
+        else {
+            for (const key of Object.keys(this._spawnDefaults)) {
+                this.setField(key, this._spawnDefaults[key]);
+            }
+        }
+        this._cachedIndex = this.store.indexOf(this.entityId);
+    }
+    onDespawn() {
+        this.store.remove(this.entityId);
+        this._cachedIndex = -1;
+    }
+    getIndex() {
+        if (this._cachedIndex === -1 || this.store.entityAt(this._cachedIndex) !== this.entityId) {
+            this._cachedIndex = this.store.indexOf(this.entityId);
+        }
+        return this._cachedIndex;
+    }
+    getField(fieldName) {
+        const idx = this.getIndex();
+        return this.store.arrays[fieldName][idx];
+    }
+    setField(fieldName, value) {
+        const idx = this.getIndex();
+        const arr = this.store.arrays[fieldName];
+        if (arr instanceof BigInt64Array) {
+            arr[idx] = value;
+        }
+        else {
+            arr[idx] = value;
+        }
+    }
+}

package/dist/SoAComponentStore.d.ts

@@ -0,0 +1,41 @@
+import { type SoASchema, type SoASchemaDefinition, type SoAFieldsOf, type SoAArraysOf } from './SoASchema';
+export interface SoAComponentStoreOptions {
+    initialCapacity?: number;
+    autoShrink?: boolean;
+}
+export declare class SoAComponentStore<S extends SoASchemaDefinition> {
+    readonly schema: SoASchema<S>;
+    readonly arrays: SoAArraysOf<S>;
+    private _count;
+    private _capacity;
+    private readonly _minCapacity;
+    private readonly _autoShrink;
+    private _fieldArrays;
+    private _fieldIsBigInt;
+    private entityToIndex;
+    private indexToEntity;
+    private _sortedEntityIds;
+    private binarySearchInsertIndex;
+    constructor(schema: SoASchema<S>, initialCapacityOrOptions?: number | SoAComponentStoreOptions);
+    private rebuildFieldCache;
+    get count(): number;
+    get capacity(): number;
+    has(entityId: number): boolean;
+    indexOf(entityId: number): number;
+    entityAt(index: number): number;
+    entityIds(): readonly number[];
+    add(entityId: number, values: SoAFieldsOf<S>): number;
+    remove(entityId: number): boolean;
+    get(entityId: number): SoAFieldsOf<S> | undefined;
+    set(entityId: number, values: Partial<SoAFieldsOf<S>>): boolean;
+    getField<K extends keyof S & string>(entityId: number, fieldName: K): SoAFieldsOf<S>[K] | undefined;
+    setField<K extends keyof S & string>(entityId: number, fieldName: K, value: SoAFieldsOf<S>[K]): boolean;
+    clear(): void;
+    private grow;
+    private resize;
+    private maybeAutoShrink;
+    shrinkToFit(minCapacity?: number): number;
+    forEachDense(callback: (entityId: number, index: number) => void): void;
+    forEach(callback: (entityId: number, index: number) => void): void;
+}
+//# sourceMappingURL=SoAComponentStore.d.ts.map

package/dist/SoAComponentStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoAComponentStore.d.ts","sourceRoot":"","sources":["../src/SoAComponentStore.ts"],"names":[],"mappings":"AAqCA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,WAAW,EAGjB,MAAM,aAAa,CAAC;AAmBrB,MAAM,WAAW,wBAAwB;IAEvC,eAAe,CAAC,EAAE,MAAM,CAAC;IAQzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA2BD,qBAAa,iBAAiB,CAAC,CAAC,SAAS,mBAAmB;IAE1D,SAAgB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAGrC,SAAgB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAGvC,OAAO,CAAC,MAAM,CAAa;IAG3B,OAAO,CAAC,SAAS,CAAS;IAM1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAGtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IAOtC,OAAO,CAAC,YAAY,CAAwB;IAO5C,OAAO,CAAC,cAAc,CAAiB;IAMvC,OAAO,CAAC,aAAa,CAAkC;IAMvD,OAAO,CAAC,aAAa,CAAgB;IAMrC,OAAO,CAAC,gBAAgB,CAAgB;IAKxC,OAAO,CAAC,uBAAuB;gBAgB7B,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,wBAAwB,GAAE,MAAM,GAAG,wBAAmD;IA6BxF,OAAO,CAAC,iBAAiB;IAczB,IAAW,KAAK,IAAI,MAAM,CAEzB;IAKD,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAKM,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQ9B,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQjC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAmB/B,SAAS,IAAI,SAAS,MAAM,EAAE;IAU9B,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM;IAyCrD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAiDjC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS;IAiBjD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;IAmB/D,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,CAAC,GACX,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;IAYzB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,CAAC,EACZ,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACvB,OAAO;IAcH,KAAK,IAAI,IAAI;IAoBpB,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,MAAM;IA6Bd,OAAO,CAAC,eAAe;IAwBhB,WAAW,CAAC,WAAW,GAAE,MAA0B,GAAG,MAAM;IAa5D,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IASvE,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;CAM1E"}