@forgeax/engine-ecs 0.1.28 → 0.1.30

package/README.md

@@ -295,6 +295,9 @@ world.addSystem(FixedUpdate, {
 runs one update step, and flushes each system's command buffer. Clock readers
 receive a stable read view; the scheduler owns writes. Resources are non-owning
 values: Cordis/plugin owners dispose external payloads, not `World`.
+Final shared-reference `release()` returns the payload to its caller.
+`readReleaseEvidence()` retains only bounded handle/refcount/generation records;
+diagnostic history must not extend the lifetime of released meshes or textures.
 
 ## Failure and recovery
 

package/dist/__tests__/shared-ref-lifetime.unit.test.d.ts

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

package/dist/__tests__/shared-ref-lifetime.unit.test.d.ts.map

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

package/dist/index.d.ts

@@ -137,7 +137,7 @@ export type { Query, QueryCreationError, QueryDescriptor, QueryRow, QuerySpan, }
  * // the SharedRefStore publishes release evidence at rc=0.
  * ```
  */
-export type { SharedRefReleaseEvidence } from './shared-ref-store';
+export type { SharedRefReleaseEvidence, SharedRefReleaseRecord } from './shared-ref-store.js';
 /**
  * ECS-managed handle store (M1). Owns the lifecycle of every
  * `Handle<T, 'unique'>` derived from `ref<T>` schema fields - World hooks
@@ -163,7 +163,7 @@ export type { SharedRefReleaseEvidence } from './shared-ref-store';
  * const data: ComponentData = { component: Position, data: { x: 1, y: 2 } };
  * ```
  */
-export type { ComponentData } from './world';
+export type { ComponentData } from './world.js';
 /**
  * Top-level ECS container. Owns entities, archetypes, systems, and resources.
  *
@@ -174,7 +174,7 @@ export type { ComponentData } from './world';
  * world.update();
  * ```
  */
-export { World } from './world';
+export { World } from './world.js';
 /**
  * Deferred command buffer passed to system functions. Queues structural changes
  * (spawn/despawn/addComponent/removeComponent) for end-of-frame flush.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA0DH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAerF;;;;;;GAMG;AACH,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EACL,kBAAkB,EAClB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,KAAK,2BAA2B,GACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,MAAM,GACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,SAAS,EACT,KAAK,iBAAiB,EACtB,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,QAAQ,CAAC;AAChB;;;GAGG;AACH,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,cAAc,EAAE,CAAC;AAMrE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;;;;;;;;;;;;;;;;;GAiBG;AACH,YAAY,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,OAAO,GACR,MAAM,aAAa,CAAC;AACrB;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C;;;;;;;GAOG;AACH,YAAY,EACV,KAAK,EACL,kBAAkB,EAClB,eAAe,EACf,QAAQ,EACR,SAAS,GACV,MAAM,eAAe,CAAC;AACvB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,YAAY,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEnE;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;GAOG;AACH,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMhC;;;;;;;;;;;GAWG;AACH,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD;;;;;;;;;;;;GAYG;AACH;;;;;;;;;;GAUG;AACH,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,GACV,MAAM,YAAY,CAAC;AACpB;;;;;;;;;;;;;GAaG;AACH;;;;;;;;GAQG;AACH,OAAO,EACL,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AAMH;;;;;;;;GAQG;AAuBH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA0DH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAerF;;;;;;GAMG;AACH,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EACL,kBAAkB,EAClB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,KAAK,2BAA2B,GACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,MAAM,GACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,SAAS,EACT,KAAK,iBAAiB,EACtB,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,QAAQ,CAAC;AAChB;;;GAGG;AACH,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,cAAc,EAAE,CAAC;AAMrE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;;;;;;;;;;;;;;;;;GAiBG;AACH,YAAY,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,OAAO,GACR,MAAM,aAAa,CAAC;AACrB;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C;;;;;;;GAOG;AACH,YAAY,EACV,KAAK,EACL,kBAAkB,EAClB,eAAe,EACf,QAAQ,EACR,SAAS,GACV,MAAM,eAAe,CAAC;AACvB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,YAAY,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE9F;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;GAOG;AACH,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMnC;;;;;;;;;;;GAWG;AACH,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD;;;;;;;;;;;;GAYG;AACH;;;;;;;;;;GAUG;AACH,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,GACV,MAAM,YAAY,CAAC;AACpB;;;;;;;;;;;;;GAaG;AACH;;;;;;;;GAQG;AACH,OAAO,EACL,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AAMH;;;;;;;;GAQG;AAuBH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.mjs

@@ -4133,13 +4133,20 @@ var SharedRefStore = class {
       generation,
       evidence: "released"
     });
-    this.releaseJournal.push(evidence);
+    this.releaseJournal.push(
+      Object.freeze({
+        handle: raw,
+        refcount: 0,
+        generation,
+        evidence: "released"
+      })
+    );
     if (this.releaseJournal.length > SHARED_REF_RELEASE_EVIDENCE_CAPACITY) {
       this.releaseJournal.shift();
     }
     return ok(evidence);
   }
-  /** Read the bounded release evidence owned by this store. */
+  /** Read bounded release metadata; payload ownership remains with the caller. */
   readReleaseEvidence() {
     return this.releaseJournal;
   }