@aura3d/ecs 1.0.6

package/README.md

@@ -0,0 +1,18 @@
+# @aura3d/ecs
+
+`@aura3d/ecs` owns entity identity, component registration/storage, sparse-set and archetype data structures, queries, command buffering, systems, scheduling, serialization, profiling, and common transform/name/tag components.
+
+## Public API
+
+- `Entity`, `EntityManager`: deterministic entity allocation, liveness, and recycling.
+- `Component`, `ComponentRegistry`, `ComponentStore`, `SparseSet`, `Bitset`, `Archetype`: component metadata and storage primitives.
+- `Query`: include/exclude query execution over component stores.
+- `CommandBuffer`: deferred entity and component mutation.
+- `System`, `SystemScheduler`, `World`: ECS update ownership, phase ordering, and system execution.
+- `ECSSerializer`, `ECSProfiler`: deterministic serialization and runtime stats.
+- `TransformComponent`, `NameComponent`, `TagComponent`, `ActiveComponent`, `HierarchyComponent`: common components for scene, gameplay, active-state, and parent/child integration.
+- `ActiveSystem`, `HierarchySystem`: active-in-hierarchy propagation, cycle-safe parenting, traversal, sibling ordering, and hierarchy validation.
+
+## Verification
+
+Entity lifecycle, component stores, queries, command buffers, scheduler behavior, hierarchy/active systems, serialization, profiling, and scene/ECS integration are covered by `tests/unit/ecs/runtime.test.ts` and `tests/integration/scene-ecs-contracts.test.ts`. Export and import consistency is covered by `pnpm verify:exports` and `pnpm verify:imports`.

package/dist/Archetype.d.ts

@@ -0,0 +1,11 @@
+import { Bitset } from "./Bitset.js";
+import { type Entity } from "./Entity.js";
+export declare class Archetype {
+    readonly signature: Bitset;
+    private readonly members;
+    constructor(signature: Bitset);
+    add(entity: Entity): void;
+    delete(entity: Entity): boolean;
+    entities(): Entity[];
+}
+//# sourceMappingURL=Archetype.d.ts.map

package/dist/Archetype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Archetype.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/Archetype.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,qBAAa,SAAS;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAEzC,SAAS,EAAE,MAAM;IAI7B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI/B,QAAQ,IAAI,MAAM,EAAE;CAGrB"}

package/dist/Archetype.js

@@ -0,0 +1,19 @@
+import { Bitset } from "./Bitset.js";
+import {} from "./Entity.js";
+export class Archetype {
+    signature;
+    members = new Map();
+    constructor(signature) {
+        this.signature = signature.clone();
+    }
+    add(entity) {
+        this.members.set(entity.id, entity);
+    }
+    delete(entity) {
+        return this.members.delete(entity.id);
+    }
+    entities() {
+        return [...this.members.values()].sort((a, b) => a.id - b.id);
+    }
+}
+//# sourceMappingURL=Archetype.js.map

package/dist/Archetype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Archetype.js","sourceRoot":"","sources":["../../../../packages/ecs/src/Archetype.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAe,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,SAAS;IACX,SAAS,CAAS;IACV,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD,YAAY,SAAiB;QAC3B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/Bitset.d.ts

@@ -0,0 +1,12 @@
+export declare class Bitset {
+    private readonly values;
+    static from(values: Iterable<number>): Bitset;
+    add(value: number): this;
+    delete(value: number): boolean;
+    has(value: number): boolean;
+    containsAll(other: Bitset): boolean;
+    intersects(other: Bitset): boolean;
+    toArray(): number[];
+    clone(): Bitset;
+}
+//# sourceMappingURL=Bitset.d.ts.map

package/dist/Bitset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bitset.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/Bitset.ts"],"names":[],"mappings":"AAEA,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM;IAM7C,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMxB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI9B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI3B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOnC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOlC,OAAO,IAAI,MAAM,EAAE;IAInB,KAAK,IAAI,MAAM;CAGhB"}

package/dist/Bitset.js

