@forgeax/engine-render 0.1.32 → 0.1.34

package/dist/{chunk-4NNZQCL3.mjs → chunk-UI5SFODX.mjs}

@@ -1,11 +1,12 @@
 import { GlyphText } from './chunk-ILQ5MEZF.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, 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, bloomEnabledFromF32, tonemapFromF32 } from './chunk-GWCEMDVR.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-DRR7D3KX.mjs';
-import { STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, SHADOW_ATLAS_DEFAULT_LAYERS, MaterialSkinAttrMissingError, SkinMaterialMismatchError, InstanceCollectionError, ShadowInvalidConfigError, EnvironmentSourceConflictError, FogCardinalityError, 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, AtmosphereInvalidParameterError } from './chunk-6TFBXLRJ.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';
+import { Time } from '@forgeax/engine-ecs';
 import { SpawnLightInvalidBoundsError, routeWorldError, SpriteInstancesMutuallyExclusiveWithInstancesError, SpriteInstancesRequiresSpriteShaderError, SpriteInstancesCountMismatchError, readRenderArrayView } from '@forgeax/engine-ecs/projection';
 import { vec3, mat4, frustum, box3 } from '@forgeax/engine-math';
 import { AssetGuid } from '@forgeax/engine-pack/guid';
@@ -183,6 +184,35 @@ function projectLightInspection(input) {
 function lightInspectionIdentity(topology, generation) {
   return `${topology}:generation-${generation}`;
 }
+var emptyBloomInspection = () => ({
+  graphStatus: "empty",
+  enabled: false,
+  levelCount: 0,
+  levelDimensions: [],
+  downsamplePassCount: 0,
+  upsamplePassCount: 0,
+  targetCount: 0,
+  targetBytes: 0,
+  resourceCount: 0,
+  passCount: 0,
+  encodeCount: 0,
+  bindGroupCount: 0,
+  uploadCount: 0,
+  residentChildBytes: 0,
+  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) {
@@ -938,8 +968,8 @@ var OcclusionRenderRuntime = class {
     if (this.queryLatencySamplesUs.length === 0) {
       return { median: 0, p95: 0, last: this.lastQueryLatencyUs };
     }
-    const sorted2 = [...this.queryLatencySamplesUs].sort((left, right) => left - right);
-    const rank = (percentile) => sorted2[Math.max(0, Math.ceil(sorted2.length * percentile) - 1)] ?? 0;
+    const sorted = [...this.queryLatencySamplesUs].sort((left, right) => left - right);
+    const rank = (percentile) => sorted[Math.max(0, Math.ceil(sorted.length * percentile) - 1)] ?? 0;
     return {
       median: rank(0.5),
       p95: rank(0.95),
@@ -1224,181 +1254,6 @@ function runtimeError(hint) {
   });
 }
 
-// src/environment/signature.ts
-function sorted(items) {
-  return [...items].sort((left, right) => left.entityKey - right.entityKey);
-}
-function environmentSignature(input) {
-  return JSON.stringify({
-    environments: sorted(input.environments),
-    fogs: sorted(input.fogs),
-    suns: sorted(input.suns)
-  });
-}
-function environmentOnlySignature(input) {
-  return JSON.stringify({
-    environments: sorted(input.environments),
-    suns: sorted(input.suns)
-  });
-}
-function fogOnlySignature(input) {
-  return JSON.stringify({ fogs: sorted(input.fogs) });
-}
-function environmentFactSignatures(input) {
-  return {
-    environmentSignature: environmentOnlySignature(input),
-    fogSignature: fogOnlySignature(input),
-    signature: environmentSignature(input)
-  };
-}
-
-// src/extract/environment.ts
-var ATMOSPHERE_PARAMETER_RANGES = Object.freeze({
-  turbidity: Object.freeze({ min: 1, max: 20 }),
-  rayleigh: Object.freeze({ min: 0, max: Number.POSITIVE_INFINITY }),
-  mieCoefficient: Object.freeze({ min: 0, max: Number.POSITIVE_INFINITY }),
-  mieDirectionalG: Object.freeze({ min: 0, max: 0.999 }),
-  sunAngularRadius: Object.freeze({ min: 0, max: Number.POSITIVE_INFINITY })
-});
-function validateFogParameters(candidate) {
-  if (candidate.color.length !== 3) {
-    return {
-      field: "color",
-      value: candidate.color.length,
-      expected: "exactly three finite channels in [0, 1]"
-    };
-  }
-  for (let index = 0; index < candidate.color.length; index += 1) {
-    const value = candidate.color[index];
-    if (value === void 0 || !Number.isFinite(value) || value < 0 || value > 1) {
-      return {
-        field: `color[${index}]`,
-        value: value ?? Number.NaN,
-        expected: "a finite number in [0, 1]"
-      };
-    }
-  }
-  if (!Number.isFinite(candidate.density) || candidate.density < 0) {
-    return { field: "density", value: candidate.density, expected: "a finite number >= 0" };
-  }
-  if (!Number.isFinite(candidate.heightFalloff) || candidate.heightFalloff < 0) {
-    return {
-      field: "heightFalloff",
-      value: candidate.heightFalloff,
-      expected: "a finite number >= 0"
-    };
-  }
-  if (!Number.isFinite(candidate.maxOpacity) || candidate.maxOpacity < 0 || candidate.maxOpacity > 1) {
-    return {
-      field: "maxOpacity",
-      value: candidate.maxOpacity,
-      expected: "a finite number in [0, 1]"
-    };
-  }
-  return void 0;
-}
-function validateAtmosphereParameters(parameters) {
-  for (const field of Object.keys(ATMOSPHERE_PARAMETER_RANGES)) {
-    const value = parameters[field];
-    const range = ATMOSPHERE_PARAMETER_RANGES[field];
-    if (!Number.isFinite(value) || value < range.min || value > range.max) {
-      return new AtmosphereInvalidParameterError(field, value, range);
-    }
-  }
-  return void 0;
-}
-
-// src/environment/frame.ts
-var SKYLIGHT_RECOVERY_FALLBACK = Object.freeze({
-  kind: "skylight",
-  active: false
-});
-var EnvironmentSelectionParameterError = class extends Error {
-  code = "environment-selection-invalid";
-  expected;
-  hint;
-  detail;
-  constructor(field, value, expected) {
-    super(`environment selection field ${field} is invalid`);
-    this.name = "EnvironmentSelectionParameterError";
-    this.expected = expected;
-    this.hint = `set ${field} to a finite value satisfying ${expected}`;
-    this.detail = { field, value };
-  }
-};
-var SunCardinalityError = class extends Error {
-  code = "sun-cardinality";
-  expected = "atmosphere has exactly one sun owner";
-  hint = "add exactly one DirectionalLight sun for the atmosphere owner";
-  detail;
-  constructor(value) {
-    super(`atmosphere sun cardinality is ${value}`);
-    this.name = "SunCardinalityError";
-    this.detail = { field: "sun", value };
-  }
-};
-function freezeCandidate(candidate) {
-  return Object.freeze(candidate);
-}
-function freezeFog(candidate) {
-  return Object.freeze({
-    ...candidate,
-    color: Object.freeze([...candidate.color])
-  });
-}
-function selectEnvironment(input) {
-  if (input.environments.length > 1) {
-    return err(
-      new EnvironmentSourceConflictError(
-        [...input.environments].sort((left, right) => left.entityKey - right.entityKey).map(({ kind, entityKey, sourceKey }) => ({ kind, entityKey, sourceKey }))
-      )
-    );
-  }
-  if (input.fogs.length > 1) return err(new FogCardinalityError(input.fogs.length));
-  const selectedFog = input.fogs[0];
-  if (selectedFog !== void 0) {
-    const issue = validateFogParameters(selectedFog);
-    if (issue !== void 0) {
-      return err(new EnvironmentSelectionParameterError(issue.field, issue.value, issue.expected));
-    }
-  }
-  const selected = input.environments[0];
-  if (selected?.kind === "atmosphere") {
-    const invalid = validateAtmosphereParameters(selected.atmosphere);
-    if (invalid !== void 0) return err(invalid);
-  }
-  if (selected?.kind === "atmosphere" && input.suns.length !== 1) {
-    return err(new SunCardinalityError(input.suns.length));
-  }
-  const source = selected === void 0 ? { kind: "none" } : selected.kind === "atmosphere" ? {
-    kind: "atmosphere",
-    entityKey: selected.entityKey,
-    sourceKey: selected.sourceKey,
-    atmosphere: Object.freeze({ ...selected.atmosphere })
-  } : {
-    kind: "image",
-    entityKey: selected.entityKey,
-    sourceKey: selected.sourceKey
-  };
-  const sun = input.suns[0] === void 0 ? void 0 : freezeCandidate({ ...input.suns[0] });
-  const fog = selectedFog === void 0 ? void 0 : freezeFog(selectedFog);
-  const signatureInput = {
-    environments: selected === void 0 ? [] : [selected],
-    fogs: selectedFog === void 0 ? [] : [selectedFog],
-    suns: input.suns
-  };
-  const signatures = environmentFactSignatures(signatureInput);
-  const result = {
-    source: Object.freeze(source),
-    fog,
-    ...signatures,
-    revision: 0,
-    sun
-  };
-  Object.defineProperty(result, "lane", { value: input.lane, enumerable: false });
-  return ok(Object.freeze(result));
-}
-
 // src/extract/directional-shadow-projection.ts
 function projectDirectionalShadow(fits, mapSize, shadowFilter, shadowAngularRadius, maxPenumbraTexels) {
   if (!Number.isFinite(mapSize) || mapSize < 1) return void 0;
@@ -2054,9 +1909,10 @@ function extractFrames(worlds, owner, assets, pipelineState, materialSnapshotCac
       });
       const frame = extractFrame(world, prepared);
       framesByWorld.set(wi, frame);
-    } catch (err8) {
+    } catch (err5) {
+      if (err5 instanceof MotionBlurValidationError) throw err5;
       try {
-        createWorldInternalView(world)._routeError(err8, {
+        createWorldInternalView(world)._routeError(err5, {
           severity: Severity.Error,
           systemName: `RenderSystem.extractFrames(world[${wi}])`
         });
@@ -2216,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;
@@ -2271,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,
@@ -2360,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;
@@ -2927,7 +2795,9 @@ function extractFrame(world, context) {
       rayleigh: value.rayleigh,
       mieCoefficient: value.mieCoefficient,
       mieDirectionalG: value.mieDirectionalG,
-      sunAngularRadius: value.sunAngularRadius
+      sunAngularRadius: value.sunAngularRadius,
+      circumsolarStrength: value.circumsolarStrength,
+      circumsolarWidth: value.circumsolarWidth
     };
     environmentCandidates.push({
       kind: "atmosphere",
@@ -3015,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],
@@ -3052,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;
@@ -3085,6 +2958,9 @@ function extractFrame(world, context) {
       if (!authorVisible && !retainHidden) {
         continue;
       }
+      if (isRenderable && fAssetHandle === 0) {
+        continue;
+      }
       const layerVal = fLayerValue ?? 0;
       const pendingDispatch = [];
       const materialsView = worldInternal._getArrayView(entity, MeshRenderer, "materials");
@@ -3270,28 +3146,28 @@ function extractFrame(world, context) {
           } else {
             const resolvedResult = walkMaterialPassesOverSharedRefs(world, tagged, assets);
             if (!resolvedResult.ok) {
-              const err8 = resolvedResult.error;
-              switch (err8.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(err8, {
+                  worldInternal._routeError(err5, {
                     severity: Severity.Error,
-                    systemName: `RenderSystem.extract (${err8.code})`
+                    systemName: `RenderSystem.extract (${err5.code})`
                   });
                   break;
                 case "material-circular-inheritance":
-                  worldInternal._routeError(err8, {
+                  worldInternal._routeError(err5, {
                     severity: Severity.Error,
                     systemName: "RenderSystem.extract (material-circular-inheritance)"
                   });
                   break;
                 default:
-                  worldInternal._routeError(err8, {
+                  worldInternal._routeError(err5, {
                     severity: Severity.Error,
-                    systemName: `RenderSystem.extract (_materialWalk: ${err8.code})`
+                    systemName: `RenderSystem.extract (_materialWalk: ${err5.code})`
                   });
               }
               continue;
@@ -3548,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,
@@ -3898,44 +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,
-            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 = {
@@ -4123,6 +3987,7 @@ function extractFrame(world, context) {
     environment,
     environmentReady: true,
     ...volumetricFog === void 0 ? {} : { volumetricFog },
+    ...cloudLayer === void 0 ? {} : { cloudLayer },
     renderables,
     dispatch,
     shadowCasterEntityKeys,
@@ -4823,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,
@@ -5072,12 +4943,22 @@ 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;
     const depthOfField = row.get(DepthOfField);
     const dynamicResolution = row.get(DynamicResolution);
     const screenSpaceReflection = row.get(ScreenSpaceReflection);
@@ -5105,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 },
@@ -5126,10 +5009,17 @@ function collectCameraSnapshots(world) {
       ...output === void 0 ? {} : { output },
       antialias,
       ...dynamicResolutionResult.value === void 0 ? {} : { dynamicResolution: dynamicResolutionResult.value },
-      bloom: bloomEnabledFromF32(cam.bloom),
+      bloom: validateCameraBloom(
+        cam.bloom,
+        cam.bloomThreshold,
+        cam.bloomIntensity,
+        cam.bloomSoftKnee,
+        cam.bloomScatter
+      ),
       bloomThreshold: cam.bloomThreshold,
       bloomIntensity: cam.bloomIntensity,
-      bloomBlurRadius: cam.bloomBlurRadius,
+      bloomSoftKnee: cam.bloomSoftKnee,
+      bloomScatter: cam.bloomScatter,
       clearColor: [
         cam.clearColor[0] ?? 0,
         cam.clearColor[1] ?? 0,
@@ -5138,13 +5028,15 @@ function collectCameraSnapshots(world) {
       ],
       ...depthOfFieldResult.ok && depthOfFieldResult.value !== void 0 ? { depthOfField: depthOfFieldResult.value } : {},
       ...depthOfFieldError === void 0 ? {} : { depthOfFieldError },
-      ...motionBlur === void 0 ? {} : {
+      ...motionBlurParams === void 0 ? {} : {
         motionBlur: {
-          shutterAngle: motionBlur.shutterAngle,
-          maxRadiusPixels: motionBlur.maxRadiusPixels,
-          sampleCount: motionBlur.sampleCount
+          shutterAngle: motionBlurParams.shutterAngle,
+          maxRadiusPixels: motionBlurParams.maxRadiusPixels,
+          sampleCount: motionBlurParams.sampleCount,
+          targetFps: motionBlurParams.targetFps
         }
       },
+      ...barrelDistortion === void 0 ? {} : { barrelDistortion: barrelDistortionResult.value },
       ...screenSpaceReflection === void 0 ? {} : {
         screenSpaceReflection: {
           maxDistance: screenSpaceReflection.maxDistance,
@@ -5320,11 +5212,14 @@ function textureDigest(texture2) {
   return `fnv1a:${hash.toString(16).padStart(8, "0")}`;
 }
 function extractVolumeSnapshot(world, assets, worldInternal) {
+  const elapsed = world.getResource(Time).elapsed;
+  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);
@@ -5349,7 +5244,7 @@ function extractVolumeSnapshot(world, assets, worldInternal) {
         }) : resolved.error,
         { severity: Severity.Error, systemName: "RenderSystem.extract (volumetric-density)" }
       );
-      return { status: "degraded" };
+      return { status: "degraded", worldTimeSeconds };
     }
     const densityAsset = resolved.value;
     const guid = assets?.guidOf(densityAsset) ?? `handle:${Number(densityHandle)}`;
@@ -5392,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);
@@ -5404,39 +5314,18 @@ function extractVolumeSnapshot(world, assets, worldInternal) {
       severity: Severity.Error,
       systemName: "RenderSystem.extract (volumetric-fog)"
     });
-    return {
-      status: "degraded",
-      ...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",
-    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;
@@ -5737,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);
@@ -5744,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,
@@ -5804,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)) {
@@ -5812,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]));
@@ -5889,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;
@@ -5946,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,
@@ -5961,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 });
@@ -5978,6 +5924,6 @@ var ProbeBlendSceneProjection = class {
   }
 };
 
-export { InstanceBoundsCache, OcclusionRenderRuntime, PROBE_MAX_CONTRIBUTORS, ProbeBlendSceneProjection, SKYLIGHT_RECOVERY_FALLBACK, SSR_HISTORY_FORMAT, SsrHistoryOwner, admitProbeContributors, blendLightProbes, buildRectAreaWorldFrame, buildShadowFrusta, createCookieProjectionMatrixData, createExtendedLightingState, createSsrHistoryOwner, createSsrSpatialResources, estimateSsrSpatialMemory, extractFrames, fingerprintNumericArray, glyphTextLayoutSystem, primitiveKey, primitiveKeyId, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, rectAreaFacesPoint, scaledProbeWeight, setOcclusionRuntimeTestHooks, viewKey, viewKeyId };
-//# sourceMappingURL=chunk-4NNZQCL3.mjs.map
-//# sourceMappingURL=chunk-4NNZQCL3.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