@forgeax/engine-runtime 0.1.4 → 0.1.7

package/src/__tests__/tilemap-chunk-extract.test.ts

@@ -3,7 +3,7 @@
 //
 // Asserts:
 //  - One ECS entity is spawned per NON-ZERO cell (no Instances component).
-//  - Each spawned entity carries Transform + MeshFilter (World-owned quad) +
+//  - Each spawned entity carries Transform + MeshFilter (HANDLE_QUAD) +
 //    MeshRenderer + Layer + ChildOf.
 //  - Transform.pos[0] = (cellX + 0.5) * tileSizeX (M0 1x1 unit-cell form).
 //  - Transform.pos[1] = (cellY + 0.5) * tileSizeY.
@@ -12,23 +12,20 @@
 //
 // Anchors: plan-tasks m0-t9 / m0-t10; plan-strategy §D-1 per-cell entity TRS.
 
+import { HANDLE_QUAD } from '@forgeax/engine-assets-runtime';
 import { World } from '@forgeax/engine-ecs';
 import { encodeTileBits } from '@forgeax/engine-graphics-extras';
+import { Layer, MeshFilter } from '@forgeax/engine-render';
+import { TileLayer, Tilemap } from '@forgeax/engine-render/authoring';
+import { ChildOf, Transform } from '@forgeax/engine-scene';
+import type { TilesetAsset } from '@forgeax/engine-types';
+import { describe, expect, it } from 'vitest';
+import { encodeSortScope } from '../../../render/src/components/tile-layer';
 import {
-  encodeSortScope,
-  TileLayer,
-  Tilemap,
-  tilemapChunkExtractSystem,
-} from '@forgeax/engine-render/authoring';
-import {
-  Layer,
-  MeshFilter,
   resetTilemapChunkExtractCache,
   resetTilemapDerivedEntityTracker,
-} from '@forgeax/engine-render/internal';
-import { ChildOf, Transform } from '@forgeax/engine-scene';
-import type { MeshAsset, TilesetAsset } from '@forgeax/engine-types';
-import { describe, expect, it } from 'vitest';
+  tilemapChunkExtractSystem,
+} from '../../../render/src/tilemap-chunk-extract-system';
 import { makeTilemapAssetLookup } from './helpers/tilemap-assets';
 
 const SQRT1_2 = Math.SQRT1_2;
@@ -165,7 +162,7 @@ describe('tilemapChunkExtractSystem (M0 baseline)', () => {
     expect(qw).toBeCloseTo(SQRT1_2, 5);
   });
 
