@forgeax/engine-render 0.1.25 → 0.1.26

package/src/record/main-pass-geometry.ts

@@ -44,7 +44,7 @@ import {
 import type { PointsLinesRecordPlan } from '../points-lines/record';
 import { POINTS_LINES_MATERIAL_SHADER_ID } from '../points-lines/record';
 import type { RenderRecordPhase } from '../render-contract';
-import type { MaterialSnapshot, RenderableSnapshot } from '../render-system-extract';
+import type { DispatchEntry, MaterialSnapshot, RenderableSnapshot } from '../render-system-extract';
 import {
   PROBE_BLEND_RECORD_BYTE_SIZE,
   PROBE_BLEND_RECORD_STRIDE,
@@ -120,6 +120,8 @@ type MaterialPipelineLookup = {
   readonly topology: PrimitiveTopology;
   readonly indexFormat: 'uint16' | 'uint32';
   readonly variantSet: string | undefined;
+  readonly vertexEntry: string | undefined;
+  readonly fragmentEntry: string | undefined;
   readonly passKind: PassKind;
   readonly layoutProjection: import('@forgeax/engine-geometry').VertexLayoutProjection;
   readonly sampleCount: number;
@@ -365,8 +367,10 @@ export function recordGeometryDraws(
     submeshMaterial: MaterialSnapshot,
     entityKey: number,
     materialWorld: World,
+    materialShaderId?: string,
   ) => BindGroup,
   passKind: PassKind = 'forward',
+  selectedDispatch?: readonly DispatchEntry[],
 ): void {
   const {
     runtime,
@@ -381,6 +385,17 @@ export function recordGeometryDraws(
     viewBindGroup,
     viewBindGroupDynamicOffset = 0,
   } = c;
+  const materialPasses = new Map<number, Map<number, DispatchEntry[]>>();
+  for (const dispatch of selectedDispatch ?? []) {
+    let byMaterial = materialPasses.get(dispatch.renderableIndex);
+    if (byMaterial === undefined) {
+      byMaterial = new Map();
+      materialPasses.set(dispatch.renderableIndex, byMaterial);
+    }
+    const passes = byMaterial.get(dispatch.materialHandle);
+    if (passes === undefined) byMaterial.set(dispatch.materialHandle, [dispatch]);
+    else passes.push(dispatch);
+  }
   const diagnosticsEnabled = materialDiagnosticsEnabled();
   const colorFormatOverride = c.transparentColorFormat as GPUTextureFormat | undefined;
   // The prepared Standard topology is the frame authority. A bind-group
@@ -438,6 +453,8 @@ export function recordGeometryDraws(
     variantSet: string | undefined,
     colorFormat: GPUTextureFormat | undefined,
     layoutProjection: import('@forgeax/engine-geometry').VertexLayoutProjection,
+    vertexEntry?: string,
+    fragmentEntry?: string,
   ): MaterialShaderPipelineEntry | null => {
     // The fallback MRT is an extension of the built-in Standard PBR output
     // contract only.  The render pass may carry a second attachment whenever
@@ -463,6 +480,8 @@ export function recordGeometryDraws(
           cached.topology === topology &&
           cached.indexFormat === indexFormat &&
           cached.variantSet === variantSet &&
+          cached.vertexEntry === vertexEntry &&
+          cached.fragmentEntry === fragmentEntry &&
           cached.passKind === passKind &&
           cached.layoutProjection.digest === layoutProjection.digest &&
           cached.sampleCount === sampleCount &&
@@ -474,10 +493,12 @@ export function recordGeometryDraws(
       }
     }
     const resolvedVariantSetResult =
-      variantSet === undefined &&
-      (materialShaderId === 'forgeax::sprite' || materialShaderId === 'forgeax::sprite-lit')
+      runtime.getMaterialArtifact?.(materialShaderId) !== undefined
         ? ({ ok: true, value: undefined } as const)
-        : variantSetFromVertexLayoutProjection(layoutProjection, variantSet);
+        : variantSet === undefined &&
+            (materialShaderId === 'forgeax::sprite' || materialShaderId === 'forgeax::sprite-lit')
+          ? ({ ok: true, value: undefined } as const)
+          : variantSetFromVertexLayoutProjection(layoutProjection, variantSet);
     if (!resolvedVariantSetResult.ok) {
       runtime.errorRegistry.fire(resolvedVariantSetResult.error);
       return null;
@@ -508,6 +529,8 @@ export function recordGeometryDraws(
         undefined,
         undefined,
         reflectionFallbackFormats,
+        vertexEntry,
+        fragmentEntry,
       ) ?? null;
     const handle =
       profilePhase === undefined
@@ -528,6 +551,8 @@ export function recordGeometryDraws(
         topology,
         indexFormat,
         variantSet,
+        vertexEntry,
+        fragmentEntry,
         passKind,
         layoutProjection,
         sampleCount,
@@ -591,7 +616,8 @@ export function recordGeometryDraws(
     // decal submesh) is NOT skipped at the entity level; its opaque submeshes
     // draw here and the per-submesh loop below skips the transparent ones
     // (they are drawn in the blend sub-pass instead).
-    if (splitLdrSprite && isEntityFullyTransparent(entry.source)) continue;
+    if (selectedDispatch === undefined && splitLdrSprite && isEntityFullyTransparent(entry.source))
+      continue;
 
     const pipelineTag: 'unlit' = 'unlit';
 
@@ -975,295 +1001,315 @@ export function recordGeometryDraws(
         const materialHandle = submeshMaterial.materialHandle ?? 0;
         if (materialHandles === undefined || !materialHandles.has(materialHandle)) continue;
       }
-      // feat-city-glb Bug 5 (per-submesh transparency): in the LDR split, a
-      // transparent submesh is drawn in the blend sub-pass (non-sRGB view),
-      // NOT here in the sRGB geometry pass. Skip it. Opaque submeshes of the
-      // same (mixed) mesh still draw here. Single-material / fully-opaque
-      // meshes are unaffected (their submesh materials are not transparent).
-      if (splitLdrSprite && submeshMaterial.transparent === true) {
-        continue;
-      }
-      // bug-20260610 layer 7d: per-submesh BG construction. Texture
-      // views resolve from `matsForRebind[smIdx]` so the j-th submesh
-      // sees its own materials[j] textures (baseColor / MR / normal /
-      // emissive / occlusion). Pick slot j when materials.length covers
-      // smIdx; otherwise fall back to slot 0 (count-mismatch already
-      // filtered by extract; this guard handles the materials.length=1
-      // single-material path mapped over multi-submesh meshes safely).
-      // This BG drops entityKey: identical-texture-set submeshes
-      // (whether on the same entity or different ones) share one BG via
-      // the shaderId-outer `materialBgShared` cache. The 14 handle
-      // objects form the WeakMap chain and fully discriminate the
-      // binding state since sampler/textureView/buffer handle identities
-      // are stable across frames.
-      //
-      // feat-20260625-refactor-sprite-as-transparent-mesh M3 / w13:
-      // sprite materials now use the same per-submesh BG construction
-      // (the sprite-specific BG branch above is deleted; sprite per-
-      // submesh single-slot is still enforced via materialSlotIndices
-      // and the sprite-shaped paramSnapshot fills the PBR-shaped BGL
-      // bindings via fallback textures for the 4 unused slots).
-      // feat-city-glb Bug 5: per-submesh material BG assembly extracted to
-      // the shared `buildPerSubmeshMaterialBg` closure (also called by the
-      // LDR blend sub-pass). Resolves the shader's user-region textures
-      // (baseColor/MR/normal + a custom Nth texture), emissive/occlusion
-      // injection, and Skylight merge; deduped cross-entity via the
-      // shaderId-outer `materialBgShared` cache.
-      const materialSlot = materialSlotIndices[i]?.[matSlotIdx] ?? materialSlotIndices[i]?.[0] ?? 0;
-      const processValue = (
-        globalThis as {
-          process?: { env?: Record<string, string | undefined> };
+      const draws: readonly (DispatchEntry | undefined)[] =
+        selectedDispatch === undefined
+          ? [undefined]
+          : (materialPasses.get(entry.renderableIndex)?.get(submeshMaterial.materialHandle ?? 0) ??
+            []);
+      for (const selectedPass of draws) {
+        const selectedShaderId =
+          selectedPass === undefined
+            ? submeshMaterial.materialShaderId
+            : selectedPass.materialShaderId;
+        const selectedRenderState =
+          selectedPass === undefined ? submeshMaterial.renderState : selectedPass.renderState;
+        const selectedStencil =
+          (selectedPass === undefined ? entry.stencilReference : selectedPass.stencilReference) ??
+          0;
+        if (selectedStencil !== lastStencilReference) {
+          pass.setStencilReference(selectedStencil);
+          lastStencilReference = selectedStencil;
         }
-      ).process;
-      if (
-        processValue?.env?.FORGEAX_MATERIAL_PIPELINE_DIAGNOSTICS === '1' &&
-        (submeshMaterial.materialShaderId === 'forgeax::default-standard-pbr' ||
-          submeshMaterial.materialShaderId === 'forgeax::pbr-skin')
-      ) {
-        console.error(
-          `[render-material] draw receipt: ${JSON.stringify({
-            entityIndex: entry.renderableIndex,
-            materialSlot,
-            materialHandle: submeshMaterial.materialHandle,
-            clearcoat: submeshMaterial.paramSnapshot?.clearcoat,
-            shader: submeshMaterial.materialShaderId,
-          })}`,
-        );
-      }
-      perSubmeshBg =
-        profilePhase === undefined
-          ? resolveMaterialBindGroup(
+        // feat-city-glb Bug 5 (per-submesh transparency): in the LDR split, a
+        // transparent submesh is drawn in the blend sub-pass (non-sRGB view),
+        // NOT here in the sRGB geometry pass. Skip it. Opaque submeshes of the
+        // same (mixed) mesh still draw here. Single-material / fully-opaque
+        // meshes are unaffected (their submesh materials are not transparent).
+        if (
+          splitLdrSprite &&
+          (selectedPass === undefined
+            ? submeshMaterial.transparent === true
+            : selectedRenderState?.blend !== undefined)
+        ) {
+          continue;
+        }
+        // bug-20260610 layer 7d: per-submesh BG construction. Texture
+        // views resolve from `matsForRebind[smIdx]` so the j-th submesh
+        // sees its own materials[j] textures (baseColor / MR / normal /
+        // emissive / occlusion). Pick slot j when materials.length covers
+        // smIdx; otherwise fall back to slot 0 (count-mismatch already
+        // filtered by extract; this guard handles the materials.length=1
+        // single-material path mapped over multi-submesh meshes safely).
+        // This BG drops entityKey: identical-texture-set submeshes
+        // (whether on the same entity or different ones) share one BG via
+        // the shaderId-outer `materialBgShared` cache. The 14 handle
+        // objects form the WeakMap chain and fully discriminate the
+        // binding state since sampler/textureView/buffer handle identities
+        // are stable across frames.
+        //
+        // feat-20260625-refactor-sprite-as-transparent-mesh M3 / w13:
+        // sprite materials now use the same per-submesh BG construction
+        // (the sprite-specific BG branch above is deleted; sprite per-
+        // submesh single-slot is still enforced via materialSlotIndices
+        // and the sprite-shaped paramSnapshot fills the PBR-shaped BGL
+        // bindings via fallback textures for the 4 unused slots).
+        // feat-city-glb Bug 5: per-submesh material BG assembly extracted to
+        // the shared `buildPerSubmeshMaterialBg` closure (also called by the
+        // LDR blend sub-pass). Resolves the shader's user-region textures
+        // (baseColor/MR/normal + a custom Nth texture), emissive/occlusion
+        // injection, and Skylight merge; deduped cross-entity via the
+        // shaderId-outer `materialBgShared` cache.
+        const materialSlot =
+          materialSlotIndices[i]?.[matSlotIdx] ?? materialSlotIndices[i]?.[0] ?? 0;
+        const processValue = (
+          globalThis as {
+            process?: { env?: Record<string, string | undefined> };
+          }
+        ).process;
+        if (
+          processValue?.env?.FORGEAX_MATERIAL_PIPELINE_DIAGNOSTICS === '1' &&
+          (submeshMaterial.materialShaderId === 'forgeax::default-standard-pbr' ||
+            submeshMaterial.materialShaderId === 'forgeax::pbr-skin')
+        ) {
+          console.error(
+            `[render-material] draw receipt: ${JSON.stringify({
+              entityIndex: entry.renderableIndex,
               materialSlot,
-              submeshMaterial,
-              entry.source.entityKey,
-              entry.world ?? c.world,
-            )
-          : profileGeometrySegment(c, passKind, 'material-bind-groups', () =>
-              resolveMaterialBindGroup(
+              materialHandle: submeshMaterial.materialHandle,
+              clearcoat: submeshMaterial.paramSnapshot?.clearcoat,
+              shader: submeshMaterial.materialShaderId,
+            })}`,
+          );
+        }
+        perSubmeshBg =
+          profilePhase === undefined
+            ? resolveMaterialBindGroup(
                 materialSlot,
                 submeshMaterial,
                 entry.source.entityKey,
                 entry.world ?? c.world,
-              ),
+                selectedShaderId,
+              )
+            : profileGeometrySegment(c, passKind, 'material-bind-groups', () =>
+                resolveMaterialBindGroup(
+                  materialSlot,
+                  submeshMaterial,
+                  entry.source.entityKey,
+                  entry.world ?? c.world,
+                  selectedShaderId,
+                ),
+              );
+        materialGroup1DynamicOffsets[0] = materialSlot * MATERIAL_PER_ENTITY_STRIDE;
+        pass.setBindGroup(1, perSubmeshBg, materialGroup1DynamicOffsets, 0, 1);
+        const smTopology = sm.topology;
+        const smMaterialShaderId =
+          selectedPass !== undefined
+            ? selectedShaderId
+            : entry.source.skin !== undefined
+              ? isStandardPbrSkinMaterialShader(submeshMaterial.materialShaderId)
+                ? submeshMaterial.materialShaderId
+                : SKIN_MATERIAL_SHADER_ID
+              : submeshMaterial.materialShaderId;
+        const probeBlendAvailable =
+          probeBlendRecordAvailable && isStandardPbrMaterialShader(smMaterialShaderId);
+        const isSpriteShader =
+          smMaterialShaderId === 'forgeax::sprite' || smMaterialShaderId === 'forgeax::sprite-lit';
+        // Preserve the dedicated sprite-pass state when the linear-LDR graph
+        // routes a sprite through this generic geometry path. Negative scale
+        // flips winding, so back-face culling would erase the quad.
+        const basePipelineRenderState = isSpriteShader
+          ? {
+              ...selectedRenderState,
+              depthWriteEnabled: false,
+              depthCompare: 'less-equal' as const,
+              cullMode: 'none' as const,
+              blend: selectedRenderState?.blend ?? SPRITE_PREMULTIPLIED_ALPHA_BLEND,
+            }
+          : geometryRenderStateForTopology(smTopology, selectedRenderState);
+        const pipelineRenderState = geometryRenderStateForPass(basePipelineRenderState, passKind);
+        let smPipelineHandle: typeof pipelineState.unlitPipeline;
+        let materialGroup2Contract: 'mesh' | 'skin' | 'cluster' | 'skin-cluster' | undefined;
+        let materialPipelineEntry: MaterialShaderPipelineEntry | null = null;
+        if (smMaterialShaderId === undefined || smMaterialShaderId === 'forgeax::default-unlit') {
+          const unlitShaderId = smMaterialShaderId ?? 'forgeax::default-unlit';
+          const unlitProjectionVariantResult = variantSetFromVertexLayoutProjection(
+            entry.mesh.layoutProjection,
+            undefined,
+          );
+          if (!unlitProjectionVariantResult.ok) {
+            runtime.errorRegistry.fire(unlitProjectionVariantResult.error);
+            continue;
+          }
+          const unlitHasColor =
+            unlitProjectionVariantResult.value === 'VERTEX_COLOR_AVAILABLE=true';
+          const unlitVariantSet = standardStorageVariantSet(
+            runtime.device.caps.storageBuffer,
+            unlitHasColor,
+          );
+          const unlitRsp = resolveMaterialPipeline(
+            unlitShaderId,
+            pipelineRenderState,
+            smTopology,
+            entry.mesh.indexFormat,
+            unlitVariantSet,
+            colorFormatOverride,
+            entry.mesh.layoutProjection,
+            selectedPass?.vertexEntry,
+            selectedPass?.fragmentEntry,
+          );
+          materialPipelineEntry = unlitRsp;
+          smPipelineHandle =
+            unlitRsp?.pipeline ??
+            (colorFormatOverride === undefined
+              ? selectGeometryPipeline(pipelineState, isHdrTarget, msaaActive)
+              : null);
+        } else if (smMaterialShaderId !== undefined) {
+          // feat-20260609 M4.5 / w38 (D-11): the variantSet handed to
+          // getMaterialShaderPipeline MUST mirror the boot-time
+          // `definesKey` rule at createRenderer.ts:2483-2485 (sortedEntries
+          // .every(v=>v===true) ? '' : 'A=v+...'). manifest variant.definesKey
+          // is `''` for the all-true variant, so HDRP (both axes true) must
+          // pass the canonical empty key to hit that variant via
+          // findVariantByKey. Passing the expanded form would produce a
+          // miss and silently fall back to the registered default WGSL,
+          // creating a layout/binding mismatch under HDRP.
+          //
+          // URP path passes the explicit expanded form because the URP
+          // variant's manifest definesKey IS that exact non-empty string
+          // (CLUSTER_FORWARD_AVAILABLE=false+STORAGE_BUFFER_AVAILABLE=true)
+          // -- the canonical-empty rule only applies to the all-true case.
+          const hasVertexColor = entry.mesh.layoutProjection.attributes.some(
+            (attribute) => attribute.key === 'color',
+          );
+          // The all-true HDRP variant uses the canonical empty key only when
+          // every variant axis is true. A plain mesh adds the geometry-owned
+          // VERTEX_COLOR_AVAILABLE=false axis, so retain the two capability
+          // axes explicitly or the selector would silently choose the URP
+          // group(2) layout for an HDRP cluster bind group.
+          const capabilityVariantSet = standardTopologyVariantSet(
+            c.standardLighting,
+            runtime.device.caps.storageBuffer,
+            hasVertexColor,
+            probeBlendAvailable,
+          );
+          const transmissionAvailable = requestsStandardTransmissionVariant(submeshMaterial);
+          const materialCapabilityVariantSet =
+            transmissionAvailable && !capabilityVariantSet.includes('TRANSMISSION_AVAILABLE=')
+              ? `${capabilityVariantSet === '' ? '' : `${capabilityVariantSet}+`}TRANSMISSION_AVAILABLE=true`
+              : capabilityVariantSet;
+          // Sprite's base request must retain the boot-selected artifact. Only
+          // SpriteInstances uses the explicit empty key for the
+          // PER_INSTANCE_REGION=true variant; synthesizing the generic PBR
+          // capability axes for a base sprite would invent a lazy module label
+          // that has no boot seed and skip the first HDR draw.
+          const variantSet = isSpriteShader
+            ? smMaterialShaderId === 'forgeax::sprite' && entry.source.spriteInstances !== undefined
+              ? ''
+              : undefined
+            : entry.variantSet === undefined
+              ? materialCapabilityVariantSet
+              : capabilityVariantSet === ''
+                ? entry.variantSet
+                : `${capabilityVariantSet}+${entry.variantSet}`;
+          const cachedPipeline = resolveMaterialPipeline(
+            smMaterialShaderId,
+            pipelineRenderState,
+            smTopology,
+            entry.mesh.indexFormat,
+            variantSet,
+            colorFormatOverride,
+            entry.mesh.layoutProjection,
+            selectedPass?.vertexEntry,
+            selectedPass?.fragmentEntry,
+          );
+          // feat-20260615-pipeline-spec-ssot M6-T1: cache miss resolves to
+          // null uniformly across URP / HDRP / skin shaders. Charter P3
+          // explicit failure: the pre-M6 URP-path silent fallback to the
+          // boot-time `pipelineState.standardPipeline*` (M4.5-followup w43)
+          // masked real PipelineSpecError build failures behind a
+          // layout-compatible-but-wrong PSO. The per-submesh
+          // `if (smPipelineHandle === null) continue` skip-draw (which
+          // already covered HDRP-active and skin miss paths) is now the
+          // single uniform recovery shape -- one frame of skip-draw on
+          // first-touch, then the cached PSO flows in once the async
+          // build resolves. The pre-loop skin-PSO probe still skips the
+          // entire entry on first-submesh probe miss; this site only
+          // fires on per-submesh topology variance miss.
+          materialPipelineEntry = cachedPipeline;
+          smPipelineHandle = cachedPipeline?.pipeline ?? null;
+        } else {
+          smPipelineHandle = selectGeometryPipeline(pipelineState, isHdrTarget, msaaActive);
+        }
+
+        if (smPipelineHandle === null) {
+          if (diagnosticsEnabled) {
+            console.error(
+              `[render-material] draw skipped: ${JSON.stringify({
+                entityKey: entry.source.entityKey,
+                materialHandle: submeshMaterial.materialHandle,
+                shader: smMaterialShaderId,
+                reason: 'pipeline-unavailable',
+              })}`,
             );
-      materialGroup1DynamicOffsets[0] = materialSlot * MATERIAL_PER_ENTITY_STRIDE;
-      pass.setBindGroup(1, perSubmeshBg, materialGroup1DynamicOffsets, 0, 1);
-      const smTopology = sm.topology;
-      const smMaterialShaderId =
-        entry.source.skin !== undefined
-          ? isStandardPbrSkinMaterialShader(submeshMaterial.materialShaderId)
-            ? submeshMaterial.materialShaderId
-            : SKIN_MATERIAL_SHADER_ID
-          : submeshMaterial.materialShaderId;
-      const probeBlendAvailable =
-        probeBlendRecordAvailable && isStandardPbrMaterialShader(smMaterialShaderId);
-      const isSpriteShader =
-        smMaterialShaderId === 'forgeax::sprite' || smMaterialShaderId === 'forgeax::sprite-lit';
-      // Preserve the dedicated sprite-pass state when the linear-LDR graph
-      // routes a sprite through this generic geometry path. Negative scale
-      // flips winding, so back-face culling would erase the quad.
-      const basePipelineRenderState = isSpriteShader
-        ? {
-            ...submeshMaterial.renderState,
-            depthWriteEnabled: false,
-            depthCompare: 'less-equal' as const,
-            cullMode: 'none' as const,
-            blend: submeshMaterial.renderState?.blend ?? SPRITE_PREMULTIPLIED_ALPHA_BLEND,
           }
-        : geometryRenderStateForTopology(smTopology, submeshMaterial.renderState);
-      const pipelineRenderState = geometryRenderStateForPass(basePipelineRenderState, passKind);
-      let smPipelineHandle: typeof pipelineState.unlitPipeline;
-      let materialGroup2Contract: 'mesh' | 'skin' | 'cluster' | 'skin-cluster' | undefined;
-      let materialPipelineEntry: MaterialShaderPipelineEntry | null = null;
-      if (smMaterialShaderId === undefined || smMaterialShaderId === 'forgeax::default-unlit') {
-        const unlitShaderId = smMaterialShaderId ?? 'forgeax::default-unlit';
-        const unlitProjectionVariantResult = variantSetFromVertexLayoutProjection(
-          entry.mesh.layoutProjection,
-          undefined,
-        );
-        if (!unlitProjectionVariantResult.ok) {
-          runtime.errorRegistry.fire(unlitProjectionVariantResult.error);
           continue;
         }
-        const unlitHasColor = unlitProjectionVariantResult.value === 'VERTEX_COLOR_AVAILABLE=true';
-        const unlitVariantSet = standardStorageVariantSet(
-          runtime.device.caps.storageBuffer,
-          unlitHasColor,
-        );
-        const unlitRsp = resolveMaterialPipeline(
-          unlitShaderId,
-          pipelineRenderState,
-          smTopology,
-          entry.mesh.indexFormat,
-          unlitVariantSet,
-          colorFormatOverride,
-          entry.mesh.layoutProjection,
-        );
-        materialPipelineEntry = unlitRsp;
-        smPipelineHandle =
-          unlitRsp?.pipeline ??
-          (colorFormatOverride === undefined
-            ? selectGeometryPipeline(pipelineState, isHdrTarget, msaaActive)
-            : null);
-      } else if (smMaterialShaderId !== undefined) {
-        // feat-20260609 M4.5 / w38 (D-11): the variantSet handed to
-        // getMaterialShaderPipeline MUST mirror the boot-time
-        // `definesKey` rule at createRenderer.ts:2483-2485 (sortedEntries
-        // .every(v=>v===true) ? '' : 'A=v+...'). manifest variant.definesKey
-        // is `''` for the all-true variant, so HDRP (both axes true) must
-        // pass the canonical empty key to hit that variant via
-        // findVariantByKey. Passing the expanded form would produce a
-        // miss and silently fall back to the registered default WGSL,
-        // creating a layout/binding mismatch under HDRP.
-        //
-        // URP path passes the explicit expanded form because the URP
-        // variant's manifest definesKey IS that exact non-empty string
-        // (CLUSTER_FORWARD_AVAILABLE=false+STORAGE_BUFFER_AVAILABLE=true)
-        // -- the canonical-empty rule only applies to the all-true case.
-        const hasVertexColor = entry.mesh.layoutProjection.attributes.some(
-          (attribute) => attribute.key === 'color',
-        );
-        // The all-true HDRP variant uses the canonical empty key only when
-        // every variant axis is true. A plain mesh adds the geometry-owned
-        // VERTEX_COLOR_AVAILABLE=false axis, so retain the two capability
-        // axes explicitly or the selector would silently choose the URP
-        // group(2) layout for an HDRP cluster bind group.
-        const capabilityVariantSet = standardTopologyVariantSet(
-          c.standardLighting,
-          runtime.device.caps.storageBuffer,
-          hasVertexColor,
+        // The probe record is an ABI extension of the built-in Standard PBR
+        // shaders only. RenderScene may retain a record on every projected
+        // renderable, but unlit/custom shaders still use the one-binding
+        // instances BGL and must never receive the probe bind group. Resolve
+        // this per submesh so mixed-material meshes cannot cross the layouts.
+        const instanceDraws = resolveGeometryInstanceBuffer(
+          c,
+          entry,
+          identityInstanceDraws,
           probeBlendAvailable,
         );
-        const transmissionAvailable = requestsStandardTransmissionVariant(submeshMaterial);
-        const materialCapabilityVariantSet =
-          transmissionAvailable && !capabilityVariantSet.includes('TRANSMISSION_AVAILABLE=')
-            ? `${capabilityVariantSet === '' ? '' : `${capabilityVariantSet}+`}TRANSMISSION_AVAILABLE=true`
-            : capabilityVariantSet;
-        // Sprite's base request must retain the boot-selected artifact. Only
-        // SpriteInstances uses the explicit empty key for the
-        // PER_INSTANCE_REGION=true variant; synthesizing the generic PBR
-        // capability axes for a base sprite would invent a lazy module label
-        // that has no boot seed and skip the first HDR draw.
-        const variantSet = isSpriteShader
-          ? smMaterialShaderId === 'forgeax::sprite' && entry.source.spriteInstances !== undefined
-            ? ''
-            : undefined
-          : entry.variantSet === undefined
-            ? materialCapabilityVariantSet
-            : capabilityVariantSet === ''
-              ? entry.variantSet
-              : `${capabilityVariantSet}+${entry.variantSet}`;
-        const cachedPipeline = resolveMaterialPipeline(
-          smMaterialShaderId,
-          pipelineRenderState,
-          smTopology,
-          entry.mesh.indexFormat,
-          variantSet,
-          colorFormatOverride,
-          entry.mesh.layoutProjection,
-        );
-        // feat-20260615-pipeline-spec-ssot M6-T1: cache miss resolves to
-        // null uniformly across URP / HDRP / skin shaders. Charter P3
-        // explicit failure: the pre-M6 URP-path silent fallback to the
-        // boot-time `pipelineState.standardPipeline*` (M4.5-followup w43)
-        // masked real PipelineSpecError build failures behind a
-        // layout-compatible-but-wrong PSO. The per-submesh
-        // `if (smPipelineHandle === null) continue` skip-draw (which
-        // already covered HDRP-active and skin miss paths) is now the
-        // single uniform recovery shape -- one frame of skip-draw on
-        // first-touch, then the cached PSO flows in once the async
-        // build resolves. The pre-loop skin-PSO probe still skips the
-        // entire entry on first-submesh probe miss; this site only
-        // fires on per-submesh topology variance miss.
-        materialPipelineEntry = cachedPipeline;
-        smPipelineHandle = cachedPipeline?.pipeline ?? null;
-      } else {
-        smPipelineHandle = selectGeometryPipeline(pipelineState, isHdrTarget, msaaActive);
-      }
-
-      if (smPipelineHandle === null) {
-        if (diagnosticsEnabled) {
+        if (instanceDraws === null) continue;
+        // Standard clustered PBR variants declare the unified cluster/SSAO
+        // group(2) layout. Unlit and other URP-layout materials must bind the
+        // ordinary mesh group instead; choosing one group for the whole pass
+        // makes Dawn reject an otherwise valid unlit pipeline and invalidates
+        // the command buffer before it reaches the surface.
+        if (!isSkinEntry) {
+          materialGroup2Contract = materialPipelineEntry?.group2Contract;
+          if (materialGroup2Contract === undefined) continue;
+          const selectedGroup = selectMaterialGroup2(
+            meshGroup2,
+            meshBindGroup,
+            materialGroup2Contract,
+          );
+          if (selectedGroup === null) continue;
+          group2BindGroup = selectedGroup;
+        }
+        if (diagnosticsEnabled && submeshMaterial.textureHandles !== undefined) {
           console.error(
-            `[render-material] draw skipped: ${JSON.stringify({
+            `[render-material] draw submitted: ${JSON.stringify({
               entityKey: entry.source.entityKey,
               materialHandle: submeshMaterial.materialHandle,
               shader: smMaterialShaderId,
-              reason: 'pipeline-unavailable',
+              textureHandles: [...submeshMaterial.textureHandles.entries()].map(
+                ([field, handle]) => ({
+                  field,
+                  handle,
+                }),
+              ),
+              skin: isSkinEntry
+                ? {
+                    resourcesReady: skinResources !== null,
+                    psoReady: skinPsoProbe !== null,
+                    paletteBufferReady: skinSlice?.buffer !== undefined,
+                    paletteByteOffset: skinSlice?.byteOffset,
+                    dynamicOffsets: [...group2DynamicOffsets],
+                  }
+                : undefined,
+              pipelineReady: true,
             })}`,
           );
         }
-        continue;
-      }
-      // The probe record is an ABI extension of the built-in Standard PBR
-      // shaders only. RenderScene may retain a record on every projected
-      // renderable, but unlit/custom shaders still use the one-binding
-      // instances BGL and must never receive the probe bind group. Resolve
-      // this per submesh so mixed-material meshes cannot cross the layouts.
-      const instanceDraws = resolveGeometryInstanceBuffer(
-        c,
-        entry,
-        identityInstanceDraws,
-        probeBlendAvailable,
-      );
-      if (instanceDraws === null) continue;
-      // Standard clustered PBR variants declare the unified cluster/SSAO
-      // group(2) layout. Unlit and other URP-layout materials must bind the
-      // ordinary mesh group instead; choosing one group for the whole pass
-      // makes Dawn reject an otherwise valid unlit pipeline and invalidates
-      // the command buffer before it reaches the surface.
-      if (!isSkinEntry) {
-        materialGroup2Contract = materialPipelineEntry?.group2Contract;
-        if (materialGroup2Contract === undefined) continue;
-        const selectedGroup = selectMaterialGroup2(
-          meshGroup2,
-          meshBindGroup,
-          materialGroup2Contract,
-        );
-        if (selectedGroup === null) continue;
-        group2BindGroup = selectedGroup;
-      }
-      if (diagnosticsEnabled && submeshMaterial.textureHandles !== undefined) {
-        console.error(
-          `[render-material] draw submitted: ${JSON.stringify({
-            entityKey: entry.source.entityKey,
-            materialHandle: submeshMaterial.materialHandle,
-            shader: smMaterialShaderId,
-            textureHandles: [...submeshMaterial.textureHandles.entries()].map(
-              ([field, handle]) => ({
-                field,
-                handle,
-              }),
-            ),
-            skin: isSkinEntry
-              ? {
-                  resourcesReady: skinResources !== null,
-                  psoReady: skinPsoProbe !== null,
-                  paletteBufferReady: skinSlice?.buffer !== undefined,
-                  paletteByteOffset: skinSlice?.byteOffset,
-                  dynamicOffsets: [...group2DynamicOffsets],
-                }
-              : undefined,
-            pipelineReady: true,
-          })}`,
-        );
-      }
-      pass.setBindGroup(2, group2BindGroup, group2DynamicOffsets);
+        pass.setBindGroup(2, group2BindGroup, group2DynamicOffsets);
 
-      if (profilePhase === undefined) {
-        recordOcclusionCandidate(() =>
-          submitSubmeshDraws(
-            pass,
-            bindingState,
-            smPipelineHandle,
-            instanceDraws,
-            entry.mesh.indexed,
-            sm.indexCount,
-            sm.vertexCount,
-            sm.indexOffset,
-          ),
-        );
-      } else {
-        profileGeometrySegment(c, passKind, 'draw-submit', () =>
+        if (profilePhase === undefined) {
           recordOcclusionCandidate(() =>
             submitSubmeshDraws(
               pass,
@@ -1275,11 +1321,26 @@ export function recordGeometryDraws(
               sm.vertexCount,
               sm.indexOffset,
             ),
-          ),
-        );
-      }
-      if (diagnosticsEnabled && perSubmeshBg !== null) {
-        recordIblPipelineBinding(c, submeshMaterial, smPipelineHandle, perSubmeshBg);
+          );
+        } else {
+          profileGeometrySegment(c, passKind, 'draw-submit', () =>
+            recordOcclusionCandidate(() =>
+              submitSubmeshDraws(
+                pass,
+                bindingState,
+                smPipelineHandle,
+                instanceDraws,
+                entry.mesh.indexed,
+                sm.indexCount,
+                sm.vertexCount,
+                sm.indexOffset,
+              ),
+            ),
+          );
+        }
+        if (diagnosticsEnabled && perSubmeshBg !== null) {
+          recordIblPipelineBinding(c, submeshMaterial, smPipelineHandle, perSubmeshBg);
+        }
       }
     }
   }