@@ -0,0 +1,43 @@
+import { ValidationError } from "@aura3d/core";
+export class Bitset {
+    values = new Set();
+    static from(values) {
+        const bitset = new Bitset();
+        for (const value of values)
+            bitset.add(value);
+        return bitset;
+    }
+    add(value) {
+        if (!Number.isSafeInteger(value) || value < 0)
+            throw new ValidationError("BITSET_VALUE", "Bitset values must be non-negative safe integers.");
+        this.values.add(value);
+        return this;
+    }
+    delete(value) {
+        return this.values.delete(value);
+    }
+    has(value) {
+        return this.values.has(value);
+    }
+    containsAll(other) {
+        for (const value of other.values) {
+            if (!this.values.has(value))
+                return false;
+        }
+        return true;
+    }
+    intersects(other) {
+        for (const value of other.values) {
+            if (this.values.has(value))
+                return true;
+        }
+        return false;
+    }
+    toArray() {
+        return [...this.values].sort((a, b) => a - b);
+    }
+    clone() {
+        return Bitset.from(this.values);
+    }
+}
+//# sourceMappingURL=Bitset.js.map

package/dist/Bitset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bitset.js","sourceRoot":"","sources":["../../../../packages/ecs/src/Bitset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,OAAO,MAAM;IACA,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAE5C,MAAM,CAAC,IAAI,CAAC,MAAwB;QAClC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,GAAG,CAAC,KAAa;QACf,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,mDAAmD,CAAC,CAAC;QAC9I,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,KAAa;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,WAAW,CAAC,KAAa;QACvB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU,CAAC,KAAa;QACtB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC1C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,KAAK;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/CommandBuffer.d.ts

@@ -0,0 +1,16 @@
+import { type ComponentCtor } from "./Component.js";
+import { type Entity } from "./Entity.js";
+import { type World } from "./World.js";
+export type EntityRef = Entity | {
+    readonly tempId: number;
+};
+export declare class CommandBuffer {
+    private nextTempId;
+    private readonly commands;
+    createEntity(): EntityRef;
+    destroyEntity(entity: EntityRef): void;
+    add<T extends object>(entity: EntityRef, ctor: ComponentCtor<T>, component: T): void;
+    remove<T extends object>(entity: EntityRef, ctor: ComponentCtor<T>): void;
+    flush(world: World): Entity[];
+}
+//# sourceMappingURL=CommandBuffer.d.ts.map

package/dist/CommandBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandBuffer.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/CommandBuffer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAQ7D,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C,YAAY,IAAI,SAAS;IAOzB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAItC,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI;IAIpF,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAIzE,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE;CAmB9B"}

package/dist/CommandBuffer.js

@@ -0,0 +1,86 @@
+import { ValidationError } from "@aura3d/core";
+import {} from "./Component.js";
+import { entityKey } from "./Entity.js";
+import {} from "./World.js";
+export class CommandBuffer {
+    nextTempId = 1;
+    commands = [];
+    createEntity() {
+        const ref = { tempId: this.nextTempId };
+        this.nextTempId += 1;
+        this.commands.push({ kind: "create", tempId: ref.tempId });
+        return ref;
+    }
+    destroyEntity(entity) {
+        this.commands.push({ kind: "destroy", entity });
+    }
+    add(entity, ctor, component) {
+        this.commands.push({ kind: "add", entity, ctor, component });
+    }
+    remove(entity, ctor) {
+        this.commands.push({ kind: "remove", entity, ctor });
+    }
+    flush(world) {
+        validateCommands(world, this.commands);
+        const tempEntities = new Map();
+        const created = [];
+        const commands = this.commands.splice(0, this.commands.length);
+        for (const command of commands) {
+            if (command.kind === "create") {
+                const entity = world.createEntity();
+                tempEntities.set(command.tempId, entity);
+                created.push(entity);
+                continue;
+            }
+            const entity = resolve(command.entity, tempEntities);
+            if (command.kind === "destroy")
+                world.destroyEntity(entity);
+            if (command.kind === "add")
+                world.add(entity, command.ctor, command.component);
+            if (command.kind === "remove")
+                world.remove(entity, command.ctor);
+        }
+        return created;
+    }
+}
+function validateCommands(world, commands) {
+    const tempAlive = new Set();
+    const deadEntities = new Set();
+    for (const command of commands) {
+        if (command.kind === "create") {
+            tempAlive.add(command.tempId);
+            continue;
+        }
+        validateEntityRef(world, command.entity, tempAlive, deadEntities);
+        if (command.kind === "remove")
+            world.registry.require(command.ctor);
+        if (command.kind === "destroy") {
+            if ("tempId" in command.entity) {
+                tempAlive.delete(command.entity.tempId);
+            }
+            else {
+                deadEntities.add(entityKey(command.entity));
+            }
+        }
+    }
+}
+function validateEntityRef(world, ref, tempAlive, deadEntities) {
+    if ("tempId" in ref) {
+        if (!tempAlive.has(ref.tempId))
+            throw new ValidationError("TEMP_ENTITY", `Temporary entity is not alive: ${ref.tempId}`);
+        return;
+    }
+    world.assertAlive(ref);
+    if (deadEntities.has(entityKey(ref)))
+        throw new ValidationError("ENTITY_NOT_ALIVE", `Entity was already destroyed by this command buffer: ${entityKey(ref)}`);
+}
+function resolve(ref, tempEntities) {
+    if ("tempId" in ref) {
+        const entity = tempEntities.get(ref.tempId);
+        if (!entity)
+            throw new ValidationError("TEMP_ENTITY", `Temporary entity was not created: ${ref.tempId}`);
+        return entity;
+    }
+    return ref;
+}
+//# sourceMappingURL=CommandBuffer.js.map

