koota 0.6.2 → 0.6.4

package/README.md

@@ -91,10 +91,10 @@ function RocketView({ entity }) {
 Use actions to safely modify Koota from inside of React in either effects or events.
 
 ```js
-import { defineActions } from 'koota'
+import { createActions } from 'koota'
 import { useActions } from 'koota/react'
 
-const actions = defineActions((world) => ({
+const actions = createActions((world) => ({
   spawnShip: (position) => world.spawn(Position(position), Velocity),
   destroyAllShips: () => {
     world.query(Position, Velocity).forEach((entity) => {
@@ -136,7 +136,7 @@ useEffect(() => {
 
 ### Relations
 
-Koota supports relations between entities using the `relation` function. Relations allow you to create connections between entities and query them efficiently.
+Koota supports relations between entities using the `relation` function. Relations allow you to build graphs by creating connections between entities with efficient queries.
 
 ```js
 const ChildOf = relation()
@@ -147,6 +147,24 @@ const child = world.spawn(ChildOf(parent))
 const entity = world.queryFirst(ChildOf(parent)) // Returns child
 ```
 
+A relation is typically owned by the entity that needs to express it. The **source** is the entity that has the relation added, and the **target** is the entity it points to.
+
+```mermaid
+flowchart BT
+    subgraph Parent
+    end
+    subgraph childA["Child"]
+        COA["ChildOf(Parent)"]
+    end
+    subgraph childB["Child"]
+        COB["ChildOf(Parent)"]
+    end
+    COA --> Parent
+    COB --> Parent
+```
+
+In `child.add(ChildOf(parent))`, child is the source and parent is the target. This design means the parent doesn't need to know about its children, instead children care about their parent, optimzing batch queries.
+
 #### With data
 
 Relations can contain data like any trait.
@@ -167,12 +185,14 @@ inventory.set(Contains(gold), { amount: 20 })
 const data = inventory.get(Contains(gold)) // { amount: 20 }
 ```
 
-#### Auto remove target
+#### Auto destroy
 
-Relations can automatically remove target entities and their descendants.
+Relations can automatically destroy related entities when their counterpart is destroyed using the `autoDestroy` option.
+
+**Destroy orphans.** When a target is destroyed, destroy all sources pointing to it. This is commonly used for hierarchies when you want to clean up any detached graphs. It can be enabled with the `'orphan'` or `'source'` option.
 
 ```js
-const ChildOf = relation({ autoRemoveTarget: true })
+const ChildOf = relation({ autoDestroy: 'orphan' }) // Or 'source'
 
 const parent = world.spawn()
 const child = world.spawn(ChildOf(parent))
@@ -183,6 +203,21 @@ parent.destroy()
 world.has(child) // False, the child and grandchild are destroyed too
 ```
 
+**Destroy targets.** When a source is destroyed, destroy all its targets.
+
+```js
+const Contains = relation({ autoDestroy: 'target' })
+
+const container = world.spawn()
+const itemA = world.spawn()
+const itemB = world.spawn()
+
+container.add(Contains(itemA), Contains(itemB))
+container.destroy()
+
+world.has(itemA) // False, items are destroyed with container
+```
+
 #### Exclusive relations
 
 Exclusive relations ensure each entity can only have one target.
@@ -206,7 +241,27 @@ hero.has(Targeting(goblin)) // True
 > ⚠️ **Experimental**<br>
 > This API is experimental and may change in future versions. Please provide feedback on GitHub or Discord.
 
-Ordered relations maintain a list of related entities with bidirectional sync.
+Ordered relations maintain a list of related entities with
+bidirectional sync.
+
+A query like `world.query(ChildOf(parent))` returns a flat list of children without any ordering. If you need an ordered list, you'd have to store an order field and sort every time you query.
+
+An ordered relation solves this by caching the order on the target. It's a trait added to the parent that maintains a view of all entities targeting it.
+
+```mermaid
+flowchart BT
+    subgraph Parent
+        OC["OrderedChildren → [Child B, Child A]"]
+    end
+    subgraph childA["Child A"]
+        COA["ChildOf(Parent)"]
+    end
+    subgraph childB["Child B"]
+        COB["ChildOf(Parent)"]
+    end
+    COA --> Parent
+    COB --> Parent
+```
 
 ```js
 import { relation, ordered } from 'koota'
@@ -227,7 +282,7 @@ child2.add(ChildOf(parent)) // child2 automatically added to list
 Ordered relations support array methods like `push()`, `pop()`, `shift()`, `unshift()`, and `splice()`, plus special methods `moveTo()` and `insert()` for precise control. Changes to the list automatically sync with relations, and vice versa.
 
 > ⚠️ **Performance note**<br>
-> Ordered relations are more expensive to update than regular relations but enable faster traversal when order matters. Use them only when entity order is essential.
+> Ordered relations requires additional bookkeeping where the cost of ordering is paid during structural changes (add, remove, move) instead of at query time. Use ordered relations only when entity order is essential or when hierarchical search (looping over children) is necessary.
 
 #### Querying relations
 
@@ -1106,11 +1161,11 @@ function InventoryDisplay({ entity }) {
 
 ### `useActions`
 
-Returns actions bound to the world that is in context. Use actions created by `defineActions`.
+Returns actions bound to the world that is in context. Use actions created by `createActions`.
 
 ```js
 // Create actions
-const actions = defineActions((world) => ({
+const actions = createActions((world) => ({
     spawnPlayer: () => world.spawn(IsPlayer).
     destroyAllPlayers: () => {
         world.query(IsPlayer).forEach((player) => {

package/dist/{chunk-URTUZC7P.js → chunk-QE3Q3CT7.js}

@@ -414,12 +414,14 @@ var OrderedList = class extends Array {
   world;
   parent;
   relation;
+  orderedTrait;
   _syncing = false;
-  constructor(world, parent, relation2, items = []) {
+  constructor(world, parent, relation2, orderedTrait, items = []) {
     super(...items);
     this.world = world;
     this.parent = parent;
     this.relation = relation2;
+    this.orderedTrait = orderedTrait;
   }
   get [Symbol.toStringTag]() {
     return "OrderedList";
@@ -433,7 +435,9 @@ var OrderedList = class extends Array {
       for (const item of items) {
         addTrait(this.world, item, this.relation(this.parent));
       }
-      return super.push(...items);
+      const result = super.push(...items);
+      setChanged(this.world, this.parent, this.orderedTrait);
+      return result;
     } finally {
       this._syncing = false;
     }
@@ -447,6 +451,7 @@ var OrderedList = class extends Array {
       const item = super.pop();
       if (item !== void 0) {
         removeTrait(this.world, item, this.relation(this.parent));
+        setChanged(this.world, this.parent, this.orderedTrait);
       }
       return item;
     } finally {
@@ -462,6 +467,7 @@ var OrderedList = class extends Array {
       const item = super.shift();
       if (item !== void 0) {
         removeTrait(this.world, item, this.relation(this.parent));
+        setChanged(this.world, this.parent, this.orderedTrait);
       }
       return item;
     } finally {
@@ -477,7 +483,9 @@ var OrderedList = class extends Array {
       for (const item of items) {
         addTrait(this.world, item, this.relation(this.parent));
       }
-      return super.unshift(...items);
+      const result = super.unshift(...items);
+      setChanged(this.world, this.parent, this.orderedTrait);
+      return result;
     } finally {
       this._syncing = false;
     }
@@ -495,6 +503,9 @@ var OrderedList = class extends Array {
       for (const item of items) {
         addTrait(this.world, item, this.relation(this.parent));
       }
+      if (removed.length > 0 || items.length > 0) {
+        setChanged(this.world, this.parent, this.orderedTrait);
+      }
       return removed;
     } finally {
       this._syncing = false;
@@ -505,6 +516,7 @@ var OrderedList = class extends Array {
    */
   sort(compareFn) {
     super.sort(compareFn);
+    setChanged(this.world, this.parent, this.orderedTrait);
     return this;
   }
   /**
@@ -512,6 +524,7 @@ var OrderedList = class extends Array {
    */
   reverse() {
     super.reverse();
+    setChanged(this.world, this.parent, this.orderedTrait);
     return this;
   }
   /**
@@ -544,6 +557,7 @@ var OrderedList = class extends Array {
     if (fromIndex === toIndex) return;
     super.splice(fromIndex, 1);
     super.splice(toIndex, 0, item);
+    setChanged(this.world, this.parent, this.orderedTrait);
   }
   /**
    * Insert an entity at a specific index and add its relation pair.
@@ -553,6 +567,7 @@ var OrderedList = class extends Array {
     try {
       addTrait(this.world, item, this.relation(this.parent));
       super.splice(index, 0, item);
+      setChanged(this.world, this.parent, this.orderedTrait);
     } finally {
       this._syncing = false;
     }
@@ -564,6 +579,7 @@ var OrderedList = class extends Array {
   _appendWithoutSync(item) {
     if (!this._syncing) {
       super.push(item);
+      setChanged(this.world, this.parent, this.orderedTrait);
     }
   }
   /**
@@ -575,6 +591,7 @@ var OrderedList = class extends Array {
       const index = this.indexOf(item);
       if (index !== -1) {
         super.splice(index, 1);
+        setChanged(this.world, this.parent, this.orderedTrait);
       }
     }
   }
@@ -739,17 +756,17 @@ function registerTrait(world, trait2) {
   ctx.traitInstances[traitId_1_$f] = data;
   world.traits.add(trait2);
   if (traitCtx.relation) ctx.relations.add(traitCtx.relation);
-  if ($orderedTargetsTrait in trait2) setupOrderedTraitSync(world, trait2);
-  const ctx_3_$f = world[$internal];
-  ctx_3_$f.bitflag *= 2;
-  if (ctx_3_$f.bitflag >= 2 ** 31) {
-    ctx_3_$f.bitflag = 1;
-    ctx_3_$f.entityMasks.push([]);
+  const ctx_2_$f = world[$internal];
+  ctx_2_$f.bitflag *= 2;
+  if (ctx_2_$f.bitflag >= 2 ** 31) {
+    ctx_2_$f.bitflag = 1;
+    ctx_2_$f.entityMasks.push([]);
   }
+  if ($orderedTargetsTrait in trait2) setupOrderedTraitSync(world, trait2);
 }
 function getOrderedTrait(world, entity, trait2) {
   const relation2 = trait2[$orderedTargetsTrait].relation;
-  return new OrderedList(world, entity, relation2);
+  return new OrderedList(world, entity, relation2, trait2);
 }
 function addTrait(world, entity, ...traits) {
   for (let i = 0; i < traits.length; i++) {
@@ -1200,10 +1217,20 @@ function createRelation(definition) {
   const relationTrait = trait(definition?.store ?? {});
   const traitCtx = relationTrait[$internal];
   traitCtx.relation = null;
+  let autoDestroy = false;
+  if (definition?.autoDestroy === "orphan" || definition?.autoDestroy === "source") {
+    autoDestroy = "source";
+  } else if (definition?.autoDestroy === "target") {
+    autoDestroy = "target";
+  }
+  if (definition?.autoRemoveTarget) {
+    console.warn(`Koota: 'autoRemoveTarget' is deprecated. Use 'autoDestroy: "orphan"' instead.`);
+    autoDestroy = "source";
+  }
   const relationCtx = {
     trait: relationTrait,
     exclusive: definition?.exclusive ?? false,
-    autoRemoveTarget: definition?.autoRemoveTarget ?? false
+    autoDestroy
   };
   function relationFn(target, params) {
     if (target === void 0) throw Error("Relation target is undefined");
@@ -2117,10 +2144,10 @@ function createQueryInstance(world, parameters) {
               traitMatches = (oldMask & bitflag) === 0 && (currentMask & bitflag) === bitflag;
               break;
             case "remove":
-              traitMatches = (oldMask & bitflag) === bitflag && (currentMask & bitflag) === 0 || (oldMask & bitflag) === 0 && (currentMask & bitflag) === 0 && (dirtyMask[generationId][eid] & bitflag) === bitflag;
+              traitMatches = (oldMask & bitflag) === bitflag && (currentMask & bitflag) === 0 || (oldMask & bitflag) === 0 && (currentMask & bitflag) === 0 && ((dirtyMask[generationId]?.[eid] ?? 0) & bitflag) === bitflag;
               break;
             case "change":
-              traitMatches = (changedMask[generationId][eid] & bitflag) === bitflag;
+              traitMatches = ((changedMask[generationId]?.[eid] ?? 0) & bitflag) === bitflag;
               break;
           }
           if (!traitMatches) {
@@ -2147,9 +2174,7 @@ var queryId = 0;
 function createQuery(...parameters) {
   const hash = createQueryHash(parameters);
   const existing = universe.cachedQueries.get(hash);
-  if (existing) {
-    return existing;
-  }
+  if (existing) return existing;
   const id = queryId++;
   const queryRef = Object.freeze({
     [$queryRef]: true,
@@ -2335,12 +2360,35 @@ function destroyEntity(world, entity) {
     if (processedEntities.has(currentEntity)) continue;
     processedEntities.add(currentEntity);
     for (const relation2 of ctx.relations) {
-      const subjects = getEntitiesWithRelationTo(world, relation2, currentEntity);
-      for (const subject of subjects) {
-        if (!world.has(subject)) continue;
-        const relationCtx = relation2[$internal];
-        cleanupRelationTarget(world, relation2, subject, currentEntity);
-        if (relationCtx.autoRemoveTarget) entityQueue.push(subject);
+      const relationCtx = relation2[$internal];
+      const sources = getEntitiesWithRelationTo(world, relation2, currentEntity);
+      for (const source of sources) {
+        if (!world.has(source)) continue;
+        cleanupRelationTarget(world, relation2, source, currentEntity);
+        if (relationCtx.autoDestroy === "source") entityQueue.push(source);
+      }
+      if (relationCtx.autoDestroy === "target") {
+        let result_getRelationTargets_1_$f;
+        const ctx_1_$f = world[$internal];
+        const relationCtx_1_$f = relation2[$internal];
+        const traitData_1_$f = ctx_1_$f.traitInstances[relationCtx_1_$f.trait.id];
+        if (!traitData_1_$f || !traitData_1_$f.relationTargets) {
+          result_getRelationTargets_1_$f = [];
+        } else {
+          const eid_1_$f = currentEntity & ENTITY_ID_MASK;
+          if (relationCtx_1_$f.exclusive) {
+            const target_1_$f = traitData_1_$f.relationTargets[eid_1_$f];
+            result_getRelationTargets_1_$f = target_1_$f !== void 0 ? [target_1_$f] : [];
+          } else {
+            const targets_1_$f = traitData_1_$f.relationTargets[eid_1_$f];
+            result_getRelationTargets_1_$f = targets_1_$f !== void 0 ? targets_1_$f.slice() : [];
+          }
+        }
+        const targets = result_getRelationTargets_1_$f;
+        for (const target of targets) {
+          if (!world.has(target)) continue;
+          if (!processedEntities.has(target)) entityQueue.push(target);
+        }
       }
     }
     const entityTraits = ctx.entityTraits.get(currentEntity);
@@ -2364,6 +2412,7 @@ function destroyEntity(world, entity) {
 function createWorld(optionsOrFirstTrait, ...traits) {
   const id = allocateWorldId(universe.worldIndex);
   let isInitialized = false;
+  let lazyTraits;
   const world = {
     [$internal]: {
       entityIndex: createEntityIndex(id),
@@ -2396,6 +2445,10 @@ function createWorld(optionsOrFirstTrait, ...traits) {
       }
       const traitId_0_$f = IsExcluded.id;
       if (!(traitId_0_$f < ctx.traitInstances.length && ctx.traitInstances[traitId_0_$f] !== void 0)) registerTrait(world, IsExcluded);
+      if (lazyTraits) {
+        initTraits = lazyTraits;
+        lazyTraits = void 0;
+      }
       ctx.worldEntity = createEntity(world, IsExcluded, ...initTraits);
     },
     spawn(...spawnTraits) {
@@ -2433,6 +2486,7 @@ function createWorld(optionsOrFirstTrait, ...traits) {
       universe.worlds[id] = null;
     },
     reset() {
+      lazyTraits = void 0;
       const ctx = world[$internal];
       world.entities.forEach((entity) => {
         if (world.has(entity)) {
@@ -2602,7 +2656,11 @@ function createWorld(optionsOrFirstTrait, ...traits) {
       traits: optionTraits = [],
       lazy = false
     } = optionsOrFirstTrait;
-    if (!lazy) world.init(...optionTraits);
+    if (!lazy) {
+      world.init(...optionTraits);
+    } else {
+      lazyTraits = optionTraits;
+    }
   } else {
     world.init(...optionsOrFirstTrait ? [optionsOrFirstTrait, ...traits] : traits);
   }

package/dist/index.cjs

@@ -227,10 +227,20 @@ function createRelation(definition) {
   const relationTrait = trait(definition?.store ?? {});
   const traitCtx = relationTrait[$internal];
   traitCtx.relation = null;
+  let autoDestroy = false;
+  if (definition?.autoDestroy === "orphan" || definition?.autoDestroy === "source") {
+    autoDestroy = "source";
+  } else if (definition?.autoDestroy === "target") {
+    autoDestroy = "target";
+  }
+  if (definition?.autoRemoveTarget) {
+    console.warn(`Koota: 'autoRemoveTarget' is deprecated. Use 'autoDestroy: "orphan"' instead.`);
+    autoDestroy = "source";
+  }
   const relationCtx = {
     trait: relationTrait,
     exclusive: definition?.exclusive ?? false,
-    autoRemoveTarget: definition?.autoRemoveTarget ?? false
+    autoDestroy
   };
   function relationFn(target, params) {
     if (target === void 0) throw Error("Relation target is undefined");
@@ -679,12 +689,14 @@ var OrderedList = class extends Array {
   world;
   parent;
   relation;
+  orderedTrait;
   _syncing = false;
-  constructor(world, parent, relation2, items = []) {
+  constructor(world, parent, relation2, orderedTrait, items = []) {
     super(...items);
     this.world = world;
     this.parent = parent;
     this.relation = relation2;
+    this.orderedTrait = orderedTrait;
   }
   get [Symbol.toStringTag]() {
     return "OrderedList";
@@ -698,7 +710,9 @@ var OrderedList = class extends Array {
       for (const item of items) {
         addTrait(this.world, item, this.relation(this.parent));
       }
-      return super.push(...items);
+      const result = super.push(...items);
+      setChanged(this.world, this.parent, this.orderedTrait);
+      return result;
     } finally {
       this._syncing = false;
     }
@@ -712,6 +726,7 @@ var OrderedList = class extends Array {
       const item = super.pop();
       if (item !== void 0) {
         removeTrait(this.world, item, this.relation(this.parent));
+        setChanged(this.world, this.parent, this.orderedTrait);
       }
       return item;
     } finally {
@@ -727,6 +742,7 @@ var OrderedList = class extends Array {
       const item = super.shift();
       if (item !== void 0) {
         removeTrait(this.world, item, this.relation(this.parent));
+        setChanged(this.world, this.parent, this.orderedTrait);
       }
       return item;
     } finally {
@@ -742,7 +758,9 @@ var OrderedList = class extends Array {
       for (const item of items) {
         addTrait(this.world, item, this.relation(this.parent));
       }
-      return super.unshift(...items);
+      const result = super.unshift(...items);
+      setChanged(this.world, this.parent, this.orderedTrait);
+      return result;
     } finally {
       this._syncing = false;
     }
@@ -760,6 +778,9 @@ var OrderedList = class extends Array {
       for (const item of items) {
         addTrait(this.world, item, this.relation(this.parent));
       }
+      if (removed.length > 0 || items.length > 0) {
+        setChanged(this.world, this.parent, this.orderedTrait);
+      }
       return removed;
     } finally {
       this._syncing = false;
@@ -770,6 +791,7 @@ var OrderedList = class extends Array {
    */
   sort(compareFn) {
     super.sort(compareFn);
+    setChanged(this.world, this.parent, this.orderedTrait);
     return this;
   }
   /**
@@ -777,6 +799,7 @@ var OrderedList = class extends Array {
    */
   reverse() {
     super.reverse();
+    setChanged(this.world, this.parent, this.orderedTrait);
     return this;
   }
   /**
@@ -809,6 +832,7 @@ var OrderedList = class extends Array {
     if (fromIndex === toIndex) return;
     super.splice(fromIndex, 1);
     super.splice(toIndex, 0, item);
+    setChanged(this.world, this.parent, this.orderedTrait);
   }
   /**
    * Insert an entity at a specific index and add its relation pair.
@@ -818,6 +842,7 @@ var OrderedList = class extends Array {
     try {
       addTrait(this.world, item, this.relation(this.parent));
       super.splice(index, 0, item);
+      setChanged(this.world, this.parent, this.orderedTrait);
     } finally {
       this._syncing = false;
     }
@@ -829,6 +854,7 @@ var OrderedList = class extends Array {
   _appendWithoutSync(item) {
     if (!this._syncing) {
       super.push(item);
+      setChanged(this.world, this.parent, this.orderedTrait);
     }
   }
   /**
@@ -840,6 +866,7 @@ var OrderedList = class extends Array {
       const index = this.indexOf(item);
       if (index !== -1) {
         super.splice(index, 1);
+        setChanged(this.world, this.parent, this.orderedTrait);
       }
     }
   }
@@ -1004,17 +1031,17 @@ function registerTrait(world, trait2) {
   ctx.traitInstances[traitId_1_$f] = data;
   world.traits.add(trait2);
   if (traitCtx.relation) ctx.relations.add(traitCtx.relation);
-  if ($orderedTargetsTrait in trait2) setupOrderedTraitSync(world, trait2);
-  const ctx_3_$f = world[$internal];
-  ctx_3_$f.bitflag *= 2;
-  if (ctx_3_$f.bitflag >= 2 ** 31) {
-    ctx_3_$f.bitflag = 1;
-    ctx_3_$f.entityMasks.push([]);
+  const ctx_2_$f = world[$internal];
+  ctx_2_$f.bitflag *= 2;
+  if (ctx_2_$f.bitflag >= 2 ** 31) {
+    ctx_2_$f.bitflag = 1;
+    ctx_2_$f.entityMasks.push([]);
   }
+  if ($orderedTargetsTrait in trait2) setupOrderedTraitSync(world, trait2);
 }
 function getOrderedTrait(world, entity, trait2) {
   const relation2 = trait2[$orderedTargetsTrait].relation;
-  return new OrderedList(world, entity, relation2);
+  return new OrderedList(world, entity, relation2, trait2);
 }
 function addTrait(world, entity, ...traits) {
   for (let i = 0; i < traits.length; i++) {
@@ -2162,10 +2189,10 @@ function createQueryInstance(world, parameters) {
               traitMatches = (oldMask & bitflag) === 0 && (currentMask & bitflag) === bitflag;
               break;
             case "remove":
-              traitMatches = (oldMask & bitflag) === bitflag && (currentMask & bitflag) === 0 || (oldMask & bitflag) === 0 && (currentMask & bitflag) === 0 && (dirtyMask[generationId][eid] & bitflag) === bitflag;
+              traitMatches = (oldMask & bitflag) === bitflag && (currentMask & bitflag) === 0 || (oldMask & bitflag) === 0 && (currentMask & bitflag) === 0 && ((dirtyMask[generationId]?.[eid] ?? 0) & bitflag) === bitflag;
               break;
             case "change":
-              traitMatches = (changedMask[generationId][eid] & bitflag) === bitflag;
+              traitMatches = ((changedMask[generationId]?.[eid] ?? 0) & bitflag) === bitflag;
               break;
           }
           if (!traitMatches) {
@@ -2192,9 +2219,7 @@ var queryId = 0;
 function createQuery(...parameters) {
   const hash = createQueryHash(parameters);
   const existing = universe.cachedQueries.get(hash);
-  if (existing) {
-    return existing;
-  }
+  if (existing) return existing;
   const id = queryId++;
   const queryRef = Object.freeze({
     [$queryRef]: true,
@@ -2380,12 +2405,35 @@ function destroyEntity(world, entity) {
     if (processedEntities.has(currentEntity)) continue;
     processedEntities.add(currentEntity);
     for (const relation2 of ctx.relations) {
-      const subjects = getEntitiesWithRelationTo(world, relation2, currentEntity);
-      for (const subject of subjects) {
-        if (!world.has(subject)) continue;
-        const relationCtx = relation2[$internal];
-        cleanupRelationTarget(world, relation2, subject, currentEntity);
-        if (relationCtx.autoRemoveTarget) entityQueue.push(subject);
+      const relationCtx = relation2[$internal];
+      const sources = getEntitiesWithRelationTo(world, relation2, currentEntity);
+      for (const source of sources) {
+        if (!world.has(source)) continue;
+        cleanupRelationTarget(world, relation2, source, currentEntity);
+        if (relationCtx.autoDestroy === "source") entityQueue.push(source);
+      }
+      if (relationCtx.autoDestroy === "target") {
+        let result_getRelationTargets_1_$f;
+        const ctx_1_$f = world[$internal];
+        const relationCtx_1_$f = relation2[$internal];
+        const traitData_1_$f = ctx_1_$f.traitInstances[relationCtx_1_$f.trait.id];
+        if (!traitData_1_$f || !traitData_1_$f.relationTargets) {
+          result_getRelationTargets_1_$f = [];
+        } else {
+          const eid_1_$f = currentEntity & ENTITY_ID_MASK;
+          if (relationCtx_1_$f.exclusive) {
+            const target_1_$f = traitData_1_$f.relationTargets[eid_1_$f];
+            result_getRelationTargets_1_$f = target_1_$f !== void 0 ? [target_1_$f] : [];
+          } else {
+            const targets_1_$f = traitData_1_$f.relationTargets[eid_1_$f];
+            result_getRelationTargets_1_$f = targets_1_$f !== void 0 ? targets_1_$f.slice() : [];
+          }
+        }
+        const targets = result_getRelationTargets_1_$f;
+        for (const target of targets) {
+          if (!world.has(target)) continue;
+          if (!processedEntities.has(target)) entityQueue.push(target);
+        }
       }
     }
     const entityTraits = ctx.entityTraits.get(currentEntity);
@@ -2409,6 +2457,7 @@ function destroyEntity(world, entity) {
 function createWorld(optionsOrFirstTrait, ...traits) {
   const id = allocateWorldId(universe.worldIndex);
   let isInitialized = false;
+  let lazyTraits;
   const world = {
     [$internal]: {
       entityIndex: createEntityIndex(id),
@@ -2441,6 +2490,10 @@ function createWorld(optionsOrFirstTrait, ...traits) {
       }
       const traitId_0_$f = IsExcluded.id;
       if (!(traitId_0_$f < ctx.traitInstances.length && ctx.traitInstances[traitId_0_$f] !== void 0)) registerTrait(world, IsExcluded);
+      if (lazyTraits) {
+        initTraits = lazyTraits;
+        lazyTraits = void 0;
+      }
       ctx.worldEntity = createEntity(world, IsExcluded, ...initTraits);
     },
     spawn(...spawnTraits) {
@@ -2478,6 +2531,7 @@ function createWorld(optionsOrFirstTrait, ...traits) {
       universe.worlds[id] = null;
     },
     reset() {
+      lazyTraits = void 0;
       const ctx = world[$internal];
       world.entities.forEach((entity) => {
         if (world.has(entity)) {
@@ -2647,7 +2701,11 @@ function createWorld(optionsOrFirstTrait, ...traits) {
       traits: optionTraits = [],
       lazy = false
     } = optionsOrFirstTrait;
-    if (!lazy) world.init(...optionTraits);
+    if (!lazy) {
+      world.init(...optionTraits);
+    } else {
+      lazyTraits = optionTraits;
+    }
   } else {
     world.init(...optionsOrFirstTrait ? [optionsOrFirstTrait, ...traits] : traits);
   }