@forgeax/engine-render 0.1.31 → 0.1.33

package/dist/{chunk-C3DDSXYK.mjs → chunk-OO3DRYK7.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, Camera, CAMERA_EXPOSURE_MODE_MANUAL, cameraExposureFromColumns, antialiasFromF32, validateDynamicResolutionCamera, bloomEnabledFromF32, tonemapFromF32, cameraProjectionFromF32 } from './chunk-S5UE2T5P.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-FUUO4UND.mjs';
-import { STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, SHADOW_ATLAS_DEFAULT_LAYERS, SkinMaterialMismatchError, MaterialSkinAttrMissingError, 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-JRBDO2KB.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 { 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,24 @@ 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"
+});
 
 // src/prepare/extended-lighting/state.ts
 function createExtendedLightingState(generation) {
@@ -938,8 +957,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 +1243,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;
@@ -1984,6 +1828,14 @@ function buildShadowFrusta(lights) {
 function skinPaletteIdentity(world, entity) {
   return `skin:${world.identity}:${entity}`;
 }
+function materialProgramSelectionRequiresSkin(selection) {
+  if (selection.abi?.skinPaletteAddress !== void 0) return true;
+  const semantics = new Set((selection.abi?.vertexInputs ?? []).map((input) => input.semantic));
+  return semantics.has("skinIndex") && semantics.has("skinWeight");
+}
+function isMissingMaterialProgram(error) {
+  return error !== null && typeof error === "object" && error.code === "material-specialization-not-cooked";
+}
 function extractFrames(worlds, owner, assets, pipelineState, materialSnapshotCachesByWorld, options = {}) {
   const cameraOwner = typeof owner === "number" ? owner : owner.cameraOwner;
   const resourceOwner = typeof owner === "number" ? owner : owner.resourceOwner;
@@ -2046,9 +1898,10 @@ function extractFrames(worlds, owner, assets, pipelineState, materialSnapshotCac
       });
       const frame = extractFrame(world, prepared);
       framesByWorld.set(wi, frame);
-    } catch (err8) {
+    } catch (err6) {
+      if (err6 instanceof MotionBlurValidationError) throw err6;
       try {
-        createWorldInternalView(world)._routeError(err8, {
+        createWorldInternalView(world)._routeError(err6, {
           severity: Severity.Error,
           systemName: `RenderSystem.extractFrames(world[${wi}])`
         });
@@ -2919,7 +2772,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",
@@ -3077,6 +2932,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");
@@ -3198,6 +3056,7 @@ function extractFrame(world, context) {
       const handleRaw = materialHandles[0] ?? 0;
       const cachedMaterial = handleRaw !== 0 && !hasSpriteRegionOverride && !hasSkin ? materialSnapshotCache.get(handleRaw) : void 0;
       let materialSnap;
+      let materialProgramSelections;
       if (cachedMaterial !== void 0) {
         materialSnap = cachedMaterial.snapshot;
         if (isRenderable) {
@@ -3261,28 +3120,28 @@ function extractFrame(world, context) {
           } else {
             const resolvedResult = walkMaterialPassesOverSharedRefs(world, tagged, assets);
             if (!resolvedResult.ok) {
-              const err8 = resolvedResult.error;
-              switch (err8.code) {
+              const err6 = resolvedResult.error;
+              switch (err6.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(err6, {
                     severity: Severity.Error,
-                    systemName: `RenderSystem.extract (${err8.code})`
+                    systemName: `RenderSystem.extract (${err6.code})`
                   });
                   break;
                 case "material-circular-inheritance":
-                  worldInternal._routeError(err8, {
+                  worldInternal._routeError(err6, {
                     severity: Severity.Error,
                     systemName: "RenderSystem.extract (material-circular-inheritance)"
                   });
                   break;
                 default:
-                  worldInternal._routeError(err8, {
+                  worldInternal._routeError(err6, {
                     severity: Severity.Error,
-                    systemName: `RenderSystem.extract (_materialWalk: ${err8.code})`
+                    systemName: `RenderSystem.extract (_materialWalk: ${err6.code})`
                   });
               }
               continue;
@@ -3293,10 +3152,41 @@ function extractFrame(world, context) {
               ...context.materialContext,
               geometry: hasSkin ? "skinned" : context.materialContext.geometry
             };
-            const materialProgramKeys = materialProgramKeysForMaterial(
-              asset,
-              assets,
-              materialContext
+            try {
+              materialProgramSelections = materialProgramSelectionsForMaterial(
+                asset,
+                assets,
+                materialContext
+              );
+            } catch (error) {
+              if (isMissingMaterialProgram(error) && materialContext?.geometry === "mesh") {
+                try {
+                  const skinnedSelections = materialProgramSelectionsForMaterial(asset, assets, {
+                    ...materialContext,
+                    geometry: "skinned"
+                  });
+                  if (skinnedSelections?.some(materialProgramSelectionRequiresSkin) === true && gpuDrivenMesh !== void 0) {
+                    const hasSkinIndex = gpuDrivenMesh.attributes.skinIndex !== void 0;
+                    const hasSkinWeight = gpuDrivenMesh.attributes.skinWeight !== void 0;
+                    if (!hasSkinIndex || !hasSkinWeight) {
+                      const missing = !hasSkinIndex && !hasSkinWeight ? "both" : !hasSkinIndex ? "skinIndex" : "skinWeight";
+                      worldInternal._routeError(new MaterialSkinAttrMissingError(entity, missing), {
+                        severity: Severity.Error,
+                        systemName: "RenderSystem.extract (material-skin-attr-missing)"
+                      });
+                      continue;
+                    }
+                  }
+                } catch {
+                }
+              }
+              throw error;
+            }
+            const materialProgramKeys = materialProgramSelections === void 0 ? void 0 : Object.fromEntries(
+              materialProgramSelections.map(({ pass, specializationKey }) => [
+                pass,
+                specializationKey
+              ])
             );
             const materialSceneIndexProgramKeys = materialSceneIndexProgramKeysForMaterial(
               asset,
@@ -3341,7 +3231,7 @@ function extractFrame(world, context) {
             );
             {
               const hasSkinSkel = hasSkin && skinSkeletonView !== void 0 && skinSkeletonView !== void 0 && skinSkeletonView !== 0;
-              const isPbrSkinMaterial = isStandardPbrSkinMaterialShader(firstPassShader);
+              const isPbrSkinMaterial = materialProgramSelections?.some(materialProgramSelectionRequiresSkin) === true || isStandardPbrSkinMaterialShader(firstPassShader);
               if (hasSkinSkel && !isPbrSkinMaterial) {
                 worldInternal._routeError(new SkinMaterialMismatchError(entity, firstPassShader), {
                   severity: Severity.Error,
@@ -3707,7 +3597,7 @@ function extractFrame(world, context) {
         }
         if (skinSlice === void 0 && hasSkin) {
           releaseSkinIdentity();
-          if (materialSnap.materialShaderId === "forgeax::pbr-skin") {
+          if (materialSnap.materialShaderId === "forgeax::pbr-skin" || materialProgramSelections?.some(materialProgramSelectionRequiresSkin) === true) {
             pendingDispatch.length = 0;
             continue;
           }
@@ -3887,6 +3777,7 @@ function extractFrame(world, context) {
           }
           instancesSnap = {
             transforms: collectionResult.value.transforms,
+            generations: collectionResult.value.generations,
             instanceCount: collectionResult.value.count,
             collectionId: collectionResult.value.collectionId,
             revision: collectionResult.value.revision,
@@ -4310,6 +4201,30 @@ function runtimeMaterialShaderId(module, passName) {
 function materialProgramKeysForMaterial(material, assets, context) {
   return materialProgramKeysForAddress(material, assets, context, "direct");
 }
+function materialProgramSelectionsForMaterial(material, assets, context, address = "direct") {
+  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 projection.passes.map((pass) => {
+    const mode = String(
+      pass.renderState?.tags?.LightMode ?? pass.name
+    );
+    const passKind = /shadow/i.test(mode) ? "shadow" : /depth/i.test(mode) ? "depth" : "forward";
+    const selectedContext = {
+      ...context,
+      pass: passKind,
+      pipeline: /deferred|gbuffer/i.test(mode) ? "deferred" : context.pipeline
+    };
+    const selected = selectMaterialPassProgram(projection, pass.name, selectedContext, address);
+    return {
+      pass: pass.name,
+      context: selectedContext,
+      specializationKey: selected.specializationKey,
+      ...selected.abi === void 0 ? {} : { abi: selected.abi }
+    };
+  });
+}
 function materialSceneIndexProgramKeysForMaterial(material, assets, context) {
   const projection = assets.getMaterialProjectionForPayload(material);
   if (projection === void 0) return void 0;
@@ -4335,35 +4250,19 @@ function materialSceneIndexProgramKeysForMaterial(material, assets, context) {
       );
       entries[pass.name] = { specializationKey: selected.specializationKey, pass: passKind };
     } catch (error) {
-      if (!isMissingMaterialProgram(error)) throw error;
+      if (!isMissingMaterialProgram2(error)) throw error;
     }
   }
   return Object.keys(entries).length === 0 ? void 0 : entries;
 }
-function isMissingMaterialProgram(error) {
+function isMissingMaterialProgram2(error) {
   return error !== null && typeof error === "object" && error.code === "material-specialization-not-cooked";
 }
 function materialProgramKeysForAddress(material, assets, context, address) {
-  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");
-  const entries = [];
-  for (const pass of projection.passes) {
-    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
-    };
-    entries.push([
-      pass.name,
-      selectMaterialPassProgram(projection, pass.name, selectedContext, address).specializationKey
-    ]);
-  }
-  return entries.length === 0 ? void 0 : Object.fromEntries(entries);
+  const selections = materialProgramSelectionsForMaterial(material, assets, context, address);
+  return selections === void 0 ? void 0 : Object.fromEntries(
+    selections.map(({ pass, specializationKey }) => [pass, specializationKey])
+  );
 }
 function runtimeMaterialShaderIdForMaterial(passes, programs) {
   const pass = passes.find(
@@ -4965,6 +4864,22 @@ function computeDirectionalCsm(direction, config, cameraData) {
       if ((ls[2] ?? 0) < minZ) minZ = ls[2] ?? 0;
       if ((ls[2] ?? 0) > maxZ) maxZ = ls[2] ?? 0;
     }
+    const texelX = (maxX - minX) / config.mapSize;
+    const texelY = (maxY - minY) / config.mapSize;
+    if (Number.isFinite(texelX) && texelX > 0) {
+      const centerX = (minX + maxX) * 0.5;
+      const snappedCenterX = Math.round(centerX / texelX) * texelX;
+      const halfWidth = (maxX - minX) * 0.5 + texelX * 0.5;
+      minX = snappedCenterX - halfWidth;
+      maxX = snappedCenterX + halfWidth;
+    }
+    if (Number.isFinite(texelY) && texelY > 0) {
+      const centerY = (minY + maxY) * 0.5;
+      const snappedCenterY = Math.round(centerY / texelY) * texelY;
+      const halfHeight = (maxY - minY) * 0.5 + texelY * 0.5;
+      minY = snappedCenterY - halfHeight;
+      maxY = snappedCenterY + halfHeight;
+    }
     const nearZ = Math.max(maxZ, lightSpaceMaxZFull);
     const orthoProj = mat4.create();
     mat4.orthographic(orthoProj, minX, maxX, maxY, minY, -nearZ, -minZ);
@@ -5008,14 +4923,26 @@ function collectCameraSnapshots(world) {
   const cameras = [];
   const cameraQuery = world.query({
     read: [Camera],
-    optional: [MotionBlur, DynamicResolution, ScreenSpaceReflection],
+    optional: [MotionBlur, DynamicResolution, ScreenSpaceReflection, DepthOfField],
     with: [Transform, GlobalTransform]
   }).unwrap();
   for (const row of cameraQuery) {
     const cam = row.get(Camera);
     const motionBlur = row.get(MotionBlur);
+    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);
+    const projection = cameraProjectionFromF32(cam.projection);
+    const depthOfFieldResult = resolveDepthOfFieldParams(depthOfField, {
+      projection,
+      fov: cam.fov,
+      near: cam.near,
+      far: cam.far
+    });
+    const depthOfFieldError = depthOfFieldResult.ok ? void 0 : depthOfFieldRequestFailure(depthOfFieldResult.error);
     const entity = row.entity;
     const view = worldInternal._getArrayView(entity, GlobalTransform, "world");
     if (view === void 0) continue;
@@ -5042,7 +4969,7 @@ function collectCameraSnapshots(world) {
       aspect: cam.aspect,
       near: cam.near,
       far: cam.far,
-      projection: cameraProjectionFromF32(cam.projection),
+      projection,
       orthoLeft: cam.left,
       orthoRight: cam.right,
       orthoBottom: cam.bottom,
@@ -5053,21 +4980,31 @@ 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,
         cam.clearColor[2] ?? 0,
         cam.clearColor[3] ?? 1
       ],
-      ...motionBlur === void 0 ? {} : {
+      ...depthOfFieldResult.ok && depthOfFieldResult.value !== void 0 ? { depthOfField: depthOfFieldResult.value } : {},
+      ...depthOfFieldError === void 0 ? {} : { depthOfFieldError },
+      ...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
         }
       },
       ...screenSpaceReflection === void 0 ? {} : {
@@ -5245,6 +5182,8 @@ 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 = [];
   let selectedLight;
@@ -5274,7 +5213,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)}`;
@@ -5331,6 +5270,7 @@ function extractVolumeSnapshot(world, assets, worldInternal) {
     });
     return {
       status: "degraded",
+      worldTimeSeconds,
       ...first === void 0 ? {} : {
         densityHandle: first.densityHandle,
         densityAsset: first.densityAsset,
@@ -5355,6 +5295,7 @@ function extractVolumeSnapshot(world, assets, worldInternal) {
   };
   return {
     status: "available",
+    worldTimeSeconds,
     fog: extracted.value.fog,
     densityHandle: first.densityHandle,
     densityAsset: first.densityAsset,
@@ -5903,6 +5844,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-C3DDSXYK.mjs.map
-//# sourceMappingURL=chunk-C3DDSXYK.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, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, rectAreaFacesPoint, scaledProbeWeight, setOcclusionRuntimeTestHooks, viewKey, viewKeyId };
+//# sourceMappingURL=chunk-OO3DRYK7.mjs.map
+//# sourceMappingURL=chunk-OO3DRYK7.mjs.map