@forgeax/engine-runtime 0.1.6 → 0.1.19

package/dist/renderer-host.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/backend-selection.ts","../src/renderer-host.ts"],"names":[],"mappings":"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","file":"renderer-host.mjs","sourcesContent":["import type { RendererOptions } from '@forgeax/engine-render';\nimport type { RhiBackendPack } from '@forgeax/engine-render/internal/construct-renderer';\nimport { err, ok, RhiError } from '@forgeax/engine-rhi';\nimport * as rhiWebgpu from '@forgeax/engine-rhi-webgpu';\n\nexport function loadRhiPack(\n  mod: Record<string, unknown>,\n  instrumentation?: RhiBackendPack['instrumentation'],\n): RhiBackendPack {\n  const rhi = mod.rhi as unknown as RhiBackendPack['rhi'];\n  const createShaderModule = mod.createShaderModule as\n    | RhiBackendPack['createShaderModule']\n    | undefined;\n  const translateErrorEventToRhiError = mod.translateErrorEventToRhiError as\n    | RhiBackendPack['translateErrorEventToRhiError']\n    | undefined;\n  const rawDeviceAccessor = mod._internal_getRawDevice as unknown as\n    | RhiBackendPack['_internal_getRawDevice']\n    | undefined;\n  const backendInstrumentation = mod.instrumentation as\n    | RhiBackendPack['instrumentation']\n    | undefined;\n  const pack: RhiBackendPack = {\n    rhi,\n    ...(createShaderModule === undefined ? {} : { createShaderModule }),\n    ...(translateErrorEventToRhiError === undefined ? {} : { translateErrorEventToRhiError }),\n    ...(rawDeviceAccessor === undefined ? {} : { _internal_getRawDevice: rawDeviceAccessor }),\n  };\n  const resolvedInstrumentation = instrumentation ?? backendInstrumentation;\n  return resolvedInstrumentation === undefined\n    ? pack\n    : { ...pack, instrumentation: resolvedInstrumentation };\n}\n\n/** Selects one backend pack; render receives only this typed owner contract. */\nexport async function loadBackendPack(\n  options: RendererOptions | undefined,\n  preferWgpu = false,\n): Promise<\n  | { readonly ok: true; readonly value: RhiBackendPack }\n  | { readonly ok: false; readonly error: RhiError }\n> {\n  const explicit = options?.rhi;\n  if (explicit !== undefined && explicit !== null) {\n    return ok(loadRhiPack({ rhi: explicit, ...(explicit as object) }, options?.rhiInstrumentation));\n  }\n  const nav =\n    typeof globalThis === 'undefined'\n      ? undefined\n      : (globalThis as { navigator?: { gpu?: unknown } }).navigator;\n  if (!preferWgpu && nav?.gpu !== undefined && nav.gpu !== null) {\n    return ok(\n      loadRhiPack(rhiWebgpu as unknown as Record<string, unknown>, options?.rhiInstrumentation),\n    );\n  }\n  try {\n    const mod = (await import('@forgeax/engine-rhi-wgpu')) as Record<string, unknown>;\n    await (mod.ensureReady as () => Promise<unknown>)();\n    return ok(loadRhiPack(mod, options?.rhiInstrumentation));\n  } catch (cause) {\n    return err(\n      new RhiError({\n        code: 'rhi-not-available',\n        expected: 'a usable RHI backend is available',\n        hint: `failed to load wgpu backend: ${String(cause)}`,\n      }),\n    );\n  }\n}\n","import type { AssetRegistry } from '@forgeax/engine-assets-runtime';\nimport type { RenderError, RendererOptions, RenderResult } from '@forgeax/engine-render';\nimport type {\n  BundlerOptions,\n  RendererHostAssembly,\n} from '@forgeax/engine-render/internal/construct-renderer';\nimport { constructRendererHost } from '@forgeax/engine-render/internal/construct-renderer';\nimport { loadBackendPack } from './backend-selection';\n\nexport type {\n  BundlerOptions,\n  RendererHostAssembly,\n} from '@forgeax/engine-render/internal/construct-renderer';\n\n/** Assemble renderer plus asset services in the Runtime-owned backend host. */\nexport async function constructRuntimeRendererHost(\n  canvas: unknown,\n  options?: RendererOptions,\n  bundler?: BundlerOptions,\n): Promise<RenderResult<RendererHostAssembly, RenderError>> {\n  const first = await loadBackendPack(options);\n  if (!first.ok) throw first.error;\n  const constructed = await constructRendererHost(canvas, options, bundler, first.value);\n  if (constructed.ok || options?.rhi !== undefined || typeof globalThis === 'undefined') {\n    return constructed;\n  }\n  const fallback = await loadBackendPack(options, true);\n  if (!fallback.ok) return constructed;\n  return constructRendererHost(canvas, options, bundler, fallback.value);\n}\n\nexport { loadRhiPack } from './backend-selection';\nexport type { AssetRegistry };\n"]}
+{"version":3,"sources":["../src/backend-selection.ts","../src/renderer-host.ts"],"names":[],"mappings":"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","file":"renderer-host.mjs","sourcesContent":["import type { RendererOptions } from '@forgeax/engine-render';\nimport type { RhiBackendPack } from '@forgeax/engine-render/internal/construct-renderer';\nimport { err, ok, RhiError } from '@forgeax/engine-rhi';\nimport * as rhiWebgpu from '@forgeax/engine-rhi-webgpu';\n\nexport function loadRhiPack(\n  mod: Record<string, unknown>,\n  instrumentation?: RhiBackendPack['instrumentation'],\n): RhiBackendPack {\n  const rhi = mod.rhi as unknown as RhiBackendPack['rhi'];\n  const createShaderModule = mod.createShaderModule as\n    | RhiBackendPack['createShaderModule']\n    | undefined;\n  const createShaderModuleImmediate = mod.createShaderModuleImmediate as\n    | RhiBackendPack['createShaderModuleImmediate']\n    | undefined;\n  const translateErrorEventToRhiError = mod.translateErrorEventToRhiError as\n    | RhiBackendPack['translateErrorEventToRhiError']\n    | undefined;\n  const rawDeviceAccessor = mod._internal_getRawDevice as unknown as\n    | RhiBackendPack['_internal_getRawDevice']\n    | undefined;\n  const backendInstrumentation = mod.instrumentation as\n    | RhiBackendPack['instrumentation']\n    | undefined;\n  const pack: RhiBackendPack = {\n    rhi,\n    ...(createShaderModule === undefined ? {} : { createShaderModule }),\n    ...(createShaderModuleImmediate === undefined ? {} : { createShaderModuleImmediate }),\n    ...(translateErrorEventToRhiError === undefined ? {} : { translateErrorEventToRhiError }),\n    ...(rawDeviceAccessor === undefined ? {} : { _internal_getRawDevice: rawDeviceAccessor }),\n  };\n  const resolvedInstrumentation = instrumentation ?? backendInstrumentation;\n  return resolvedInstrumentation === undefined\n    ? pack\n    : { ...pack, instrumentation: resolvedInstrumentation };\n}\n\n/** Selects one backend pack; render receives only this typed owner contract. */\nexport async function loadBackendPack(\n  options: RendererOptions | undefined,\n  preferWgpu = false,\n): Promise<\n  | { readonly ok: true; readonly value: RhiBackendPack }\n  | { readonly ok: false; readonly error: RhiError }\n> {\n  const explicit = options?.rhi;\n  if (explicit !== undefined && explicit !== null) {\n    return ok(loadRhiPack({ rhi: explicit, ...(explicit as object) }, options?.rhiInstrumentation));\n  }\n  const nav =\n    typeof globalThis === 'undefined'\n      ? undefined\n      : (globalThis as { navigator?: { gpu?: unknown } }).navigator;\n  if (!preferWgpu && nav?.gpu !== undefined && nav.gpu !== null) {\n    return ok(\n      loadRhiPack(rhiWebgpu as unknown as Record<string, unknown>, options?.rhiInstrumentation),\n    );\n  }\n  try {\n    const mod = (await import('@forgeax/engine-rhi-wgpu')) as Record<string, unknown>;\n    await (mod.ensureReady as () => Promise<unknown>)();\n    return ok(loadRhiPack(mod, options?.rhiInstrumentation));\n  } catch (cause) {\n    return err(\n      new RhiError({\n        code: 'rhi-not-available',\n        expected: 'a usable RHI backend is available',\n        hint: `failed to load wgpu backend: ${String(cause)}`,\n      }),\n    );\n  }\n}\n","import type { AssetRegistry } from '@forgeax/engine-assets-runtime';\nimport type { RenderError, RendererOptions, RenderResult } from '@forgeax/engine-render';\nimport type {\n  BundlerOptions,\n  RendererHostAssembly,\n} from '@forgeax/engine-render/internal/construct-renderer';\nimport {\n  constructRendererHost,\n  EngineEnvironmentError,\n} from '@forgeax/engine-render/internal/construct-renderer';\nimport { loadBackendPack } from './backend-selection';\n\nexport type {\n  BundlerOptions,\n  RendererHostAssembly,\n} from '@forgeax/engine-render/internal/construct-renderer';\n\nconst FALLBACK_ERROR_CODES = new Set([\n  'adapter-unavailable',\n  'request-adapter-threw',\n  'feature-not-enabled',\n  'limit-exceeded',\n  'rhi-not-available',\n  'device-lost',\n  'oom',\n]);\n\nfunction canFallbackToWgpu(error: unknown): boolean {\n  if (!(error instanceof EngineEnvironmentError)) return false;\n  const webgpuError = error.detail.webgpuError;\n  if (webgpuError === undefined || typeof webgpuError !== 'object') return false;\n  if (!('code' in webgpuError)) return false;\n  const code = webgpuError.code;\n  return typeof code === 'string' && FALLBACK_ERROR_CODES.has(code);\n}\n\n/** Assemble renderer plus asset services in the Runtime-owned backend host. */\nexport async function constructRuntimeRendererHost(\n  canvas: unknown,\n  options?: RendererOptions,\n  bundler?: BundlerOptions,\n): Promise<RenderResult<RendererHostAssembly, RenderError | EngineEnvironmentError>> {\n  const first = await loadBackendPack(options);\n  if (!first.ok) throw first.error;\n  const constructed = await constructRendererHost(canvas, options, bundler, first.value);\n  if (\n    constructed.ok ||\n    options?.rhi !== undefined ||\n    typeof globalThis === 'undefined' ||\n    !canFallbackToWgpu(constructed.error)\n  ) {\n    return constructed;\n  }\n  const fallback = await loadBackendPack(options, true);\n  if (!fallback.ok) return constructed;\n  return constructRendererHost(canvas, options, bundler, fallback.value);\n}\n\nexport { loadRhiPack } from './backend-selection';\nexport type { AssetRegistry };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-runtime",
-  "version": "0.1.6",
+  "version": "0.1.19",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -26,37 +26,37 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-animation": "0.1.6",
-    "@forgeax/engine-assets-runtime": "0.1.6",
-    "@forgeax/engine-audio-webaudio": "0.1.6",
-    "@forgeax/engine-codec": "0.1.6",
-    "@forgeax/engine-debug-draw": "0.1.6",
-    "@forgeax/engine-ecs": "0.1.6",
-    "@forgeax/engine-font": "0.1.6",
-    "@forgeax/engine-geometry": "0.1.6",
-    "@forgeax/engine-graphics-extras": "0.1.6",
-    "@forgeax/engine-image": "0.1.6",
-    "@forgeax/engine-input": "0.1.6",
-    "@forgeax/engine-math": "0.1.6",
-    "@forgeax/engine-pack": "0.1.6",
-    "@forgeax/engine-profiler": "0.1.6",
-    "@forgeax/engine-render": "0.1.6",
-    "@forgeax/engine-render-graph": "0.1.6",
-    "@forgeax/engine-rhi": "0.1.6",
-    "@forgeax/engine-rhi-null": "0.1.6",
-    "@forgeax/engine-rhi-webgpu": "0.1.6",
-    "@forgeax/engine-rhi-wgpu": "0.1.6",
-    "@forgeax/engine-scene": "0.1.6",
-    "@forgeax/engine-shader": "0.1.6",
-    "@forgeax/engine-skinning": "0.1.6",
-    "@forgeax/engine-types": "0.1.6",
-    "@forgeax/engine-vfx": "0.1.6"
+    "@forgeax/engine-animation": "0.1.19",
+    "@forgeax/engine-assets-runtime": "0.1.19",
+    "@forgeax/engine-audio-webaudio": "0.1.19",
+    "@forgeax/engine-codec": "0.1.19",
+    "@forgeax/engine-debug-draw": "0.1.19",
+    "@forgeax/engine-ecs": "0.1.19",
+    "@forgeax/engine-font": "0.1.19",
+    "@forgeax/engine-geometry": "0.1.19",
+    "@forgeax/engine-graphics-extras": "0.1.19",
+    "@forgeax/engine-image": "0.1.19",
+    "@forgeax/engine-input": "0.1.19",
+    "@forgeax/engine-math": "0.1.19",
+    "@forgeax/engine-pack": "0.1.19",
+    "@forgeax/engine-profiler": "0.1.19",
+    "@forgeax/engine-render": "0.1.19",
+    "@forgeax/engine-render-graph": "0.1.19",
+    "@forgeax/engine-rhi": "0.1.19",
+    "@forgeax/engine-rhi-null": "0.1.19",
+    "@forgeax/engine-rhi-webgpu": "0.1.19",
+    "@forgeax/engine-rhi-wgpu": "0.1.19",
+    "@forgeax/engine-scene": "0.1.19",
+    "@forgeax/engine-shader": "0.1.19",
+    "@forgeax/engine-skinning": "0.1.19",
+    "@forgeax/engine-types": "0.1.19",
+    "@forgeax/engine-vfx": "0.1.19"
   },
   "devDependencies": {
-    "@forgeax/engine-import": "0.1.6",
-    "@forgeax/engine-naga": "0.1.6",
-    "@forgeax/engine-state": "0.1.6",
-    "@forgeax/engine-vite-plugin-shader": "0.1.6",
+    "@forgeax/engine-import": "0.1.19",
+    "@forgeax/engine-naga": "0.1.19",
+    "@forgeax/engine-state": "0.1.19",
+    "@forgeax/engine-vite-plugin-shader": "0.1.19",
     "@types/node": "^20.14.0"
   },
   "forgeax": {

package/src/__tests__/asset-registry-guid-reverse.test.ts

@@ -18,6 +18,7 @@ import * as SceneOwner from '@forgeax/engine-scene';
 import {
   type Asset,
   AssetRegistry,
+  HANDLE_CUBE,
   resolveAssetHandle,
   SceneCollectAssetGuidUnresolvedError,
 } from '@forgeax/engine-assets-runtime';
@@ -205,6 +206,38 @@ describe('m1-t2 — uncatalogued scene MISS path', () => {
   });
 });
 
