@aura3d/engine 1.0.0

package/dist/ecs/Query.js

@@ -0,0 +1,47 @@
+import { ValidationError } from "../core/index.js";
+import { Bitset } from "./Bitset.js";
+import {} from "./Component.js";
+import {} from "./ComponentRegistry.js";
+import {} from "./ComponentStore.js";
+import {} from "./Entity.js";
+import {} from "./EntityManager.js";
+export class Query {
+    entities;
+    store;
+    includeMask;
+    excludeMask;
+    include;
+    exclude;
+    constructor(entities, store, registry, options) {
+        this.entities = entities;
+        this.store = store;
+        this.include = options.include ?? [];
+        this.exclude = options.exclude ?? [];
+        this.includeMask = Bitset.from(this.include.map((ctor) => registry.require(ctor).id));
+        this.excludeMask = Bitset.from(this.exclude.map((ctor) => registry.require(ctor).id));
+    }
+    matches(entity) {
+        const signature = this.store.signature(entity);
+        return signature.containsAll(this.includeMask) && !signature.intersects(this.excludeMask);
+    }
+    toArray() {
+        if (this.include.length === 1 && this.exclude.length === 0) {
+            return this.store.entitiesWith(this.include[0]);
+        }
+        return this.entities.entities().filter((entity) => this.matches(entity));
+    }
+    forEach(visitor) {
+        for (const entity of this.toArray())
+            visitor(entity);
+    }
+    first() {
+        return this.toArray()[0];
+    }
+    single() {
+        const result = this.toArray();
+        if (result.length !== 1)
+            throw new ValidationError("QUERY_SINGLE", `Expected exactly one entity, found ${result.length}.`);
+        return result[0];
+    }
+}
+//# sourceMappingURL=Query.js.map

package/dist/ecs/Query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Query.js","sourceRoot":"","sources":["../../../../packages/ecs/src/Query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAsB,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAA0B,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAuB,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAe,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AAOxD,MAAM,OAAO,KAAK;IAOG;IACA;IAPF,WAAW,CAAS;IACpB,WAAW,CAAS;IACpB,OAAO,CAA2B;IAClC,OAAO,CAA2B;IAEnD,YACmB,QAAuB,EACvB,KAAqB,EACtC,QAA2B,EAC3B,OAAqB;QAHJ,aAAQ,GAAR,QAAQ,CAAe;QACvB,UAAK,GAAL,KAAK,CAAgB;QAItC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtF,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,OAAO,CAAC,MAAc;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5F,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,CAAC,OAAiC;QACvC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,sCAAsC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3H,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;CACF"}

package/dist/ecs/SparseSet.d.ts

@@ -0,0 +1,14 @@
+import { type Entity } from "./Entity.js";
+export declare class SparseSet<T> {
+    private readonly denseEntities;
+    private readonly denseValues;
+    private readonly sparse;
+    add(entity: Entity, value: T): void;
+    get(entity: Entity): T | undefined;
+    has(entity: Entity): boolean;
+    delete(entity: Entity): boolean;
+    entries(): [Entity, T][];
+    entities(): Entity[];
+    get size(): number;
+}
+//# sourceMappingURL=SparseSet.d.ts.map

package/dist/ecs/SparseSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SparseSet.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/SparseSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAErD,qBAAa,SAAS,CAAC,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAW;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAEpD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAYnC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAKlC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAgB/B,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE;IAIxB,QAAQ,IAAI,MAAM,EAAE;IAIpB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/ecs/SparseSet.js

@@ -0,0 +1,50 @@
+import { entityKey } from "./Entity.js";
+export class SparseSet {
+    denseEntities = [];
+    denseValues = [];
+    sparse = new Map();
+    add(entity, value) {
+        const key = entityKey(entity);
+        const existing = this.sparse.get(key);
+        if (existing !== undefined) {
+            this.denseValues[existing] = value;
+            return;
+        }
+        this.sparse.set(key, this.denseEntities.length);
+        this.denseEntities.push(entity);
+        this.denseValues.push(value);
+    }
+    get(entity) {
+        const index = this.sparse.get(entityKey(entity));
+        return index === undefined ? undefined : this.denseValues[index];
+    }
+    has(entity) {
+        return this.sparse.has(entityKey(entity));
+    }
+    delete(entity) {
+        const key = entityKey(entity);
+        const index = this.sparse.get(key);
+        if (index === undefined)
+            return false;
+        const lastIndex = this.denseEntities.length - 1;
+        const lastEntity = this.denseEntities[lastIndex];
+        const lastValue = this.denseValues[lastIndex];
+        this.denseEntities[index] = lastEntity;
+        this.denseValues[index] = lastValue;
+        this.sparse.set(entityKey(lastEntity), index);
+        this.denseEntities.pop();
+        this.denseValues.pop();
+        this.sparse.delete(key);
+        return true;
+    }
+    entries() {
+        return this.denseEntities.map((entity, index) => [entity, this.denseValues[index]]);
+    }
+    entities() {
+        return this.denseEntities.map((entity) => ({ ...entity }));
+    }
+    get size() {
+        return this.denseEntities.length;
+    }
+}
+//# sourceMappingURL=SparseSet.js.map

