@forgeax/engine-render 0.1.32 → 0.1.34

package/dist/{chunk-DRR7D3KX.mjs → chunk-SHFUFJ5N.mjs}

@@ -1,4 +1,4 @@
-import { LifecycleConstructionError, GpuDrivenPreparationError, RenderTargetDescriptorInvalidError } from './chunk-6TFBXLRJ.mjs';
+import { LifecycleConstructionError, GpuDrivenPreparationError, RenderTargetDescriptorInvalidError } from './chunk-WEX45HKH.mjs';
 import { ok, err, derive } from '@forgeax/engine-types';
 import '@forgeax/engine-rhi';
 import { vec3 } from '@forgeax/engine-math';
@@ -375,7 +375,8 @@ function makeZeroCameraFallbackSnapshot() {
     bloom: "off",
     bloomThreshold: 1,
     bloomIntensity: 1,
-    bloomBlurRadius: 4,
+    bloomSoftKnee: 0.5,
+    bloomScatter: 0.7,
     clearColor: ZERO_CAMERA_CLEAR_FALLBACK
   };
 }
@@ -562,6 +563,41 @@ function appendInjection(bgl, kind) {
       ];
   }
 }
+function appendSingleLayerMediumInjection(bgl) {
+  const start = bgl.length;
+  return [
+    {
+      binding: start,
+      visibility: GPU_SHADER_STAGE_FRAGMENT,
+      sampler: { type: "non-filtering" }
+    },
+    {
+      binding: start + 1,
+      visibility: GPU_SHADER_STAGE_FRAGMENT,
+      texture: { sampleType: "unfilterable-float", viewDimension: "2d" }
+    },
+    {
+      binding: start + 2,
+      visibility: GPU_SHADER_STAGE_FRAGMENT,
+      sampler: { type: "filtering" }
+    },
+    {
+      binding: start + 3,
+      visibility: GPU_SHADER_STAGE_FRAGMENT,
+      texture: { sampleType: "float", viewDimension: "2d" }
+    },
+    {
+      binding: start + 4,
+      visibility: GPU_SHADER_STAGE_FRAGMENT,
+      sampler: { type: "non-filtering" }
+    },
+    {
+      binding: start + 5,
+      visibility: GPU_SHADER_STAGE_FRAGMENT,
+      texture: { sampleType: "unfilterable-float", viewDimension: "2d" }
+    }
+  ];
+}
 function physicalTextureFields(paramSchema) {
   return standardPhysicalTextureFields(paramSchema);
 }
@@ -689,6 +725,7 @@ function buildPbrViewBglEntries(caps) {
     }
   ];
   const extendedLighting = caps.extendedLighting ?? true;
