@forgeax/engine-runtime 0.1.27 → 0.1.29

package/src/components/__tests__/sprite-animation.test-d.ts

@@ -30,8 +30,8 @@
 //
 // Why array<f32> (and not array<f32, N>) for `regions`? The length
 // `frameCount * 4` is a runtime value (frameCount itself is a column read
-// per entity); the variable-capacity `array<f32>` mirrors `Instances.transforms`
-// (M1 feat-20260514) where the runtime length is also data-dependent. The
+// per entity); the variable-capacity `array<f32>` mirrors the renderer-owned
+// collection snapshot where the runtime length is also data-dependent. The
 // length invariant is enforced by the M4 sprite-animation-tick system at
 // first observation (AC-09 fail-fast path; D-1 + D-6).
 //

package/src/index.ts

@@ -106,6 +106,7 @@ export {
   type RhiErrorCode,
   type RhiErrorDetail,
   type RhiShaderCompileDetail,
+  type RhiWebgpuRuntimeCause,
   type RhiWebgpuRuntimeDetail,
 } from '@forgeax/engine-rhi';
 /**

package/src/scene-utils/mount-override-fold.ts

@@ -49,18 +49,14 @@ import {
 } from '@forgeax/engine-ecs';
 import { componentSchema } from '@forgeax/engine-ecs/internal';
 import { fillComponentDefaults } from '@forgeax/engine-ecs/projection';
-import type {
-  Handle,
-  LocalEntityId,
-  MountOverride,
-  SceneAsset,
-  SceneEntity,
-} from '@forgeax/engine-types';
+import type { MountOverride } from '@forgeax/engine-scene';
+import type { Handle, LocalEntityId, SceneAsset } from '@forgeax/engine-types';
 
 /** Minimal structural view of a SceneInstanceState the fold reads (D-4 boundary:
  * `world.getSceneInstanceState(root).value` is structurally assignable). */
 export interface FoldSceneInstanceState {
   readonly source: Handle<'SceneAsset', 'shared'>;
+  readonly keyByLocalId: Map<number, string>;
   readonly entityToLocalId: Map<EntityHandle, LocalEntityId>;
 }
 
@@ -151,12 +147,6 @@ export function foldMountOverrides(world: World, state: FoldSceneInstanceState):
   if (!sourceRes.ok) return [];
   const source = sourceRes.value as SceneAsset;
 
-  // Index source entities by localId for O(1) baseline lookup.
-  const sourceByLid = new Map<number, SceneEntity>();
-  for (const node of source.entities) {
-    sourceByLid.set(node.localId as unknown as number, node);
-  }
-
   const excluded = excludedComponentNames();
   const registered = world.components.entries();
   const overrides: MountOverride[] = [];
@@ -170,7 +160,8 @@ export function foldMountOverrides(world: World, state: FoldSceneInstanceState):
   members.sort((a, b) => a[1] - b[1]);
 
   for (const [entity, lid] of members) {
-    const sourceNode = sourceByLid.get(lid);
+    const sourceKey = state.keyByLocalId.get(lid);
+    const sourceNode = sourceKey === undefined ? undefined : source.entities[sourceKey];
     const sourceComps = (sourceNode?.components ?? {}) as Record<string, Record<string, unknown>>;
 
     for (const [compName, compToken] of registered) {

package/src/__tests__/node-shims.d.ts

@@ -1,31 +0,0 @@
-// Ambient declarations for node:* modules used by dawn tests that read the
-// hello-triangle compiled shader manifest at runtime. The runtime package's
-// tsconfig does not enable @types/node (production target is browser); these
-// minimal shims keep tsc green for the small set of dawn test files that read
-// compiled shader manifests at runtime.
-//
-// Used by shader-manifest Dawn fixtures and the runtime benchmark fixtures.
-// - tilemap-chunk-y-sort-bench.unit.test.ts (perf_hooks + process.env)
-// - record-fold-scene-instances.unit.test.ts (readdirSync + dirname)
-// - basis-catalog-dispatch.integration.test.ts (existsSync pkg-built gate)
-
-declare module 'node:fs' {
-  export function readFileSync(path: string, encoding: string): string;
-  export function readdirSync(path: string): string[];
-  export function existsSync(path: string): boolean;
-}
-
-declare module 'node:path' {
-  export function resolve(...paths: string[]): string;
-  export function dirname(p: string): string;
-}
-
-declare module 'node:url' {
-  export function fileURLToPath(url: string | URL): string;
-}
-
-declare module 'node:perf_hooks' {
-  export const performance: { now(): number };
-}
-
-declare const process: { env: Record<string, string | undefined> };