@forgeax/engine-render 0.1.24 → 0.1.26

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

@@ -1,10 +1,10 @@
 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, PROBE_BLEND_RECORD_BYTE_SIZE, GPU_BUFFER_USAGE_QUERY_RESOLVE, GPU_BUFFER_USAGE_COPY_SRC, COOKIE_SLICE_SIZE, isStandardPbrMaterialShader } 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 { resolveAssetHandle, walkMaterialPassesOverSharedRefs, selectMaterialPassProgram, materialParametersToParamSchema as materialParametersToParamSchema$1 } from '@forgeax/engine-assets-runtime';
 import { SpawnLightInvalidBoundsError, routeWorldError, SpriteInstancesMutuallyExclusiveWithInstancesError, SpriteInstancesRequiresSpriteShaderError, SpriteInstancesCountMismatchError, InstanceTransformsStrideMismatchError, readRenderArrayView } from '@forgeax/engine-ecs/projection';
 import { vec3, mat4, frustum, box3 } from '@forgeax/engine-math';
 import { AssetGuid } from '@forgeax/engine-pack/guid';
@@ -1639,9 +1639,13 @@ function extractFrames(worlds, owner, assets, pipelineState, materialSnapshotCac
             return cache;
           })()
         },
+        ...options.materialContext === void 0 ? {} : { materialContext: options.materialContext },
         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 +1818,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 +1907,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;