package/dist/CommandBuffer.js.map

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

package/dist/Component.d.ts

@@ -0,0 +1,18 @@
+export interface ComponentCtor<T = object> {
+    readonly prototype: T;
+    readonly name: string;
+    readonly schema?: ComponentSchema;
+}
+export interface ComponentSchema {
+    readonly version: number;
+    serialize?(component: object): unknown;
+    deserialize?(data: unknown): object;
+}
+export interface ComponentType<T = object> {
+    readonly id: number;
+    readonly name: string;
+    readonly ctor: ComponentCtor<T>;
+    readonly schema: ComponentSchema;
+}
+export declare function componentName(ctor: ComponentCtor): string;
+//# sourceMappingURL=Component.d.ts.map

package/dist/Component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Component.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/Component.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM;IACvC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,WAAW,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAGzD"}

package/dist/Component.js

@@ -0,0 +1,7 @@
+import { ValidationError } from "@aura3d/core";
+export function componentName(ctor) {
+    if (!ctor.name)
+        throw new ValidationError("COMPONENT_NAME", "Component classes must have a stable name.");
+    return ctor.name;
+}
+//# sourceMappingURL=Component.js.map

package/dist/Component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Component.js","sourceRoot":"","sources":["../../../../packages/ecs/src/Component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAqB/C,MAAM,UAAU,aAAa,CAAC,IAAmB;IAC/C,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,eAAe,CAAC,gBAAgB,EAAE,4CAA4C,CAAC,CAAC;IAC1G,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}

package/dist/ComponentRegistry.d.ts

@@ -0,0 +1,12 @@
+import { type ComponentCtor, type ComponentSchema, type ComponentType } from "./Component.js";
+export declare class ComponentRegistry {
+    private nextId;
+    private readonly byCtor;
+    private readonly byName;
+    register<T extends object>(ctor: ComponentCtor<T>, schema?: ComponentSchema): ComponentType<T>;
+    get<T extends object>(ctor: ComponentCtor<T>): ComponentType<T> | undefined;
+    require<T extends object>(ctor: ComponentCtor<T>): ComponentType<T>;
+    getByName(name: string): ComponentType | undefined;
+    list(): ComponentType[];
+}
+//# sourceMappingURL=ComponentRegistry.d.ts.map

package/dist/ComponentRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentRegistry.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/ComponentRegistry.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE7G,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAE3D,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,aAAa,CAAC,CAAC,CAAC;IAY9F,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS;IAI3E,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;IAMnE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIlD,IAAI,IAAI,aAAa,EAAE;CAGxB"}

package/dist/ComponentRegistry.js

@@ -0,0 +1,36 @@
+import { ValidationError } from "@aura3d/core";
+import { componentName } from "./Component.js";
+export class ComponentRegistry {
+    nextId = 0;
+    byCtor = new Map();
+    byName = new Map();
+    register(ctor, schema) {
+        const name = componentName(ctor);
+        const existingByCtor = this.byCtor.get(ctor);
+        if (existingByCtor)
+            return existingByCtor;
+        if (this.byName.has(name))
+            throw new ValidationError("DUPLICATE_COMPONENT", `Duplicate component name: ${name}`);
+        const type = { id: this.nextId, name, ctor, schema: schema ?? ctor.schema ?? { version: 1 } };
+        this.nextId += 1;
+        this.byCtor.set(ctor, type);
+        this.byName.set(name, type);
+        return type;
+    }
+    get(ctor) {
+        return this.byCtor.get(ctor);
+    }
+    require(ctor) {
+        const type = this.get(ctor);
+        if (!type)
+            throw new ValidationError("UNREGISTERED_COMPONENT", `Component is not registered: ${componentName(ctor)}`);
+        return type;
+    }
+    getByName(name) {
+        return this.byName.get(name);
+    }
+    list() {
+        return [...this.byCtor.values()].sort((a, b) => a.id - b.id);
+    }
+}
+//# sourceMappingURL=ComponentRegistry.js.map

