@forgeax/engine-render 0.1.33 → 0.1.34

package/dist/{chunk-OO3DRYK7.mjs → chunk-UI5SFODX.mjs}

@@ -1,8 +1,8 @@
 import { GlyphText } from './chunk-ILQ5MEZF.mjs';
-import { MeshRenderer, MeshFilter, DirectionalLight, validateDirectionalLightData, PointLight, computeInvRangeSquared, SpotLight, degToCos, RectAreaLight, validateRectAreaLightData, directionalShadowQualityFromF32, PointLightShadow, Skylight, LightProbe, validateLightProbeData, SkyboxBackground, Atmosphere, selectEnvironment, Instances, Layer, Points, Lines, SortKey, resolveMeshMaterialBindings, pointShapeFromU32, PostProcessParams, buildCubeCameraFaceViews, CubeCamera, cubeCameraUpdateIntentFromF32, ReflectionProbe, reflectionProbeUpdateIntentFromF32, tonemapToU32, resolveVisibility, Fog, VolumetricFog, resolveSelectedVolumetricLight, extractVolumetricFog, MotionBlur, DynamicResolution, ScreenSpaceReflection, DepthOfField, Camera, cameraProjectionFromF32, resolveDepthOfFieldParams, depthOfFieldRequestFailure, CAMERA_EXPOSURE_MODE_MANUAL, cameraExposureFromColumns, antialiasFromF32, validateDynamicResolutionCamera, validateCameraBloom, tonemapFromF32 } from './chunk-PLAXOOX5.mjs';
-import { SpriteRegionOverride, SpriteInstances, selectActiveCameraIndex, getActiveCamera } from './chunk-PA5DRJNI.mjs';
-import { PROBE_BLEND_RECORD_CAPACITY, GPU_BUFFER_USAGE_MAP_READ, GPU_BUFFER_USAGE_VERTEX, GPU_BUFFER_USAGE_COPY_DST, gpuDrivenShadowDrawKey, IES_SLICE_CAPACITY, COOKIE_SLICE_CAPACITY, isStandardPbrSkinMaterialShader, buildGpuDrivenDraws, worldEntityKey, gpuDrivenSourceDrawItemIndex, selectPasses, resolveRenderTargetMaterialSource, isCanonicalStandardPbrMaterialShader, PROBE_BLEND_RECORD_BYTE_SIZE, GPU_BUFFER_USAGE_UNIFORM, GPU_BUFFER_USAGE_QUERY_RESOLVE, GPU_BUFFER_USAGE_COPY_SRC, COOKIE_SLICE_SIZE, isStandardPbrMaterialShader } from './chunk-3RTCJTH4.mjs';
-import { MotionBlurValidationError, STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, SHADOW_ATLAS_DEFAULT_LAYERS, MaterialSkinAttrMissingError, SkinMaterialMismatchError, InstanceCollectionError, ShadowInvalidConfigError, resolveMotionBlurParams, GPU_TEXTURE_USAGE_COPY_SRC, GPU_TEXTURE_USAGE_COPY_DST, GPU_TEXTURE_USAGE_TEXTURE_BINDING, GPU_TEXTURE_USAGE_STORAGE_BINDING, GPU_TEXTURE_USAGE_RENDER_ATTACHMENT } from './chunk-NB2S7ZRX.mjs';
+import { freezeBarrelDistortionMapping, MeshRenderer, MeshFilter, DirectionalLight, extractCloudLayer, validateDirectionalLightData, PointLight, computeInvRangeSquared, SpotLight, degToCos, RectAreaLight, validateRectAreaLightData, directionalShadowQualityFromF32, PointLightShadow, Skylight, LightProbe, validateLightProbeData, SkyboxBackground, Atmosphere, selectEnvironment, Instances, Layer, Points, Lines, SortKey, resolveMeshMaterialBindings, pointShapeFromU32, PostProcessParams, buildCubeCameraFaceViews, CubeCamera, cubeCameraUpdateIntentFromF32, ReflectionProbe, reflectionProbeUpdateIntentFromF32, tonemapToU32, resolveVisibility, Fog, VolumetricFog, resolveSelectedVolumetricLight, extractVolumetricFog, MotionBlur, DynamicResolution, ScreenSpaceReflection, DepthOfField, BarrelDistortion, Camera, cameraProjectionFromF32, resolveDepthOfFieldParams, depthOfFieldRequestFailure, CAMERA_EXPOSURE_MODE_MANUAL, cameraExposureFromColumns, antialiasFromF32, validateDynamicResolutionCamera, validateBarrelDistortionParameters, validateCameraBloom, tonemapFromF32 } from './chunk-UINHLCZA.mjs';
+import { SpriteRegionOverride, SpriteInstances, selectActiveCameraIndex, getActiveCamera } from './chunk-ELJFJ2BU.mjs';
+import { PROBE_BLEND_RECORD_CAPACITY, GPU_BUFFER_USAGE_MAP_READ, GPU_BUFFER_USAGE_VERTEX, GPU_BUFFER_USAGE_COPY_DST, gpuDrivenShadowDrawKey, IES_SLICE_CAPACITY, COOKIE_SLICE_CAPACITY, isStandardPbrSkinMaterialShader, buildGpuDrivenDraws, worldEntityKey, gpuDrivenSourceDrawItemIndex, selectPasses, resolveRenderTargetMaterialSource, isCanonicalStandardPbrMaterialShader, PROBE_BLEND_RECORD_BYTE_SIZE, GPU_BUFFER_USAGE_UNIFORM, GPU_BUFFER_USAGE_QUERY_RESOLVE, GPU_BUFFER_USAGE_COPY_SRC, COOKIE_SLICE_SIZE, isStandardPbrMaterialShader } from './chunk-SHFUFJ5N.mjs';
+import { MotionBlurValidationError, STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, SHADOW_ATLAS_DEFAULT_LAYERS, MaterialSkinAttrMissingError, SkinMaterialMismatchError, validateInstanceTransforms, ShadowInvalidConfigError, resolveMotionBlurParams, GPU_TEXTURE_USAGE_COPY_SRC, GPU_TEXTURE_USAGE_COPY_DST, GPU_TEXTURE_USAGE_TEXTURE_BINDING, GPU_TEXTURE_USAGE_STORAGE_BINDING, GPU_TEXTURE_USAGE_RENDER_ATTACHMENT } from './chunk-WEX45HKH.mjs';
 import { R_MIN, ok, err, TextError, toShared, handleSlot, AssetError, ASSET_ERROR_HINTS, materialValuesToLinearRuntime, derive, unpackSlot, materialGuidText } from '@forgeax/engine-types';
 import { err as err$1, ok as ok$1, RhiError } from '@forgeax/engine-rhi';
 import { resolveAssetHandle, walkMaterialPassesOverSharedRefs, selectMaterialPassProgram, materialParametersToParamSchema as materialParametersToParamSchema$1 } from '@forgeax/engine-assets-runtime';
