@forgeax/engine-render 0.1.19 → 0.1.20

package/dist/{chunk-RJRUS55L.mjs → chunk-4XINDLAY.mjs}

@@ -1,15 +1,15 @@
 import { TRANSPARENT_SORT_MODE_LAYER_Z, TRANSPARENT_SORT_MODE_LAYER_Y } from './chunk-RXZ3RGOU.mjs';
-import { DEFAULT_CLUSTER_GRID, CLUSTER_GRID_STRIDE_U32, LIGHT_INDEX_LIST_CAPACITY, EquirectProjectionFailedError, PointShadowAtlasUninitializedError, PointShadowAtlasBoundsViolationError, HdrpLightBudgetExceededError, STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, MAX_LIGHTS, HdrpIndexListOverflowError, VideoUploadUnsupportedError, VertexColorVariantConflictError } from './chunk-LOSO4CTV.mjs';
+import { DEFAULT_CLUSTER_GRID, CLUSTER_GRID_STRIDE_U32, LIGHT_INDEX_LIST_CAPACITY, EquirectProjectionFailedError, PointShadowAtlasUninitializedError, PointShadowAtlasBoundsViolationError, HdrpLightBudgetExceededError, STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, MAX_LIGHTS, HdrpIndexListOverflowError, VideoUploadUnsupportedError, VertexColorVariantConflictError } from './chunk-TBQJOK2L.mjs';
 import { SPRITE_PREMULTIPLIED_ALPHA_BLEND } from './chunk-VFPLTKCU.mjs';
-import { clampPcfKernelSize, worldEntityKey } from './chunk-IPXCABEP.mjs';
-import { ok, err as err$1, toShared, ASSET_ERROR_HINTS, derive, KNOWN_PASS_KINDS, resolveMaterialTextureCoordinates, handleSlot } from '@forgeax/engine-types';
+import { clampPcfKernelSize, worldEntityKey } from './chunk-M2MP4ZOU.mjs';
+import { ok, derive, err as err$1, toShared, ASSET_ERROR_HINTS, deriveTextureLayout, KNOWN_PASS_KINDS, resolveMaterialTextureCoordinates, handleSlot } from '@forgeax/engine-types';
 import { ok as ok$1, err, RhiError, cubeArrayDepthDescriptor, comparisonSamplerDescriptor, cubeArrayDepthFaceView } from '@forgeax/engine-rhi';
 import { vec3, mat3, mat4 } from '@forgeax/engine-math';
 import { deriveVertexLayoutProjection, deriveVertexBufferLayout } from '@forgeax/engine-geometry';
 import { DEFAULT_STANDARD_PBR_PARAM_SCHEMA, DEFAULT_MSDF_TEXT_PARAM_SCHEMA, DEFAULT_SPRITE_PARAM_SCHEMA, DEFAULT_UNLIT_PARAM_SCHEMA } from '@forgeax/engine-shader';
-import { resolveAssetHandle, numMipLevels } from '@forgeax/engine-assets-runtime';
+import { resolveAssetHandle } from '@forgeax/engine-assets-runtime';
 import { probeVideoHighPerfUpload, VIDEO_ELEMENT_PROVIDER_KEY } from '@forgeax/engine-graphics-extras';
-import { blockParamsForFormat, isCompressedFormat, bytesPerRow } from '@forgeax/engine-codec';
+import { isCompressedFormat, bytesPerRow, blockParamsForFormat } from '@forgeax/engine-codec';
 
 // src/gpu-texture-usage.ts
 var GPU_TEXTURE_USAGE_COPY_SRC = 1;
@@ -478,6 +478,8 @@ var GPU_BUFFER_USAGE_COPY_SRC = 4;
 var GPU_BUFFER_USAGE_UNIFORM = 64;
 var GPU_BUFFER_USAGE_STORAGE = 128;
 var GPU_BUFFER_USAGE_INDIRECT = 256;