package/dist/ComponentRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentRegistry.js","sourceRoot":"","sources":["../../../../packages/ecs/src/ComponentRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAgE,MAAM,gBAAgB,CAAC;AAE7G,MAAM,OAAO,iBAAiB;IACpB,MAAM,GAAG,CAAC,CAAC;IACF,MAAM,GAAG,IAAI,GAAG,EAAgC,CAAC;IACjD,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE3D,QAAQ,CAAmB,IAAsB,EAAE,MAAwB;QACzE,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,cAAc;YAAE,OAAO,cAAkC,CAAC;QAC9D,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,qBAAqB,EAAE,6BAA6B,IAAI,EAAE,CAAC,CAAC;QACjH,MAAM,IAAI,GAAqB,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QAChH,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACjB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAqB,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAqB,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAmB,IAAsB;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAiC,CAAC;IAC/D,CAAC;IAED,OAAO,CAAmB,IAAsB;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,eAAe,CAAC,wBAAwB,EAAE,gCAAgC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/ComponentStore.d.ts

@@ -0,0 +1,21 @@
+import { Bitset } from "./Bitset.js";
+import { type ComponentCtor } from "./Component.js";
+import { ComponentRegistry } from "./ComponentRegistry.js";
+import { type Entity } from "./Entity.js";
+export declare class ComponentStore {
+    private readonly registry;
+    private readonly stores;
+    private readonly signatures;
+    constructor(registry: ComponentRegistry);
+    add<T extends object>(entity: Entity, ctor: ComponentCtor<T>, component: T): void;
+    remove<T extends object>(entity: Entity, ctor: ComponentCtor<T>): boolean;
+    get<T extends object>(entity: Entity, ctor: ComponentCtor<T>): T | undefined;
+    has<T extends object>(entity: Entity, ctor: ComponentCtor<T>): boolean;
+    deleteEntity(entity: Entity): void;
+    signature(entity: Entity): Bitset;
+    entries<T extends object>(ctor: ComponentCtor<T>): [Entity, T][];
+    entitiesWith<T extends object>(ctor: ComponentCtor<T>): Entity[];
+    private storeFor;
+    private signatureFor;
+}
+//# sourceMappingURL=ComponentStore.d.ts.map

package/dist/ComponentStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentStore.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/ComponentStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;gBAE3B,QAAQ,EAAE,iBAAiB;IAExD,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI;IAMjF,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO;IAOzE,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS;IAK5E,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO;IAKtE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKlC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIjC,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE;IAKhE,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE;IAKhE,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,YAAY;CAQrB"}

package/dist/ComponentStore.js

@@ -0,0 +1,66 @@
+import { Bitset } from "./Bitset.js";
+import {} from "./Component.js";
+import { ComponentRegistry } from "./ComponentRegistry.js";
+import {} from "./Entity.js";
+import { SparseSet } from "./SparseSet.js";
+export class ComponentStore {
+    registry;
+    stores = new Map();
+    signatures = new Map();
+    constructor(registry) {
+        this.registry = registry;
+    }
+    add(entity, ctor, component) {
+        const type = this.registry.require(ctor);
+        this.storeFor(type).add(entity, component);
+        this.signatureFor(entity).add(type.id);
+    }
+    remove(entity, ctor) {
+        const type = this.registry.require(ctor);
+        const removed = this.storeFor(type).delete(entity);
+        if (removed)
+            this.signatureFor(entity).delete(type.id);
+        return removed;
+    }
+    get(entity, ctor) {
+        const type = this.registry.require(ctor);
+        return this.storeFor(type).get(entity);
+    }
+    has(entity, ctor) {
+        const type = this.registry.require(ctor);
+        return this.storeFor(type).has(entity);
+    }
+    deleteEntity(entity) {
+        for (const store of this.stores.values())
+            store.delete(entity);
+        this.signatures.delete(entity.id);
+    }
+    signature(entity) {
+        return this.signatures.get(entity.id)?.clone() ?? new Bitset();
+    }
+    entries(ctor) {
+        const type = this.registry.require(ctor);
+        return this.storeFor(type).entries();
+    }
+    entitiesWith(ctor) {
+        const type = this.registry.require(ctor);
+        return this.storeFor(type).entities();
+    }
+    storeFor(type) {
+        let store = this.stores.get(type.id);
+        if (!store) {
+            store = new SparseSet();
+            this.stores.set(type.id, store);
+        }
+        return store;
+    }
+    signatureFor(entity) {
+        let signature = this.signatures.get(entity.id);
+        if (!signature) {
+            signature = new Bitset();
+            this.signatures.set(entity.id, signature);
+        }
+        return signature;
+    }
+}
+//# sourceMappingURL=ComponentStore.js.map

