@forgeax/engine-render 0.1.29 → 0.1.31

package/dist/{chunk-BTWH7BP4.mjs → chunk-FUUO4UND.mjs}

@@ -1,4 +1,4 @@
-import { LifecycleConstructionError, GpuDrivenPreparationError, RenderTargetDescriptorInvalidError } from './chunk-NRNXBLIJ.mjs';
+import { LifecycleConstructionError, GpuDrivenPreparationError, RenderTargetDescriptorInvalidError } from './chunk-JRBDO2KB.mjs';
 import { ok, err, derive } from '@forgeax/engine-types';
 import '@forgeax/engine-rhi';
 import { vec3 } from '@forgeax/engine-math';
@@ -36,7 +36,7 @@ var DeviceScope = class _DeviceScope {
   owner;
   parent;
   lifecycleState = "active";
-  resources = [];
+  resources = /* @__PURE__ */ new Map();
   children = [];
   constructor(generation, owner, parent) {
     this.generation = generation;
@@ -67,7 +67,7 @@ var DeviceScope = class _DeviceScope {
   }
   ref(kind, value) {
     const ref = new DeviceResourceRef(kind, this.owner, this.generation, value);
-    this.resources.push({ ref, cleanup: () => void 0 });
+    this.resources.set(ref, { ref, cleanup: () => void 0 });
     return ref;
   }
   accepts(ref) {
@@ -77,20 +77,25 @@ var DeviceScope = class _DeviceScope {
     return this.lifecycleState === "active";
   }
   resourceDelta() {
-    return this.resources.length;
+    return this.resources.size;
   }
   /** @internal */
   _adopt(kind, value, cleanup) {
     const ref = new DeviceResourceRef(kind, this.owner, this.generation, value);
-    this.resources.push({
+    this.resources.set(ref, {
       ref,
       cleanup: idempotentCleanup(cleanup)
     });
     return ref;
   }
+  /** @internal Remove ownership only after the resource's cleanup succeeded. */
+  _release(ref) {
+    this.resources.delete(ref);
+  }
   /** @internal */
   _clearResources() {
-    const resources = this.resources.splice(0);
+    const resources = [...this.resources.values()];
+    this.resources.clear();
     for (const resource of resources.reverse()) {
       try {
         const pending = resource.cleanup(resource.ref.value);
@@ -154,7 +159,7 @@ var DeviceScope = class _DeviceScope {
     return {
       owner: this.owner,
       generation: this.generation,
-      resourceCount: this.resources.length
+      resourceCount: this.resources.size
     };
   }
 };
@@ -257,7 +262,7 @@ var IES_SLICE_WIDTH = 256;
 var IES_SLICE_HEIGHT = 128;
 var COOKIE_SLICE_SIZE = 256;
 var COOKIE_MATRIX_BYTES = 32 * 16 * Float32Array.BYTES_PER_ELEMENT;
-var EXTENDED_LIGHTING_REQUIRED_SAMPLED_TEXTURES = 20;
+var EXTENDED_LIGHTING_REQUIRED_SAMPLED_TEXTURES = 21;
 function extendedLightingSampledTextureCapacityAvailable(maxSampledTexturesPerShaderStage) {
   return maxSampledTexturesPerShaderStage !== void 0 && maxSampledTexturesPerShaderStage >= EXTENDED_LIGHTING_REQUIRED_SAMPLED_TEXTURES;
 }
@@ -325,16 +330,21 @@ function validateGraphTargetCaptureReadback(input) {
   const { bytes, expectedByteLength, sentinel, allowZero = false } = input;
   if (bytes.byteLength !== expectedByteLength)
     return { ok: false, code: "capture-readback-length" };
-  if (sentinel?.every((value, index) => bytes[index] === value)) {
+  if (sentinel?.every((value, index2) => bytes[index2] === value)) {
     return { ok: false, code: "capture-readback-untouched-sentinel" };
   }
   if (!allowZero && bytes.every((value) => value === 0)) {
     return { ok: false, code: "capture-readback-empty" };
   }
-  for (let index = 0; index + 1 < bytes.length; index += 2) {
-    const exponent = (bytes[index + 1] ?? 0) >>> 2 & 31;
-    if (exponent === 31) return { ok: false, code: "capture-readback-non-finite" };
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  let index = 0;
+  for (; index + 3 < bytes.byteLength; index += 4) {
+    const word = view.getUint32(index, true);
+    if ((word & 31744) === 31744 || (word & 2080374784) === 2080374784)
+      return { ok: false, code: "capture-readback-non-finite" };
   }
+  if (index + 1 < bytes.byteLength && (view.getUint16(index, true) & 31744) === 31744)
+    return { ok: false, code: "capture-readback-non-finite" };
   return { ok: true };
 }
 function makeZeroCameraFallbackSnapshot() {
@@ -801,7 +811,7 @@ var AUTHORED_STANDARD_ID_RE = /::(?:standard|pbr-skin)(?:-|$)/;
 function isStandardPbrSkinMaterialShader(shaderId) {
   return shaderId === SKIN_MATERIAL_SHADER_ID || shaderId === "forgeax::default-standard-pbr-skin" || shaderId !== void 0 && /::pbr-skin(?:-|$)/.test(shaderId);
 }
-function shadowCasterVariantSet(storageBuffer, skinned, gpuDrivenSceneIndex = false, alphaMask = false) {
+function shadowCasterVariantSet(storageBuffer, skinned, gpuDrivenSceneIndex = false, alphaMask = false, vertexColorAvailable = false) {
   const skinningDisabled = !skinned;
   const defines = {
     ALPHA_MASK: alphaMask,
@@ -810,6 +820,7 @@ function shadowCasterVariantSet(storageBuffer, skinned, gpuDrivenSceneIndex = fa
     SKINNING_DISABLED: skinningDisabled,
     STORAGE_BUFFER_AVAILABLE: storageBuffer
   };
+  if (vertexColorAvailable) defines.VERTEX_COLOR_AVAILABLE = true;
   return Object.entries(defines).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).map(([name, value]) => `${name}=${String(value)}`).join("+");
 }
 function resolvePipelineGroup2Contract(source) {
@@ -1124,7 +1135,7 @@ function buildBindGroupLayoutDescriptor(spec, options) {
       const afterIbl = [...userRegion, ...appendInjection(userRegion, "ibl")];
       const afterTransmission = [...afterIbl, ...appendInjection(afterIbl, "transmission")];
       const merged = [
-        ...afterTransmission,
+        ...options.caps?.transmissionBackdrop === false ? afterIbl : afterTransmission,
         ...appendTextureInjection(afterTransmission, physicalFields)
       ];
       if (options.caps?.storageBuffer ?? true) {
@@ -1136,7 +1147,14 @@ function buildBindGroupLayoutDescriptor(spec, options) {
       }
       return {
         label: "pbr-material-skylight-bgl",
-        entries: merged
+        entries: [
+          ...merged,
+          {
+            binding: 47,
+            visibility: GPU_SHADER_STAGE_FRAGMENT,
+            texture: { sampleType: "float", viewDimension: "cube" }
+          }
+        ]
       };
     }
     case "unlit-material": {
@@ -1331,6 +1349,7 @@ 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 === "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;
@@ -1380,11 +1399,12 @@ function prepareGpuDrivenDraw(input) {
       actual: input.geometry.vertexInputs.map((input2) => input2.semantic).join(",")
     });
   }
-  if (receipt.alphaMask.cutoff.length === 0) {
+  const hasAlphaMask = receipt.alphaMask.cutoff.length > 0 || receipt.alphaMask.source.length > 0;
+  if (hasAlphaMask && (receipt.alphaMask.cutoff.length === 0 || receipt.alphaMask.source.length === 0)) {
     return failure("alpha-mask-mismatch", {
       reason: "alpha-mask-receipt-missing",
       owner: "material",
-      expected: "alphaMask.cutoff"
+      expected: "alphaMask.cutoff and alphaMask.source for a masked Pass"
     });
   }
   if (!hasMaterialResources(input.snapshot, receipt)) {
@@ -1421,6 +1441,7 @@ function prepareGpuDrivenDraw(input) {
         deformation
       },
       receiptGeneration: receipt.generation,
+      receiptIdentity: receipt.receiptIdentity,
       directEntry: receipt.directEntry,
       sceneIndexEntry: receipt.sceneIndexEntry,
       materialRow: receipt.materialRow,
@@ -1445,6 +1466,14 @@ function gpuDrivenDrawKey(worldEntity, materialHandle, drawItemIndex) {
 function gpuDrivenShadowDrawKey(worldEntity, materialHandle, drawItemIndex, passIndex) {
   return `${gpuDrivenDrawKey(worldEntity, materialHandle, drawItemIndex)}:${passIndex}`;
 }
+function gpuDrivenMaterialArtifactKey(input) {
+  return [
+    input.material,
+    input.deformation,
+    input.receiptIdentity ?? "<legacy-receipt>",
+    input.receiptGeneration
+  ].join("|");
+}
 function gpuDrivenSourceDrawItemIndex(draw, compactIndex) {
   return draw.drawItemIndex ?? compactIndex;
 }
@@ -1512,13 +1541,23 @@ function buildGpuDrivenDraws(input) {
     const withLodRanges = lodRanges?.length !== 0 && lodRanges?.every((range) => range !== void 0) ? { lodRanges } : {};
     const prepared = legacy ? input.prepare?.(draw, drawMaterial) : hasCpuOnlyMaterialResources(drawMaterial) ? void 0 : (() => {
       const materialShaderId = drawMaterial.materialShaderId;
-      const artifact = materialShaderId === void 0 ? void 0 : input.getMaterialShaderArtifact?.(
-        materialShaderId,
-        geometry.vertexInputs.some((attribute) => attribute.semantic === "color")
+      const vertexColorAvailable = geometry.vertexInputs.some(
+        (input2) => input2.semantic === "color"
       );
-      const standardPbr = isStandardPbrMaterialShader(materialShaderId);
+      const sceneIndexProgramKey = Object.entries(
+        drawMaterial.materialSceneIndexProgramKeys ?? {}
+      ).find(
+        ([passName, program]) => program.pass === "forward" && drawMaterial.materialProgramKeys?.[passName] === materialShaderId
+      )?.[1]?.specializationKey;
+      const artifact = materialShaderId === void 0 ? void 0 : input.getMaterialShaderArtifact?.(sceneIndexProgramKey ?? materialShaderId, {
+        vertexColorAvailable,
+        deformation: input.baseSnapshot.skin === void 0 ? "rigid" : "skin",
+        pass: "forward",
+        address: "scene-index"
+      });
+      const requiresReceipt = isCanonicalStandardPbrMaterialShader(materialShaderId) || sceneIndexProgramKey !== void 0;
       if (artifact === void 0) {
-        return input.getMaterialShaderArtifact !== void 0 && standardPbr ? new GpuDrivenPreparationError("missing-material-receipt", {
+        return input.getMaterialShaderArtifact !== void 0 && requiresReceipt ? new GpuDrivenPreparationError("missing-material-receipt", {
           reason: "material-receipt-missing",
           owner: "material",
           expected: `artifact for ${materialShaderId}`
@@ -1526,11 +1565,11 @@ function buildGpuDrivenDraws(input) {
       }
       const receipt = artifact.receipt;
       if (receipt === void 0) {
-        return standardPbr ? new GpuDrivenPreparationError("missing-material-receipt", {
+        return new GpuDrivenPreparationError("missing-material-receipt", {
           reason: "material-receipt-missing",
           owner: "material",
           expected: `receipt for ${materialShaderId}`
-        }) : void 0;
+        });
       }
       const skinReceipt = input.baseSnapshot.skin !== void 0 && receipt.skinPaletteAddress !== void 0 ? {
         identity: input.baseSnapshot.skin.identity,
@@ -1539,15 +1578,20 @@ function buildGpuDrivenDraws(input) {
         binding: receipt.skinPaletteAddress.binding,
         byteOffset: input.baseSnapshot.skin.byteOffset
       } : void 0;
+      const selectedArtifact = artifact === void 0 || sceneIndexProgramKey === void 0 || materialShaderId === void 0 ? artifact : {
+        ...artifact,
+        material: materialShaderId,
+        specializationKey: sceneIndexProgramKey
+      };
       const result = resolvePreparedGpuDrivenDraw({
         snapshot: { ...input.baseSnapshot, material: drawMaterial },
-        artifact,
+        artifact: selectedArtifact ?? artifact,
         geometry: { ...geometry, topology: draw.topology, indexed: draw.kind === "indexed" },
         generation: receipt.generation,
         draw,
         ...skinReceipt === void 0 ? {} : { skinReceipt }
       });
-      return result.ok ? result.value : standardPbr ? result.error : void 0;
+      return result.ok ? result.value : result.error;
     })();
     if (prepared instanceof GpuDrivenPreparationError) {
       return [{ ...draw, preparationError: prepared, ...withLodRanges }];
@@ -1558,6 +1602,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, gpuDrivenShadowDrawKey, gpuDrivenSourceDrawItemIndex, instanceCollectionCacheKey, isCanonicalStandardPbrMaterialShader, isStandardPbrMaterialShader, isStandardPbrSkinMaterialShader, makeZeroCameraFallbackSnapshot, matchPass, materialBindGroupLayoutIdentity, pbrSkinMeshDynamicOffsets, physicalTextureFields, probeBlendRecordOffset, resolvePipelineGroup2Contract, resolveRenderTargetMaterialSource, scanSceneDataCoverage, selectPasses, shadowCasterVariantSet, validateGraphTargetCaptureReadback, worldEntityKey };
-//# sourceMappingURL=chunk-BTWH7BP4.mjs.map
-//# sourceMappingURL=chunk-BTWH7BP4.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, 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-FUUO4UND.mjs.map
+//# sourceMappingURL=chunk-FUUO4UND.mjs.map