@@ -202,6 +202,17 @@ var emptyBloomInspection = () => ({
   generation: 0,
   state: "off"
 });
+function projectBarrelDistortionInspection(input) {
+  const effectiveMapping = input.effectiveMapping === void 0 ? void 0 : freezeBarrelDistortionMapping(input.effectiveMapping);
+  return Object.freeze({
+    effectiveMapping,
+    extent: effectiveMapping === void 0 ? void 0 : Object.freeze({ width: effectiveMapping.width, height: effectiveMapping.height }),
+    frameId: input.frameId,
+    deviceGeneration: input.deviceGeneration,
+    graphGeneration: input.graphGeneration,
+    lastKnownGood: input.lastKnownGood
+  });
+}
 
 // src/prepare/extended-lighting/state.ts
 function createExtendedLightingState(generation) {
@@ -1898,10 +1909,10 @@ function extractFrames(worlds, owner, assets, pipelineState, materialSnapshotCac
       });
       const frame = extractFrame(world, prepared);
       framesByWorld.set(wi, frame);
-    } catch (err6) {
-      if (err6 instanceof MotionBlurValidationError) throw err6;
+    } catch (err5) {
+      if (err5 instanceof MotionBlurValidationError) throw err5;
       try {
-        createWorldInternalView(world)._routeError(err6, {
+        createWorldInternalView(world)._routeError(err5, {
           severity: Severity.Error,
           systemName: `RenderSystem.extractFrames(world[${wi}])`
         });
@@ -2061,6 +2072,7 @@ function extractFrames(worlds, owner, assets, pipelineState, materialSnapshotCac
     directionalCsmDirection
   };
   const volumetricFog = resourceOwnerFrame?.volumetricFog;
+  const cloudLayer = resourceOwnerFrame?.cloudLayer;
   const skylight = resourceOwnerFrame?.skylight;
   const skylightCount = resourceOwnerFrame?.skylightCount ?? 0;
   const skybox = resourceOwnerFrame?.skybox;
@@ -2116,6 +2128,7 @@ function extractFrames(worlds, owner, assets, pipelineState, materialSnapshotCac
     reflectionProbes,
     lights,
     ...volumetricFog === void 0 ? {} : { volumetricFog: { ...volumetricFog, worldId: resourceOwner } },
+    ...cloudLayer === void 0 ? {} : { cloudLayer },
     renderables,
     dispatch: dispatchEntries,
     shadowCasterEntityKeys,
@@ -2205,6 +2218,16 @@ function extractFrame(world, context) {
   const directionalLightQuery = world.query({ read: [DirectionalLight] }).unwrap();
   const worldInternal = createWorldInternalView(world);
   let volumetricFog = extractVolumeSnapshot(world, assets, worldInternal);
+  let cloudLayer;
+  const extractedCloudLayer = extractCloudLayer(world);
+  if (extractedCloudLayer.ok) {
+    cloudLayer = extractedCloudLayer.value;
+  } else {
+    worldInternal._routeError(extractedCloudLayer.error, {
+      severity: Severity.Error,
+      systemName: "RenderSystem.extract (cloud-layer)"
+    });
+  }
   const cameraRoles = selectCameraRoles(world, context.cameraEntityKey);
   const cameras = [...cameraRoles.display];
   const auxiliaryCameras = cameraRoles.auxiliary;
@@ -2862,7 +2885,6 @@ function extractFrame(world, context) {
   let dispatch = [];
   const shadowMembershipEntries = [];
   const materialSnapshotCache = /* @__PURE__ */ new Map();
-  const instanceSnapshotCache = /* @__PURE__ */ new Map();
   const skinnedMaterialSnapshotCache = /* @__PURE__ */ new Map();
   const meshRendererQuery = context.renderables === "none" ? [] : world.query({
     read: [MeshRenderer],
@@ -2899,14 +2921,18 @@ function extractFrame(world, context) {
   const flushPendingDispatch = (pending) => {
     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 requestedRows = renderableEntities === void 0 ? meshRendererQuery : {
+    *[Symbol.iterator]() {
+      for (const entity of renderableEntities) {
+        const row = meshRendererQuery.at(entity);
+        if (row !== void 0) yield row;
+      }
     }
+  };
+  for (const row of requestedRows) {
     const hasTransform = row.has(Transform);
     const meshFilter = row.get(MeshFilter);
-    const instancesData = row.get(Instances);
-    const hasInstances = instancesData !== void 0;
+    const hasInstances = row.has(Instances);
     const skin = row.get(Skin);
     const morphWeightsView = worldInternal._getArrayView(row.entity, MorphWeights, "weights");
     const hasMeshFilter = meshFilter !== void 0;
@@ -3120,28 +3146,28 @@ function extractFrame(world, context) {
           } else {
             const resolvedResult = walkMaterialPassesOverSharedRefs(world, tagged, assets);
             if (!resolvedResult.ok) {
-              const err6 = resolvedResult.error;
-              switch (err6.code) {
+              const err5 = resolvedResult.error;
+              switch (err5.code) {
                 case "material-parent-not-found":
                 case "material-no-effective-pass":
                 case "material-value-unknown":
                 case "material-value-type-mismatch":
                 case "material-contract-program-mismatch":
-                  worldInternal._routeError(err6, {
+                  worldInternal._routeError(err5, {
                     severity: Severity.Error,
-                    systemName: `RenderSystem.extract (${err6.code})`
+                    systemName: `RenderSystem.extract (${err5.code})`
                   });
                   break;
                 case "material-circular-inheritance":
-                  worldInternal._routeError(err6, {
+                  worldInternal._routeError(err5, {
                     severity: Severity.Error,
                     systemName: "RenderSystem.extract (material-circular-inheritance)"
                   });
                   break;
                 default:
-                  worldInternal._routeError(err6, {
+                  worldInternal._routeError(err5, {
                     severity: Severity.Error,
-                    systemName: `RenderSystem.extract (_materialWalk: ${err6.code})`
+                    systemName: `RenderSystem.extract (_materialWalk: ${err5.code})`
                   });
               }
               continue;
@@ -3398,6 +3424,12 @@ function extractFrame(world, context) {
               baseColor,
               metallic: metallicPv,
               roughness: roughnessPv,
+              ...resolved.surface?.model === void 0 ? {} : { surfaceModel: resolved.surface.model },
+              deferredPass: allPasses.some(
+                (pass) => String(
+                  pass.renderState?.tags?.LightMode ?? pass.name
+                ) === "Deferred"
+              ),
               ...specularColorPv !== void 0 && {
                 specularColor: [
                   specularColorPv[0] ?? 1,
@@ -3748,45 +3780,26 @@ function extractFrame(world, context) {
         };
         let instancesSnap;
         if (hasInstances) {
-          const collectionId = instancesData?.collectionId;
-          let collectionResult = collectionId !== void 0 ? instanceSnapshotCache.get(collectionId) : void 0;
-          if (collectionResult === void 0) {
-            collectionResult = collectionId !== void 0 && collectionId > 0 && instanceCollections !== void 0 ? instanceCollections.snapshot(collectionId) : err(
-              new InstanceCollectionError(
-                "instance-collection-invalid",
-                "Instances.collectionId references a live renderer-owned collection",
-                "create the collection through renderer.instances before attaching Instances",
-                {
-                  operation: "inspect",
-                  expected: "a positive collectionId with a live renderer owner",
-                  actual: Number(collectionId ?? 0),
-                  ...collectionId === void 0 ? {} : { collectionId }
-                }
-              )
-            );
-            if (collectionId !== void 0)
-              instanceSnapshotCache.set(collectionId, collectionResult);
-          }
-          if (collectionResult === void 0) continue;
-          if (!collectionResult.ok) {
-            worldInternal._routeError(collectionResult.error, {
+          const transforms = worldInternal._getArrayView(entity, Instances, "transforms") ?? new Float32Array();
+          const invalid = validateInstanceTransforms(transforms);
+          if (invalid !== void 0) {
+            worldInternal._routeError(invalid, {
               severity: Severity.Error,
-              systemName: "RenderSystem.extract (Instances collection)"
+              systemName: "RenderSystem.extract (Instances transforms)"
             });
             continue;
           }
+          const projected = instanceCollections?.project(world, entity, transforms);
           instancesSnap = {
-            transforms: collectionResult.value.transforms,
-            generations: collectionResult.value.generations,
-            instanceCount: collectionResult.value.count,
-            collectionId: collectionResult.value.collectionId,
-            revision: collectionResult.value.revision,
-            capacity: collectionResult.value.capacity,
-            dirtyRanges: collectionResult.value.dirtyRanges,
+            transforms: projected?.transforms ?? new Float32Array(transforms),
+            instanceCount: transforms.length / 16,
             cacheKey: entity,
-            // Explicit collection revisions supersede ECS archetype content
-            // hashes; retain zero as the legacy sprite-only field value.
-            archVersion: 0
+            archVersion: projected === void 0 ? archVersion : 0,
+            ...projected === void 0 ? {} : {
+              collectionId: projected.collectionId,
+              revision: projected.revision,
+              generations: projected.generations
+            }
           };
         }
         const baseRenderable = {
@@ -3974,6 +3987,7 @@ function extractFrame(world, context) {
     environment,
     environmentReady: true,
     ...volumetricFog === void 0 ? {} : { volumetricFog },
+    ...cloudLayer === void 0 ? {} : { cloudLayer },
     renderables,
     dispatch,
     shadowCasterEntityKeys,
@@ -4674,6 +4688,12 @@ function resolveMaterialSnapshot(handleRaw, world, assetsRef, materialSnapshotCa
     baseColor,
     metallic: metallicPv,
     roughness: roughnessPv,
+    ...resolved.surface?.model === void 0 ? {} : { surfaceModel: resolved.surface.model },
+    deferredPass: allPasses.some(
+      (pass) => String(
+        pass.renderState?.tags?.LightMode ?? pass.name
+      ) === "Deferred"
+    ),
     ...specularColorPv !== void 0 && {
       specularColor: [
         specularColorPv[0] ?? 1,
@@ -4923,12 +4943,19 @@ function collectCameraSnapshots(world) {
   const cameras = [];
   const cameraQuery = world.query({
     read: [Camera],
-    optional: [MotionBlur, DynamicResolution, ScreenSpaceReflection, DepthOfField],
+    optional: [
+      MotionBlur,
+      DynamicResolution,
+      ScreenSpaceReflection,
+      DepthOfField,
+      BarrelDistortion
+    ],
     with: [Transform, GlobalTransform]
   }).unwrap();
   for (const row of cameraQuery) {
     const cam = row.get(Camera);
     const motionBlur = row.get(MotionBlur);
+    const barrelDistortion = row.get(BarrelDistortion);
     const motionBlurResult = resolveMotionBlurParams(motionBlur);
     if (!motionBlurResult.ok) throw motionBlurResult.error;
     const motionBlurParams = motionBlurResult.value;
@@ -4959,6 +4986,8 @@ function collectCameraSnapshots(world) {
     const antialias = antialiasFromF32(cam.antialias);
     const dynamicResolutionResult = validateDynamicResolutionCamera(dynamicResolution, antialias);
     if (!dynamicResolutionResult.ok) throw dynamicResolutionResult.error;
+    const barrelDistortionResult = validateBarrelDistortionParameters(barrelDistortion);
+    if (!barrelDistortionResult.ok) throw barrelDistortionResult.error;
     cameras.push({
       entityKey: entity,
       ...target === void 0 ? {} : { target },
@@ -5007,6 +5036,7 @@ function collectCameraSnapshots(world) {
           targetFps: motionBlurParams.targetFps
         }
       },
+      ...barrelDistortion === void 0 ? {} : { barrelDistortion: barrelDistortionResult.value },
       ...screenSpaceReflection === void 0 ? {} : {
         screenSpaceReflection: {
           maxDistance: screenSpaceReflection.maxDistance,
@@ -5186,9 +5216,10 @@ function extractVolumeSnapshot(world, assets, worldInternal) {
   const worldTimeSeconds = Number.isFinite(elapsed) ? Math.max(0, elapsed) : 0;
   const query = world.query({ read: [VolumetricFog] }).unwrap();
   const authorings = [];
+  const members = [];
   let selectedLight;
-  let first;
   for (const row of query) {
+    selectedLight = void 0;
     const source = row.get(VolumetricFog);
     if (source.light === null) continue;
     const selected = resolveSelectedVolumetricLight(world, source.light);
@@ -5256,10 +5287,25 @@ function extractVolumeSnapshot(world, assets, worldInternal) {
       albedo: [source.albedo[0] ?? 0, source.albedo[1] ?? 0, source.albedo[2] ?? 0],
       emission: [source.emission[0] ?? 0, source.emission[1] ?? 0, source.emission[2] ?? 0],
       anisotropy: source.anisotropy,
-      maxDistance: source.maxDistance
+      maxDistance: source.maxDistance,
+      sampling: source.sampling === 1 ? "density" : "noise"
     };
     authorings.push(authoring);
-    first ??= { densityHandle, densityAsset, guid };
+    members.push({
+      status: "available",
+      worldTimeSeconds,
+      densityHandle,
+      densityAsset,
+      guid,
+      generation: 1,
+      digest: textureDigest(densityAsset),
+      ...selectedLight === void 0 ? {} : {
+        lightEntity: selectedLight.entity,
+        lightKind: selectedLight.kind,
+        ...selectedLight.pointLightEntity === void 0 ? {} : { pointLightEntity: selectedLight.pointLightEntity },
+        ...selectedLight.spotLightEntity === void 0 ? {} : { spotLightEntity: selectedLight.spotLightEntity }
+      }
+    });
   }
   if (authorings.length === 0) return void 0;
   const extracted = extractVolumetricFog(authorings);
@@ -5268,41 +5314,18 @@ function extractVolumeSnapshot(world, assets, worldInternal) {
       severity: Severity.Error,
       systemName: "RenderSystem.extract (volumetric-fog)"
     });
-    return {
-      status: "degraded",
-      worldTimeSeconds,
-      ...first === void 0 ? {} : {
-        densityHandle: first.densityHandle,
-        densityAsset: first.densityAsset,
-        guid: first.guid,
-        generation: 1,
-        digest: textureDigest(first.densityAsset),
-        ...selectedLight === void 0 ? {} : {
-          lightEntity: selectedLight.entity,
-          lightKind: selectedLight.kind,
-          ...selectedLight.pointLightEntity === void 0 ? {} : { pointLightEntity: selectedLight.pointLightEntity },
-          ...selectedLight.spotLightEntity === void 0 ? {} : { spotLightEntity: selectedLight.spotLightEntity }
-        }
-      }
-    };
+    return { ...members[0], status: "degraded" };
   }
-  if (extracted.value.status === "off" || first === void 0) return { status: "off" };
-  const selectedLightFields = selectedLight === void 0 ? {} : {
-    lightEntity: selectedLight.entity,
-    lightKind: selectedLight.kind,
-    ...selectedLight.pointLightEntity === void 0 ? {} : { pointLightEntity: selectedLight.pointLightEntity },
-    ...selectedLight.spotLightEntity === void 0 ? {} : { spotLightEntity: selectedLight.spotLightEntity }
-  };
+  if (extracted.value.status === "off") return { status: "off" };
+  const validatedMembers = extracted.value.fogs.map((fog, index) => ({
+    ...members[index],
+    status: "available",
+    fog
+  }));
   return {
     status: "available",
-    worldTimeSeconds,
-    fog: extracted.value.fog,
-    densityHandle: first.densityHandle,
-    densityAsset: first.densityAsset,
-    guid: first.guid,
-    generation: 1,
-    digest: textureDigest(first.densityAsset),
-    ...selectedLightFields
+    ...validatedMembers[0],
+    additional: validatedMembers.slice(1)
   };
 }
 var PROBE_R_MIN = R_MIN;
@@ -5603,6 +5626,17 @@ var ProbeBlendSceneProjection = class {
   };
   lastDirtyVisitCount = 0;
   lastDirtyReasons = [];
+  bufferProjectionSource = Object.freeze({});
+  bufferProjection = Object.freeze({
+    sourceIdentity: this.bufferProjectionSource,
+    revision: 0,
+    baseRevision: 0,
+    capacity: 1,
+    records: Object.freeze([]),
+    dirtyRecords: Object.freeze([]),
+    removedCacheKeys: Object.freeze([])
+  });
+  resultRecords = Object.freeze([]);
   recordFacts = /* @__PURE__ */ new Map();
   getRecord(objectKey) {
     return this.records.get(objectKey);
@@ -5610,6 +5644,10 @@ var ProbeBlendSceneProjection = class {
   hasRecords() {
     return this.records.size > 0;
   }
+  /** Stable upload projection; rebuilt only when probe/object facts change. */
+  recordBufferProjection() {
+    return this.bufferProjection;
+  }
   inspect() {
     return {
       activeContributorCount: this.lastActiveContributorCount,
@@ -5670,6 +5708,23 @@ var ProbeBlendSceneProjection = class {
     const dirtyReasons = [];
     const affectedObjectKeys = /* @__PURE__ */ new Set();
     const previous = this.previous;
+    if (previous !== void 0 && previous.objects === input.objects && input.worldRevision === previous.worldRevision && input.retainSkyResidualRecords === previous.retainSkyResidualRecords && sameProbeFacts(input.probes, previous.probes) && sameSkyFacts(input, previous)) {
+      return {
+        records: this.resultRecords,
+        contributors: [],
+        activeContributorCount: this.lastActiveContributorCount,
+        admittedProbeCount: this.lastAdmittedProbeCount,
+        coverage: this.lastCoverage,
+        skyResidualFraction: 1 - this.lastCoverage,
+        dirtyReasons: [],
+        affectedObjectKeys: [],
+        visits: 0,
+        allocations: 0,
+        uploads: 0,
+        receipt: this.lastReceipt,
+        ...this.lastError === void 0 ? {} : { error: this.lastError }
+      };
+    }
     const objectKeys = input.objects.map((object) => String(object.objectKey)).sort();
     const previousObjectKeys = previous?.objects.map((object) => String(object.objectKey)).sort() ?? [];
     if (previous === void 0 || !sameList(objectKeys, previousObjectKeys)) {
@@ -5678,7 +5733,7 @@ var ProbeBlendSceneProjection = class {
     }
     if (previous !== void 0 && input.worldRevision !== previous.worldRevision)
       dirtyReasons.push("world");
-    if (previous !== void 0 && !sameProbeFacts(input.probes, previous.probes))
+    if (previous !== void 0 && (!sameProbeFacts(input.probes, previous.probes) || input.retainSkyResidualRecords !== previous.retainSkyResidualRecords))
       dirtyReasons.push("probe-fact");
     if (previous !== void 0 && !sameSkyFacts(input, previous)) dirtyReasons.push("sky");
     const previousObjects = new Map(previous?.objects.map((object) => [object.objectKey, object]));
@@ -5755,7 +5810,7 @@ var ProbeBlendSceneProjection = class {
       let record;
       if (admission.error !== void 0) firstError ??= admission.error;
       if (admission.admitted.length === 0) {
-        if (input.probes.length === 0) {
+        if (input.probes.length === 0 && input.retainSkyResidualRecords !== true) {
           nextRecords.delete(object.objectKey);
           this.recordFacts.delete(object.objectKey);
           continue;
@@ -5812,8 +5867,9 @@ var ProbeBlendSceneProjection = class {
       firstError ??= admission.error;
     }
     const allocations = previous === void 0 ? nextRecords.size : 0;
+    const resultRecords = Object.freeze([...nextRecords.values()]);
     const result = {
-      records: [...nextRecords.values()],
+      records: resultRecords,
       contributors: firstTerms,
       activeContributorCount: firstActiveCount,
       admittedProbeCount: firstAdmittedCount,
@@ -5827,14 +5883,38 @@ var ProbeBlendSceneProjection = class {
       receipt: firstReceipt,
       ...firstError === void 0 ? {} : { error: firstError }
     };
+    const projectedRecords = Object.freeze(
+      [...nextRecords].map(([objectKey, record]) => Object.freeze({ cacheKey: objectKey, record }))
+    );
+    const dirtyRecords = Object.freeze(
+      projectedRecords.filter(({ record }) => affectedObjectKeys.has(record.objectKey))
+    );
+    const removedCacheKeys = Object.freeze(
+      [...this.records.keys()].filter((objectKey) => !nextRecords.has(objectKey))
+    );
+    const capacity = projectedRecords.reduce(
+      (value, { record }) => Math.max(value, record.objectKey + 2),
+      1
+    );
     this.previous = input;
     this.records = nextRecords;
+    this.resultRecords = resultRecords;
+    const baseRevision = this.bufferProjection.revision;
+    this.bufferProjection = Object.freeze({
+      sourceIdentity: this.bufferProjectionSource,
+      revision: baseRevision + 1,
+      baseRevision,
+      capacity,
+      records: projectedRecords,
+      dirtyRecords,
+      removedCacheKeys
+    });
     this.lastError = firstError;
     this.lastReceipt = firstReceipt;
     this.lastActiveContributorCount = firstActiveCount;
     this.lastAdmittedProbeCount = firstAdmittedCount;
     this.lastCoverage = firstCoverage;
-    this.lastFinite = [...nextRecords.values()].every(
+    this.lastFinite = this.resultRecords.every(
       (record) => record.bytes.length === PROBE_BLEND_RECORD_BYTE_SIZE
     );
     this.lastSky = input.sky ?? (input.skyIrradiance === void 0 ? { available: false, irradiance: [0, 0, 0], fallbackReason: "no-skylight" } : { available: true, irradiance: input.skyIrradiance });
@@ -5844,6 +5924,6 @@ var ProbeBlendSceneProjection = class {
   }
 };
 
-export { InstanceBoundsCache, OcclusionRenderRuntime, PROBE_MAX_CONTRIBUTORS, ProbeBlendSceneProjection, SSR_HISTORY_FORMAT, SsrHistoryOwner, admitProbeContributors, blendLightProbes, buildRectAreaWorldFrame, buildShadowFrusta, createCookieProjectionMatrixData, createExtendedLightingState, createSsrHistoryOwner, createSsrSpatialResources, emptyBloomInspection, estimateSsrSpatialMemory, extractFrames, fingerprintNumericArray, glyphTextLayoutSystem, primitiveKey, primitiveKeyId, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, rectAreaFacesPoint, scaledProbeWeight, setOcclusionRuntimeTestHooks, viewKey, viewKeyId };
-//# sourceMappingURL=chunk-OO3DRYK7.mjs.map
-//# sourceMappingURL=chunk-OO3DRYK7.mjs.map
+export { InstanceBoundsCache, OcclusionRenderRuntime, PROBE_MAX_CONTRIBUTORS, ProbeBlendSceneProjection, SSR_HISTORY_FORMAT, SsrHistoryOwner, admitProbeContributors, blendLightProbes, buildRectAreaWorldFrame, buildShadowFrusta, createCookieProjectionMatrixData, createExtendedLightingState, createSsrHistoryOwner, createSsrSpatialResources, emptyBloomInspection, estimateSsrSpatialMemory, extractFrames, fingerprintNumericArray, glyphTextLayoutSystem, primitiveKey, primitiveKeyId, projectBarrelDistortionInspection, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, rectAreaFacesPoint, scaledProbeWeight, setOcclusionRuntimeTestHooks, viewKey, viewKeyId };
+//# sourceMappingURL=chunk-UI5SFODX.mjs.map
+//# sourceMappingURL=chunk-UI5SFODX.mjs.map