package/dist/ecs/SparseSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SparseSet.js","sourceRoot":"","sources":["../../../../packages/ecs/src/SparseSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AAErD,MAAM,OAAO,SAAS;IACH,aAAa,GAAa,EAAE,CAAC;IAC7B,WAAW,GAAQ,EAAE,CAAC;IACtB,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEpD,GAAG,CAAC,MAAc,EAAE,KAAQ;QAC1B,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;YACnC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACjD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC;QACvC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;IACnC,CAAC;CACF"}

package/dist/ecs/System.d.ts

@@ -0,0 +1,18 @@
+import { type World } from "./World.js";
+export type SystemPhase = "fixed" | "update" | "late";
+export interface SystemContext {
+    readonly deltaTime: number;
+    readonly elapsedTime: number;
+    readonly frame: number;
+}
+export interface System {
+    readonly name: string;
+    readonly phase?: SystemPhase;
+    readonly priority?: number;
+    readonly before?: readonly string[];
+    readonly after?: readonly string[];
+    onAdd?(world: World): void;
+    onRemove?(world: World): void;
+    update(world: World, context: SystemContext): void;
+}
+//# sourceMappingURL=System.d.ts.map

package/dist/ecs/System.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"System.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/System.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;CACpD"}

package/dist/ecs/System.js

@@ -0,0 +1,2 @@
+import {} from "./World.js";
+//# sourceMappingURL=System.js.map

package/dist/ecs/System.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"System.js","sourceRoot":"","sources":["../../../../packages/ecs/src/System.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,MAAM,YAAY,CAAC"}

package/dist/ecs/SystemScheduler.d.ts

@@ -0,0 +1,10 @@
+import { type System, type SystemContext, type SystemPhase } from "./System.js";
+import { type World } from "./World.js";
+export declare class SystemScheduler {
+    private readonly systems;
+    add(system: System, world?: World): void;
+    remove(name: string, world?: World): boolean;
+    order(phase?: SystemPhase): System[];
+    update(world: World, context: SystemContext): void;
+}
+//# sourceMappingURL=SystemScheduler.d.ts.map

package/dist/ecs/SystemScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemScheduler.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/SystemScheduler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAIxC,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAMxC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO;IAO5C,KAAK,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE;IAKpC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;CAKnD"}

package/dist/ecs/SystemScheduler.js

