@forgeax/engine-render 0.1.24 → 0.1.25

package/dist/{chunk-Z3YYH2MB.mjs → chunk-N3RT2EUR.mjs}

@@ -1,8 +1,8 @@
 import { GlyphText, selectActiveCameraIndex, getActiveCamera } from './chunk-FJ6P52EE.mjs';
-import { MeshRenderer, MeshFilter, DirectionalLight, validateDirectionalLightData, PointLight, computeInvRangeSquared, SpotLight, degToCos, RectAreaLight, validateRectAreaLightData, directionalShadowQualityFromF32, PointLightShadow, Skylight, LightProbe, validateLightProbeData, SkyboxBackground, Atmosphere, Instances, Layer, Points, Lines, SortKey, resolveMeshMaterialBindings, pointShapeFromU32, PostProcessParams, CubeCamera, cubeCameraUpdateIntentFromF32, ReflectionProbe, reflectionProbeUpdateIntentFromF32, tonemapToU32, resolveVisibility, Fog, VolumetricFog, resolveSelectedVolumetricLight, extractVolumetricFog, MotionBlur, Camera, bloomEnabledFromF32, antialiasFromF32, tonemapFromF32, cameraProjectionFromF32 } from './chunk-Q752SHI5.mjs';
+import { MeshRenderer, MeshFilter, DirectionalLight, validateDirectionalLightData, PointLight, computeInvRangeSquared, SpotLight, degToCos, RectAreaLight, validateRectAreaLightData, directionalShadowQualityFromF32, PointLightShadow, Skylight, LightProbe, validateLightProbeData, SkyboxBackground, Atmosphere, Instances, Layer, Points, Lines, SortKey, resolveMeshMaterialBindings, pointShapeFromU32, PostProcessParams, CubeCamera, cubeCameraUpdateIntentFromF32, ReflectionProbe, reflectionProbeUpdateIntentFromF32, tonemapToU32, resolveVisibility, Fog, VolumetricFog, resolveSelectedVolumetricLight, extractVolumetricFog, MotionBlur, Camera, bloomEnabledFromF32, antialiasFromF32, tonemapFromF32, cameraProjectionFromF32 } from './chunk-ADHHVYLW.mjs';
 import { SpriteRegionOverride, SpriteInstances } from './chunk-JDWARUOI.mjs';
-import { PROBE_BLEND_RECORD_CAPACITY, GPU_BUFFER_USAGE_MAP_READ, GPU_BUFFER_USAGE_VERTEX, GPU_BUFFER_USAGE_COPY_DST, IES_SLICE_CAPACITY, COOKIE_SLICE_CAPACITY, isStandardPbrSkinMaterialShader, selectPasses, resolveRenderTargetMaterialSource, isCanonicalStandardPbrMaterialShader, isStandardPbrMaterialShader, PROBE_BLEND_RECORD_BYTE_SIZE, GPU_BUFFER_USAGE_QUERY_RESOLVE, GPU_BUFFER_USAGE_COPY_SRC, COOKIE_SLICE_SIZE } from './chunk-KZFTK6DO.mjs';
-import { STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, SHADOW_ATLAS_DEFAULT_LAYERS, SkinMaterialMismatchError, MaterialSkinAttrMissingError, ShadowInvalidConfigError, EnvironmentSourceConflictError, FogCardinalityError, AtmosphereInvalidParameterError } from './chunk-RR5L4SRS.mjs';
+import { PROBE_BLEND_RECORD_CAPACITY, GPU_BUFFER_USAGE_MAP_READ, GPU_BUFFER_USAGE_VERTEX, GPU_BUFFER_USAGE_COPY_DST, IES_SLICE_CAPACITY, COOKIE_SLICE_CAPACITY, isStandardPbrSkinMaterialShader, selectPasses, resolveRenderTargetMaterialSource, isCanonicalStandardPbrMaterialShader, isStandardPbrMaterialShader, PROBE_BLEND_RECORD_BYTE_SIZE, GPU_BUFFER_USAGE_QUERY_RESOLVE, GPU_BUFFER_USAGE_COPY_SRC, COOKIE_SLICE_SIZE } from './chunk-HKXTW355.mjs';
+import { STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, SHADOW_ATLAS_DEFAULT_LAYERS, SkinMaterialMismatchError, MaterialSkinAttrMissingError, ShadowInvalidConfigError, EnvironmentSourceConflictError, FogCardinalityError, AtmosphereInvalidParameterError } from './chunk-ZZ4YQ474.mjs';
 import { err, ok, RhiError } from '@forgeax/engine-rhi';
 import { resolveAssetHandle, walkMaterialPassesOverSharedRefs } from '@forgeax/engine-assets-runtime';
 import { SpawnLightInvalidBoundsError, routeWorldError, SpriteInstancesMutuallyExclusiveWithInstancesError, SpriteInstancesRequiresSpriteShaderError, SpriteInstancesCountMismatchError, InstanceTransformsStrideMismatchError, readRenderArrayView } from '@forgeax/engine-ecs/projection';