+var GPU_BUFFER_USAGE_MAP_READ = 1;
+var GPU_BUFFER_USAGE_QUERY_RESOLVE = 512;
 var BYTES_PER_LIGHT_SLOT = 64;
 var LightSlotKind = {
   POINT: 0,
@@ -485,8 +487,9 @@ var LightSlotKind = {
 };
 var STORAGE_BUFFER_MIN_REQUIRED = 4;
 var POINT_LIGHT_STD430_BYTES = 32;
-var SPOT_LIGHT_STD430_BYTES = 64;
+var SPOT_LIGHT_STD430_BYTES = 80;
 var SPOT_LIGHT_SHADOW_TILE_SENTINEL = -1;
+var SPOT_LIGHT_PROJECTOR_ONLY_SENTINEL = -2;
 var LIGHT_ARRAY_HEADER_BYTES = 16;
 var LIGHT_ARRAY_MAX_SLOTS = 4;
 var POINT_LIGHT_SHADOW_LAYER_SENTINEL = -1;
@@ -504,7 +507,7 @@ function packPointLight(snap) {
   return out;
 }
 function packSpotLight(snap) {
-  const out = new Float32Array(16);
+  const out = new Float32Array(20);
   out[0] = snap.position[0] ?? 0;
   out[1] = snap.position[1] ?? 0;
   out[2] = snap.position[2] ?? 0;
@@ -517,8 +520,12 @@ function packSpotLight(snap) {
   out[9] = snap.direction[1] ?? 0;
   out[10] = snap.direction[2] ?? 0;
   out[11] = snap.cosOuter;
+  out[12] = snap.depthBias ?? 5e-3;
+  out[13] = snap.normalBias ?? 0.05;
+  out[14] = snap.pcfKernelSize ?? 3;
   const i32 = new Int32Array(out.buffer);
-  i32[15] = snap.shadowAtlasTile ?? SPOT_LIGHT_SHADOW_TILE_SENTINEL;
+  i32[15] = snap.shadowAtlasTile >= 0 ? snap.shadowAtlasTile : snap.projectorAsset !== void 0 && snap.lightViewProj !== void 0 ? SPOT_LIGHT_PROJECTOR_ONLY_SENTINEL : SPOT_LIGHT_SHADOW_TILE_SENTINEL;
+  out[16] = snap.shadowIntensity ?? 1;
   return out;
 }
 function packLightArrayHeader(count) {
@@ -549,7 +556,9 @@ function packLightSlot(snap, shadow) {
     out[14] = shadow.near;
     out[15] = shadow.far;
   } else if (snap.kind === "spot") {
-    i32[13] = snap.shadowAtlasTile;
+    i32[13] = snap.shadowAtlasTile >= 0 ? snap.shadowAtlasTile : snap.projectorAsset !== void 0 && snap.lightViewProj !== void 0 ? SPOT_LIGHT_PROJECTOR_ONLY_SENTINEL : SPOT_LIGHT_SHADOW_TILE_SENTINEL;
+    out[14] = snap.shadowIntensity ?? 1;
+    out[15] = snap.pcfKernelSize ?? 3;
   } else {
     i32[13] = POINT_LIGHT_SHADOW_LAYER_SENTINEL;
   }
@@ -593,7 +602,7 @@ function buildPbrMaterialUserRegionEntries(paramSchema = DEFAULT_STANDARD_PBR_PA
     })
   );
   const ubo = entries[0];
-  if (ubo !== void 0 && ubo.binding === 0 && ubo.buffer !== void 0) {
+  if (ubo !== void 0 && ubo.binding === 0 && ubo.buffer?.type === "uniform") {
     entries[0] = {
       binding: 0,
       visibility: GPU_SHADER_STAGE_VERTEX | GPU_SHADER_STAGE_FRAGMENT,
@@ -705,7 +714,7 @@ function appendInjection(bgl, kind) {
 }
 function buildPbrViewBglEntries(caps) {
   const lightBufType = caps.storageBuffer ? "read-only-storage" : "uniform";
-  return [
+  const entries = [
     {
       binding: 0,
       visibility: GPU_SHADER_STAGE_VERTEX | GPU_SHADER_STAGE_FRAGMENT,
@@ -797,13 +806,28 @@ function buildPbrViewBglEntries(caps) {
       binding: 8,
       visibility: GPU_SHADER_STAGE_FRAGMENT,
       texture: { sampleType: "depth", viewDimension: "2d" }
-    },
-    {
-      binding: 10,
-      visibility: GPU_SHADER_STAGE_VERTEX,
-      buffer: { type: "uniform", hasDynamicOffset: true }
     }
   ];
+  if (caps.projectorAvailable !== false) {
+    entries.push(
+      {
+        binding: 11,
+        visibility: GPU_SHADER_STAGE_FRAGMENT,
+        texture: { sampleType: "float", viewDimension: "2d" }
+      },
+      {
+        binding: 12,
+        visibility: GPU_SHADER_STAGE_FRAGMENT,
+        sampler: { type: "filtering" }
+      }
+    );
+  }
+  entries.push({
+    binding: 10,
+    visibility: GPU_SHADER_STAGE_VERTEX,
+    buffer: { type: "uniform", hasDynamicOffset: true }
+  });
+  return entries;
 }
 function buildPbrPipelineLayouts(device, caps) {
   const viewBglRes = device.createBindGroupLayout(
@@ -2990,6 +3014,9 @@ function buildPerFrameBindGroups(internals, frameState, pipelineState, hasValida
       const b5View = atlasViewMaybe !== null ? atlasViewMaybe : pipelineState.shadowAtlasFallbackTextureView;
       const graphSpotShadowView = graphTargets?.spotShadow;
       const b8View = graphSpotShadowView !== void 0 ? graphSpotShadowView : pipelineState.shadowFallbackTextureView;
+      const projectorAvailable = pipelineState.projectorAvailable !== false;
+      const b11View = graphTargets?.projector ?? pipelineState.defaultWhiteTextureView;
+      const b12Sampler = graphTargets?.projectorSampler ?? pipelineState.defaultSampler;
       viewBindGroup = getOrCreateFromChain(
         frameState.viewBindGroupCache,
         [
@@ -3001,110 +3028,116 @@ function buildPerFrameBindGroups(internals, frameState, pipelineState, hasValida
           b5View,
           pipelineState.shadowParamsBuffer,
           b8View,
+          ...projectorAvailable ? [b11View, b12Sampler] : [],
           pipelineState.pointsLinesViewBuffer ?? pipelineState.viewUniformBuffer
         ],
         "view-main",
         () => {
+          const entries = [
+            {
+              binding: 0,
+              resource: {
+                kind: "buffer",
+                value: { buffer: pipelineState.viewUniformBuffer, size: VIEW_UNIFORM_BYTES }
+              }
+            },
+            {
+              binding: 1,
+              resource: {
+                kind: "buffer",
+                value: { buffer: pipelineState.pointLightsBuffer }
+              }
+            },
+            {
+              binding: 2,
+              resource: {
+                kind: "buffer",
+                value: { buffer: pipelineState.spotLightsBuffer }
+              }
+            },
+            {
+              binding: 3,
+              resource: {
+                kind: "textureView",
+                value: b3View
+              }
+            },
+            {
+              binding: 4,
+              resource: {
+                kind: "sampler",
+                value: shadowSampler
+              }
+            },
+            // feat-20260612-point-light-shadows-urp-hdrp Round-2 F-1:
+            // cube_array shadow atlas view (real ShadowAtlas when point
+            // shadows are active; else 1x1x6 fallback).
+            {
+              binding: 5,
+              resource: {
+                kind: "textureView",
+                value: b5View
+              }
+            },
+            // feat-20260612-point-light-shadows-urp-hdrp Round-2 F-1:
+            // shadowParams UBO (`array<vec4<f32>, 4>` = 64 B). Lane N
+            // stores `(near, far, 1/(far-near), 0)` for the point light
+            // with shadowAtlasLayer === N. Updated per frame from
+            // `pointShadowSnapshots` below.
+            {
+              binding: 6,
+              resource: {
+                kind: "buffer",
+                value: { buffer: pipelineState.shadowParamsBuffer }
+              }
+            },
+            // feat-20260613-csm-cascaded-shadow-maps M5 / w28 (rebased to
+            // binding 7 on 2026-06-13 to make room for point-shadow 5/6):
+            // forward shaders declare binding 7 in common.wgsl (shared
+            // view BGL) but never reference it; only shadow_caster.wgsl
+            // reads it. Host writes a stable singleton buffer so every
+            // forward bind group entry stays populated.
+            {
+              binding: 7,
+              resource: {
+                kind: "buffer",
+                value: { buffer: pipelineState.shadowCasterCascadeBuffer }
+              }
+            },
+            // feat-20260625-spot-light-shadow-mapping M3 / w21 (D-5):
+            // spot shadow 2D atlas (real spotShadowDepth view when spot
+            // shadows run this frame, else the 1x1 depth fallback). Always-on.
+            {
+              binding: 8,
+              resource: {
+                kind: "textureView",
+                value: b8View
+              }
+            },
+            {
+              binding: 10,
+              resource: {
+                kind: "buffer",
+                value: {
+                  buffer: pipelineState.pointsLinesViewBuffer ?? pipelineState.viewUniformBuffer,
+                  size: POINTS_LINES_VIEW_BYTES
+                }
+              }
+            },
+            ...projectorAvailable ? [
+              { binding: 11, resource: { kind: "textureView", value: b11View } },
+              { binding: 12, resource: { kind: "sampler", value: b12Sampler } }
+            ] : []
+            // feat-20260625-spot-light-shadow-mapping w25: the per-spot
+            // fragment-read lightViewProj matrices fold into the View UBO
+            // (binding 0, `view.spotLightViewProj`) — no standalone binding 9
+            // (WebGL2 fragment uniform-buffer budget). binding 10 is the
+            // dedicated vertex-only Points/Lines viewport UBO.
+          ];
           const viewBindGroupResult = internals.device.createBindGroup({
             label: "pbr-view-bg",
             layout: pipelineState.viewBindGroupLayout,
-            entries: [
-              {
-                binding: 0,
-                resource: {
-                  kind: "buffer",
-                  value: { buffer: pipelineState.viewUniformBuffer, size: VIEW_UNIFORM_BYTES }
-                }
-              },
-              {
-                binding: 1,
-                resource: {
-                  kind: "buffer",
-                  value: { buffer: pipelineState.pointLightsBuffer }
-                }
-              },
-              {
-                binding: 2,
-                resource: {
-                  kind: "buffer",
-                  value: { buffer: pipelineState.spotLightsBuffer }
-                }
-              },
-              {
-                binding: 3,
-                resource: {
-                  kind: "textureView",
-                  value: b3View
-                }
-              },
-              {
-                binding: 4,
-                resource: {
-                  kind: "sampler",
-                  value: shadowSampler
-                }
-              },
-              // feat-20260612-point-light-shadows-urp-hdrp Round-2 F-1:
-              // cube_array shadow atlas view (real ShadowAtlas when point
-              // shadows are active; else 1x1x6 fallback).
-              {
-                binding: 5,
-                resource: {
-                  kind: "textureView",
-                  value: b5View
-                }
-              },
-              // feat-20260612-point-light-shadows-urp-hdrp Round-2 F-1:
-              // shadowParams UBO (`array<vec4<f32>, 4>` = 64 B). Lane N
-              // stores `(near, far, 1/(far-near), 0)` for the point light
-              // with shadowAtlasLayer === N. Updated per frame from
-              // `pointShadowSnapshots` below.
-              {
-                binding: 6,
-                resource: {
-                  kind: "buffer",
-                  value: { buffer: pipelineState.shadowParamsBuffer }
-                }
-              },
-              // feat-20260613-csm-cascaded-shadow-maps M5 / w28 (rebased to
-              // binding 7 on 2026-06-13 to make room for point-shadow 5/6):
-              // forward shaders declare binding 7 in common.wgsl (shared
-              // view BGL) but never reference it; only shadow_caster.wgsl
-              // reads it. Host writes a stable singleton buffer so every
-              // forward bind group entry stays populated.
-              {
-                binding: 7,
-                resource: {
-                  kind: "buffer",
-                  value: { buffer: pipelineState.shadowCasterCascadeBuffer }
-                }
-              },
-              // feat-20260625-spot-light-shadow-mapping M3 / w21 (D-5):
-              // spot shadow 2D atlas (real spotShadowDepth view when spot
-              // shadows run this frame, else the 1x1 depth fallback). Always-on.
-              {
-                binding: 8,
-                resource: {
-                  kind: "textureView",
-                  value: b8View
-                }
-              },
-              {
-                binding: 10,
-                resource: {
-                  kind: "buffer",
-                  value: {
-                    buffer: pipelineState.pointsLinesViewBuffer ?? pipelineState.viewUniformBuffer,
-                    size: POINTS_LINES_VIEW_BYTES
-                  }
-                }
-              }
-              // feat-20260625-spot-light-shadow-mapping w25: the per-spot
-              // fragment-read lightViewProj matrices fold into the View UBO
-              // (binding 0, `view.spotLightViewProj`) — no standalone binding 9
-              // (WebGL2 fragment uniform-buffer budget). binding 10 is the
-              // dedicated vertex-only Points/Lines viewport UBO.
-            ]
+            entries
           });
           if (!viewBindGroupResult.ok) throw viewBindGroupResult.error;
           return viewBindGroupResult.value;
@@ -4643,35 +4676,6 @@ function deriveTextureExtent(format, width, height) {
     uvScale: [width / physicalWidth, height / physicalHeight]
   };
 }
-function deriveMipUploadLayout(format, baseWidth, baseHeight, mipLevelCount) {
-  const params = blockParamsForFormat(format);
-  if (params === null) return [];
-  const levels = [];
-  let byteOffset = 0;
-  for (let level = 0; level < mipLevelCount; level++) {
-    const width = Math.max(1, baseWidth >> level);
-    const height = Math.max(1, baseHeight >> level);
-    const blockCols = Math.ceil(width / params.blockW);
-    const blockRows = Math.ceil(height / params.blockH);
-    const rowBytes = blockCols * params.bytesPerBlock;
-    const byteLength = rowBytes * blockRows;
-    levels.push({
-      level,
-      width,
-      height,
-      physicalWidth: blockCols * params.blockW,
-      physicalHeight: blockRows * params.blockH,
-      copyWidth: blockCols * params.blockW,
-      copyHeight: blockRows * params.blockH,
-      bytesPerRow: rowBytes,
-      rowsPerImage: blockRows,
-      byteOffset,
-      byteLength
-    });
-    byteOffset += byteLength;
-  }
-  return levels;
-}
 function deriveRenderDataMesh(mesh) {
   const indices = mesh.indices;
   const indexBytesUnpadded = indices === void 0 ? 0 : indices.byteLength;
@@ -4689,6 +4693,8 @@ function deriveRenderDataMesh(mesh) {
   });
 }
 function deriveRenderDataTexture(tex) {
+  const width = tex.shape.extent.width;
+  const height = tex.shape.extent.height;
   const isSrgbFormat = tex.format.endsWith("-srgb");
   const expectedColorSpace = isSrgbFormat ? "srgb" : "linear";
   if (tex.colorSpace !== expectedColorSpace) {
@@ -4701,8 +4707,17 @@ function deriveRenderDataTexture(tex) {
     );
   }
   const compressed = isCompressedFormat(tex.format);
-  const hasOfflineMipChain = (tex.mipLevelCount ?? 1) > 1;
-  if (compressed && tex.mipmap === true && !hasOfflineMipChain) {
+  const layout = deriveTextureLayout({ shape: tex.shape, format: tex.format, mips: tex.mips });
+  if (!layout.ok) {
+    return err(
+      projectionError({
+        code: "invalid-source-format",
+        expected: layout.error.expected,
+        hint: layout.error.hint
+      })
+    );
+  }
+  if (compressed && tex.mips.kind === "generate") {
     return err(
       projectionError({
         code: "mipgen-unsupported-compressed-format",
@@ -4711,9 +4726,18 @@ function deriveRenderDataTexture(tex) {
       })
     );
   }
-  const mipLevelCount = compressed ? Math.max(1, tex.mipLevelCount ?? 1) : tex.mipmap ? numMipLevels(tex) : 1;
-  const uncompressedBytesPerTexel = tex.format === "rgba32float" ? 16 : tex.format === "rgba16float" ? 8 : 4;
-  if (!compressed && tex.data.byteLength < tex.width * tex.height * uncompressedBytesPerTexel) {
+  const mipLevelCount = layout.value.levels.length;
+  const baseLevel = layout.value.levels[0];
+  if (baseLevel === void 0) {
+    return err(
+      projectionError({
+        code: "invalid-source-format",
+        expected: "texture layout contains a base mip level",
+        hint: ASSET_ERROR_HINTS["invalid-source-format"]
+      })
+    );
+  }
+  if (!compressed && tex.data.byteLength < baseLevel.byteLength) {
     return err(
       projectionError({
         code: "invalid-source-format",
@@ -4722,12 +4746,14 @@ function deriveRenderDataTexture(tex) {
       })
     );
   }
-  const bytesPerRow$1 = compressed ? bytesPerRow(tex.format, tex.width) ?? tex.width * 4 : tex.width * uncompressedBytesPerTexel;
+  const bytesPerRow$1 = compressed ? bytesPerRow(tex.format, width) ?? baseLevel.bytesPerRow : baseLevel.bytesPerRow;
   const usage = compressed ? GPU_TEXTURE_USAGE_TEXTURE_BINDING | GPU_TEXTURE_USAGE_COPY_DST | GPU_TEXTURE_USAGE_COPY_SRC : GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING | GPU_TEXTURE_USAGE_COPY_DST | GPU_TEXTURE_USAGE_COPY_SRC;
   return ok$1({
-    width: tex.width,
-    height: tex.height,
-    ...deriveTextureExtent(tex.format, tex.width, tex.height),
+    width,
+    height,
+    shape: tex.shape,
+    depthOrArrayLayers: tex.shape.viewDimension === "2d" ? 1 : tex.shape.viewDimension === "2d-array" ? tex.shape.extent.layers : tex.shape.extent.depth,
+    ...deriveTextureExtent(tex.format, width, height),
     format: tex.format,
     mipLevelCount,
     usage,
@@ -4746,8 +4772,9 @@ function deriveRenderDataCubemap(source) {
       })
     );
   }
+  const sourceHeight = source.shape.viewDimension === "2d" ? source.shape.extent.height : 0;
   return ok$1({
-    cubeFaceSize: source.height,
+    cubeFaceSize: sourceHeight,
     outputFormat: "rgba16float",
     needsHalfConversion: source.format === "rgba32float",
     cubeUsage: GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING | GPU_TEXTURE_USAGE_COPY_DST | GPU_TEXTURE_USAGE_COPY_SRC
@@ -5081,7 +5108,11 @@ var DEFAULT_STANDARD_TEXTURE_COORDINATES = new Float32Array([
 ]);
 function materialTextureUvScale(texture) {
   if (texture === void 0) return [1, 1];
-  return deriveTextureExtent(texture.format, texture.width, texture.height).uvScale;
+  return deriveTextureExtent(
+    texture.format,
+    texture.shape.extent.width,
+    texture.shape.extent.height
+  ).uvScale;
 }
 function materialTextureForField(material, field) {
   if (field === "emissiveTexture") return material.emissiveTexture;
@@ -6725,6 +6756,7 @@ function ensureTypedShadowViewBg(c, viewOffset, cascadeOffset, variant) {
   const { runtime, frameState, pipelineState } = c;
   const shadowSampler = pipelineState.perPassResources.shadowSampler;
   if (shadowSampler === null) return null;
+  const projectorAvailable = pipelineState.projectorAvailable !== false;
   try {
     return getOrCreateFromChain(
       frameState.viewBindGroupCache,
@@ -6738,6 +6770,7 @@ function ensureTypedShadowViewBg(c, viewOffset, cascadeOffset, variant) {
         pipelineState.shadowParamsBuffer,
         pipelineState.shadowCasterCascadeBuffer,
         pipelineState.shadowFallbackTextureView,
+        ...projectorAvailable ? [pipelineState.defaultWhiteTextureView, pipelineState.defaultSampler] : [],
         pipelineState.pointsLinesViewBuffer ?? pipelineState.viewUniformBuffer
       ],
       variant,
@@ -6808,7 +6841,20 @@ function ensureTypedShadowViewBg(c, viewOffset, cascadeOffset, variant) {
                   size: 80
                 }
               }
-            }
+            },
+            ...projectorAvailable ? [
+              {
+                binding: 11,
+                resource: {
+                  kind: "textureView",
+                  value: pipelineState.defaultWhiteTextureView
+                }
+              },
+              {
+                binding: 12,
+                resource: { kind: "sampler", value: pipelineState.defaultSampler }
+              }
+            ] : []
           ]
         });
         if (!created.ok) throw created.error;
@@ -6828,7 +6874,15 @@ function shadowShaderMap(c) {
   const shaders = /* @__PURE__ */ new Map();
   for (const entry of c.dispatch) {
     if (entry.tags.LightMode === "ShadowCaster" && entry.materialShaderId !== void 0) {
-      shaders.set(entry.renderableIndex, entry.materialShaderId);
+      let byMaterial = shaders.get(entry.renderableIndex);
+      if (byMaterial === void 0) {
+        byMaterial = /* @__PURE__ */ new Map();
+        shaders.set(entry.renderableIndex, byMaterial);
+      }
+      byMaterial.set(entry.materialHandle, {
+        materialShaderId: entry.materialShaderId,
+        renderState: entry.renderState
+      });
     }
   }
   return shaders;
@@ -7026,7 +7080,7 @@ function buildMatchedMaterialHandlesByRenderable(dispatch, selector) {
   }
   return handlesByRenderable;
 }
-function recordShadowCasterDraws(c, shadowPass, shadowPipeline2, shadowMeshBindGroup, matchedIndices, shadowShaderByRenderableIdx) {
+function recordShadowCasterDraws(c, shadowPass, shadowPipeline2, shadowMeshBindGroup, matchedIndices, shadowDispatchByRenderableIdx) {
   const { runtime, pipelineState, validatedOrdered } = c;
   let shadowLastVertexBuffer = null;
   let shadowLastIndexBuffer = null;
@@ -7035,32 +7089,13 @@ function recordShadowCasterDraws(c, shadowPass, shadowPipeline2, shadowMeshBindG
     const entry = validatedOrdered[i];
     if (entry === void 0) continue;
     if (matchedIndices !== null && !matchedIndices.has(entry.renderableIndex)) continue;
-    const entryShadowShaderId = shadowShaderByRenderableIdx.get(entry.renderableIndex);
-    let entryShadowPipeline = shadowPipeline2;
     if (entry.source.skin !== void 0) {
       const skinPipeline = skinnedShadowPipeline(c, entry);
       if (skinPipeline === null) continue;
-      entryShadowPipeline = skinPipeline;
-    } else if (entryShadowShaderId !== void 0 && entryShadowShaderId !== SHADOW_CASTER_SHADER_ID) {
-      entryShadowPipeline = runtime.getMaterialShaderPipeline?.(
-        entryShadowShaderId,
-        false,
-        // isHdr — shadow depth pass is always LDR
-        void 0,
-        // renderState
-        "triangle-list",
-        // topology — shadow PSO targets triangle-list
-        void 0,
-        // indexFormat
-        void 0,
-        // variantSet — shadow caster has no variant axes
-        "shadow-caster"
-        // passKind
-      ) ?? shadowPipeline2;
-    }
-    if (entryShadowPipeline !== shadowLastPipeline && entryShadowPipeline !== null) {
-      shadowPass.setPipeline(entryShadowPipeline);
-      shadowLastPipeline = entryShadowPipeline;
+      if (skinPipeline !== shadowLastPipeline) {
+        shadowPass.setPipeline(skinPipeline);
+        shadowLastPipeline = skinPipeline;
+      }
     }
     const shadowSubmeshes = entry.mesh.submeshes;
     const hasAnyShadowSubmesh = shadowSubmeshes.some(
@@ -7176,6 +7211,31 @@ function recordShadowCasterDraws(c, shadowPass, shadowPipeline2, shadowMeshBindG
       if (sm.topology !== "triangle-list" && sm.topology !== "triangle-strip") {
         continue;
       }
+      const submeshMaterial = entry.source.materials[sm.materialSlot] ?? entry.source.material;
+      const shadowDispatch = shadowDispatchByRenderableIdx.get(entry.renderableIndex)?.get(submeshMaterial.materialHandle ?? 0);
+      const entryShadowShaderId = shadowDispatch?.materialShaderId;
+      const entryShadowRenderState = shadowDispatch?.renderState;
+      let entryShadowPipeline = entry.source.skin !== void 0 ? shadowLastPipeline : shadowPipeline2;
+      if (entry.source.skin === void 0 && entryShadowShaderId !== void 0 && (entryShadowShaderId !== "forgeax::default-shadow-caster" || entryShadowRenderState !== void 0)) {
+        entryShadowPipeline = runtime.getMaterialShaderPipeline?.(
+          entryShadowShaderId,
+          false,
+          // isHdr — shadow depth pass is always LDR
+          entryShadowRenderState,
+          "triangle-list",
+          // topology — shadow PSO targets triangle-list
+          void 0,
+          // indexFormat
+          void 0,
+          // variantSet — shadow caster has no variant axes
+          "shadow-caster"
+          // passKind
+        ) ?? shadowPipeline2;
+      }
+      if (entryShadowPipeline !== shadowLastPipeline && entryShadowPipeline !== null) {
+        shadowPass.setPipeline(entryShadowPipeline);
+        shadowLastPipeline = entryShadowPipeline;
+      }
       if (entry.mesh.indexed) {
         shadowPass.drawIndexed(sm.indexCount, shadowInstanceCount, sm.indexOffset, 0, 0);
       } else {
@@ -8847,7 +8907,12 @@ function addTypedScenePass(graph, options) {
         internal.pipelineState,
         internal.validated.length > 0 || options.gpuDriven !== void 0,
         internal.bindGroupCounts,
-        { directionalShadow, spotShadow }
+        {
+          directionalShadow,
+          spotShadow,
+          projector: internal.spotLightProjector?.view ?? internal.volumetricFog?.projectorView,
+          projectorSampler: internal.spotLightProjector?.sampler ?? internal.volumetricFog?.projectorSampler
+        }
       );
       if (groups.viewBindGroup !== null) {
         options.gpuDriven?.encode(groups.viewBindGroup, pass, resources);
@@ -9169,7 +9234,10 @@ function addTypedFullscreenPass(graph, options) {
         }),
         outputFormat: options.output.format,
         ...options.depth === void 0 ? {} : { depthView: resolvedDepthView(frame, resources, options.depth) },
-        ...options.rawSwapchainOutput === void 0 ? {} : { rawSwapchainOutput: options.rawSwapchainOutput }
+        ...options.rawSwapchainOutput === void 0 ? {} : { rawSwapchainOutput: options.rawSwapchainOutput },
+        ...options.paramsTransform === void 0 ? {} : {
+          paramsOverride: options.paramsTransform(frame.postProcessParams.get(options.shader))
+        }
       });
     }
   });
@@ -9220,14 +9288,27 @@ function addTypedCompositePostEffects(graph, effects, input, output, depth, size
   }
   return ok(void 0);
 }
-function addTypedOutputTransformPass(graph, input, output, outputOnly = false) {
+function addTypedOutputTransformPass(graph, input, output, options = {}) {
+  const outputOnly = options.outputOnly ?? false;
   return addTypedFullscreenPass(graph, {
     name: outputOnly ? "present" : "output-transform",
     shader: STANDARD_OUTPUT_TRANSFORM_FEATURE_ID,
     input,
     output,
     outputOnly,
-    rawSwapchainOutput: outputOnly
+    rawSwapchainOutput: outputOnly,
+    ...options.outputTransform === true ? {
+      paramsTransform: (params) => {
+        if (params === void 0 || params.byteLength !== 16) return params;
+        const transformed = params.slice();
+        new DataView(
+          transformed.buffer,
+          transformed.byteOffset,
+          transformed.byteLength
+        ).setFloat32(12, 1, true);
+        return transformed;
+      }
+    } : {}
   });
 }
 
@@ -9318,6 +9399,6 @@ function addTaaResolvePass(graph, current, currentTemporal, previousColor, previ
   });
 }
 
-export { CAPTURE_VIEW_PROJS, CUBEMAP_FACE_VERTICES, DEFERRED_COLOR_FORMATS, DEPTH_MIN_PARAMS_BYTE_SIZE, FALLBACK_BYTES_PER_ROW, GPU_BUFFER_USAGE_COPY_DST, GPU_BUFFER_USAGE_COPY_SRC, GPU_BUFFER_USAGE_INDEX, GPU_BUFFER_USAGE_INDIRECT, GPU_BUFFER_USAGE_STORAGE, GPU_BUFFER_USAGE_UNIFORM, GPU_BUFFER_USAGE_VERTEX, GPU_SHADER_STAGE_FRAGMENT, GPU_SHADER_STAGE_VERTEX, GPU_TEXTURE_USAGE_COPY_DST, GPU_TEXTURE_USAGE_COPY_SRC, GPU_TEXTURE_USAGE_RENDER_ATTACHMENT, GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING, GPU_TEXTURE_USAGE_TEXTURE_BINDING, GpuBuffer, GpuTexture, LIGHT_ARRAY_HEADER_BYTES, LIGHT_ARRAY_MAX_SLOTS, MATERIAL_PER_ENTITY_STRIDE, POINTS_LINES_MATERIAL_SHADER_ID, POINTS_LINES_VIEW_BUFFER_SIZE, POINT_LIGHT_STD430_BYTES, PREFILTER_MIP_LEVELS, PREFILTER_SIZE, PipelineSpecError, PostProcessError, SHADOW_CASTER_BUFFER_SIZE, SKIN_MATERIAL_SHADER_ID, SPOT_LIGHT_STD430_BYTES, TYPED_BLOOM_PASS_NAMES, VIEW_UNIFORM_BUFFER_SIZE, abortTemporalGpuSubmit, addStandardSceneDataPass, addTaaResolvePass, addTypedBloomPasses, addTypedCompositePostEffects, addTypedFrameObservationPass, addTypedFullscreenPass, addTypedOutputTransformPass, addTypedScenePass, addTypedSkyboxPass, addTypedSsaoPasses, addTypedTemporalResolvePass, aggregateTemporalDemand, applyParamSnapshotToUbo, assembleMaterialWithSkylightEntries, assertStorageBufferCap, buildBindGroupLayoutDescriptor, buildFoldDispatchPlan, buildFullscreenPostProcessPass, buildLinearLdrMaterialSpecTable, buildPbrPipelineLayouts, buildPbrSkinLayouts, buildPerFrameBindGroups, buildSpecConstTable, cacheKeyOf, cleanPerEntityCache, colorFormatsForPassKind, commitTemporalGpuSubmit, computeProjectionMatrix, computeSplitLdrSprite, computeViewMatrix, configureSurface, createClusterBinScratch, createFullscreenBindGroup, createHdrpBindGroupLayoutDescriptor, createHdrpClusterMembershipBindGroupLayoutDescriptor, createIblPipelines, createPointsLinesLaneAdapter, createPointsLinesLaneContract, createRenderPipelineTarget, createSkylightFallback, createStandardSceneDataTarget, deriveMipUploadLayout, deriveRenderDataCubemap, deriveRenderDataMesh, deriveRenderDataTexture, describeTemporalDemand, driveLazyEquirectProjection, encodeDirectionalShadowPass, encodePointShadowPass, encodeSpotShadowPass, ensureMeshSsboCapacity, entryHasDepthRead, evaluateFoldBucketUniformCap, foldDispatchBuckets, geometryRenderStateForTopology, getOrBuildPipeline, getOrCreateHdrpBuffers, getTemporalGpuState, hasPendingTemporalGpuSubmit, importRenderPipelineSurface, incrementFoldedDrawsMetric, isSkinnedShadowCasterVariant, isStandardPbrMaterialShader, isTemporalFullscreenBinding, prepareFrameLighting, residentTextureView, resolveSkyboxActive, resolveSsaoParameters, resolveSurfaceFormatPair, resolveSurfaceProfile, retireTemporalGpuState, retireTemporalGpuStateAfterFence, runIblPrecompute, selectLazyEquirectHandle, selectPasses, selectSwapChainFormat, setIblComposedShaders, standardTemporalLaneAdmission, standardTemporalPostOrder, temporalReadIndex, temporalWriteIndex, typedFrameClearColor, uploadMeshSsboBatch, variantSetFromDefines, warnMultiSkybox, warnMultiSkylight, warnZeroLightStandard, writeHdrpClusterAndSsaoBuffers, writePointSpotLightBuffers, writePointsLinesViewUbo, writeShadowCasterUniforms, writeShadowParamsBuffer, writeViewUbo };
-//# sourceMappingURL=chunk-RJRUS55L.mjs.map
-//# sourceMappingURL=chunk-RJRUS55L.mjs.map
+export { CAPTURE_VIEW_PROJS, CUBEMAP_FACE_VERTICES, DEFERRED_COLOR_FORMATS, DEPTH_MIN_PARAMS_BYTE_SIZE, FALLBACK_BYTES_PER_ROW, 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_FRAGMENT, GPU_SHADER_STAGE_VERTEX, GPU_TEXTURE_USAGE_COPY_DST, GPU_TEXTURE_USAGE_COPY_SRC, GPU_TEXTURE_USAGE_RENDER_ATTACHMENT, GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING, GPU_TEXTURE_USAGE_TEXTURE_BINDING, GpuBuffer, GpuTexture, LIGHT_ARRAY_HEADER_BYTES, LIGHT_ARRAY_MAX_SLOTS, MATERIAL_PER_ENTITY_STRIDE, POINTS_LINES_MATERIAL_SHADER_ID, POINTS_LINES_VIEW_BUFFER_SIZE, POINT_LIGHT_STD430_BYTES, PREFILTER_MIP_LEVELS, PREFILTER_SIZE, PipelineSpecError, PostProcessError, SHADOW_CASTER_BUFFER_SIZE, SKIN_MATERIAL_SHADER_ID, SPOT_LIGHT_STD430_BYTES, TYPED_BLOOM_PASS_NAMES, VIEW_UNIFORM_BUFFER_SIZE, VIEW_UNIFORM_BYTES, abortTemporalGpuSubmit, addStandardSceneDataPass, addTaaResolvePass, addTypedBloomPasses, addTypedCompositePostEffects, addTypedFrameObservationPass, addTypedFullscreenPass, addTypedOutputTransformPass, addTypedScenePass, addTypedSkyboxPass, addTypedSsaoPasses, addTypedTemporalResolvePass, aggregateTemporalDemand, applyParamSnapshotToUbo, assembleMaterialWithSkylightEntries, assertStorageBufferCap, buildBindGroupLayoutDescriptor, buildFoldDispatchPlan, buildFullscreenPostProcessPass, buildLinearLdrMaterialSpecTable, buildPbrMaterialUserRegionEntries, buildPbrPipelineLayouts, buildPbrSkinLayouts, buildPerFrameBindGroups, buildSpecConstTable, cacheKeyOf, cleanPerEntityCache, colorFormatsForPassKind, commitTemporalGpuSubmit, computeProjectionMatrix, computeSplitLdrSprite, computeViewMatrix, configureSurface, createClusterBinScratch, createFullscreenBindGroup, createHdrpBindGroupLayoutDescriptor, createHdrpClusterMembershipBindGroupLayoutDescriptor, createIblPipelines, createPointsLinesLaneAdapter, createPointsLinesLaneContract, createRenderPipelineTarget, createSkylightFallback, createStandardSceneDataTarget, deriveRenderDataCubemap, deriveRenderDataMesh, deriveRenderDataTexture, describeTemporalDemand, driveLazyEquirectProjection, encodeDirectionalShadowPass, encodePointShadowPass, encodeSpotShadowPass, ensureMeshSsboCapacity, entryHasDepthRead, evaluateFoldBucketUniformCap, foldDispatchBuckets, geometryRenderStateForTopology, getOrBuildPipeline, getOrCreateHdrpBuffers, getTemporalGpuState, hasPendingTemporalGpuSubmit, importRenderPipelineSurface, incrementFoldedDrawsMetric, isSkinnedShadowCasterVariant, isStandardPbrMaterialShader, isTemporalFullscreenBinding, prepareFrameLighting, residentTextureView, resolveSkyboxActive, resolveSsaoParameters, resolveSurfaceFormatPair, resolveSurfaceProfile, retireTemporalGpuState, retireTemporalGpuStateAfterFence, runIblPrecompute, selectLazyEquirectHandle, selectPasses, selectSwapChainFormat, setIblComposedShaders, standardTemporalLaneAdmission, standardTemporalPostOrder, temporalReadIndex, temporalWriteIndex, typedFrameClearColor, uploadMeshSsboBatch, variantSetFromDefines, warnMultiSkybox, warnMultiSkylight, warnZeroLightStandard, writeHdrpClusterAndSsaoBuffers, writePointSpotLightBuffers, writePointsLinesViewUbo, writeShadowCasterUniforms, writeShadowParamsBuffer, writeViewUbo };
+//# sourceMappingURL=chunk-4XINDLAY.mjs.map
+//# sourceMappingURL=chunk-4XINDLAY.mjs.map