@@ -0,0 +1,79 @@
+import { ValidationError } from "../core/index.js";
+import {} from "./System.js";
+import {} from "./World.js";
+const phaseOrder = ["fixed", "update", "late"];
+export class SystemScheduler {
+    systems = new Map();
+    add(system, world) {
+        if (this.systems.has(system.name))
+            throw new ValidationError("DUPLICATE_SYSTEM", `Duplicate system name: ${system.name}`);
+        this.systems.set(system.name, system);
+        system.onAdd?.(world);
+    }
+    remove(name, world) {
+        const system = this.systems.get(name);
+        if (!system)
+            return false;
+        system.onRemove?.(world);
+        return this.systems.delete(name);
+    }
+    order(phase) {
+        const systems = [...this.systems.values()].filter((system) => (system.phase ?? "update") === (phase ?? system.phase ?? "update"));
+        return sortSystems(systems);
+    }
+    update(world, context) {
+        for (const phase of phaseOrder) {
+            for (const system of this.order(phase))
+                system.update(world, context);
+        }
+    }
+}
+function sortSystems(systems) {
+    const byName = new Map(systems.map((system) => [system.name, system]));
+    const graph = new Map();
+    const indegree = new Map();
+    const insertion = new Map(systems.map((system, index) => [system.name, index]));
+    for (const system of systems) {
+        graph.set(system.name, new Set());
+        indegree.set(system.name, 0);
+    }
+    for (const system of systems) {
+        for (const dependency of system.after ?? [])
+            addEdge(dependency, system.name);
+        for (const dependent of system.before ?? [])
+            addEdge(system.name, dependent);
+    }
+    const ready = systems
+        .filter((system) => indegree.get(system.name) === 0)
+        .sort(compareSystems);
+    const result = [];
+    while (ready.length > 0) {
+        const system = ready.shift();
+        result.push(system);
+        for (const dependent of graph.get(system.name) ?? []) {
+            indegree.set(dependent, (indegree.get(dependent) ?? 0) - 1);
+            if (indegree.get(dependent) === 0) {
+                ready.push(byName.get(dependent));
+                ready.sort(compareSystems);
+            }
+        }
+    }
+    if (result.length !== systems.length)
+        throw new ValidationError("ECS_SYSTEM_CYCLE", "ECS system dependency cycle rejected.");
+    return result;
+    function addEdge(from, to) {
+        if (!byName.has(from))
+            throw new ValidationError("MISSING_ECS_SYSTEM_DEPENDENCY", `Missing ECS system dependency: ${from}`);
+        if (!byName.has(to))
+            throw new ValidationError("MISSING_ECS_SYSTEM_DEPENDENCY", `Missing ECS system dependency: ${to}`);
+        const edges = graph.get(from);
+        if (!edges.has(to)) {
+            edges.add(to);
+            indegree.set(to, (indegree.get(to) ?? 0) + 1);
+        }
+    }
+    function compareSystems(a, b) {
+        return (a.priority ?? 0) - (b.priority ?? 0) || (insertion.get(a.name) ?? 0) - (insertion.get(b.name) ?? 0);
+    }
+}
+//# sourceMappingURL=SystemScheduler.js.map

package/dist/ecs/SystemScheduler.js.map

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

package/dist/ecs/World.d.ts

@@ -0,0 +1,27 @@
+import { type ComponentCtor, type ComponentSchema } from "./Component.js";
+import { ComponentRegistry } from "./ComponentRegistry.js";
+import { ComponentStore } from "./ComponentStore.js";
+import { type Entity } from "./Entity.js";
+import { EntityManager } from "./EntityManager.js";
+import { Query, type QueryOptions } from "./Query.js";
+import { SystemScheduler } from "./SystemScheduler.js";
+import { type SystemContext } from "./System.js";
+export declare class World {
+    readonly entities: EntityManager;
+    readonly registry: ComponentRegistry;
+    readonly components: ComponentStore;
+    readonly systems: SystemScheduler;
+    private version;
+    registerComponent<T extends object>(ctor: ComponentCtor<T>, schema?: ComponentSchema): void;
+    createEntity(): Entity;
+    destroyEntity(entity: Entity): boolean;
+    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;
+    query(options: QueryOptions): Query;
+    update(context: SystemContext): void;
+    getVersion(): number;
+    assertAlive(entity: Entity): void;
+}
+//# sourceMappingURL=World.d.ts.map

package/dist/ecs/World.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"World.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/World.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,qBAAa,KAAK;IAChB,QAAQ,CAAC,QAAQ,gBAAuB;IACxC,QAAQ,CAAC,QAAQ,oBAA2B;IAC5C,QAAQ,CAAC,UAAU,iBAAqC;IACxD,QAAQ,CAAC,OAAO,kBAAyB;IACzC,OAAO,CAAC,OAAO,CAAK;IAEpB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI;IAI3F,YAAY,IAAI,MAAM;IAKtB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAUtC,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI;IAOjF,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,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK;IAInC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIpC,UAAU,IAAI,MAAM;IAIpB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAGlC"}

package/dist/ecs/World.js

