@forgeax/engine-render 0.1.32 → 0.1.33

package/dist/{chunk-4NNZQCL3.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, DepthOfField, Camera, cameraProjectionFromF32, resolveDepthOfFieldParams, depthOfFieldRequestFailure, CAMERA_EXPOSURE_MODE_MANUAL, cameraExposureFromColumns, antialiasFromF32, validateDynamicResolutionCamera, bloomEnabledFromF32, tonemapFromF32 } from './chunk-GWCEMDVR.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-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 { 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;
@@ -2054,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}])`
         });
@@ -2927,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",
@@ -3085,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");
@@ -3270,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;
@@ -3927,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,
@@ -5078,6 +4929,9 @@ function collectCameraSnapshots(world) {
   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);
@@ -5126,10 +4980,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,11 +4999,12 @@ 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
         }
       },
       ...screenSpaceReflection === void 0 ? {} : {
@@ -5320,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;
@@ -5349,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)}`;
@@ -5406,6 +5270,7 @@ function extractVolumeSnapshot(world, assets, worldInternal) {
     });
     return {
       status: "degraded",
+      worldTimeSeconds,
       ...first === void 0 ? {} : {
         densityHandle: first.densityHandle,
         densityAsset: first.densityAsset,
@@ -5430,6 +5295,7 @@ function extractVolumeSnapshot(world, assets, worldInternal) {
   };
   return {
     status: "available",
+    worldTimeSeconds,
     fog: extracted.value.fog,
     densityHandle: first.densityHandle,
     densityAsset: first.densityAsset,
@@ -5978,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-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, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, rectAreaFacesPoint, scaledProbeWeight, setOcclusionRuntimeTestHooks, viewKey, viewKeyId };
+//# sourceMappingURL=chunk-OO3DRYK7.mjs.map
+//# sourceMappingURL=chunk-OO3DRYK7.mjs.map