+  const lowLimitCloudBindings = extendedLighting === false && caps.projectorAvailable === false;
   if (extendedLighting) {
     entries.push(
       {
@@ -741,6 +778,20 @@ function buildPbrViewBglEntries(caps) {
     visibility: GPU_SHADER_STAGE_VERTEX,
     buffer: { type: "uniform", hasDynamicOffset: true }
   });
+  if (!lowLimitCloudBindings) {
+    entries.push(
+      {
+        binding: 16,
+        visibility: GPU_SHADER_STAGE_FRAGMENT,
+        texture: { sampleType: "float", viewDimension: "2d" }
+      },
+      {
+        binding: 17,
+        visibility: GPU_SHADER_STAGE_FRAGMENT,
+        sampler: { type: "filtering" }
+      }
+    );
+  }
   return entries;
 }
 function buildPbrPipelineLayouts(device, caps) {
@@ -894,6 +945,19 @@ function buildGpuDrivenPbrInstancesBindGroupLayout(device, caps) {
   if (!result.ok) throw result.error;
   return result.value;
 }
+function buildSurfaceDirectInstancesBindGroupLayout(device, caps) {
+  if (!caps.storageBuffer) {
+    throw new Error("Direct Surface instances layout requires storage-buffer capability");
+  }
+  const result = device.createBindGroupLayout(
+    buildBindGroupLayoutDescriptor(BGL_ONLY_SPEC_STUB, {
+      kind: "pbr-surface-direct-instances",
+      caps
+    })
+  );
+  if (!result.ok) throw result.error;
+  return result.value;
+}
 function buildGpuDrivenPbrPipelineLayout(device, pbr, gpuDrivenInstancesBgl) {
   const result = device.createPipelineLayout({
     label: "pbr-gpu-driven-pl",
@@ -1082,7 +1146,7 @@ function buildBindGroupLayoutDescriptor(spec, options) {
         entries: [
           {
             binding: 0,
-            visibility: GPU_SHADER_STAGE_VERTEX | GPU_SHADER_STAGE_FRAGMENT,
+            visibility: GPU_SHADER_STAGE_VERTEX,
             buffer: { type: meshBufType, hasDynamicOffset: false }
           },
           {
@@ -1091,13 +1155,78 @@ function buildBindGroupLayoutDescriptor(spec, options) {
             // the shared visible bind group can serve both the Standard PBR
             // (binding(2)) and depth-only shadow (binding(1)) consumers.
             binding: 1,
-            visibility: GPU_SHADER_STAGE_VERTEX,
+            visibility: GPU_SHADER_STAGE_VERTEX | GPU_SHADER_STAGE_FRAGMENT,
             buffer: { type: meshBufType, hasDynamicOffset: false }
           },
           {
             binding: 2,
             visibility: GPU_SHADER_STAGE_VERTEX,
             buffer: { type: meshBufType, hasDynamicOffset: false }
+          },
+          {
+            // Generic Surface dynamic pages are read by authored Surface
+            // accessors. The binding is present for every scene-index group
+            // so Standard and custom Surface batches share one owner shape.
+            binding: 3,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            buffer: { type: meshBufType, hasDynamicOffset: false }
+          },
+          {
+            // Frame time, explicit event ranges, and paired background/depth
+            // facts use separate read-only pages. This keeps live state out
+            // of the material row and leaves skin's address lane untouched.
+            binding: 4,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            buffer: { type: meshBufType, hasDynamicOffset: false }
+          },
+          {
+            // Frame time is one frame-global fact. Keeping it outside the
+            // member row prevents a stable frame from issuing one 4-byte
+            // queue write for every visible Surface member.
+            binding: 5,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            buffer: { type: "uniform", hasDynamicOffset: false }
+          }
+        ]
+      };
+    }
+    case "pbr-surface-direct-instances": {
+      return {
+        label: "pbr-surface-direct-instances-bgl",
+        entries: [
+          {
+            binding: 0,
+            // Direct instance transforms are consumed only by vs_main. Keep
+            // them out of the fragment-stage storage budget; Surface already
+            // needs the retained ProbeBlend/page/frame records there and the
+            // portable WebGPU limit is eight storage buffers per stage.
+            visibility: GPU_SHADER_STAGE_VERTEX,
+            buffer: { type: "read-only-storage", hasDynamicOffset: false }
+          },
+          {
+            binding: 1,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            buffer: { type: "read-only-storage", hasDynamicOffset: true }
+          },
+          {
+            binding: 3,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            buffer: { type: "read-only-storage", hasDynamicOffset: false }
+          },
+          {
+            binding: 4,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            buffer: { type: "read-only-storage", hasDynamicOffset: false }
+          },
+          {
+            binding: 5,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            buffer: { type: "uniform", hasDynamicOffset: false }
+          },
+          {
+            binding: 6,
+            visibility: GPU_SHADER_STAGE_VERTEX,
+            buffer: { type: "uniform", hasDynamicOffset: false }
           }
         ]
       };
@@ -1134,9 +1263,11 @@ function buildBindGroupLayoutDescriptor(spec, options) {
       const userRegion = buildPbrMaterialUserRegionEntries(userRegionSchema);
       const afterIbl = [...userRegion, ...appendInjection(userRegion, "ibl")];
       const afterTransmission = [...afterIbl, ...appendInjection(afterIbl, "transmission")];
+      const engineRegion = options.caps?.transmissionBackdrop === false && spec.shader.id !== "forgeax::single-layer-medium" ? afterIbl : afterTransmission;
+      const afterSurfaceMedium = spec.shader.id === "forgeax::single-layer-medium" ? [...engineRegion, ...appendSingleLayerMediumInjection(engineRegion)] : engineRegion;
       const merged = [
-        ...options.caps?.transmissionBackdrop === false ? afterIbl : afterTransmission,
-        ...appendTextureInjection(afterTransmission, physicalFields)
+        ...afterSurfaceMedium,
+        ...appendTextureInjection(afterSurfaceMedium, physicalFields)
       ];
       if (options.caps?.storageBuffer ?? true) {
         merged.push({
@@ -1145,16 +1276,19 @@ function buildBindGroupLayoutDescriptor(spec, options) {
           buffer: { type: "read-only-storage", hasDynamicOffset: false }
         });
       }
-      return {
-        label: "pbr-material-skylight-bgl",
-        entries: [
-          ...merged,
+      const entries = [
+        ...merged,
+        ...spec.shader.id === "forgeax::single-layer-medium" ? [] : [
           {
             binding: 47,
             visibility: GPU_SHADER_STAGE_FRAGMENT,
             texture: { sampleType: "float", viewDimension: "cube" }
           }
         ]
+      ];
+      return {
+        label: "pbr-material-skylight-bgl",
+        entries
       };
     }
     case "unlit-material": {
@@ -1236,6 +1370,42 @@ function buildBindGroupLayoutDescriptor(spec, options) {
         ]
       };
     }
+    case "fullscreen-post-with-paired-msaa": {
+      return {
+        label: "fullscreen-post-with-paired-msaa-bgl",
+        entries: [
+          {
+            binding: 0,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            texture: {
+              sampleType: "unfilterable-float",
+              viewDimension: "2d",
+              multisampled: true
+            }
+          },
+          {
+            binding: 1,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            sampler: { type: "filtering" }
+          },
+          {
+            binding: 2,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            buffer: { type: "uniform" }
+          },
+          {
+            binding: 3,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            texture: { sampleType: "depth", viewDimension: "2d", multisampled: true }
+          },
+          {
+            binding: 4,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            sampler: { type: "non-filtering" }
+          }
+        ]
+      };
+    }
   }
 }
 function buildFullscreenPostInputEntries(spec) {
@@ -1335,9 +1505,11 @@ function selectPasses(passes, selector) {
 function failure(code, detail) {
   return { ok: false, error: new GpuDrivenPreparationError(code, detail) };
 }
-function sameVertexInputs(expected, actual) {
-  return expected.length === actual.length && expected.every(
-    (input, index) => input.semantic === actual[index]?.semantic && input.location === actual[index]?.location && input.format === actual[index]?.format
+function hasRequiredVertexInputs(expected, actual) {
+  return expected.every(
+    (input) => actual.some(
+      (candidate) => candidate.semantic === input.semantic && candidate.location === input.location && candidate.format === input.format
+    )
   );
 }
 function hasMaterialResources(snapshot, receipt) {
@@ -1349,7 +1521,9 @@ function hasMaterialResources(snapshot, receipt) {
   const authoredTextures = snapshot.material.authoredTextureFields;
   const authoredSamplers = snapshot.material.authoredSamplerFields;
   return receipt.resourceSlots.every((slot) => {
-    if (slot.kind === "storage-buffer") return false;
+    if (slot.kind === "storage-buffer") {
+      return receipt.surface?.dynamicInput?.group === slot.group && receipt.surface.dynamicInput.binding === slot.binding && slot.group === 3 && slot.binding === 3;
+    }
     if (slot.kind === "texture") {
       if (!authoredTextures?.has(slot.parameter)) return true;
       return textures?.has(slot.parameter) === true || snapshot.material.textureSources?.has(slot.parameter) === true || snapshot.material.videoTextureFields?.has(slot.parameter) === true;
@@ -1391,7 +1565,7 @@ function prepareGpuDrivenDraw(input) {
       actual: `${input.geometry.vertexInputs.filter((vertex) => vertex.semantic.startsWith("uv")).length} geometry UV sets`
     });
   }
-  if (!sameVertexInputs(receipt.vertexInputs, input.geometry.vertexInputs)) {
+  if (!hasRequiredVertexInputs(receipt.vertexInputs, input.geometry.vertexInputs)) {
     return failure("vertex-input-mismatch", {
       reason: "vertex-semantic-mismatch",
       owner: "geometry",
@@ -1602,6 +1776,6 @@ function buildGpuDrivenDraws(input) {
   });
 }
 
-export { COOKIE_MATRIX_BYTES, COOKIE_SLICE_CAPACITY, COOKIE_SLICE_SIZE, DeviceScope, EXTENDED_LIGHTING_REQUIRED_SAMPLED_TEXTURES, EXTENDED_LIGHTING_TOPOLOGY, GPU_BUFFER_USAGE_COPY_DST, GPU_BUFFER_USAGE_COPY_SRC, GPU_BUFFER_USAGE_INDEX, GPU_BUFFER_USAGE_INDIRECT, GPU_BUFFER_USAGE_MAP_READ, GPU_BUFFER_USAGE_QUERY_RESOLVE, GPU_BUFFER_USAGE_STORAGE, GPU_BUFFER_USAGE_UNIFORM, GPU_BUFFER_USAGE_VERTEX, GPU_SHADER_STAGE_COMPUTE, GPU_SHADER_STAGE_FRAGMENT, GPU_SHADER_STAGE_VERTEX, IES_SLICE_CAPACITY, IES_SLICE_HEIGHT, IES_SLICE_WIDTH, LifecycleTransaction, PROBE_BLEND_RECORD_BYTE_SIZE, PROBE_BLEND_RECORD_CAPACITY, PROBE_BLEND_RECORD_STRIDE, SHADOW_CASTER_SHADER_ID, SKIN_MATERIAL_SHADER_ID, SPRITE_PASS_PER_INSTANCE_REGION_VARIANT_SET, buildBindGroupLayoutDescriptor, buildGpuDrivenDraws, buildGpuDrivenPbrInstancesBindGroupLayout, buildGpuDrivenPbrPipelineLayout, buildGpuDrivenPbrSkinPipelineLayout, buildPbrMaterialUserRegionEntries, buildPbrPipelineLayouts, buildPbrSkinLayouts, classifySceneDataCoverage, createHdrpBindGroupLayoutDescriptor, createHdrpSkinBindGroupLayoutDescriptor, createPbrSkinMeshBindGroupEntries, createRenderTargetMaterialSource, createTemporalCoverage, deriveExtendedLightingCapability, extendedLightingSampledTextureCapacityAvailable, getOpaqueResourceIdentity, getTextureIdentity, gpuDrivenDrawKey, gpuDrivenMaterialArtifactKey, gpuDrivenShadowDrawKey, gpuDrivenSourceDrawItemIndex, instanceCollectionCacheKey, isCanonicalStandardPbrMaterialShader, isStandardPbrMaterialShader, isStandardPbrSkinMaterialShader, makeZeroCameraFallbackSnapshot, matchPass, materialBindGroupLayoutIdentity, pbrSkinMeshDynamicOffsets, physicalTextureFields, probeBlendRecordOffset, resolvePipelineGroup2Contract, resolveRenderTargetMaterialSource, scanSceneDataCoverage, selectPasses, shadowCasterVariantSet, validateGraphTargetCaptureReadback, worldEntityKey };
-//# sourceMappingURL=chunk-DRR7D3KX.mjs.map
-//# sourceMappingURL=chunk-DRR7D3KX.mjs.map
+export { COOKIE_MATRIX_BYTES, COOKIE_SLICE_CAPACITY, COOKIE_SLICE_SIZE, DeviceScope, EXTENDED_LIGHTING_REQUIRED_SAMPLED_TEXTURES, EXTENDED_LIGHTING_TOPOLOGY, GPU_BUFFER_USAGE_COPY_DST, GPU_BUFFER_USAGE_COPY_SRC, GPU_BUFFER_USAGE_INDEX, GPU_BUFFER_USAGE_INDIRECT, GPU_BUFFER_USAGE_MAP_READ, GPU_BUFFER_USAGE_QUERY_RESOLVE, GPU_BUFFER_USAGE_STORAGE, GPU_BUFFER_USAGE_UNIFORM, GPU_BUFFER_USAGE_VERTEX, GPU_SHADER_STAGE_COMPUTE, GPU_SHADER_STAGE_FRAGMENT, GPU_SHADER_STAGE_VERTEX, IES_SLICE_CAPACITY, IES_SLICE_HEIGHT, IES_SLICE_WIDTH, LifecycleTransaction, PROBE_BLEND_RECORD_BYTE_SIZE, PROBE_BLEND_RECORD_CAPACITY, PROBE_BLEND_RECORD_STRIDE, SHADOW_CASTER_SHADER_ID, SKIN_MATERIAL_SHADER_ID, SPRITE_PASS_PER_INSTANCE_REGION_VARIANT_SET, buildBindGroupLayoutDescriptor, buildGpuDrivenDraws, buildGpuDrivenPbrInstancesBindGroupLayout, buildGpuDrivenPbrPipelineLayout, buildGpuDrivenPbrSkinPipelineLayout, buildPbrMaterialUserRegionEntries, buildPbrPipelineLayouts, buildPbrSkinLayouts, buildSurfaceDirectInstancesBindGroupLayout, classifySceneDataCoverage, createHdrpBindGroupLayoutDescriptor, createHdrpSkinBindGroupLayoutDescriptor, createPbrSkinMeshBindGroupEntries, createRenderTargetMaterialSource, createTemporalCoverage, deriveExtendedLightingCapability, extendedLightingSampledTextureCapacityAvailable, getOpaqueResourceIdentity, getTextureIdentity, gpuDrivenDrawKey, gpuDrivenMaterialArtifactKey, gpuDrivenShadowDrawKey, gpuDrivenSourceDrawItemIndex, hasRequiredVertexInputs, instanceCollectionCacheKey, isCanonicalStandardPbrMaterialShader, isStandardPbrMaterialShader, isStandardPbrSkinMaterialShader, makeZeroCameraFallbackSnapshot, matchPass, materialBindGroupLayoutIdentity, pbrSkinMeshDynamicOffsets, physicalTextureFields, probeBlendRecordOffset, resolvePipelineGroup2Contract, resolveRenderTargetMaterialSource, scanSceneDataCoverage, selectPasses, shadowCasterVariantSet, validateGraphTargetCaptureReadback, worldEntityKey };
+//# sourceMappingURL=chunk-SHFUFJ5N.mjs.map
+//# sourceMappingURL=chunk-SHFUFJ5N.mjs.map