@@ -1641,7 +1641,10 @@ function extractFrames(worlds, owner, assets, pipelineState, materialSnapshotCac
         },
         cull: options.cull === "none" ? "none" : isCameraOwner ? "self" : "external",
         renderables: options.renderables ?? "full",
+        ...options.renderableEntitiesByWorld?.[wi] === void 0 ? {} : { renderableEntities: options.renderableEntitiesByWorld[wi] },
+        retainHidden: options.retainHidden ?? false,
         ...options.getMaterialShaderArtifact === void 0 ? {} : { getMaterialShaderArtifact: options.getMaterialShaderArtifact },
+        ...options.instanceCollections === void 0 ? {} : { instanceCollections: options.instanceCollections },
         ...cameraOwnerFrame2 === void 0 ? {} : { cullCameras: cameraOwnerFrame2.cameras }
       });
       const frame = extractFrame(world, prepared);
@@ -1814,6 +1817,24 @@ function extractFrames(worlds, owner, assets, pipelineState, materialSnapshotCac
     const worldId = succeededIndices[index] ?? 0;
     return (f.reflectionProbes ?? []).map((probe) => ({ ...probe, worldId }));
   });
+  if (options.renderables !== "none" && options.renderableEntitiesByWorld === void 0) {
+    options.instanceCollections?.retain(
+      new Set(
+        renderables.flatMap(
+          (row) => row.instances?.collectionId === void 0 ? [] : [row.instances.collectionId]
+        )
+      )
+    );
+    if (skinPaletteAllocator !== null && typeof skinPaletteAllocator.retainSliceKeys === "function") {
+      skinPaletteAllocator.retainSliceKeys(
+        new Set(
+          renderables.flatMap(
+            (row) => row.skin === void 0 ? [] : [`${worlds[row.worldId]?.identity ?? row.worldId}:${row.entityKey}`]
+          )
+        )
+      );
+    }
+  }
   return {
     cameras,
     auxiliaryCameras,
@@ -1885,7 +1906,10 @@ function extractFrame(world, context) {
     materialSnapshotCache: persistentMaterialSnapshotCache,
     cull: cullMode,
     resourceOwnerFog,
-    getMaterialShaderArtifact
+    getMaterialShaderArtifact,
+    instanceCollections,
+    renderableEntities,
+    retainHidden
   } = context;
   const fog = resourceOwnerFog === void 0 ? selectFogFrame(world) : resourceOwnerFog ?? void 0;
   const fogFailure = fogState(world).failure;
@@ -2558,7 +2582,6 @@ function extractFrame(world, context) {
   }).unwrap();
   const resolveArchVersion = (entity) => {
     const values = [
-      worldInternal._getArrayView(entity, Instances, "transforms"),
       worldInternal._getArrayView(entity, SpriteInstances, "transforms"),
       worldInternal._getArrayView(entity, SpriteInstances, "regions")
     ];
@@ -2576,6 +2599,9 @@ function extractFrame(world, context) {
     for (const entry of pending) dispatch.push(entry);
   };
   for (const row of meshRendererQuery) {
+    if (context.renderables === "full" && renderableEntities !== void 0 && !renderableEntities.has(row.entity)) {
+      continue;
+    }
     const hasTransform = row.has(Transform);
     const meshFilter = row.get(MeshFilter);
     const hasInstances = row.has(Instances);
@@ -2599,8 +2625,9 @@ function extractFrame(world, context) {
     }
     {
       const entity = row.entity;
-      if (isRenderable && visibility?.effective(entity) === "hidden") {
-        explicitlyHidden.add(entity);
+      const authorVisible = !(isRenderable && visibility?.effective(entity) === "hidden");
+      if (!authorVisible) explicitlyHidden.add(entity);
+      if (!authorVisible && !retainHidden) {
         continue;
       }
       const layerVal = fLayerValue ?? 0;
@@ -2748,7 +2775,9 @@ function extractFrame(world, context) {
             handleRaw,
             renderables.length,
             layerVal,
-            materialSnap.paramSnapshot
+            materialSnap.paramSnapshot,
+            0,
+            materialSnap.materialShaderId
           );
         }
       } else if (handleRaw === 0 || assets === void 0 || assets === null) {
@@ -2771,7 +2800,9 @@ function extractFrame(world, context) {
               handleRaw,
               renderables.length,
               layerVal,
-              materialSnap.paramSnapshot
+              materialSnap.paramSnapshot,
+              0,
+              materialSnap.materialShaderId
             );
           }
         } else {
@@ -2825,7 +2856,7 @@ function extractFrame(world, context) {
             }
             const resolved = resolvedResult.value;
             const allPasses = resolved.passes;
-            const firstPassShader = allPasses.length > 0 ? runtimeMaterialShaderId(allPasses[0]?.program.module, allPasses[0]?.name) : void 0;
+            const firstPassShader = runtimeMaterialShaderIdForMaterial(asset, allPasses, assets);
             const pv = materialValuesToLinearRuntime(
               resolved.values,
               materialColorParameterSchema(resolved.parameters ?? [], firstPassShader, assets),
@@ -3065,7 +3096,9 @@ function extractFrame(world, context) {
                 handleRaw,
                 renderables.length,
                 layerVal,
-                paramSnap
+                paramSnap,
+                0,
+                firstPassShader
               );
             }
           }
@@ -3162,7 +3195,10 @@ function extractFrame(world, context) {
               ibms[jIdx] = ibmFlat.subarray(jIdx * 16, jIdx * 16 + 16);
             }
             if (skinPaletteAllocator !== null) {
-              const slice = skinPaletteAllocator.allocateSlice(skeleton.jointCount);
+              const slice = typeof skinPaletteAllocator.allocateSliceFor === "function" ? skinPaletteAllocator.allocateSliceFor(
+                `${world.identity}:${entity}`,
+                skeleton.jointCount
+              ) : skinPaletteAllocator.allocateSlice(skeleton.jointCount);
               skinPaletteAllocator.writeJointPalette(slice, ibms, jointWorlds);
               skinSlice = {
                 jointCount: slice.jointCount,
@@ -3208,7 +3244,9 @@ function extractFrame(world, context) {
               subHandle,
               renderables.length,
               layerVal,
-              materialsArr[mi]?.paramSnapshot
+              materialsArr[mi]?.paramSnapshot,
+              0,
+              materialsArr[mi]?.materialShaderId
             );
           }
         }
@@ -3306,31 +3344,28 @@ function extractFrame(world, context) {
         };
         let instancesSnap;
         if (hasInstances) {
-          const transforms = worldInternal._getArrayView(entity, Instances, "transforms");
-          if (transforms === void 0) {
-            instancesSnap = {
-              transforms: new Float32Array(),
-              instanceCount: 0,
-              cacheKey: entity,
-              archVersion
-            };
-          } else {
-            const actualLength = transforms.length;
-            if (actualLength % 16 !== 0) {
-              worldInternal._routeError(new InstanceTransformsStrideMismatchError(actualLength), {
+          const transforms = worldInternal._getArrayView(entity, Instances, "transforms") ?? new Float32Array();
+          if (transforms.length % 16 !== 0) {
+            worldInternal._routeError(
+              new InstanceTransformsStrideMismatchError(transforms.length),
+              {
                 severity: Severity.Error,
                 systemName: "RenderSystem.extract (Instances stride)"
-              });
-              continue;
-            }
-            const snapshotCopy = new Float32Array(transforms);
-            instancesSnap = {
-              transforms: snapshotCopy,
-              instanceCount: actualLength / 16,
-              cacheKey: entity,
-              archVersion
-            };
+              }
+            );
+            continue;
           }
+          const projected = instanceCollections?.project(world, entity, transforms);
+          instancesSnap = {
+            transforms: projected?.transforms ?? new Float32Array(transforms),
+            instanceCount: transforms.length / 16,
+            cacheKey: entity,
+            archVersion: projected === void 0 ? fingerprintNumericArray(transforms) : 0,
+            ...projected === void 0 ? {} : {
+              collectionId: projected.collectionId,
+              revision: projected.revision
+            }
+          };
         }
         const baseRenderable = {
           assetHandle: Math.round(fAssetHandle ?? 0),
@@ -3344,7 +3379,9 @@ function extractFrame(world, context) {
           materialBindingDiagnostics,
           worldId: 0,
           entityKey: entity,
+          ...authorVisible ? {} : { authorVisible: false },
           ...skinSlice !== void 0 ? { skin: skinSlice } : {},
+          ...skin?.joints === void 0 ? {} : { skinJointEntities: Array.from(skin.joints, (joint) => Number(joint)) },
           ...morph !== void 0 ? { morph } : {},
           ...instancesSnap !== void 0 ? { instances: instancesSnap } : {},
           ...spriteInstancesSnap !== void 0 ? { spriteInstances: spriteInstancesSnap } : {},
@@ -3516,12 +3553,14 @@ var DEFAULT_FORWARD_PASS = {
   program: { module: "forgeax::default-unlit", vertexEntry: "vs_main", fragmentEntry: "fs_main" },
   renderState: { tags: { LightMode: "Forward" }, queue: 2e3 }
 };
-function appendMaterialDispatchEntries(pendingDispatch, passes, entity, materialHandle, renderableIndex, layer, paramSnapshot, passIndexOffset = 0) {
+function appendMaterialDispatchEntries(pendingDispatch, passes, entity, materialHandle, renderableIndex, layer, paramSnapshot, passIndexOffset = 0, materialShaderIdOverride) {
   const matchedPasses = selectPasses(passes, {});
   for (let pIdx = 0; pIdx < matchedPasses.length; pIdx++) {
     const pass = matchedPasses[pIdx];
     if (pass === void 0) continue;
     const passState = pass.renderState ?? {};
+    const authoredShaderId = runtimeMaterialShaderId(pass.program.module, pass.name);
+    const dispatchShaderId = authoredShaderId === "forgeax::default-shadow-caster" ? authoredShaderId : materialShaderIdOverride ?? authoredShaderId;
     pendingDispatch.push({
       entityIndex: entity,
       materialHandle,
@@ -3536,7 +3575,14 @@ function appendMaterialDispatchEntries(pendingDispatch, passes, entity, material
       defines: void 0,
       vertexEntry: pass.program.vertexEntry,
       fragmentEntry: pass.program.fragmentEntry,
-      materialShaderId: runtimeMaterialShaderId(pass.program.module, pass.name),
+      // A cooked Standard publication supplies one specialization key for its
+      // forward/deferred artifact, but its ShadowCaster pass still owns the
+      // engine depth-only shader. Keep the pass-local canonical identity so a
+      // specialized Standard source (which only declares fs_main/fs_gbuffer)
+      // is never asked to build an fs_shadow pipeline. Authored non-Standard
+      // ShadowCaster modules retain the publication override and continue to
+      // use their producer-owned source.
+      materialShaderId: dispatchShaderId,
       paramSnapshot,
       ...passState.stencilReference !== void 0 && {
         stencilReference: passState.stencilReference
@@ -3632,6 +3678,10 @@ function runtimeMaterialShaderId(module, passName) {
       return module;
   }
 }
+function runtimeMaterialShaderIdForMaterial(material, passes, assets) {
+  const authored = runtimeMaterialShaderId(passes[0]?.program.module, passes[0]?.name);
+  return assets.getMaterialProjectionForPayload(material)?.specializationKey ?? authored;
+}
 function pipelineRenderState(renderState) {
   if (renderState === void 0) return void 0;
   const {
@@ -3888,7 +3938,7 @@ function resolveMaterialSnapshot(handleRaw, world, assetsRef, materialSnapshotCa
   if (!resolvedResult.ok) return defaultMaterialSnapshot(handleRaw);
   const resolved = resolvedResult.value;
   const allPasses = resolved.passes;
-  const firstPassShader = allPasses.length > 0 ? runtimeMaterialShaderId(allPasses[0]?.program.module, allPasses[0]?.name) : void 0;
+  const firstPassShader = runtimeMaterialShaderIdForMaterial(asset, allPasses, assetsRef);
   const pv = materialValuesToLinearRuntime(
     resolved.values,
     materialColorParameterSchema(resolved.parameters ?? [], firstPassShader, assetsRef),
@@ -4359,8 +4409,11 @@ function prepareExtractContext(world, options = {}) {
     cull: options.cull ?? "self",
     cullCameras: options.cullCameras,
     renderables,
+    renderableEntities: options.renderableEntities,
+    retainHidden: options.retainHidden ?? false,
     visibility: renderables === "none" ? ALL_VISIBLE : resolveVisibility(world),
-    getMaterialShaderArtifact: options.getMaterialShaderArtifact
+    getMaterialShaderArtifact: options.getMaterialShaderArtifact,
+    instanceCollections: options.instanceCollections
   };
 }
 var fogQueries = /* @__PURE__ */ new WeakMap();
@@ -5078,5 +5131,5 @@ var ProbeBlendSceneProjection = class {
 };
 
 export { InstanceBoundsCache, OcclusionRenderRuntime, PROBE_MAX_CONTRIBUTORS, ProbeBlendSceneProjection, SKYLIGHT_RECOVERY_FALLBACK, admitProbeContributors, blendLightProbes, buildRectAreaWorldFrame, createCookieProjectionMatrixData, createExtendedLightingState, extractFrames, fingerprintNumericArray, glyphTextLayoutSystem, primitiveKey, primitiveKeyId, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, rectAreaFacesPoint, scaledProbeWeight, setOcclusionRuntimeTestHooks, viewKey, viewKeyId };
-//# sourceMappingURL=chunk-Z3YYH2MB.mjs.map
-//# sourceMappingURL=chunk-Z3YYH2MB.mjs.map
+//# sourceMappingURL=chunk-N3RT2EUR.mjs.map
+//# sourceMappingURL=chunk-N3RT2EUR.mjs.map