+describe('builtin reverse lookup ownership', () => {
+  it('collects a builtin mesh GUID without cataloguing the process-static payload', () => {
+    const registry = { guidOf: () => undefined };
+    const world = new World();
+    prepareWorld(world);
+    const scene: SceneAsset = {
+      kind: 'scene',
+      entities: [
+        {
+          localId: 0 as never,
+          components: {
+            Transform: {},
+            MeshFilter: { assetHandle: HANDLE_CUBE as never },
+          },
+        },
+      ],
+    };
+    const sceneHandle = world.allocSharedRef<'SceneAsset', SceneAsset>('SceneAsset', scene);
+    const instantiated = SceneOwner.worldInstantiateScene(world, sceneHandle);
+    expect(instantiated.ok).toBe(true);
+    if (!instantiated.ok) return;
+
+    const collected = rootsToSceneAsset(registry, world, [instantiated.value.root]);
+    expect(collected.ok).toBe(true);
+    if (!collected.ok) return;
+    const meshEntity = collected.value.entities.find(
+      (entity) => entity.components.MeshFilter !== undefined,
+    );
+    expect(meshEntity?.components.MeshFilter?.assetHandle).toBe(GUID_A);
+  });
+});
+
 // ── w14 (M4) PROBE: mounted-scene-with-material identity anchor ──────────
 //
 // feat-20260713 M4 / w14 (D-6, probe-first). Empirically anchors the true