-  it('uses a live World-owned quad mesh handle on derived entities', () => {
+  it('uses HANDLE_QUAD as the MeshFilter handle on derived entities', () => {
     const tiles = new Uint32Array(1);
     tiles[0] = 1;
     const { world, lookup } = makeSetup({ cols: 1, rows: 1, tiles });
@@ -173,9 +170,8 @@ describe('tilemapChunkExtractSystem (M0 baseline)', () => {
     const query = world.query({ read: [MeshFilter], with: [Layer] }).unwrap();
     for (const row of query) {
       const mf = row.get(MeshFilter);
-      const resolved = world.sharedRefs.resolve<'MeshAsset', MeshAsset>(mf.assetHandle);
-      expect(resolved.ok).toBe(true);
-      if (resolved.ok) expect(resolved.value.kind).toBe('mesh');
+      // Compare raw u32 (unwrap brand via numeric cast).
+      expect(mf.assetHandle as unknown as number).toBe(HANDLE_QUAD as unknown as number);
     }
   });
 

package/src/__tests__/tilemap-dirty-rebuild.test.ts

@@ -13,20 +13,16 @@
 // Anchors: plan-tasks m0-t9; charter F1.
 
 import { Entity, type EntityHandle, World } from '@forgeax/engine-ecs';
-import {
-  encodeSortScope,
-  markTileLayerDirty,
-  TileLayer,
-  Tilemap,
-  tilemapChunkExtractSystem,
-} from '@forgeax/engine-render/authoring';
-import {
-  resetTilemapChunkExtractCache,
-  resetTilemapDerivedEntityTracker,
-} from '@forgeax/engine-render/internal';
+import { TileLayer, Tilemap } from '@forgeax/engine-render/authoring';
 import { ChildOf, Children, Transform } from '@forgeax/engine-scene';
 import type { TilesetAsset } from '@forgeax/engine-types';
 import { describe, expect, it } from 'vitest';
+import { encodeSortScope, markTileLayerDirty } from '../../../render/src/components/tile-layer';
+import {
+  resetTilemapChunkExtractCache,
+  resetTilemapDerivedEntityTracker,
+  tilemapChunkExtractSystem,
+} from '../../../render/src/tilemap-chunk-extract-system';
 import { makeTilemapAssetLookup } from './helpers/tilemap-assets';
 
 function setup() {

package/src/__tests__/tilemap-material-cache.test.ts

@@ -16,22 +16,17 @@
 // charter P4 (atlases plural composite + binary cache key).
 
 import { World } from '@forgeax/engine-ecs';
-import {
-  encodeSortScope,
-  TileLayer,
-  Tilemap,
-  tilemapChunkExtractSystem,
-} from '@forgeax/engine-render/authoring';
-import {
-  Layer,
-  MeshFilter,
-  MeshRenderer,
-  resetTilemapChunkExtractCache,
-  resetTilemapDerivedEntityTracker,
-} from '@forgeax/engine-render/internal';
+import { Layer, MeshFilter, MeshRenderer } from '@forgeax/engine-render';
+import { TileLayer, Tilemap } from '@forgeax/engine-render/authoring';
 import { ChildOf, Transform } from '@forgeax/engine-scene';
 import type { TilesetAsset } from '@forgeax/engine-types';
 import { describe, expect, it } from 'vitest';
+import { encodeSortScope } from '../../../render/src/components/tile-layer';
+import {
+  resetTilemapChunkExtractCache,
+  resetTilemapDerivedEntityTracker,
+  tilemapChunkExtractSystem,
+} from '../../../render/src/tilemap-chunk-extract-system';
 import { makeTilemapAssetLookup } from './helpers/tilemap-assets';
 
 function spawnTilemapWithLayer(

package/src/__tests__/tilemap-multi-atlas.test.ts

@@ -17,28 +17,19 @@
 // atlas slot is unexpectedly empty rather than silently sampling the
 // wrong texture).
 
+import { resolveAssetHandle } from '@forgeax/engine-assets-runtime';
 import { World } from '@forgeax/engine-ecs';
+import { Layer, MeshFilter, MeshRenderer } from '@forgeax/engine-render';
+import { TileLayer, Tilemap } from '@forgeax/engine-render/authoring';
+import { ChildOf, Transform } from '@forgeax/engine-scene';
+import { type MaterialAsset, type TilesetAsset, toShared } from '@forgeax/engine-types';
+import { describe, expect, it } from 'vitest';
+import { encodeSortScope } from '../../../render/src/components/tile-layer';
 import {
-  encodeSortScope,
-  TileLayer,
-  Tilemap,
-  tilemapChunkExtractSystem,
-} from '@forgeax/engine-render/authoring';
-import {
-  Layer,
-  MeshFilter,
-  MeshRenderer,
   resetTilemapChunkExtractCache,
   resetTilemapDerivedEntityTracker,
-} from '@forgeax/engine-render/internal';
-import { ChildOf, Transform } from '@forgeax/engine-scene';
-import {
-  type MaterialAsset,
-  type MaterialTextureValue,
-  type TilesetAsset,
-  toShared,
-} from '@forgeax/engine-types';
-import { describe, expect, it } from 'vitest';
+  tilemapChunkExtractSystem,
+} from '../../../render/src/tilemap-chunk-extract-system';
 import { makeTestTexture, makeTilemapAssetLookup } from './helpers/tilemap-assets';
 
 interface RegionWithAtlasIndex {
@@ -98,24 +89,13 @@ function spawnTilemap(
 
 function readMaterialTextureHandle(world: World, materialHandle: number): number {
   const tagged = toShared<'MaterialAsset'>(materialHandle);
-  const res = world.sharedRefs.resolve<string, MaterialAsset>(tagged);
+  const res = resolveAssetHandle<MaterialAsset>(world, tagged);
   if (!res.ok) return 0;
   const asset = res.value;
   if (asset.kind !== 'material') return 0;
-  const pv = asset.values as Readonly<
-    Record<string, number | number[] | string | MaterialTextureValue | undefined>
-  >;
+  const pv = asset.values as Readonly<Record<string, number | number[] | string | undefined>>;
   const tex = pv.baseColorTexture;
-  if (typeof tex === 'number') return tex;
-  if (
-    typeof tex === 'object' &&
-    tex !== null &&
-    !Array.isArray(tex) &&
-    typeof tex.texture === 'number'
-  ) {
-    return tex.texture;
-  }
-  return 0;
+  return typeof tex === 'number' ? tex : 0;
 }
 
 function readDerivedMaterialHandles(world: World): number[] {

package/src/__tests__/tilemap-owner-boundary.unit.test.ts

@@ -1,8 +1,11 @@
 import { World } from '@forgeax/engine-ecs';
-import { TileLayer, Tilemap, tilemapChunkExtractSystem } from '@forgeax/engine-render/authoring';
-import { resetTilemapChunkExtractCache } from '@forgeax/engine-render/internal';
+import { TileLayer, Tilemap } from '@forgeax/engine-render/authoring';
 import { ChildOf, Transform } from '@forgeax/engine-scene';
 import { describe, expect, it } from 'vitest';
+import {
+  resetTilemapChunkExtractCache,
+  tilemapChunkExtractSystem,
+} from '../../../render/src/tilemap-chunk-extract-system';
 import { makeTilemapAssetLookup } from './helpers/tilemap-assets';
 
 describe('tilemap extraction owner boundary', () => {

package/src/__tests__/tilemap-region-pack.test.ts

@@ -18,21 +18,17 @@
 
 import { World } from '@forgeax/engine-ecs';
 import { encodeTileBits } from '@forgeax/engine-graphics-extras';
-import {
-  encodeSortScope,
-  TileLayer,
-  Tilemap,
-  tilemapChunkExtractSystem,
-} from '@forgeax/engine-render/authoring';
-import {
-  Layer,
-  MeshFilter,
-  resetTilemapChunkExtractCache,
-  resetTilemapDerivedEntityTracker,
-} from '@forgeax/engine-render/internal';
+import { Layer, MeshFilter } from '@forgeax/engine-render';
+import { TileLayer, Tilemap } from '@forgeax/engine-render/authoring';
 import { ChildOf, Transform } from '@forgeax/engine-scene';
 import type { TilesetAsset } from '@forgeax/engine-types';
 import { describe, expect, it } from 'vitest';
+import { encodeSortScope } from '../../../render/src/components/tile-layer';
+import {
+  resetTilemapChunkExtractCache,
+  resetTilemapDerivedEntityTracker,
+  tilemapChunkExtractSystem,
+} from '../../../render/src/tilemap-chunk-extract-system';
 import { makeTilemapAssetLookup } from './helpers/tilemap-assets';
 
 function setup(opts: {

package/src/__tests__/tilemap-spawn-flip-pivot.test.ts

@@ -35,21 +35,17 @@
 
 import { World } from '@forgeax/engine-ecs';
 import { encodeTileBits } from '@forgeax/engine-graphics-extras';
-import {
-  encodeSortScope,
-  TileLayer,
-  Tilemap,
-  tilemapChunkExtractSystem,
-} from '@forgeax/engine-render/authoring';
-import {
-  Layer,
-  MeshFilter,
-  resetTilemapChunkExtractCache,
-  resetTilemapDerivedEntityTracker,
-} from '@forgeax/engine-render/internal';
+import { Layer, MeshFilter } from '@forgeax/engine-render';
+import { TileLayer, Tilemap } from '@forgeax/engine-render/authoring';
 import { ChildOf, Transform } from '@forgeax/engine-scene';
 import type { TilesetAsset } from '@forgeax/engine-types';
 import { describe, expect, it } from 'vitest';
+import { encodeSortScope } from '../../../render/src/components/tile-layer';
+import {
+  resetTilemapChunkExtractCache,
+  resetTilemapDerivedEntityTracker,
+  tilemapChunkExtractSystem,
+} from '../../../render/src/tilemap-chunk-extract-system';
 import { makeTilemapAssetLookup } from './helpers/tilemap-assets';
 
 const SQRT1_2 = Math.SQRT1_2;

package/src/__tests__/tilemap-uv-inset.test.ts

@@ -25,23 +25,19 @@
 // Anchors: plan-tasks m2-t3; plan-strategy §D-7 step 3; charter P3
 // (default behaviour avoids silently introducing visual defects).
 
+import { resolveAssetHandle } from '@forgeax/engine-assets-runtime';
 import { World } from '@forgeax/engine-ecs';
-import {
-  encodeSortScope,
-  TileLayer,
-  Tilemap,
-  tilemapChunkExtractSystem,
-} from '@forgeax/engine-render/authoring';
-import {
-  Layer,
-  MeshFilter,
-  MeshRenderer,
-  resetTilemapChunkExtractCache,
-  resetTilemapDerivedEntityTracker,
-} from '@forgeax/engine-render/internal';
+import { Layer, MeshFilter, MeshRenderer } from '@forgeax/engine-render';
+import { TileLayer, Tilemap } from '@forgeax/engine-render/authoring';
 import { ChildOf, Transform } from '@forgeax/engine-scene';
 import { type MaterialAsset, type TilesetAsset, toShared } from '@forgeax/engine-types';
 import { describe, expect, it } from 'vitest';
+import { encodeSortScope } from '../../../render/src/components/tile-layer';
+import {
+  resetTilemapChunkExtractCache,
+  resetTilemapDerivedEntityTracker,
+  tilemapChunkExtractSystem,
+} from '../../../render/src/tilemap-chunk-extract-system';
 import { makeTilemapAssetLookup } from './helpers/tilemap-assets';
 
 interface AtlasMeta {
@@ -106,7 +102,8 @@ function readDerivedMaterialRegions(world: World): number[][] {
   for (const row of query) {
     const handleRaw = row.get(MeshRenderer).materials[0];
     if (handleRaw === undefined) continue;
-    const matRes = world.sharedRefs.resolve<string, MaterialAsset>(
+    const matRes = resolveAssetHandle<MaterialAsset>(
+      world,
       toShared<'MaterialAsset'>(handleRaw as unknown as number),
     );
     if (!matRes.ok) continue;

package/src/__tests__/tilemap-validate.test.ts

@@ -21,10 +21,10 @@
 // baseline); charter P3.
 
 import { World } from '@forgeax/engine-ecs';
-import { TileLayer, Tilemap } from '@forgeax/engine-render/authoring';
 import { ChildOf } from '@forgeax/engine-scene';
 import { AssetError } from '@forgeax/engine-types';
 import { describe, expect, it } from 'vitest';
+import { TileLayer, Tilemap } from '../../../render/src/components';
 import {
   validateTileLayerAtRegister,
   validateTilemapAtRegister,