@@ -2539,6 +2564,7 @@ function extractFrame(world, context) {
   const explicitlyHidden = /* @__PURE__ */ new Set();
   let dispatch = [];
   const materialSnapshotCache = /* @__PURE__ */ new Map();
+  const skinnedMaterialSnapshotCache = /* @__PURE__ */ new Map();
   const meshRendererQuery = context.renderables === "none" ? [] : world.query({
     read: [MeshRenderer],
     optional: [
@@ -2558,7 +2584,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 +2601,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 +2627,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 +2777,9 @@ function extractFrame(world, context) {
             handleRaw,
             renderables.length,
             layerVal,
-            materialSnap.paramSnapshot
+            materialSnap.paramSnapshot,
+            0,
+            materialSnap.materialProgramKeys
           );
         }
       } else if (handleRaw === 0 || assets === void 0 || assets === null) {
@@ -2771,7 +2802,9 @@ function extractFrame(world, context) {
               handleRaw,
               renderables.length,
               layerVal,
-              materialSnap.paramSnapshot
+              materialSnap.paramSnapshot,
+              0,
+              materialSnap.materialProgramKeys
             );
           }
         } else {
@@ -2825,7 +2858,23 @@ 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 materialContext = context.materialContext === void 0 ? void 0 : {
+              ...context.materialContext,
+              geometry: hasSkin ? "skinned" : context.materialContext.geometry
+            };
+            const materialProgramKeys = materialProgramKeysForMaterial(
+              asset,
+              assets,
+              materialContext
+            );
+            const authoredFirstPassShader = runtimeMaterialShaderIdForMaterial(
+              allPasses,
+              void 0
+            );
+            const firstPassShader = runtimeMaterialShaderIdForMaterial(
+              allPasses,
+              materialProgramKeys
+            );
             const pv = materialValuesToLinearRuntime(
               resolved.values,
               materialColorParameterSchema(resolved.parameters ?? [], firstPassShader, assets),
@@ -2851,7 +2900,7 @@ function extractFrame(world, context) {
             }
             const materialParamSchema = materialParametersToParamSchema(
               resolved.parameters ?? [],
-              firstPassShader
+              authoredFirstPassShader
             );
             {
               const hasSkinSkel = hasSkin && skinSkeletonView !== void 0 && skinSkeletonView !== void 0 && skinSkeletonView !== 0;
@@ -3013,6 +3062,7 @@ function extractFrame(world, context) {
               },
               normalScale: normalScalePv,
               materialShaderId: firstPassShader,
+              materialProgramKeys,
               materialHandle: handleRaw,
               renderState: pipelineRenderState(allPasses[0]?.renderState),
               paramSnapshot: paramSnap,
@@ -3065,7 +3115,9 @@ function extractFrame(world, context) {
                 handleRaw,
                 renderables.length,
                 layerVal,
-                paramSnap
+                paramSnap,
+                0,
+                materialProgramKeys
               );
             }
           }
@@ -3162,7 +3214,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,
@@ -3184,14 +3239,19 @@ function extractFrame(world, context) {
         if (assets !== void 0 && assets !== null) {
           for (let mi = 1; mi < materialHandles.length; mi++) {
             const subHandle = materialHandles[mi] ?? 0;
-            const cachedSubmaterial = materialSnapshotCache.get(subHandle);
+            const subCache = hasSkin ? skinnedMaterialSnapshotCache : materialSnapshotCache;
+            const cachedSubmaterial = subCache.get(subHandle);
             materialsArr.push(
               cachedSubmaterial?.snapshot ?? resolveMaterialSnapshot(
                 subHandle,
                 world,
                 assets,
-                materialSnapshotCache,
-                persistentMaterialSnapshotCache
+                subCache,
+                hasSkin ? void 0 : persistentMaterialSnapshotCache,
+                context.materialContext === void 0 ? void 0 : {
+                  ...context.materialContext,
+                  geometry: hasSkin ? "skinned" : context.materialContext.geometry
+                }
               )
             );
           }
@@ -3200,7 +3260,11 @@ function extractFrame(world, context) {
           for (let mi = 1; mi < materialHandles.length; mi++) {
             const subHandle = materialHandles[mi] ?? 0;
             if (subHandle === handleRaw) continue;
-            const subEntry = materialSnapshotCache.get(subHandle) ?? readPersistentMaterialSnapshot(persistentMaterialSnapshotCache, subHandle, assets);
+            const subEntry = (hasSkin ? skinnedMaterialSnapshotCache : materialSnapshotCache).get(subHandle) ?? (hasSkin ? void 0 : readPersistentMaterialSnapshot(
+              persistentMaterialSnapshotCache,
+              subHandle,
+              assets
+            ));
             appendMaterialDispatchEntries(
               pendingDispatch,
               subEntry?.passes ?? (subHandle === 0 ? [DEFAULT_FORWARD_PASS] : []),
@@ -3208,7 +3272,9 @@ function extractFrame(world, context) {
               subHandle,
               renderables.length,
               layerVal,
-              materialsArr[mi]?.paramSnapshot
+              materialsArr[mi]?.paramSnapshot,
+              0,
+              materialsArr[mi]?.materialProgramKeys
             );
           }
         }
@@ -3306,31 +3372,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 +3407,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 +3581,16 @@ 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, materialProgramKeys) {
   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 = materialProgramKeys === void 0 ? authoredShaderId : materialProgramKeys[pass.name];
+    if (materialProgramKeys !== void 0 && dispatchShaderId === void 0)
+      throw new Error(`Missing published material program for Pass ${pass.name}`);
     pendingDispatch.push({
       entityIndex: entity,
       materialHandle,
@@ -3536,7 +3605,7 @@ function appendMaterialDispatchEntries(pendingDispatch, passes, entity, material
       defines: void 0,
       vertexEntry: pass.program.vertexEntry,
       fragmentEntry: pass.program.fragmentEntry,
-      materialShaderId: runtimeMaterialShaderId(pass.program.module, pass.name),
+      materialShaderId: dispatchShaderId,
       paramSnapshot,
       ...passState.stencilReference !== void 0 && {
         stencilReference: passState.stencilReference
@@ -3632,6 +3701,39 @@ function runtimeMaterialShaderId(module, passName) {
       return module;
   }
 }
+function materialProgramKeysForMaterial(material, assets, context) {
+  const projection = assets.getMaterialProjectionForPayload(material);
+  if (projection === void 0) return void 0;
+  if (context === void 0)
+    throw new Error("Published material selection requires renderer-owned compiler context");
+  return Object.fromEntries(
+    projection.passes.map((pass) => {
+      const mode = String(
+        pass.renderState?.tags?.LightMode ?? pass.name
+      );
+      const selectedContext = {
+        ...context,
+        pass: /shadow/i.test(mode) ? "shadow" : /depth/i.test(mode) ? "depth" : "forward",
+        pipeline: /deferred|gbuffer/i.test(mode) ? "deferred" : context.pipeline
+      };
+      return [
+        pass.name,
+        selectMaterialPassProgram(projection, pass.name, selectedContext).specializationKey
+      ];
+    })
+  );
+}
+function runtimeMaterialShaderIdForMaterial(passes, programs) {
+  const pass = passes.find(
+    (pass2) => !/shadow|depth/i.test(
+      String(
+        pass2.renderState?.tags?.LightMode ?? pass2.name
+      )
+    )
+  ) ?? passes[0];
+  if (pass === void 0) return void 0;
+  return programs === void 0 ? runtimeMaterialShaderId(pass.program.module, pass.name) : programs[pass.name];
+}
 function pipelineRenderState(renderState) {
   if (renderState === void 0) return void 0;
   const {
@@ -3769,30 +3871,8 @@ function isEngineInjectedTextureField(shaderId, fieldName) {
   return isStandardPbrMaterialShader(shaderId) && ENGINE_INJECTED_TEXTURE_FIELDS.has(fieldName);
 }
 function materialParametersToParamSchema(parameters, shaderId) {
-  if (isCanonicalStandardPbrMaterialShader(shaderId)) {
-    return STANDARD_PIPELINE_PARAM_SCHEMA;
-  }
-  const engineInjectedTextureFields = isStandardPbrMaterialShader(shaderId) ? ENGINE_INJECTED_TEXTURE_FIELDS : void 0;
-  return parameters.flatMap((parameter) => {
-    if (parameter.type === "bool") return [];
-    if (parameter.type === "texture" || parameter.type === "texture_cube") {
-      if (engineInjectedTextureFields?.has(parameter.name) === true) return [];
-      return [
-        {
-          name: parameter.name,
-          type: parameter.type === "texture_cube" ? "texture_cube" : "texture2d",
-          default: parameter.default
-        }
-      ];
-    }
-    const numericDefault = typeof parameter.default === "number" ? parameter.default : Array.isArray(parameter.default) && parameter.default.every((entry) => typeof entry === "number") ? parameter.default : void 0;
-    const numericEntry = {
-      name: parameter.name,
-      type: parameter.type,
-      ...parameter.colorSpace === void 0 ? {} : { colorSpace: parameter.colorSpace }
-    };
-    return numericDefault === void 0 ? [numericEntry] : [{ ...numericEntry, default: numericDefault }];
-  });
+  if (isCanonicalStandardPbrMaterialShader(shaderId)) return STANDARD_PIPELINE_PARAM_SCHEMA;
+  return materialParametersToParamSchema$1(parameters);
 }
 function materialColorParameterSchema(parameters, shaderId, assets) {
   if (shaderId === void 0) return parameters;
@@ -3857,7 +3937,7 @@ function storeMaterialSnapshot(cache, handleRaw, snapshot, passes, root, assets)
   cache.set(handleRaw, entry);
   return entry;
 }
-function resolveMaterialSnapshot(handleRaw, world, assetsRef, materialSnapshotCache, persistentMaterialSnapshotCache) {
+function resolveMaterialSnapshot(handleRaw, world, assetsRef, materialSnapshotCache, persistentMaterialSnapshotCache, materialContext) {
   if (handleRaw === 0) return defaultMaterialSnapshot(handleRaw);
   const cached = materialSnapshotCache?.get(handleRaw);
   if (cached !== void 0) return cached.snapshot;
@@ -3888,7 +3968,9 @@ 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 materialProgramKeys = materialProgramKeysForMaterial(asset, assetsRef, materialContext);
+  const authoredFirstPassShader = runtimeMaterialShaderIdForMaterial(allPasses, void 0);
+  const firstPassShader = runtimeMaterialShaderIdForMaterial(allPasses, materialProgramKeys);
   const pv = materialValuesToLinearRuntime(
     resolved.values,
     materialColorParameterSchema(resolved.parameters ?? [], firstPassShader, assetsRef),
@@ -3914,7 +3996,7 @@ function resolveMaterialSnapshot(handleRaw, world, assetsRef, materialSnapshotCa
   }
   const materialParamSchema = materialParametersToParamSchema(
     resolved.parameters ?? [],
-    firstPassShader
+    authoredFirstPassShader
   );
   const resolveTexLike = (value, brand) => {
     if (typeof value === "number") return toShared(value);
@@ -3964,6 +4046,7 @@ function resolveMaterialSnapshot(handleRaw, world, assetsRef, materialSnapshotCa
     },
     normalScale: normalScalePv,
     materialShaderId: firstPassShader,
+    materialProgramKeys,
     materialHandle: handleRaw,
     renderState: pipelineRenderState(allPasses[0]?.renderState),
     paramSnapshot: paramSnap,
@@ -4352,6 +4435,7 @@ function tonemapParams(camera) {
 function prepareExtractContext(world, options = {}) {
   const renderables = options.renderables ?? "full";
   return {
+    materialContext: options.materialContext,
     assets: options.assets,
     pipelineState: options.pipelineState,
     materialSnapshotCache: options.materialSnapshotCache,
@@ -4359,8 +4443,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 +5165,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-YUQXSEHG.mjs.map
+//# sourceMappingURL=chunk-YUQXSEHG.mjs.map