@forgeax/engine-render 0.1.25 → 0.1.27

package/dist/{chunk-N3RT2EUR.mjs → chunk-XDP6XE5V.mjs}

@@ -1,15 +1,15 @@
 import { GlyphText, selectActiveCameraIndex, getActiveCamera } from './chunk-FJ6P52EE.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, CubeCamera, cubeCameraUpdateIntentFromF32, ReflectionProbe, reflectionProbeUpdateIntentFromF32, tonemapToU32, resolveVisibility, Fog, VolumetricFog, resolveSelectedVolumetricLight, extractVolumetricFog, MotionBlur, Camera, bloomEnabledFromF32, antialiasFromF32, tonemapFromF32, cameraProjectionFromF32 } from './chunk-ADHHVYLW.mjs';
 import { SpriteRegionOverride, SpriteInstances } from './chunk-JDWARUOI.mjs';
-import { PROBE_BLEND_RECORD_CAPACITY, GPU_BUFFER_USAGE_MAP_READ, GPU_BUFFER_USAGE_VERTEX, GPU_BUFFER_USAGE_COPY_DST, IES_SLICE_CAPACITY, COOKIE_SLICE_CAPACITY, isStandardPbrSkinMaterialShader, selectPasses, resolveRenderTargetMaterialSource, isCanonicalStandardPbrMaterialShader, isStandardPbrMaterialShader, PROBE_BLEND_RECORD_BYTE_SIZE, GPU_BUFFER_USAGE_QUERY_RESOLVE, GPU_BUFFER_USAGE_COPY_SRC, COOKIE_SLICE_SIZE } from './chunk-HKXTW355.mjs';
+import { PROBE_BLEND_RECORD_CAPACITY, GPU_BUFFER_USAGE_MAP_READ, GPU_BUFFER_USAGE_VERTEX, GPU_BUFFER_USAGE_COPY_DST, IES_SLICE_CAPACITY, COOKIE_SLICE_CAPACITY, isStandardPbrSkinMaterialShader, selectPasses, resolveRenderTargetMaterialSource, PROBE_BLEND_RECORD_BYTE_SIZE, GPU_BUFFER_USAGE_QUERY_RESOLVE, GPU_BUFFER_USAGE_COPY_SRC, COOKIE_SLICE_SIZE, isCanonicalStandardPbrMaterialShader, isStandardPbrMaterialShader } from './chunk-HKXTW355.mjs';
 import { STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, SHADOW_ATLAS_DEFAULT_LAYERS, SkinMaterialMismatchError, MaterialSkinAttrMissingError, ShadowInvalidConfigError, EnvironmentSourceConflictError, FogCardinalityError, AtmosphereInvalidParameterError } from './chunk-ZZ4YQ474.mjs';
 import { err, ok, RhiError } from '@forgeax/engine-rhi';
-import { resolveAssetHandle, walkMaterialPassesOverSharedRefs } from '@forgeax/engine-assets-runtime';
+import { resolveAssetHandle, walkMaterialPassesOverSharedRefs, selectMaterialPassProgram, materialParametersToParamSchema as materialParametersToParamSchema$1 } from '@forgeax/engine-assets-runtime';
 import { SpawnLightInvalidBoundsError, routeWorldError, SpriteInstancesMutuallyExclusiveWithInstancesError, SpriteInstancesRequiresSpriteShaderError, SpriteInstancesCountMismatchError, InstanceTransformsStrideMismatchError, readRenderArrayView } from '@forgeax/engine-ecs/projection';
 import { vec3, mat4, frustum, box3 } from '@forgeax/engine-math';
 import { AssetGuid } from '@forgeax/engine-pack/guid';
 import { Transform, GlobalTransform, MorphWeights } from '@forgeax/engine-scene';