package/src/__tests__/dawn/instances-per-instance-pbr.dawn.test.ts

@@ -10,11 +10,8 @@
 // AC-01: PBR instances=N vs instances=1 frames differ (diffCount>0).
 // AC-06: single entity + N instance reads meshes[0] (not meshes[instance_index]).
 //
-// Red phase (current): the shader reads meshes[instance_index].worldFromLocal
-// -- all N copies collapse to entity origin. The two frames are identical
-// (diffCount===0) because instance=1 at origin and instances=N all at origin
-// produce the same pixel pattern. GREEN after w4 lands (PBR vs_main reads
-// meshes[0] + instances[idx]).
+// The PBR vertex path must combine the entity transform from meshes[0] with
+// the per-instance transform selected by instance_index.
 //
 // Dual-state methodology: render to two textures (instances=N vs instances=1),
 // read back both, count pixels that differ by more than epsilon. The
@@ -52,6 +49,11 @@ const INSTANCE_GRID_Y = 3;
 const INSTANCE_GRID_Z = 2;
 const INSTANCE_COUNT = INSTANCE_GRID_X * INSTANCE_GRID_Y * INSTANCE_GRID_Z; // 30
 const SPACING = 2.5;
+// Windows Dawn first-touch attempts have reached about 80 seconds for this
+// two-renderer PBR/readback probe. Keep the test bounded, but above the
+// project-wide 30-second budget so retries do not turn a slow valid probe into
+// a cancelled nightly job.
+const PBR_DAWN_TEST_TIMEOUT_MS = 120_000;
 
 function buildTranslationGrid(): Float32Array {
   const out = new Float32Array(INSTANCE_COUNT * 16);
@@ -85,8 +87,10 @@ const ENGINE_MANIFEST_URL = `data:application/json,${encodeURIComponent(
   JSON.stringify(ENGINE_MANIFEST),
 )}`;
 
-describe('w2 -- PBR dual-state dawn smoke (AC-01 / AC-06, RED before w4)', () => {
-  it('instances=N vs instances=1: frames differ in pixel diff count (currently RED)', async () => {
+describe('w2 -- PBR dual-state dawn smoke (AC-01 / AC-06)', () => {
+  it('instances=N vs instances=1: frames differ in pixel diff count', {
+    timeout: PBR_DAWN_TEST_TIMEOUT_MS,
+  }, async () => {
     const dawnAvailable = typeof globalThis.navigator?.gpu?.requestAdapter === 'function';
     if (!dawnAvailable) {
       throw new Error('dawn-node navigator.gpu not injected; vitest.setup-webgpu.ts regressed');
@@ -366,9 +370,6 @@ describe('w2 -- PBR dual-state dawn smoke (AC-01 / AC-06, RED before w4)', () =>
 
     // AC-01: diffCount>0 -- the two frames must differ (instances=N spreads
     // to distinct positions, instances=1 renders at entity origin only).
-    // RED before w4: all N copies collapse to entity origin, so both frames
-    // render the same cube at the same position -> diffCount===0.
-    // Currently RED: diffCount===0 because shader doesn't read @group(3)
     expect(diffCount).toBeGreaterThan(0);
     // Also verify the N-instance frame has substantial non-clear pixels
     // (proves instances rendered, not just an empty frame)
@@ -377,7 +378,7 @@ describe('w2 -- PBR dual-state dawn smoke (AC-01 / AC-06, RED before w4)', () =>
   });
 
   // w5 -- unlit dual-state: N unlit instances at distinct NDC positions (AC-02)
-  it('unlit Instances=N vs instances=1: frames differ (RED before w5)', async () => {
+  it('unlit Instances=N vs instances=1: frames differ', async () => {
     const dawnAvailable_2 = typeof globalThis.navigator?.gpu?.requestAdapter === 'function';
     if (!dawnAvailable_2) {
       throw new Error('dawn-node navigator.gpu not injected');

package/src/__tests__/dawn/material-cooked-fixture.dawn.test.ts

@@ -3,9 +3,22 @@ import { fileURLToPath } from 'node:url';
 import { describe, expect, it } from 'vitest';
 
 type CookedRecord = {
-  readonly key: string;
-  readonly bytes: string;
-  readonly values: unknown;
+  readonly specializationKey: string;
+  readonly artifactDigest: string;
+  readonly artifact: { readonly digest: string; readonly bytes: readonly number[] };
+  readonly resolved?: {
+    readonly values?: unknown;
+  };
+  readonly receipt?: {
+    readonly identity?: {
+      readonly layoutIdentity?: string;
+      readonly programIdentity?: string;
+      readonly pipelineIdentity?: string;
+      readonly cookIdentity?: string;
+      readonly compilerFingerprint?: string;
+    };
+    readonly schemaVersion?: string;
+  };
 };
 
 type MaterialRow = {
@@ -34,9 +47,29 @@ describe('custom-shader cooked MaterialAsset fixture', () => {
     const derived = fixture.assets.find((asset) => asset.payload.role === 'derived');
     expect(root?.payload.cooked).toBeDefined();
     expect(derived?.payload.cooked).toBeDefined();
-    expect(derived?.payload.cooked?.key).toBe(root?.payload.cooked?.key);
-    expect(derived?.payload.cooked?.bytes).toBe(root?.payload.cooked?.bytes);
-    expect(derived?.payload.cooked?.values).toEqual(root?.payload.cooked?.values);
+    expect(derived?.payload.cooked?.specializationKey).toBe(
+      root?.payload.cooked?.specializationKey,
+    );
+    expect(derived?.payload.cooked?.artifactDigest).toBe(root?.payload.cooked?.artifactDigest);
+    expect(derived?.payload.cooked?.artifact.bytes).toEqual(root?.payload.cooked?.artifact.bytes);
+    expect(derived?.payload.cooked?.resolved?.values).toEqual(
+      root?.payload.cooked?.resolved?.values,
+    );
+  });
+
+  it('keeps cooked layout identity and authored coordinate transforms', () => {
+    const root = fixture.assets.find((asset) => asset.payload.role === 'root');
+    const cooked = root?.payload.cooked;
+    expect(cooked?.receipt?.schemaVersion).toBe('material-cook/3');
+    expect(cooked?.receipt?.identity?.layoutIdentity).toMatch(/^sha256-/);
+    expect(cooked?.receipt?.identity?.programIdentity).toMatch(/^sha256:/);
+    expect(cooked?.receipt?.identity?.pipelineIdentity).toMatch(/^sha256:/);
+    expect(cooked?.receipt?.identity?.cookIdentity).toMatch(/^sha256:/);
+    expect(cooked?.receipt?.identity?.compilerFingerprint).toMatch(/^sha256-/);
+    expect(cooked?.resolved?.values).toMatchObject({
+      baseColorUvTransform: [0, 0, 1, 1],
+      normalUvTransform: [0.125, 0.25, 2, 2],
+    });
   });
 
   it('runs the real Dawn path for exactly 300 frames without unexpected RHI errors', () => {

package/src/__tests__/errors.unit.test.ts

@@ -418,14 +418,30 @@ type RuntimeLayerError = RenderError | AssetRuntimeError | SkinError;
               return 'recovery failed';
             case 'cleanup-failed':
               return 'cleanup failed';
+            case 'scene-data-unavailable':
+              return 'scene data unavailable';
             case 'frame-receipt-stale':
               return 'frame receipt stale';
             case 'renderer-contract-failed':
               return 'renderer contract failed';
             case 'observation-unavailable':
               return 'observation unavailable';
+            case 'taa-unavailable':
+              return 'taa unavailable';
             case 'shadow-invalid-config':
               return 'shadow invalid config';
+            case 'environment-source-conflict':
+              return 'environment source conflict';
+            case 'fog-cardinality':
+              return 'fog cardinality';
+            case 'taa-caps-insufficient':
+              return 'taa caps insufficient';
+            case 'environment-generation-failed':
+              return 'environment generation failed';
+            case 'atmosphere-invalid-parameter':
+              return 'atmosphere invalid parameter';
+            case 'owner-stage-failed':
+              return 'owner stage failed';
             case 'skin-joint-count-exceeded':
               return 'skin joint count exceeded';
             case 'skin-joint-despawned':
@@ -500,6 +516,20 @@ type RuntimeLayerError = RenderError | AssetRuntimeError | SkinError;
               return 'render feature prepared state mismatch';
             case 'render-feature-draw-recording-failed':
               return 'render feature draw recording failed';
+            case 'points-lines-invalid-style':
+              return 'points lines invalid style';
+            case 'points-lines-topology-mismatch':
+              return 'points lines topology mismatch';
+            case 'points-lines-style-unsupported':
+              return 'points lines style unsupported';
+            case 'points-lines-material-unsupported':
+              return 'points lines material unsupported';
+            case 'points-lines-budget-exceeded':
+              return 'points lines budget exceeded';
+            case 'points-lines-prepare-failed':
+              return 'points lines prepare failed';
+            case 'transmission-capability-missing':
+              return 'transmission capability missing';
           }
         }
         expect(exhaustive('equirect-projection-failed')).toBe('equirect projection failed');
@@ -550,14 +580,30 @@ type RuntimeLayerError = RenderError | AssetRuntimeError | SkinError;
               return 'ok';
             case 'cleanup-failed':
               return 'ok';
+            case 'scene-data-unavailable':
+              return 'ok';
             case 'frame-receipt-stale':
               return 'ok';
             case 'renderer-contract-failed':
               return 'ok';
             case 'observation-unavailable':
               return 'ok';
+            case 'taa-unavailable':
+              return 'ok';
             case 'shadow-invalid-config':
               return 'ok';
+            case 'environment-source-conflict':
+              return 'ok';
+            case 'fog-cardinality':
+              return 'ok';
+            case 'taa-caps-insufficient':
+              return 'ok';
+            case 'environment-generation-failed':
+              return 'ok';
+            case 'atmosphere-invalid-parameter':
+              return 'ok';
+            case 'owner-stage-failed':
+              return 'ok';
             case 'skin-joint-count-exceeded':
               return 'ok';
             case 'skin-joint-despawned':
@@ -620,6 +666,20 @@ type RuntimeLayerError = RenderError | AssetRuntimeError | SkinError;
               return 'ok';
             case 'render-feature-draw-recording-failed':
               return 'ok';
+            case 'points-lines-invalid-style':
+              return 'ok';
+            case 'points-lines-topology-mismatch':
+              return 'ok';
+            case 'points-lines-style-unsupported':
+              return 'ok';
+            case 'points-lines-material-unsupported':
+              return 'ok';
+            case 'points-lines-budget-exceeded':
+              return 'ok';
+            case 'points-lines-prepare-failed':
+              return 'ok';
+            case 'transmission-capability-missing':
+              return 'ok';
           }
         }
         expect(exhaustive('hdrp-deferred-caps-insufficient')).toBe('ok');

package/src/__tests__/extract-record-no-hardcoded-texture-fields.test.ts

@@ -12,16 +12,15 @@
 // not actually happen — the 4th texture (heightTexture) would silently fall
 // through.
 //
-// Scope of the gate — the three USER-REGION texture fields only:
+// Scope of the gate — the three user-authored base texture fields:
 //   baseColorTexture / metallicRoughnessTexture / normalTexture
 // These are the fields `derive(default-standard-pbr).textureFieldNames`
 // produces and that w7/w8 route through iteration.
 //
 // Deliberately NOT gated (legitimate residual naming):
-//   - emissiveTexture / occlusionTexture: these live in the engine-injection
-//     LIGHTMAP region (appendInjection 'lightmap'), are NOT in any paramSchema
-//     textureFieldNames set, and are assembled by the injection path — naming
-//     them there is the engine-managed region, not user-region hardcoding.
+//   - emissiveTexture / occlusionTexture: legacy engine-owned snapshot fields
+//     still have named reads, while the production Standard BGL no longer adds
+//     a duplicate lightmap region.
 //   - USER_REGION_TEXTURE_FIELDS in derive-paramschema.ts: the 3-field
 //     register-time under-declaration validator (charter P3 safety net from
 //     the 4.3 blending regression). Orthogonal to binding; lives in a