@@ -0,0 +1,68 @@
+import { ValidationError } from "../core/index.js";
+import {} from "./Component.js";
+import { ComponentRegistry } from "./ComponentRegistry.js";
+import { ComponentStore } from "./ComponentStore.js";
+import {} from "./Entity.js";
+import { EntityManager } from "./EntityManager.js";
+import { Query } from "./Query.js";
+import { SystemScheduler } from "./SystemScheduler.js";
+import {} from "./System.js";
+export class World {
+    entities = new EntityManager();
+    registry = new ComponentRegistry();
+    components = new ComponentStore(this.registry);
+    systems = new SystemScheduler();
+    version = 0;
+    registerComponent(ctor, schema) {
+        this.registry.register(ctor, schema);
+    }
+    createEntity() {
+        this.version += 1;
+        return this.entities.create();
+    }
+    destroyEntity(entity) {
+        this.assertAlive(entity);
+        const destroyed = this.entities.destroy(entity);
+        if (destroyed) {
+            this.components.deleteEntity(entity);
+            this.version += 1;
+        }
+        return destroyed;
+    }
+    add(entity, ctor, component) {
+        this.assertAlive(entity);
+        if (!this.registry.get(ctor))
+            this.registry.register(ctor);
+        this.components.add(entity, ctor, component);
+        this.version += 1;
+    }
+    remove(entity, ctor) {
+        this.assertAlive(entity);
+        const removed = this.components.remove(entity, ctor);
+        if (removed)
+            this.version += 1;
+        return removed;
+    }
+    get(entity, ctor) {
+        this.assertAlive(entity);
+        return this.components.get(entity, ctor);
+    }
+    has(entity, ctor) {
+        this.assertAlive(entity);
+        return this.components.has(entity, ctor);
+    }
+    query(options) {
+        return new Query(this.entities, this.components, this.registry, options);
+    }
+    update(context) {
+        this.systems.update(this, context);
+    }
+    getVersion() {
+        return this.version;
+    }
+    assertAlive(entity) {
+        if (!this.entities.isAlive(entity))
+            throw new ValidationError("ENTITY_NOT_ALIVE", `Entity is not alive: ${entity.id}:${entity.generation}`);
+    }
+}
+//# sourceMappingURL=World.js.map

package/dist/ecs/World.js.map

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

package/dist/ecs/components/ActiveComponent.d.ts

@@ -0,0 +1,16 @@
+import { type ComponentSchema } from "../Component.js";
+export interface SerializedActiveComponent {
+    readonly activeSelf: boolean;
+}
+export declare class ActiveComponent {
+    activeSelf: boolean;
+    activeInHierarchy: boolean;
+    constructor(active?: boolean);
+    get isActive(): boolean;
+    get isActiveInHierarchy(): boolean;
+    setActive(active: boolean): void;
+    toggle(): void;
+    toJSON(): SerializedActiveComponent;
+    static readonly schema: ComponentSchema;
+}
+//# sourceMappingURL=ActiveComponent.d.ts.map

package/dist/ecs/components/ActiveComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActiveComponent.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/ActiveComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,eAAe;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;gBAEf,MAAM,UAAO;IAMzB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAKhC,MAAM,IAAI,IAAI;IAId,MAAM,IAAI,yBAAyB;IAInC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAYrC;CACH"}

package/dist/ecs/components/ActiveComponent.js