-import { STANDARD_PIPELINE_PARAM_SCHEMA } from '@forgeax/engine-shader';
+import { STANDARD_PIPELINE_PARAM_SCHEMA, DEFAULT_STANDARD_SURFACE_MODULE } from '@forgeax/engine-shader';
 import { R_MIN, err as err$1, ok as ok$1, TextError, toShared, handleSlot, AssetError, ASSET_ERROR_HINTS, materialValuesToLinearRuntime, derive, unpackSlot, materialGuidText } from '@forgeax/engine-types';
 import { PROCEDURAL_FLOATS_PER_VERTEX, deriveVertexLayoutProjection } from '@forgeax/engine-geometry';
 import { Skin, SkinInstancesCoexistForbiddenError, SkeletonResolveFailedError, JointCountMismatchError, JointEntityDanglingError } from '@forgeax/engine-skinning';
@@ -1639,6 +1639,7 @@ function extractFrames(worlds, owner, assets, pipelineState, materialSnapshotCac
             return cache;
           })()
         },
+        ...options.materialContext === void 0 ? {} : { materialContext: options.materialContext },
         cull: options.cull === "none" ? "none" : isCameraOwner ? "self" : "external",
         renderables: options.renderables ?? "full",
         ...options.renderableEntitiesByWorld?.[wi] === void 0 ? {} : { renderableEntities: options.renderableEntitiesByWorld[wi] },
