@forgeax/engine-ecs 0.1.21 → 0.1.24

package/dist/projection/index.d.ts

@@ -2,35 +2,12 @@ import type { Result } from '@forgeax/engine-types';
 import type { Component } from '../component';
 import type { EntityHandle } from '../entity-handle';
 import type { SharedRefMutationRead } from '../shared-ref-store';
-import type { WorldChangeRead } from '../storage/change-detection';
+import type { StructuralEvidenceRead } from '../storage/structural-evidence';
 import type { EcsError, World } from '../world';
 export { fillComponentDefaults } from '../component-default-fallback';
 export { ComponentNotDefinedError, InstanceTransformsStrideMismatchError, ManagedBufferOutOfBoundsError, ResourceInvalidValueError, SpawnLightInvalidBoundsError, SpriteAnimationInvalidError, SpriteInstancesCountMismatchError, SpriteInstancesMutuallyExclusiveWithInstancesError, SpriteInstancesRequiresSpriteShaderError, StaleEntityError, } from '../errors';
-export type ProjectionChangeKind = 'component-added' | 'component-changed' | 'component-removed' | 'derived-component-changed' | 'entity-removed';
-export interface ProjectionChange {
-    readonly entity: EntityHandle;
-    readonly kind: ProjectionChangeKind;
-    /** Token identity is the owner-facing component discriminator. */
-    readonly component?: Component;
-    /** Numeric id remains journal evidence for ECS-internal consumers. */
-    readonly componentId?: number;
-}
-export type ProjectionRead = {
-    readonly status: 'delta';
-    readonly cursor: number;
-    readonly changes: readonly ProjectionChange[];
-} | {
-    readonly status: 'rebuild';
-    readonly cursor: number;
-    readonly reason: 'journal-overflow';
-};
-export interface WorldProjection {
-    readonly cursor: number;
-    poll(): ProjectionRead;
-}
-export interface WorldProjectionOptions {
-    readonly components?: readonly Component[];
-}
+/** Read producer-owned typed structural facts without inferring from a World scan. */
+export declare function readStructuralEvidence(world: World, cursor: number): StructuralEvidenceRead;
 export interface RenderProjectionComponentRequest {
     readonly component: Component;
     readonly fields: readonly string[];
@@ -49,29 +26,30 @@ export interface RenderProjectionSpans {
 }
 export interface RenderChangeBatchOk {
     readonly status: 'ok';
-    readonly cursor: number;
-    readonly world: Extract<WorldChangeRead, {
-        readonly status: 'ok';
-    }>;
-    readonly sharedRefs: Extract<SharedRefMutationRead, {
-        readonly status: 'ok';
-    }>;
+    readonly version: RenderReadVersion;
+    readonly world: RenderWorldChanges;
+    readonly sharedRefs: SharedRefMutationRead;
 }
-export interface RenderChangeBatchOverflow {
-    readonly status: 'overflow';
-    readonly cursor: number;
+export interface RenderChangeBatchRebuild {
+    readonly status: 'rebuild';
+    readonly version: RenderReadVersion;
     readonly resync: true;
-    readonly oldestAvailable: number;
-    readonly world: WorldChangeRead;
+    readonly reason: 'structure-changed';
+    readonly world: RenderWorldChanges;
     readonly sharedRefs: SharedRefMutationRead;
 }
-export type RenderChangeBatch = RenderChangeBatchOk | RenderChangeBatchOverflow;
+export interface RenderWorldChanges {
+    readonly fromEpoch: number;
+    readonly toEpoch: number;
+    readonly changedComponentIds: readonly number[];
+}
+export type RenderChangeBatch = RenderChangeBatchOk | RenderChangeBatchRebuild;
 export interface RenderReadLease {
     readonly worldIdentity: string;
     readonly generation: number;
-    readChanges(cursor: number): RenderChangeBatch;
+    readChanges(version: RenderReadVersion): RenderChangeBatch;
     querySpans(request: RenderProjectionRequest): RenderProjectionSpans;
-    inspectCursor(): number;
+    captureVersion(): RenderReadVersion;
     dispose(): void;
 }
 /**
@@ -80,24 +58,21 @@ export interface RenderReadLease {
  * transform/instance columns; the World internals remain owned by ECS.
  */
 export declare function readRenderArrayView(world: World, entity: EntityHandle, component: Component, fieldName: string): ArrayLike<number> | undefined;
+export interface RenderReadVersion {
+    readonly mutationEpoch: number;
+    readonly structureEpoch: number;
+    readonly sharedRefEpoch: number;
+}
 /** Create the render-owned lease from the ECS projection boundary. */
 export declare function createRenderReadLease(world: World, token?: object): RenderReadLease;
 /**
- * Publish one owner-derived component value without confusing it with an
- * authored mutation. Owner packages use this narrow seam for fields such as
- * `Transform.world`: the write still passes through ECS validation and managed
- * storage, while the journal records a `derived-component-changed` fact for
- * incremental projections.
+ * Publish one owner-derived component value through the component's ordinary
+ * version. Numeric consumers observe the same row epoch regardless of which
+ * owner computed the value; there is no parallel derived-change vocabulary.
  */
 export declare function setDerivedComponent(world: World, entity: EntityHandle, component: Component, value: Record<string, unknown>): Result<void, EcsError>;
 /** Route an owner-domain error through the World without exposing raw internals. */
 export declare function routeWorldError(world: World, error: unknown, context?: {
     readonly systemName: string;
 }): void;
-/**
- * Create the narrow incremental evidence surface for an owner projection.
- * Rebuilds intentionally return a reason; complete data always comes from
- * the owner's regular Query/QuerySpan path.
- */
-export declare function createWorldProjection(world: World, options?: WorldProjectionOptions): WorldProjection;
 //# sourceMappingURL=index.d.ts.map

package/dist/projection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/projection/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/projection/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAMhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EACL,wBAAwB,EACxB,qCAAqC,EACrC,6BAA6B,EAC7B,yBAAyB,EACzB,4BAA4B,EAC5B,2BAA2B,EAC3B,iCAAiC,EACjC,kDAAkD,EAClD,wCAAwC,EACxC,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAE3F;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,SAAS,gCAAgC,EAAE,CAAC;CAClE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;CAC5C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;CACjD;AAED,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,wBAAwB,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAAC;IAC3D,UAAU,CAAC,OAAO,EAAE,uBAAuB,GAAG,qBAAqB,CAAC;IACpE,cAAc,IAAI,iBAAiB,CAAC;IACpC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,GAChB,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAI/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAoCD,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAE,MAAW,GAAG,eAAe,CAqEvF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAKxB;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxC,IAAI,CAEN"}

package/dist/projection/index.mjs

@@ -122,6 +122,30 @@ var SpriteInstancesMutuallyExclusiveWithInstancesError = class extends Error {
 
 // src/errors/validation-errors.ts
 var SPAWN_LIGHT_INVALID_BOUNDS_POLICY = {
+  intensity: {
+    expected: "intensity is finite and >= 0",
+    hint: (componentName, got) => `${componentName}.intensity must be a finite non-negative number (got ${got})`
+  },
+  color: {
+    expected: "color is a finite non-negative [r, g, b] vector",
+    hint: (componentName, got) => `${componentName}.color must contain three finite non-negative channels (got ${JSON.stringify(got)})`
+  },
+  width: {
+    expected: "width is finite and > 0",
+    hint: (componentName, got) => `${componentName}.width must be a finite positive meter value (got ${got})`
+  },
+  height: {
+    expected: "height is finite and > 0",
+    hint: (componentName, got) => `${componentName}.height must be a finite positive meter value (got ${got})`
+  },
+  irradiance: {
+    expected: "irradiance is a finite 27-value SH vector",
+    hint: (componentName, got) => `${componentName}.irradiance must contain 27 finite SH values (got ${JSON.stringify(got)})`
+  },
+  radius: {
+    expected: "radius is finite and >= R_MIN",
+    hint: (componentName, got) => `${componentName}.radius must be a finite value >= R_MIN (got ${got})`
+  },
   range: {
     expected: "range >= 0 or Number.POSITIVE_INFINITY",
     hint: (componentName, got) => `${componentName}.range = ${got} is invalid; use Number.POSITIVE_INFINITY for unlimited range, or a non-negative meter value`
@@ -467,6 +491,9 @@ function fillComponentDefaults(token, raw) {
 }
 
 // src/projection/index.ts
+function readStructuralEvidence(world, cursor) {
+  return world[worldInternal].getStructuralEvidence().readAfter(cursor);
+}
 function readRenderArrayView(world, entity, component, fieldName) {
   return world[worldInternal].getArrayView(entity, component, fieldName);
 }
@@ -501,115 +528,78 @@ function readProjectionSpans(world, generation, request) {
 }
 function createRenderReadLease(world, token = {}) {
   const sharedRefs = world[worldInternal].getSharedRefs();
-  const generation = Math.max(1, world[worldInternal].getStructureEpoch());
   let disposed = false;
-  let nextCursor = 1;
-  const cursors = /* @__PURE__ */ new Map([
-    [
-      0,
-      { world: world[worldInternal].getChangeCursor(), sharedRefs: sharedRefs.getMutationEpoch() }
-    ]
-  ]);
   const assertLive = () => {
     if (disposed) throw new Error("RenderReadLease is disposed.");
   };
-  const captureCursor = () => {
-    const cursor = nextCursor++;
-    cursors.set(cursor, {
-      world: world[worldInternal].getChangeCursor(),
-      sharedRefs: sharedRefs.getMutationEpoch()
-    });
-    if (cursors.size > 8) {
-      const oldest = cursors.keys().next().value;
-      if (typeof oldest === "number" && oldest !== cursor) cursors.delete(oldest);
-    }
-    return cursor;
+  const captureVersion = () => {
+    return {
+      mutationEpoch: world[worldInternal].getMutationEpoch(),
+      structureEpoch: world[worldInternal].getStructureEpoch(),
+      sharedRefEpoch: sharedRefs.getMutationEpoch()
+    };
   };
   return {
     worldIdentity: world.identity,
-    generation,
-    inspectCursor() {
+    get generation() {
+      return Math.max(1, world[worldInternal].getStructureEpoch());
+    },
+    captureVersion() {
       assertLive();
-      return captureCursor();
+      return captureVersion();
     },
-    readChanges(cursor) {
+    readChanges(start) {
       assertLive();
-      const start = cursors.get(cursor);
-      if (start === void 0) throw new RangeError(`Unknown RenderReadLease cursor ${cursor}.`);
-      const worldRead = world[worldInternal].readChangesSince(start.world);
-      const sharedRead = sharedRefs.readChangesSince(start.sharedRefs);
-      const next = captureCursor();
-      if (worldRead.status === "overflow" || sharedRead.status === "overflow") {
-        const oldestAvailable = Math.min(
-          worldRead.status === "overflow" ? worldRead.oldestAvailable : Number.MAX_SAFE_INTEGER,
-          sharedRead.status === "overflow" ? sharedRead.oldestAvailable : Number.MAX_SAFE_INTEGER
-        );
+      const toEpoch = world[worldInternal].getMutationEpoch();
+      const componentEpochs = world[worldInternal].getComponentMutationEpochs();
+      const changedComponentIds = [];
+      for (let componentId2 = 0; componentId2 < componentEpochs.length; componentId2 += 1) {
+        const epoch = componentEpochs[componentId2] ?? 0;
+        if (epoch > start.mutationEpoch && epoch <= toEpoch) changedComponentIds.push(componentId2);
+      }
+      const worldRead = {
+        fromEpoch: start.mutationEpoch,
+        toEpoch,
+        changedComponentIds
+      };
+      const sharedRead = sharedRefs.readChangesSince(start.sharedRefEpoch);
+      const version = captureVersion();
+      const structureChanged = start.structureEpoch !== world[worldInternal].getStructureEpoch();
+      if (structureChanged) {
         return {
-          status: "overflow",
-          cursor: next,
+          status: "rebuild",
+          version,
           resync: true,
-          oldestAvailable,
+          reason: "structure-changed",
           world: worldRead,
           sharedRefs: sharedRead
         };
       }
-      return { status: "ok", cursor: next, world: worldRead, sharedRefs: sharedRead };
+      return { status: "ok", version, world: worldRead, sharedRefs: sharedRead };
     },
     querySpans(request) {
       assertLive();
-      return readProjectionSpans(world, generation, request);
+      return readProjectionSpans(
+        world,
+        Math.max(1, world[worldInternal].getStructureEpoch()),
+        request
+      );
     },
     dispose() {
       disposed = true;
-      cursors.clear();
     }
   };
 }
 function setDerivedComponent(world, entity, component, value) {
   const result = world[worldInternal].setQueryRow(entity, component, value);
   if (!result.ok) return result;
-  world[worldInternal].markDerivedComponentChanges(componentId(component), [entity]);
+  world[worldInternal].markComponentChanged(entity, componentId(component));
   return result;
 }
 function routeWorldError(world, error, context) {
   world[worldInternal].routeError(error, context);
 }
-function createWorldProjection(world, options = {}) {
-  const componentById = options.components === void 0 ? void 0 : new Map(options.components.map((component) => [componentId(component), component]));
-  const componentIds = componentById === void 0 ? void 0 : new Set(componentById.keys());
-  let cursor = world[worldInternal].getChangeCursor();
-  const pollSince = (requestedCursor) => {
-    const result = world[worldInternal].readChangesSince(requestedCursor);
-    if (result.status === "overflow") {
-      cursor = result.cursor;
-      return { status: "rebuild", cursor, reason: "journal-overflow" };
-    }
-    cursor = result.cursor;
-    const changes = [];
-    for (const record of result.records) {
-      if (componentIds !== void 0 && record.kind !== "entity-removed" && (record.componentId === void 0 || !componentIds.has(record.componentId))) {
-        continue;
-      }
-      const component = record.componentId === void 0 ? void 0 : componentById?.get(record.componentId);
-      changes.push({
-        entity: record.entity,
-        kind: record.kind,
-        ...component === void 0 ? {} : { component },
-        ...record.componentId === void 0 ? {} : { componentId: record.componentId }
-      });
-    }
-    return { status: "delta", cursor, changes };
-  };
-  return {
-    get cursor() {
-      return cursor;
-    },
-    poll() {
-      return pollSince(cursor);
-    }
-  };
-}
 
-export { ComponentNotDefinedError, InstanceTransformsStrideMismatchError, ManagedBufferOutOfBoundsError, ResourceInvalidValueError, SpawnLightInvalidBoundsError, SpriteAnimationInvalidError, SpriteInstancesCountMismatchError, SpriteInstancesMutuallyExclusiveWithInstancesError, SpriteInstancesRequiresSpriteShaderError, StaleEntityError, createRenderReadLease, createWorldProjection, fillComponentDefaults, readRenderArrayView, routeWorldError, setDerivedComponent };
+export { ComponentNotDefinedError, InstanceTransformsStrideMismatchError, ManagedBufferOutOfBoundsError, ResourceInvalidValueError, SpawnLightInvalidBoundsError, SpriteAnimationInvalidError, SpriteInstancesCountMismatchError, SpriteInstancesMutuallyExclusiveWithInstancesError, SpriteInstancesRequiresSpriteShaderError, StaleEntityError, createRenderReadLease, fillComponentDefaults, readRenderArrayView, readStructuralEvidence, routeWorldError, setDerivedComponent };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map