package/dist/ComponentStore.js.map

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

package/dist/ECSProfiler.d.ts

@@ -0,0 +1,12 @@
+import { type World } from "./World.js";
+export interface ECSProfileSnapshot {
+    entities: number;
+    components: {
+        name: string;
+        id: number;
+        count: number;
+    }[];
+    version: number;
+}
+export declare function profileWorld(world: World): ECSProfileSnapshot;
+//# sourceMappingURL=ECSProfiler.d.ts.map

package/dist/ECSProfiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ECSProfiler.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/ECSProfiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB,CAU7D"}

package/dist/ECSProfiler.js

@@ -0,0 +1,13 @@
+import {} from "./World.js";
+export function profileWorld(world) {
+    return {
+        entities: world.entities.size,
+        components: world.registry.list().map((type) => ({
+            name: type.name,
+            id: type.id,
+            count: world.components.entries(type.ctor).length
+        })),
+        version: world.getVersion()
+    };
+}
+//# sourceMappingURL=ECSProfiler.js.map

package/dist/ECSProfiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ECSProfiler.js","sourceRoot":"","sources":["../../../../packages/ecs/src/ECSProfiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,MAAM,YAAY,CAAC;AAQxC,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI;QAC7B,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM;SAClD,CAAC,CAAC;QACH,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE;KAC5B,CAAC;AACJ,CAAC"}

package/dist/ECSSerializer.d.ts

@@ -0,0 +1,18 @@
+import { type ComponentCtor } from "./Component.js";
+import { type Entity } from "./Entity.js";
+import { World } from "./World.js";
+export interface SerializedEntity {
+    id: number;
+    generation: number;
+    components: Record<string, unknown>;
+}
+export interface SerializedWorld {
+    version: 1;
+    entities: SerializedEntity[];
+}
+export declare function serializeWorld(world: World): SerializedWorld;
+export declare function deserializeWorld(serialized: SerializedWorld, componentTypes: ComponentCtor[]): {
+    world: World;
+    remap: Map<string, Entity>;
+};
+//# sourceMappingURL=ECSSerializer.d.ts.map

package/dist/ECSSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ECSSerializer.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/ECSSerializer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAU5D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAgB3I"}

package/dist/ECSSerializer.js

@@ -0,0 +1,37 @@
+import { ValidationError } from "@aura3d/core";
+import {} from "./Component.js";
+import {} from "./Entity.js";
+import { World } from "./World.js";
+export function serializeWorld(world) {
+    const entities = world.entities.entities().map((entity) => {
+        const components = {};
+        for (const type of world.registry.list()) {
+            const value = world.components.get(entity, type.ctor);
+            if (value)
+                components[type.name] = type.schema.serialize ? type.schema.serialize(value) : structuredClone(value);
+        }
+        return { id: entity.id, generation: entity.generation, components };
+    });
+    return { version: 1, entities };
+}
+export function deserializeWorld(serialized, componentTypes) {
+    if (serialized.version !== 1)
+        throw new ValidationError("ECS_VERSION", `Unsupported ECS version: ${serialized.version}`);
+    const world = new World();
+    for (const type of componentTypes)
+        world.registerComponent(type);
+    const remap = new Map();
+    for (const serializedEntity of serialized.entities) {
+        const entity = world.createEntity();
+        remap.set(`${serializedEntity.id}:${serializedEntity.generation}`, entity);
+        for (const [name, data] of Object.entries(serializedEntity.components)) {
+            const type = world.registry.getByName(name);
+            if (!type)
+                throw new ValidationError("ECS_DESERIALIZE_COMPONENT", `Missing component type during ECS deserialize: ${name}`);
+            const component = type.schema.deserialize ? type.schema.deserialize(data) : data;
+            world.add(entity, type.ctor, component);
+        }
+    }
+    return { world, remap };
+}
+//# sourceMappingURL=ECSSerializer.js.map

