@vworlds/vecs 1.0.19 → 1.0.21

package/dist/entity/entity.d.ts

@@ -1,7 +1,9 @@
 import { type ComponentType } from "../component_meta.js";
 import { type World } from "../world/index.js";
 import { IdentityEntity } from "./entity.identity.js";
-export type EntityClass<T extends Entity = Entity> = new (world: World, eid: number, ownComponentClass?: ComponentType) => T;
+/** Entity id assigned by a {@link World}. */
+export type EID = number;
+export type EntityClass<T extends Entity = Entity> = new (world: World, eid: EID, ownComponentClass?: ComponentType) => T;
 /**
  * A game object: a unique numeric id with an arbitrary set of
  * {@link ComponentInstance | components} attached.
@@ -32,4 +34,6 @@ export type EntityClass<T extends Entity = Entity> = new (world: World, eid: num
  * visible immediately.
  */
 export declare class Entity extends IdentityEntity {
+    /** Attach this entity to `parent` through the built-in `ChildOf` relationship. */
+    childOf(parent: Entity): this;
 }

package/dist/entity/entity.js

@@ -1,3 +1,4 @@
+import { ChildOf } from "../modules/relationship_types.js";
 import { IdentityEntity } from "./entity.identity.js";
 /**
  * A game object: a unique numeric id with an arbitrary set of
@@ -29,5 +30,9 @@ import { IdentityEntity } from "./entity.identity.js";
  * visible immediately.
  */
 export class Entity extends IdentityEntity {
+    /** Attach this entity to `parent` through the built-in `ChildOf` relationship. */
+    childOf(parent) {
+        return this.set(ChildOf, { target: parent });
+    }
 }
 //# sourceMappingURL=entity.js.map

package/dist/entity/entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/entity/entity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,OAAO,MAAO,SAAQ,cAAc;CAAG"}
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/entity/entity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAWtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,OAAO,MAAO,SAAQ,cAAc;IACxC,kFAAkF;IAC3E,OAAO,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/entity/entity.lifecycle.js