@@ -0,0 +1,46 @@
+import { ValidationError } from "../../core/index.js";
+import {} from "../Component.js";
+export class ActiveComponent {
+    activeSelf;
+    activeInHierarchy;
+    constructor(active = true) {
+        if (typeof active !== "boolean")
+            throw new ValidationError("ACTIVE_COMPONENT", "ActiveComponent expects a boolean active state.");
+        this.activeSelf = active;
+        this.activeInHierarchy = active;
+    }
+    get isActive() {
+        return this.activeSelf;
+    }
+    get isActiveInHierarchy() {
+        return this.activeInHierarchy;
+    }
+    setActive(active) {
+        if (typeof active !== "boolean")
+            throw new ValidationError("ACTIVE_COMPONENT", "Active state must be boolean.");
+        this.activeSelf = active;
+    }
+    toggle() {
+        this.activeSelf = !this.activeSelf;
+    }
+    toJSON() {
+        return { activeSelf: this.activeSelf };
+    }
+    static schema = {
+        version: 1,
+        serialize(component) {
+            const active = component;
+            return { activeSelf: active.activeSelf };
+        },
+        deserialize(data) {
+            if (!isRecord(data) || typeof data.activeSelf !== "boolean") {
+                throw new ValidationError("ACTIVE_COMPONENT_DESERIALIZE", "ActiveComponent data requires activeSelf boolean.");
+            }
+            return new ActiveComponent(data.activeSelf);
+        }
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=ActiveComponent.js.map

package/dist/ecs/components/ActiveComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActiveComponent.js","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/ActiveComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAwB,MAAM,iBAAiB,CAAC;AAMvD,MAAM,OAAO,eAAe;IAC1B,UAAU,CAAU;IACpB,iBAAiB,CAAU;IAE3B,YAAY,MAAM,GAAG,IAAI;QACvB,IAAI,OAAO,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,iDAAiD,CAAC,CAAC;QAClI,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QACzB,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC;IAClC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED,SAAS,CAAC,MAAe;QACvB,IAAI,OAAO,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,+BAA+B,CAAC,CAAC;QAChH,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;IAC3B,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC;IACrC,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,CAAU,MAAM,GAAoB;QACxC,OAAO,EAAE,CAAC;QACV,SAAS,CAAC,SAAiB;YACzB,MAAM,MAAM,GAAG,SAA4B,CAAC;YAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;QAC3C,CAAC;QACD,WAAW,CAAC,IAAa;YACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC5D,MAAM,IAAI,eAAe,CAAC,8BAA8B,EAAE,mDAAmD,CAAC,CAAC;YACjH,CAAC;YACD,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,CAAC;KACF,CAAC;;AAGJ,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/ecs/components/HierarchyComponent.d.ts

@@ -0,0 +1,34 @@
+import { type ComponentSchema } from "../Component.js";
+import { type Entity } from "../Entity.js";
+export interface SerializedHierarchyComponent {
+    readonly parent: Entity | null;
+    readonly children: readonly Entity[];
+    readonly previousSibling: Entity | null;
+    readonly nextSibling: Entity | null;
+    readonly depth: number;
+}
+export declare class HierarchyComponent {
+    parent: Entity | null;
+    previousSibling: Entity | null;
+    nextSibling: Entity | null;
+    depth: number;
+    private readonly childEntities;
+    constructor(parent?: Entity | null);
+    get children(): readonly Entity[];
+    get childCount(): number;
+    get firstChild(): Entity | null;
+    get lastChild(): Entity | null;
+    hasParent(): boolean;
+    hasChildren(): boolean;
+    includesChild(entity: Entity): boolean;
+    forEachChild(callback: (child: Entity) => void): void;
+    getSiblingIndex(entity?: Entity): number;
+    _setParent(parent: Entity | null): void;
+    _addChild(child: Entity): void;
+    _removeChild(child: Entity): boolean;
+    _clearChildren(): void;
+    _moveChild(child: Entity, index: number): void;
+    toJSON(): SerializedHierarchyComponent;
+    static readonly schema: ComponentSchema;
+}
+//# sourceMappingURL=HierarchyComponent.d.ts.map

package/dist/ecs/components/HierarchyComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchyComponent.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/HierarchyComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAyB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAkB;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IACtC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAClC,KAAK,SAAK;IACV,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAElC,MAAM,GAAE,MAAM,GAAG,IAAW;IAIxC,IAAI,QAAQ,IAAI,SAAS,MAAM,EAAE,CAEhC;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,SAAS,IAAI,OAAO;IAIpB,WAAW,IAAI,OAAO;IAItB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAItC,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIrD,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAKxC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIvC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOpC,cAAc,IAAI,IAAI;IAItB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO9C,MAAM,IAAI,4BAA4B;IAUtC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAkBrC;CACH"}

package/dist/ecs/components/HierarchyComponent.js

@@ -0,0 +1,103 @@
+import { ValidationError } from "../../core/index.js";
+import {} from "../Component.js";
+import { entityKey, sameEntity } from "../Entity.js";
+export class HierarchyComponent {
+    parent;
+    previousSibling = null;
+    nextSibling = null;
+    depth = 0;
+    childEntities = [];
+    constructor(parent = null) {
+        this.parent = parent;
+    }
+    get children() {
+        return this.childEntities;
+    }
+    get childCount() {
+        return this.childEntities.length;
+    }
+    get firstChild() {
+        return this.childEntities[0] ?? null;
+    }
+    get lastChild() {
+        return this.childEntities[this.childEntities.length - 1] ?? null;
+    }
+    hasParent() {
+        return this.parent !== null;
+    }
+    hasChildren() {
+        return this.childEntities.length > 0;
+    }
+    includesChild(entity) {
+        return this.childEntities.some((child) => sameEntity(child, entity));
+    }
+    forEachChild(callback) {
+        for (const child of this.childEntities)
+            callback(child);
+    }
+    getSiblingIndex(entity) {
+        if (!entity)
+            return this.parent ? 0 : -1;
+        return this.childEntities.findIndex((child) => sameEntity(child, entity));
+    }
+    _setParent(parent) {
+        this.parent = parent;
+    }
+    _addChild(child) {
+        if (!this.includesChild(child))
+            this.childEntities.push(child);
+    }
+    _removeChild(child) {
+        const index = this.childEntities.findIndex((entry) => sameEntity(entry, child));
+        if (index < 0)
+            return false;
+        this.childEntities.splice(index, 1);
+        return true;
+    }
+    _clearChildren() {
+        this.childEntities.length = 0;
+    }
+    _moveChild(child, index) {
+        const current = this.childEntities.findIndex((entry) => sameEntity(entry, child));
+        if (current < 0)
+            throw new ValidationError("ECS_HIERARCHY_CHILD", `Entity is not a child: ${entityKey(child)}`);
+        const [entry] = this.childEntities.splice(current, 1);
+        this.childEntities.splice(Math.max(0, Math.min(index, this.childEntities.length)), 0, entry);
+    }
+    toJSON() {
+        return {
+            parent: this.parent ? { ...this.parent } : null,
+            children: this.childEntities.map((child) => ({ ...child })),
+            previousSibling: this.previousSibling ? { ...this.previousSibling } : null,
+            nextSibling: this.nextSibling ? { ...this.nextSibling } : null,
+            depth: this.depth
+        };
+    }
+    static schema = {
+        version: 1,
+        serialize(component) {
+            return component.toJSON();
+        },
+        deserialize(data) {
+            if (!isRecord(data) || !Array.isArray(data.children)) {
+                throw new ValidationError("HIERARCHY_COMPONENT_DESERIALIZE", "HierarchyComponent data requires children array.");
+            }
+            const hierarchy = new HierarchyComponent(isEntity(data.parent) ? data.parent : null);
+            for (const child of data.children) {
+                if (isEntity(child))
+                    hierarchy._addChild(child);
+            }
+            hierarchy.previousSibling = isEntity(data.previousSibling) ? data.previousSibling : null;
+            hierarchy.nextSibling = isEntity(data.nextSibling) ? data.nextSibling : null;
+            hierarchy.depth = typeof data.depth === "number" && Number.isFinite(data.depth) ? Math.max(0, Math.floor(data.depth)) : 0;
+            return hierarchy;
+        }
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isEntity(value) {
+    return isRecord(value) && Number.isSafeInteger(value.id) && Number.isSafeInteger(value.generation);
+}
+//# sourceMappingURL=HierarchyComponent.js.map

package/dist/ecs/components/HierarchyComponent.js.map

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

package/dist/ecs/components/NameComponent.d.ts

@@ -0,0 +1,5 @@
+export declare class NameComponent {
+    name: string;
+    constructor(name: string);
+}
+//# sourceMappingURL=NameComponent.d.ts.map

package/dist/ecs/components/NameComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NameComponent.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/NameComponent.ts"],"names":[],"mappings":"AAEA,qBAAa,aAAa;IACL,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAGhC"}

package/dist/ecs/components/NameComponent.js

@@ -0,0 +1,10 @@
+import { ValidationError } from "../../core/index.js";
+export class NameComponent {
+    name;
+    constructor(name) {
+        this.name = name;
+        if (!name)
+            throw new ValidationError("NAME_COMPONENT", "NameComponent requires a non-empty name.");
+    }
+}
+//# sourceMappingURL=NameComponent.js.map

package/dist/ecs/components/NameComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NameComponent.js","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/NameComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,OAAO,aAAa;IACL;IAAnB,YAAmB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;QAC7B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,eAAe,CAAC,gBAAgB,EAAE,0CAA0C,CAAC,CAAC;IACrG,CAAC;CACF"}

package/dist/ecs/components/TagComponent.d.ts

@@ -0,0 +1,5 @@
+export declare class TagComponent {
+    tag: string;
+    constructor(tag: string);
+}
+//# sourceMappingURL=TagComponent.d.ts.map

package/dist/ecs/components/TagComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TagComponent.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/TagComponent.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IACJ,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM;CAG/B"}