@forgeax/engine-ecs 0.1.35 → 0.1.36

package/README.md

@@ -378,6 +378,13 @@ diagnostics. It is not a live registry and is not a storage escape hatch.
 Consumers should use entity counts, active component names, schedule summaries,
 and resource keys; gameplay code should use queries.
 
+`world.componentsOf(entity)` returns a detached array of the live entity's
+component tokens, including sparse tags, or the normal stale-entity error.
+Unlike `world.components.entries()`, it reflects actual archetype membership
+without requiring a plugin catalog lease. Inspection plugins combine it with
+public component reflection and `world.get`; it adds no inspection state or
+per-frame work to the World.
+
 ## Public surface and subpaths
 
 The root barrel is intentionally small. Advanced capabilities are named by

package/dist/__tests__/entity-components.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entity-components.unit.test.d.ts.map

package/dist/__tests__/entity-components.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-components.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/entity-components.unit.test.ts"],"names":[],"mappings":""}

package/dist/index.mjs

@@ -5374,6 +5374,12 @@ var World = class {
   inspect() {
     return detachWorldInspection(worldInspect(this));
   }
+  /** Read the actual component vocabulary of one live entity, including sparse tags. */
+  componentsOf(entity) {
+    const record = this.lookupAlive(entity, "componentsOf");
+    if (!record.ok) return record;
+    return ok([...this.graph.archetypes[record.value.archetypeId]?.components ?? []]);
+  }
   /** Return the registered schedule graphs and their declared access metadata. */
   scheduleData() {
     return worldScheduleData(this);