@@ -2563,6 +2564,7 @@ function extractFrame(world, context) {
   const explicitlyHidden = /* @__PURE__ */ new Set();
   let dispatch = [];
   const materialSnapshotCache = /* @__PURE__ */ new Map();
+  const skinnedMaterialSnapshotCache = /* @__PURE__ */ new Map();
   const meshRendererQuery = context.renderables === "none" ? [] : world.query({
     read: [MeshRenderer],
     optional: [
@@ -2777,7 +2779,7 @@ function extractFrame(world, context) {
             layerVal,
             materialSnap.paramSnapshot,
             0,
-            materialSnap.materialShaderId
+            materialSnap.materialProgramKeys
           );
         }
       } else if (handleRaw === 0 || assets === void 0 || assets === null) {
@@ -2802,7 +2804,7 @@ function extractFrame(world, context) {
               layerVal,
               materialSnap.paramSnapshot,
               0,
-              materialSnap.materialShaderId
+              materialSnap.materialProgramKeys
             );
           }
         } else {
@@ -2856,7 +2858,23 @@ function extractFrame(world, context) {
             }
             const resolved = resolvedResult.value;
             const allPasses = resolved.passes;
-            const firstPassShader = runtimeMaterialShaderIdForMaterial(asset, allPasses, assets);
+            const materialContext = context.materialContext === void 0 ? void 0 : {
+              ...context.materialContext,
+              geometry: hasSkin ? "skinned" : context.materialContext.geometry
+            };
+            const materialProgramKeys = materialProgramKeysForMaterial(
+              asset,
+              assets,
+              materialContext
+            );
+            const authoredFirstPassShader = runtimeMaterialShaderIdForMaterial(
+              allPasses,
+              void 0
+            );
+            const firstPassShader = runtimeMaterialShaderIdForMaterial(
+              allPasses,
+              materialProgramKeys
+            );
             const pv = materialValuesToLinearRuntime(
               resolved.values,
               materialColorParameterSchema(resolved.parameters ?? [], firstPassShader, assets),
@@ -2880,9 +2898,10 @@ function extractFrame(world, context) {
                 paramSnap[k] = v;
               }
             }
-            const materialParamSchema = materialParametersToParamSchema(
+            const materialParamSchema = materialParamSchemaForMaterial(
               resolved.parameters ?? [],
-              firstPassShader
+              authoredFirstPassShader,
+              allPasses
             );
             {
               const hasSkinSkel = hasSkin && skinSkeletonView !== void 0 && skinSkeletonView !== void 0 && skinSkeletonView !== 0;
@@ -3044,6 +3063,7 @@ function extractFrame(world, context) {
               },
               normalScale: normalScalePv,
               materialShaderId: firstPassShader,
+              materialProgramKeys,
               materialHandle: handleRaw,
               renderState: pipelineRenderState(allPasses[0]?.renderState),
               paramSnapshot: paramSnap,
@@ -3098,7 +3118,7 @@ function extractFrame(world, context) {
                 layerVal,
                 paramSnap,
                 0,
-                firstPassShader
+                materialProgramKeys
               );
             }
           }
@@ -3220,14 +3240,19 @@ function extractFrame(world, context) {
         if (assets !== void 0 && assets !== null) {
           for (let mi = 1; mi < materialHandles.length; mi++) {
             const subHandle = materialHandles[mi] ?? 0;
-            const cachedSubmaterial = materialSnapshotCache.get(subHandle);
+            const subCache = hasSkin ? skinnedMaterialSnapshotCache : materialSnapshotCache;
+            const cachedSubmaterial = subCache.get(subHandle);
             materialsArr.push(
               cachedSubmaterial?.snapshot ?? resolveMaterialSnapshot(
                 subHandle,
                 world,
                 assets,
-                materialSnapshotCache,
-                persistentMaterialSnapshotCache
+                subCache,
+                hasSkin ? void 0 : persistentMaterialSnapshotCache,
+                context.materialContext === void 0 ? void 0 : {
+                  ...context.materialContext,
+                  geometry: hasSkin ? "skinned" : context.materialContext.geometry
+                }
               )
             );
           }
@@ -3236,7 +3261,11 @@ function extractFrame(world, context) {
           for (let mi = 1; mi < materialHandles.length; mi++) {
             const subHandle = materialHandles[mi] ?? 0;
             if (subHandle === handleRaw) continue;
-            const subEntry = materialSnapshotCache.get(subHandle) ?? readPersistentMaterialSnapshot(persistentMaterialSnapshotCache, subHandle, assets);
+            const subEntry = (hasSkin ? skinnedMaterialSnapshotCache : materialSnapshotCache).get(subHandle) ?? (hasSkin ? void 0 : readPersistentMaterialSnapshot(
+              persistentMaterialSnapshotCache,
+              subHandle,
+              assets
+            ));
             appendMaterialDispatchEntries(
               pendingDispatch,
               subEntry?.passes ?? (subHandle === 0 ? [DEFAULT_FORWARD_PASS] : []),
@@ -3246,7 +3275,7 @@ function extractFrame(world, context) {
               layerVal,
               materialsArr[mi]?.paramSnapshot,
               0,
-              materialsArr[mi]?.materialShaderId
+              materialsArr[mi]?.materialProgramKeys
             );
           }
         }
@@ -3553,14 +3582,16 @@ var DEFAULT_FORWARD_PASS = {
   program: { module: "forgeax::default-unlit", vertexEntry: "vs_main", fragmentEntry: "fs_main" },
   renderState: { tags: { LightMode: "Forward" }, queue: 2e3 }
 };
-function appendMaterialDispatchEntries(pendingDispatch, passes, entity, materialHandle, renderableIndex, layer, paramSnapshot, passIndexOffset = 0, materialShaderIdOverride) {
+function appendMaterialDispatchEntries(pendingDispatch, passes, entity, materialHandle, renderableIndex, layer, paramSnapshot, passIndexOffset = 0, materialProgramKeys) {
   const matchedPasses = selectPasses(passes, {});
   for (let pIdx = 0; pIdx < matchedPasses.length; pIdx++) {
     const pass = matchedPasses[pIdx];
     if (pass === void 0) continue;
     const passState = pass.renderState ?? {};
     const authoredShaderId = runtimeMaterialShaderId(pass.program.module, pass.name);
-    const dispatchShaderId = authoredShaderId === "forgeax::default-shadow-caster" ? authoredShaderId : materialShaderIdOverride ?? authoredShaderId;
+    const dispatchShaderId = materialProgramKeys === void 0 ? authoredShaderId : materialProgramKeys[pass.name];
+    if (materialProgramKeys !== void 0 && dispatchShaderId === void 0)
+      throw new Error(`Missing published material program for Pass ${pass.name}`);
     pendingDispatch.push({
       entityIndex: entity,
       materialHandle,
@@ -3575,13 +3606,6 @@ function appendMaterialDispatchEntries(pendingDispatch, passes, entity, material
       defines: void 0,
       vertexEntry: pass.program.vertexEntry,
       fragmentEntry: pass.program.fragmentEntry,
-      // A cooked Standard publication supplies one specialization key for its
-      // forward/deferred artifact, but its ShadowCaster pass still owns the
-      // engine depth-only shader. Keep the pass-local canonical identity so a
-      // specialized Standard source (which only declares fs_main/fs_gbuffer)
-      // is never asked to build an fs_shadow pipeline. Authored non-Standard
-      // ShadowCaster modules retain the publication override and continue to
-      // use their producer-owned source.
       materialShaderId: dispatchShaderId,
       paramSnapshot,
       ...passState.stencilReference !== void 0 && {
@@ -3678,9 +3702,38 @@ function runtimeMaterialShaderId(module, passName) {
       return module;
   }
 }
-function runtimeMaterialShaderIdForMaterial(material, passes, assets) {
-  const authored = runtimeMaterialShaderId(passes[0]?.program.module, passes[0]?.name);
-  return assets.getMaterialProjectionForPayload(material)?.specializationKey ?? authored;
+function materialProgramKeysForMaterial(material, assets, context) {
+  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 Object.fromEntries(
+    projection.passes.map((pass) => {
+      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
+      };
+      return [
+        pass.name,
+        selectMaterialPassProgram(projection, pass.name, selectedContext).specializationKey
+      ];
+    })
+  );
+}
+function runtimeMaterialShaderIdForMaterial(passes, programs) {
+  const pass = passes.find(
+    (pass2) => !/shadow|depth/i.test(
+      String(
+        pass2.renderState?.tags?.LightMode ?? pass2.name
+      )
+    )
+  ) ?? passes[0];
+  if (pass === void 0) return void 0;
+  return programs === void 0 ? runtimeMaterialShaderId(pass.program.module, pass.name) : programs[pass.name];
 }
 function pipelineRenderState(renderState) {
   if (renderState === void 0) return void 0;
@@ -3819,30 +3872,20 @@ function isEngineInjectedTextureField(shaderId, fieldName) {
   return isStandardPbrMaterialShader(shaderId) && ENGINE_INJECTED_TEXTURE_FIELDS.has(fieldName);
 }
 function materialParametersToParamSchema(parameters, shaderId) {
-  if (isCanonicalStandardPbrMaterialShader(shaderId)) {
-    return STANDARD_PIPELINE_PARAM_SCHEMA;
-  }
-  const engineInjectedTextureFields = isStandardPbrMaterialShader(shaderId) ? ENGINE_INJECTED_TEXTURE_FIELDS : void 0;
-  return parameters.flatMap((parameter) => {
-    if (parameter.type === "bool") return [];
-    if (parameter.type === "texture" || parameter.type === "texture_cube") {
-      if (engineInjectedTextureFields?.has(parameter.name) === true) return [];
-      return [
-        {
-          name: parameter.name,
-          type: parameter.type === "texture_cube" ? "texture_cube" : "texture2d",
-          default: parameter.default
-        }
-      ];
-    }
-    const numericDefault = typeof parameter.default === "number" ? parameter.default : Array.isArray(parameter.default) && parameter.default.every((entry) => typeof entry === "number") ? parameter.default : void 0;
-    const numericEntry = {
-      name: parameter.name,
-      type: parameter.type,
-      ...parameter.colorSpace === void 0 ? {} : { colorSpace: parameter.colorSpace }
-    };
-    return numericDefault === void 0 ? [numericEntry] : [{ ...numericEntry, default: numericDefault }];
-  });
+  if (isCanonicalStandardPbrMaterialShader(shaderId)) return STANDARD_PIPELINE_PARAM_SCHEMA;
+  return materialParametersToParamSchema$1(parameters);
+}
+function materialParamSchemaForMaterial(parameters, authoredShaderId, passes) {
+  const firstPass = passes.find(
+    (pass) => !/shadow|depth/i.test(
+      String(
+        pass.renderState?.tags?.LightMode ?? pass.name
+      )
+    )
+  ) ?? passes[0];
+  const surfaceModule = firstPass?.program.moduleSlots?.surface;
+  const schemaShaderId = surfaceModule === void 0 || surfaceModule === DEFAULT_STANDARD_SURFACE_MODULE ? authoredShaderId : void 0;
+  return materialParametersToParamSchema(parameters, schemaShaderId);
 }
 function materialColorParameterSchema(parameters, shaderId, assets) {
   if (shaderId === void 0) return parameters;
@@ -3907,7 +3950,7 @@ function storeMaterialSnapshot(cache, handleRaw, snapshot, passes, root, assets)
   cache.set(handleRaw, entry);
   return entry;
 }
-function resolveMaterialSnapshot(handleRaw, world, assetsRef, materialSnapshotCache, persistentMaterialSnapshotCache) {
+function resolveMaterialSnapshot(handleRaw, world, assetsRef, materialSnapshotCache, persistentMaterialSnapshotCache, materialContext) {
   if (handleRaw === 0) return defaultMaterialSnapshot(handleRaw);
   const cached = materialSnapshotCache?.get(handleRaw);
   if (cached !== void 0) return cached.snapshot;
@@ -3938,7 +3981,9 @@ function resolveMaterialSnapshot(handleRaw, world, assetsRef, materialSnapshotCa
   if (!resolvedResult.ok) return defaultMaterialSnapshot(handleRaw);
   const resolved = resolvedResult.value;
   const allPasses = resolved.passes;
-  const firstPassShader = runtimeMaterialShaderIdForMaterial(asset, allPasses, assetsRef);
+  const materialProgramKeys = materialProgramKeysForMaterial(asset, assetsRef, materialContext);
+  const authoredFirstPassShader = runtimeMaterialShaderIdForMaterial(allPasses, void 0);
+  const firstPassShader = runtimeMaterialShaderIdForMaterial(allPasses, materialProgramKeys);
   const pv = materialValuesToLinearRuntime(
     resolved.values,
     materialColorParameterSchema(resolved.parameters ?? [], firstPassShader, assetsRef),
@@ -3962,9 +4007,10 @@ function resolveMaterialSnapshot(handleRaw, world, assetsRef, materialSnapshotCa
       paramSnap[k] = v;
     }
   }
-  const materialParamSchema = materialParametersToParamSchema(
+  const materialParamSchema = materialParamSchemaForMaterial(
     resolved.parameters ?? [],
-    firstPassShader
+    authoredFirstPassShader,
+    allPasses
   );
   const resolveTexLike = (value, brand) => {
     if (typeof value === "number") return toShared(value);
@@ -4014,6 +4060,7 @@ function resolveMaterialSnapshot(handleRaw, world, assetsRef, materialSnapshotCa
     },
     normalScale: normalScalePv,
     materialShaderId: firstPassShader,
+    materialProgramKeys,
     materialHandle: handleRaw,
     renderState: pipelineRenderState(allPasses[0]?.renderState),
     paramSnapshot: paramSnap,
@@ -4402,6 +4449,7 @@ function tonemapParams(camera) {
 function prepareExtractContext(world, options = {}) {
   const renderables = options.renderables ?? "full";
   return {
+    materialContext: options.materialContext,
     assets: options.assets,
     pipelineState: options.pipelineState,
     materialSnapshotCache: options.materialSnapshotCache,
@@ -5131,5 +5179,5 @@ var ProbeBlendSceneProjection = class {
 };
 
 export { InstanceBoundsCache, OcclusionRenderRuntime, PROBE_MAX_CONTRIBUTORS, ProbeBlendSceneProjection, SKYLIGHT_RECOVERY_FALLBACK, admitProbeContributors, blendLightProbes, buildRectAreaWorldFrame, createCookieProjectionMatrixData, createExtendedLightingState, extractFrames, fingerprintNumericArray, glyphTextLayoutSystem, primitiveKey, primitiveKeyId, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, rectAreaFacesPoint, scaledProbeWeight, setOcclusionRuntimeTestHooks, viewKey, viewKeyId };
-//# sourceMappingURL=chunk-N3RT2EUR.mjs.map
-//# sourceMappingURL=chunk-N3RT2EUR.mjs.map
+//# sourceMappingURL=chunk-XDP6XE5V.mjs.map
+//# sourceMappingURL=chunk-XDP6XE5V.mjs.map