package/dist/ECSSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ECSSerializer.js","sourceRoot":"","sources":["../../../../packages/ecs/src/ECSSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAsB,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAe,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAanC,MAAM,UAAU,cAAc,CAAC,KAAY;IACzC,MAAM,QAAQ,GAAuB,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5E,MAAM,UAAU,GAA4B,EAAE,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAqB,CAAC,CAAC;YACvE,IAAI,KAAK;gBAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACnH,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC;IACtE,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAA2B,EAAE,cAA+B;IAC3F,IAAI,UAAU,CAAC,OAAO,KAAK,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,aAAa,EAAE,4BAA4B,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IACzH,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,cAAc;QAAE,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,MAAM,gBAAgB,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;QACpC,KAAK,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,EAAE,IAAI,gBAAgB,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;QAC3E,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,eAAe,CAAC,2BAA2B,EAAE,kDAAkD,IAAI,EAAE,CAAC,CAAC;YAC5H,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACjF,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAqB,EAAE,SAAmB,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/dist/Entity.d.ts

@@ -0,0 +1,8 @@
+export interface Entity {
+    readonly id: number;
+    readonly generation: number;
+}
+export declare function entityKey(entity: Entity): string;
+export declare function sameEntity(a: Entity, b: Entity): boolean;
+export declare function assertEntity(entity: Entity): void;
+//# sourceMappingURL=Entity.d.ts.map

package/dist/Entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/Entity.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGjD"}

package/dist/Entity.js

@@ -0,0 +1,14 @@
+import { ValidationError } from "@aura3d/core";
+export function entityKey(entity) {
+    return `${entity.id}:${entity.generation}`;
+}
+export function sameEntity(a, b) {
+    return a.id === b.id && a.generation === b.generation;
+}
+export function assertEntity(entity) {
+    if (!Number.isSafeInteger(entity.id) || entity.id < 0)
+        throw new ValidationError("ENTITY_ID", "Entity id must be a non-negative safe integer.");
+    if (!Number.isSafeInteger(entity.generation) || entity.generation < 0)
+        throw new ValidationError("ENTITY_GENERATION", "Entity generation must be a non-negative safe integer.");
+}
+//# sourceMappingURL=Entity.js.map

package/dist/Entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Entity.js","sourceRoot":"","sources":["../../../../packages/ecs/src/Entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAO/C,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,OAAO,GAAG,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS;IAC7C,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,EAAE,GAAG,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,WAAW,EAAE,gDAAgD,CAAC,CAAC;IAChJ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,mBAAmB,EAAE,wDAAwD,CAAC,CAAC;AAClL,CAAC"}

package/dist/EntityManager.d.ts

@@ -0,0 +1,12 @@
+import { type Entity } from "./Entity.js";
+export declare class EntityManager {
+    private readonly generations;
+    private readonly alive;
+    private readonly free;
+    create(): Entity;
+    destroy(entity: Entity): boolean;
+    isAlive(entity: Entity): boolean;
+    get size(): number;
+    entities(): Entity[];
+}
+//# sourceMappingURL=EntityManager.d.ts.map

package/dist/EntityManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/EntityManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IAErC,MAAM,IAAI,MAAM;IAOhB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAShC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIhC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,QAAQ,IAAI,MAAM,EAAE;CAGrB"}

package/dist/EntityManager.js

@@ -0,0 +1,33 @@
+import { ValidationError } from "@aura3d/core";
+import {} from "./Entity.js";
+export class EntityManager {
+    generations = [];
+    alive = new Set();
+    free = [];
+    create() {
+        const id = this.free.pop() ?? this.generations.length;
+        this.generations[id] ??= 0;
+        this.alive.add(id);
+        return { id, generation: this.generations[id] };
+    }
+    destroy(entity) {
+        if (!this.isAlive(entity))
+            return false;
+        this.alive.delete(entity.id);
+        this.generations[entity.id] += 1;
+        if (!Number.isSafeInteger(this.generations[entity.id]))
+            throw new ValidationError("ENTITY_GENERATION_OVERFLOW", "Entity generation overflow.");
+        this.free.push(entity.id);
+        return true;
+    }
+    isAlive(entity) {
+        return this.alive.has(entity.id) && this.generations[entity.id] === entity.generation;
+    }
+    get size() {
+        return this.alive.size;
+    }
+    entities() {
+        return [...this.alive].sort((a, b) => a - b).map((id) => ({ id, generation: this.generations[id] }));
+    }
+}
+//# sourceMappingURL=EntityManager.js.map