@@ -10,15 +10,15 @@ export class Lifecycle extends Components {
         if (this._destroyed) {
             return;
         }
-        const ownMeta = this._ownMeta;
+        const entityMeta = this._meta;
         // Mark destroyed up front so a carrier cleanup that re-enters this entity's
         // `_destroy` (possible with exotic relationship topologies under Delete)
         // hits the guard above instead of tearing down twice.
         this._destroyed = true;
-        if (ownMeta) {
-            const selfCarry = this._components.has(ownMeta.eid) ? 1 : 0;
-            if (ownMeta.usageCount > selfCarry) {
-                if (ownMeta.onDelete === CleanupPolicy.Throw) {
+        if (entityMeta) {
+            const selfCarry = this._components.has(entityMeta.eid) ? 1 : 0;
+            if (entityMeta.usageCount > selfCarry) {
+                if (entityMeta.onDelete === CleanupPolicy.Throw) {
                     // The public `destroy()` already throws when an in-use component is
                     // destroyed; reaching here means usage grew between that check and
                     // this deferred apply. Abort instead of throwing so a mid-drain
@@ -27,20 +27,20 @@ export class Lifecycle extends Components {
                     this._destroyed = false;
                     return;
                 }
-                this._applyOnDelete(ownMeta, selfCarry);
+                this._applyOnDelete(entityMeta, selfCarry);
             }
         }
         const entity = this;
         this.world._notifyEntityDestroyed(entity);
-        this._components.forEach((c, eid) => {
-            const meta = this.world.entity(eid).ownMeta;
-            if (meta.isRelationship) {
-                this._removeIncoming(c.target, eid);
+        this._components.forEach((c, ceid) => {
+            const componentMeta = this.world.entity(ceid).meta;
+            if (componentMeta.isRelationship) {
+                this._removeIncoming(c.target, ceid);
             }
-            this.componentBitmask.deleteBit(meta.bitPtr);
-            this.world._notifyComponentRemoved(eid, entity);
-            meta._decrementUsage();
-            const removeHandlers = meta._onRemoveHandlers;
+            this.componentBitmask.deleteBit(componentMeta.bitPtr);
+            this.world._notifyComponentRemoved(ceid, entity);
+            componentMeta._decrementUsage();
+            const removeHandlers = componentMeta._onRemoveHandlers;
             if (removeHandlers) {
                 removeHandlers.forEach((handler) => handler(entity, c));
             }
@@ -51,8 +51,8 @@ export class Lifecycle extends Components {
             this._events.emit("destroy");
             this._events.removeAllListeners("destroy");
         }
-        if (ownMeta && ownMeta.usageCount === 0 && ownMeta.Class !== Object) {
-            this.world._classRegistry.delete(ownMeta.Class);
+        if (entityMeta && entityMeta.usageCount === 0 && entityMeta.Class !== Object) {
+            this.world._classRegistry.delete(entityMeta.Class);
         }
         this.world._unregisterEntity(entity);
         this._cleanupIncoming();
@@ -65,10 +65,10 @@ export class Lifecycle extends Components {
      * After destruction the entity must not be used.
      */
     destroy() {
-        const ownMeta = this._ownMeta;
-        if (ownMeta &&
-            ownMeta.onDelete === CleanupPolicy.Throw &&
-            ownMeta.usageCount > (this._components.has(ownMeta.eid) ? 1 : 0)) {
+        const entityMeta = this._meta;
+        if (entityMeta &&
+            entityMeta.onDelete === CleanupPolicy.Throw &&
+            entityMeta.usageCount > (this._components.has(entityMeta.eid) ? 1 : 0)) {
             throw new Error(`Cannot destroy entity ${this.eid}; component eid is still in use`);
         }
         if (this.world.deferred) {
@@ -87,23 +87,23 @@ export class Lifecycle extends Components {
     // `onDelete = Throw`, its `_destroy` safe-aborts and it survives still holding
     // this now-destroyed component eid. This is the same exotic policy-interaction
     // class flagged in `_cleanupIncoming`; left for the relationship/query rework.
-    _applyOnDelete(ownMeta, selfCarry) {
-        const ceid = ownMeta.eid;
+    _applyOnDelete(entityMeta, selfCarry) {
+        const ceid = entityMeta.eid;
         const carriers = [];
-        let remaining = ownMeta.usageCount - selfCarry;
+        let remaining = entityMeta.usageCount - selfCarry;
         this.world.entities.forEach((e) => {
             if (remaining > 0 && e !== this && e._get(ceid) !== undefined) {
                 carriers.push(e);
                 remaining--;
             }
         });
-        const shouldDelete = ownMeta.onDelete === CleanupPolicy.Delete;
+        const shouldDelete = entityMeta.onDelete === CleanupPolicy.Delete;
         for (const carrier of carriers) {
             if (shouldDelete) {
                 carrier._destroy();
             }
             else {
-                carrier._remove(ownMeta);
+                carrier._remove(entityMeta);
             }
         }
     }

package/dist/entity/entity.lifecycle.js.map

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

package/dist/entity/entity.queries.js

@@ -9,12 +9,6 @@ export class Queries extends Base {
             this._queries.add(q);
         }
     }
-    /**
-     * @internal Return `true` when this entity is currently tracked by `q`.
-     */
-    _isInQuery(q) {
-        return this._queries.has(q);
-    }
     /**
      * @internal Forget query `q` without firing exit callbacks. Called by
      * {@link World} when a {@link Query.destroy} sweeps every entity.

package/dist/entity/entity.queries.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity.queries.js","sourceRoot":"","sources":["../../src/entity/entity.queries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,MAAM,OAAO,OAAQ,SAAQ,IAAI;IAC/B;;;OAGG;IACI,mBAAmB,CAAC,CAAQ;QACjC,IAAI,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,CAAQ;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACI,WAAW,CAAC,CAAQ;QACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACI,sBAAsB,CAAC,CAAQ;QACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;CACF"}
+{"version":3,"file":"entity.queries.js","sourceRoot":"","sources":["../../src/entity/entity.queries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,MAAM,OAAO,OAAQ,SAAQ,IAAI;IAC/B;;;OAGG;IACI,mBAAmB,CAAC,CAAQ;QACjC,IAAI,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,WAAW,CAAC,CAAQ;QACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACI,sBAAsB,CAAC,CAAQ;QACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/entity/entity.relationships.d.ts

@@ -3,7 +3,7 @@ import type { Entity } from "./entity.js";
 import { Queries } from "./entity.queries.js";
 export declare class Relationships extends Queries {
     /** Return this entity's target through relationship `ref`, if present. */
-    parent(ref: ComponentRef): Entity | undefined;
+    parent(rel: ComponentRef): Entity | undefined;
     /** Return entities targeting this one through relationship `ref`. */
     children(ref: ComponentRef): ReadonlySet<Entity>;
 }

package/dist/entity/entity.relationships.js

@@ -1,15 +1,17 @@
-import { CleanupPolicy } from "../component_meta.js";
+import { CleanupPolicy, } from "../component_meta.js";
 import { ArrayMap } from "../util/array_map.js";
 import { DenseSet } from "../util/dense_set.js";
 import { Queries } from "./entity.queries.js";
 export class Relationships extends Queries {
     /** Return this entity's target through relationship `ref`, if present. */
-    parent(ref) {
-        return this._components.get(this.world.entity(ref).eid)?.target;
+    parent(rel) {
+        const relEid = typeof rel === "number" ? rel : this.world.entity(rel).eid;
+        return this._components.get(relEid)?.target;
     }
     /** Return entities targeting this one through relationship `ref`. */
     children(ref) {
-        return this._incoming?.get(this.world.entity(ref).eid) ?? Relationships._emptyIncoming;
+        const relEid = typeof ref === "number" ? ref : this.world.entity(ref).eid;
+        return this._incoming?.get(relEid) ?? Relationships._emptyIncoming;
     }
     /**
      * @internal Fast child set lookup by relationship eid — skips ref -> eid
@@ -37,7 +39,7 @@ export class Relationships extends Queries {
             if (!relEntity) {
                 return;
             }
-            const policy = relEntity.ownMeta.onDeleteTarget;
+            const policy = relEntity.meta.onDeleteTarget;
             for (const source of [...sources]) {
                 if (policy === CleanupPolicy.Delete) {
                     // If source is also an in-use component entity with onDelete Throw,

package/dist/entity/entity.relationships.js.map

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

package/dist/entity/index.d.ts

@@ -1,2 +1,2 @@
-export { Entity, type EntityClass } from "./entity.js";
+export { Entity, type EID, type EntityClass } from "./entity.js";
 export { Identity } from "./entity.identity.js";

package/dist/entity/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA8B,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/filter.d.ts

@@ -52,7 +52,7 @@ export declare class Filter<R extends ComponentType[] = []> {
      *
      * @param callback - Receives only the matching entity.
      */
-    forEach(callback: (e: Entity) => void): void;
+    forEach(callback: (e: Entity) => void): this;
     /**
      * Walk all current world entities, call `callback` for each one that
      * satisfies the filter's DSL, and inject the requested component instances.
@@ -68,19 +68,19 @@ export declare class Filter<R extends ComponentType[] = []> {
      * @param callback - Receives the entity and a tuple of resolved component
      *   instances.
      */
-    forEach<J extends FanInjectTuple>(components: readonly [...J], callback: (e: Entity, resolved: MaybeResolvedInjectTuple<J, R>) => void): void;
+    forEach<J extends FanInjectTuple>(components: readonly [...J], callback: (e: Entity, resolved: MaybeResolvedInjectTuple<J, R>) => void): this;
     /**
      * As above, but pass `Entity` first to make the entity-first signature
      * explicit. Identical behavior to the no-marker form.
      */
-    forEach<J extends FanInjectTuple>(cursor: typeof Entity, components: readonly [...J], callback: (e: Entity, resolved: MaybeResolvedInjectTuple<J, R>) => void): void;
+    forEach<J extends FanInjectTuple>(cursor: typeof Entity, components: readonly [...J], callback: (e: Entity, resolved: MaybeResolvedInjectTuple<J, R>) => void): this;
     /**
      * As above, but pass `Iter` first to receive a reused {@link Iter}
      * cursor instead of the bare entity. The cursor exposes the visited entity
      * (`it.entity`) and, in `it.src`, the source entity each resolved component
-     * was read from (the visited entity for direct components, the relationship
-     * target for `up`-injected ones).
+     * was read from (the visited entity for direct components, the
+     * relationship's target entity for ones injected via `target`).
      */
-    forEach<J extends FanInjectTuple>(cursor: typeof Iter, components: readonly [...J], callback: (it: Iter, resolved: MaybeResolvedInjectTuple<J, R>) => void): void;
+    forEach<J extends FanInjectTuple>(cursor: typeof Iter, components: readonly [...J], callback: (it: Iter, resolved: MaybeResolvedInjectTuple<J, R>) => void): this;
     private _forEachMatch;
 }

package/dist/filter.js

@@ -51,7 +51,7 @@ export class Filter {
             this.world.defer(() => {
                 this._forEachMatch(callback);
             });
-            return;
+            return this;
         }
         const useIter = wantsIter(arg0);
         const components = (isCursorMarker(arg0) ? arg1 : arg0);
@@ -60,6 +60,7 @@ export class Filter {
             const invoke = makeInjectedInvoker(this.world, components, useIter, callback);
             this._forEachMatch(invoke);
         });
+        return this;
     }
     _forEachMatch(callback) {
         const rootTerm = this.rootTerm;

package/dist/filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter.js","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAsC,MAAM,UAAU,CAAC;AAExE,OAAO,EACL,cAAc,EAEd,mBAAmB,EACnB,SAAS,GAIV,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,OAAO,MAAM;IAIjB;IACE,6CAA6C;IAC7B,KAAY,EAC5B,GAAa;QADG,UAAK,GAAL,KAAK,CAAO;QAG5B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAqDM,OAAO,CAAC,IAAa,EAAE,IAAc,EAAE,IAAc;QAC1D,oEAAoE;QACpE,IAAI,OAAO,IAAI,KAAK,UAAU,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,MAAM,QAAQ,GAAG,IAA2B,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE;gBACpB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,UAAU,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAgC,CAAC;QACvF,MAAM,QAAQ,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAG3C,CAAC;QACV,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE;YACpB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC9E,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,QAA6B;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnB,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrB,QAAQ,CAAC,CAAC,CAAC,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAsC,MAAM,UAAU,CAAC;AAExE,OAAO,EACL,cAAc,EAEd,mBAAmB,EACnB,SAAS,GAIV,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,OAAO,MAAM;IAIjB;IACE,6CAA6C;IAC7B,KAAY,EAC5B,GAAa;QADG,UAAK,GAAL,KAAK,CAAO;QAG5B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAqDM,OAAO,CAAC,IAAa,EAAE,IAAc,EAAE,IAAc;QAC1D,oEAAoE;QACpE,IAAI,OAAO,IAAI,KAAK,UAAU,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,MAAM,QAAQ,GAAG,IAA2B,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE;gBACpB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,UAAU,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAgC,CAAC;QACvF,MAAM,QAAQ,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAG3C,CAAC;QACV,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE;YACpB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC9E,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,aAAa,CAAC,QAA6B;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnB,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrB,QAAQ,CAAC,CAAC,CAAC,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,13 +1,17 @@
 export { System, type SystemQuery } from "./system.js";
-export { Query, GroupedQuery, Group, Iter, type EntityTestFunc, type MaybeRequired, type QueryDSL, type DownInject, type FanInjectElement, type FanInjectTuple, type InjectElement, type InjectTuple, type MaybeResolvedInjectTuple, type RequiredResolvedInjectTuple, type UpInject, } from "./query/index.js";
+export { Query, GroupedQuery, Group } from "./query/index.js";
+export type { EntityTestFunc, MaybeRequired, QueryDSL } from "./dsl.js";
+export { Iter } from "./inject.js";
+export type { DownInject, FanInjectElement, FanInjectTuple, InjectElement, InjectTuple, MaybeResolvedInjectTuple, RequiredResolvedInjectTuple, TargetInject, } from "./inject.js";
 export { DEFAULT_POOLS, World, type WorldOptions } from "./world/index.js";
 export { Filter } from "./filter.js";
-export { ChildOf, Relationship, SilenceSource } from "./relationship.js";
-export { CleanupPolicy, Component, type ComponentInstance, type ComponentClass, type ComponentMeta, type ComponentRef, } from "./component.js";
-export { Entity, type EntityClass, Identity } from "./entity/index.js";
+export { ChildOf, SilenceSource } from "./modules/relationships.js";
+export { CleanupPolicy, Component, Relationship, type ComponentInstance, type ComponentClass, type ComponentMeta, type ComponentRef, } from "./component.js";
+export { Entity, type EID, type EntityClass, Identity } from "./entity/index.js";
 export { Module } from "./module.js";
 export { IdentityModule } from "./modules/identity.js";
 export { Singleton, SingletonModule } from "./modules/singleton.js";
+export { Traversable, RelationshipsModule } from "./modules/relationships.js";
 export { type IPhase } from "./phase.js";
 export { getDSLKey } from "./dsl.js";
 export { Term, TermEventKind, type TermConsumer } from "./terms/term.js";

package/dist/index.js

@@ -1,13 +1,15 @@
 export { System } from "./system.js";
-export { Query, GroupedQuery, Group, Iter, } from "./query/index.js";
+export { Query, GroupedQuery, Group } from "./query/index.js";
+export { Iter } from "./inject.js";
 export { DEFAULT_POOLS, World } from "./world/index.js";
 export { Filter } from "./filter.js";
-export { ChildOf, Relationship, SilenceSource } from "./relationship.js";
-export { CleanupPolicy, Component, } from "./component.js";
+export { ChildOf, SilenceSource } from "./modules/relationships.js";
+export { CleanupPolicy, Component, Relationship, } from "./component.js";
 export { Entity, Identity } from "./entity/index.js";
 export { Module } from "./module.js";
 export { IdentityModule } from "./modules/identity.js";
 export { Singleton, SingletonModule } from "./modules/singleton.js";
+export { Traversable, RelationshipsModule } from "./modules/relationships.js";
 export { getDSLKey } from "./dsl.js";
 export { Term } from "./terms/term.js";
 export { IntervalTickSource, RateTickSource } from "./timer.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,KAAK,EACL,YAAY,EACZ,KAAK,EACL,IAAI,GAYL,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,KAAK,EAAqB,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,aAAa,EACb,SAAS,GAKV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,MAAM,EAAoB,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,IAAI,EAAoC,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,4BAA4B,EAAqB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAWnC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAqB,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EACL,aAAa,EACb,SAAS,EACT,YAAY,GAKb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,MAAM,EAA8B,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAE9E,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,IAAI,EAAoC,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,4BAA4B,EAAqB,MAAM,mBAAmB,CAAC"}

package/dist/inject.d.ts

@@ -1,29 +1,29 @@
 import { type ComponentInstance, type ComponentRef, type ComponentType } from "./component.js";
-import { Entity } from "./entity/index.js";
+import { Entity, type EID } from "./entity/index.js";
 import { type World } from "./world/index.js";
 import { type MaybeRequired } from "./dsl.js";
-export type UpInject<J extends readonly ComponentType[] = readonly ComponentType[]> = {
-    up: readonly [ComponentRef, readonly [...J]];
+export type TargetInject<J extends readonly ComponentType[] = readonly ComponentType[]> = {
+    target: readonly [ComponentRef, readonly [...J]];
 };
 export type DownInject<J extends readonly ComponentType[] = readonly ComponentType[]> = {
     down: readonly [ComponentRef, readonly [...J]];
 };
-export type InjectElement = ComponentType | UpInject;
+export type InjectElement = ComponentType | TargetInject;
 export type InjectTuple = readonly InjectElement[];
 export type FanInjectElement = InjectElement | DownInject;
 export type FanInjectTuple = readonly FanInjectElement[];
-export type ResolvedInjectTerm = number | {
-    up: readonly [number, readonly number[]];
+export type ResolvedInjectTerm = EID | {
+    target: readonly [EID, readonly EID[]];
 } | {
-    down: readonly [number, readonly number[]];
+    down: readonly [EID, readonly EID[]];
 };
 /** Resolves the component instance type for one injected component class. */
 type ResolvedComponentInstance<T> = T extends ComponentType ? InstanceType<T> : never;
 type OptionalResolvedComponentInstances<J extends readonly ComponentType[]> = {
     [K in keyof J]: InstanceType<J[K]> | undefined;
 };
-type MaybeResolvedInjectElement<T, R extends ComponentType[]> = T extends ComponentType ? [MaybeRequired<T, R>] : T extends UpInject<infer J> ? OptionalResolvedComponentInstances<J> : T extends DownInject<infer J> ? OptionalResolvedComponentInstances<J> : [];
-type RequiredResolvedInjectElement<T> = T extends ComponentType ? [ResolvedComponentInstance<T>] : T extends UpInject<infer J> ? OptionalResolvedComponentInstances<J> : T extends DownInject<infer J> ? OptionalResolvedComponentInstances<J> : [];
+type MaybeResolvedInjectElement<T, R extends ComponentType[]> = T extends ComponentType ? [MaybeRequired<T, R>] : T extends TargetInject<infer J> ? OptionalResolvedComponentInstances<J> : T extends DownInject<infer J> ? OptionalResolvedComponentInstances<J> : [];
+type RequiredResolvedInjectElement<T> = T extends ComponentType ? [ResolvedComponentInstance<T>] : T extends TargetInject<infer J> ? OptionalResolvedComponentInstances<J> : T extends DownInject<infer J> ? OptionalResolvedComponentInstances<J> : [];
 export type MaybeResolvedInjectTuple<J extends FanInjectTuple, R extends ComponentType[]> = J extends readonly [infer First, ...infer Rest extends FanInjectTuple] ? [...MaybeResolvedInjectElement<First, R>, ...MaybeResolvedInjectTuple<Rest, R>] : [];
 export type RequiredResolvedInjectTuple<J extends InjectTuple> = J extends readonly [
     infer First,
@@ -31,16 +31,16 @@ export type RequiredResolvedInjectTuple<J extends InjectTuple> = J extends reado
 ] ? [...RequiredResolvedInjectElement<First>, ...RequiredResolvedInjectTuple<Rest>] : [];
 export declare function mapInject(world: World, inject: readonly FanInjectElement[]): ResolvedInjectTerm[];
 export declare function injectArity(inject: readonly ResolvedInjectTerm[]): number;
-export declare function getInjected(e: Entity, inject: readonly ResolvedInjectTerm[], requireDirectComponents: boolean, out: (ComponentInstance | undefined)[], exitSnapshot?: Map<number, ComponentInstance>): void;
-export declare function getInjectedWithSrc(e: Entity, inject: readonly ResolvedInjectTerm[], out: (ComponentInstance | undefined)[], src: (Entity | undefined)[], requireDirectComponents?: boolean, exitSnapshot?: Map<number, ComponentInstance>): void;
-export declare function directInjectEids(inject: readonly ResolvedInjectTerm[]): number[];
+export declare function getInjected(e: Entity, inject: readonly ResolvedInjectTerm[], requireDirectComponents: boolean, out: (ComponentInstance | undefined)[], exitSnapshot?: Map<EID, ComponentInstance>): void;
+export declare function getInjectedWithSrc(e: Entity, inject: readonly ResolvedInjectTerm[], out: (ComponentInstance | undefined)[], src: (Entity | undefined)[], requireDirectComponents?: boolean, exitSnapshot?: Map<EID, ComponentInstance>): void;
+export declare function directInjectEids(inject: readonly ResolvedInjectTerm[]): EID[];
 /**
  * Per-iteration cursor passed to `each` / `forEach` / `enter` / `exit` /
- * `update` / `sort` callbacks when the caller opts in by passing `Iter` as
+ * `update` / `orderBy` callbacks when the caller opts in by passing `Iter` as
  * the first argument:
  *
  * ```ts
- * system.each(Iter, [Body, { up: [ChildOf, [Position]] }], (it, [body, pos]) => {
+ * system.each(Iter, [Body, { target: [ChildOf, [Position]] }], (it, [body, pos]) => {
  *   it.entity;  // the visited entity
  *   it.src[0];  // entity `body` was read from (the visited entity)
  *   it.src[1];  // entity `pos` was read from (the ChildOf target), or undefined
@@ -57,9 +57,10 @@ export declare class Iter {
     entity: Entity;
     /**
      * Source entity for each injected component, in the same order as the
-     * resolved tuple: the visited entity for a directly-injected component, or
-     * the relationship target for an `up`-injected one (`undefined` when the
-     * entity has no such relationship or target).
+     * resolved tuple: the visited entity for a directly-injected component, the
+     * relationship target for a `target`-injected one, or the specific child for
+     * a `down`-injected one (`undefined` when the entity has no such relationship,
+     * target, or — for `down` — when the slot is unfilled).
      */
     readonly src: (Entity | undefined)[];
     constructor(arity: number);

package/dist/inject.js

@@ -1,16 +1,19 @@
 import { Entity } from "./entity/index.js";
 import { _resolveRelationship } from "./dsl.js";
-function _isUpInject(value) {
-    return typeof value === "object" && value !== null && "up" in value;
+function _isTargetInject(value) {
+    return typeof value === "object" && value !== null && "target" in value;
 }
 function _isDownInject(value) {
     return typeof value === "object" && value !== null && "down" in value;
 }
 export function mapInject(world, inject) {
     return inject.map((term) => {
-        if (_isUpInject(term)) {
+        if (_isTargetInject(term)) {
             return {
-                up: [_resolveRelationship(term.up[0], world), term.up[1].map((C) => world.entity(C).eid)],
+                target: [
+                    _resolveRelationship(term.target[0], world),
+                    term.target[1].map((C) => world.entity(C).eid),
+                ],
             };
         }
         if (_isDownInject(term)) {
@@ -27,7 +30,8 @@ export function mapInject(world, inject) {
 export function injectArity(inject) {
     let arity = 0;
     inject.forEach((term) => {
-        arity += typeof term === "number" ? 1 : "up" in term ? term.up[1].length : term.down[1].length;
+        arity +=
+            typeof term === "number" ? 1 : "target" in term ? term.target[1].length : term.down[1].length;
     });
     return arity;
 }
@@ -45,12 +49,12 @@ export function getInjected(e, inject, requireDirectComponents, out, exitSnapsho
         if ("down" in term) {
             throw new Error("down injection is only supported in each/forEach");
         }
-        const target = e.componentBitmask.has(term.up[0])
-            ? e._get(term.up[0])?.target
+        const targetEntity = e.has(term.target[0])
+            ? e._get(term.target[0])?.target
             : undefined;
-        term.up[1].forEach((componentEid) => {
-            out[outIndex++] = target?.componentBitmask.has(componentEid)
-                ? target._get(componentEid)
+        term.target[1].forEach((componentEid) => {
+            out[outIndex++] = targetEntity?.has(componentEid)
+                ? targetEntity._get(componentEid)
                 : undefined;
         });
     });
@@ -71,14 +75,12 @@ export function getInjectedWithSrc(e, inject, out, src, requireDirectComponents
         if ("down" in term) {
             throw new Error("down injection is only supported in each/forEach");
         }
-        const target = e.componentBitmask.has(term.up[0])
-            ? e._get(term.up[0])?.target
+        const targetEntity = e.has(term.target[0])
+            ? e._get(term.target[0])?.target
             : undefined;
-        term.up[1].forEach((componentEid) => {
-            out[outIndex] = target?.componentBitmask.has(componentEid)
-                ? target._get(componentEid)
-                : undefined;
-            src[outIndex] = target;
+        term.target[1].forEach((componentEid) => {
+            out[outIndex] = targetEntity?.has(componentEid) ? targetEntity._get(componentEid) : undefined;
+            src[outIndex] = targetEntity;
             outIndex++;
         });
     });
@@ -88,11 +90,11 @@ export function directInjectEids(inject) {
 }
 /**
  * Per-iteration cursor passed to `each` / `forEach` / `enter` / `exit` /
- * `update` / `sort` callbacks when the caller opts in by passing `Iter` as
+ * `update` / `orderBy` callbacks when the caller opts in by passing `Iter` as
  * the first argument:
  *
  * ```ts
- * system.each(Iter, [Body, { up: [ChildOf, [Position]] }], (it, [body, pos]) => {
+ * system.each(Iter, [Body, { target: [ChildOf, [Position]] }], (it, [body, pos]) => {
  *   it.entity;  // the visited entity
  *   it.src[0];  // entity `body` was read from (the visited entity)
  *   it.src[1];  // entity `pos` was read from (the ChildOf target), or undefined
@@ -200,8 +202,8 @@ function _findSingleDownInject(inject) {
             slot++;
             return;
         }
-        if ("up" in term) {
-            slot += term.up[1].length;
+        if ("target" in term) {
+            slot += term.target[1].length;
             return;
         }
         if (found !== undefined) {
@@ -215,7 +217,7 @@ function _findSingleDownInject(inject) {
 function fillDownInject(child, componentEids, slot, out, src) {
     componentEids.forEach((componentEid, offset) => {
         const outIndex = slot + offset;
-        out[outIndex] = child.componentBitmask.has(componentEid) ? child._get(componentEid) : undefined;
+        out[outIndex] = child.has(componentEid) ? child._get(componentEid) : undefined;
         if (src) {
             src[outIndex] = child;
         }
@@ -232,12 +234,12 @@ function getInjectedSkippingDown(e, inject, out) {
             outIndex += term.down[1].length;
             return;
         }
-        const target = e.componentBitmask.has(term.up[0])
-            ? e._get(term.up[0])?.target
+        const targetEntity = e.has(term.target[0])
+            ? e._get(term.target[0])?.target
             : undefined;
-        term.up[1].forEach((componentEid) => {
-            out[outIndex++] = target?.componentBitmask.has(componentEid)
-                ? target._get(componentEid)
+        term.target[1].forEach((componentEid) => {
+            out[outIndex++] = targetEntity?.has(componentEid)
+                ? targetEntity._get(componentEid)
                 : undefined;
         });
     });
@@ -255,14 +257,12 @@ function getInjectedWithSrcSkippingDown(e, inject, out, src) {
             outIndex += term.down[1].length;
             return;
         }
-        const target = e.componentBitmask.has(term.up[0])
-            ? e._get(term.up[0])?.target
+        const targetEntity = e.has(term.target[0])
+            ? e._get(term.target[0])?.target
             : undefined;
-        term.up[1].forEach((componentEid) => {
-            out[outIndex] = target?.componentBitmask.has(componentEid)
-                ? target._get(componentEid)
-                : undefined;
-            src[outIndex] = target;
+        term.target[1].forEach((componentEid) => {
+            out[outIndex] = targetEntity?.has(componentEid) ? targetEntity._get(componentEid) : undefined;
+            src[outIndex] = targetEntity;
             outIndex++;
         });
     });