fix(rendering): carry retail SetSurface state to detail draws

Resolve exact SetSurface blend, alpha-test, and fog state once during extraction and preserve it through recipe-10 prepared payloads, Wb/EnvCell command data, Vulkan pipelines, push constants, and both ordinary/atmospheric one-pass shaders. Preserve AP-240 Wb pure-Clip immediate opaque/A2C while EnvCell uses retail premultiplied Clip; detail-off routing remains unchanged. Correct AP-232 and register the remaining detail-off state divergence.

Mutation first failures (all restored):
- raw Add->SRCALPHA/ONE: WalkStaticStreamPopulatorTests.ImmediateBuildingDetail_UsesExactResolvedSetSurfaceState line 1278, expected wb-mesh-raw-additive-1x.
- inverse-add->alpha-add: same test line 1278, expected wb-mesh-inverse-additive-1x.
- remove Env inverse: EnvCellAlphaDrawSourceTests.DetailOn_EveryEnvCellFamilyDrawsOnceInPlaceWithAuthoredOpacity line 132, expected envcell-inverse.
- raw IsAdditive precedence: same test line 132, Translucent|Clip|Additive expected envcell-alpha.
- Wb paletted ParamB=0: OrderPreservingSubmitterTests line 333, expected 0.392156869.
- Wb DDS ParamB=0.05: same test line 333, expected 0.784313738.
- disable Alpha+Clip test: WalkStaticStreamPopulatorTests line 1286, expected 0.784313738.
- always fog raw Add: same test line 1287, expected no-fog true.
- disable fog non-Add: same test line 1287, expected no-fog false.
- X=a*qA: RetailDetailTextureContractTests line 261, shared squared-alpha substring absent.
- X includes base alpha: same test line 262, forbidden baseTexel.a present.
- CLIP uses 0.05: EnvCellAlphaDrawSourceTests.ClipShaders_UseGreaterEqualForThePerRangeReference line 367.
- second detail draw: EnvCell detail-on line 131, collection contained 2 draws.
- straight-alpha substitute: Wb immediate line 1278, expected wb-mesh-additive-1x.
- omit ordered detail arm: OrderPreservingSubmitterTests line 318, expected (77,3.5), got (0,0).
- omit atmospheric combine: RetailDetailTextureContractTests line 260, shared include absent.
- drop serialized opacity: ObjectMeshDataSerializerTests line 292, expected opacity bits, got 1.0.
- stale detail arm: atmospheric adjacency line 402, expected slot 0, got 77.
- per-frame surface map: EnvCell warmed allocation line 285, expected 0 B, got 204800 B.

tests/AcDream.Core.Tests/Rendering/Wb/EntityClassificationCacheTests.cs

@@ -337,6 +337,7 @@ public class EntityClassificationCacheTests
             TextureSlot: new AcDream.App.Rendering.Gpu.GpuTextureSlot(texSlot),
             TextureLayer: 0,
             Translucency: TranslucencyKind.Opaque,
+            MaterialState: RetailSetSurfaceMaterialState.Opaque,
             FoliageFlags: 0u);
         return new CachedBatch(key, new AcDream.App.Rendering.Gpu.GpuTextureSlot(texSlot), Matrix4x4.Identity);
     }

tests/AcDream.Core.Tests/Rendering/Wb/WbDrawDispatcherBucketingTests.cs

@@ -426,6 +426,7 @@ public sealed class WbDrawDispatcherBucketingTests
             TextureSlot: new AcDream.App.Rendering.Gpu.GpuTextureSlot(texSlot),
             TextureLayer: 0,
             Translucency: TranslucencyKind.Opaque,
+            MaterialState: RetailSetSurfaceMaterialState.Opaque,
             FoliageFlags: 0u);
         return new CachedBatch(
             key,

tests/AcDream.Core.Tests/Rendering/Wb/WbDrawDispatcherIndirectBuilderTests.cs

@@ -20,9 +20,9 @@ public sealed class WbDrawDispatcherIndirectBuilderTests
         // Arrange — three groups: 2 opaque (12+1 instances) + 1 transparent (12 instances)
         var groups = new List<WbDrawDispatcher.IndirectGroupInput>
         {
-            new(IndexCount: 100, FirstIndex: 0,   BaseVertex: 0,   InstanceCount: 12, FirstInstance: 0,  TextureIndex: 0xAA, TextureLayer: 0, Translucency: TranslucencyKind.Opaque, SurfaceOpacity: 0.75f),
-            new(IndexCount: 200, FirstIndex: 100, BaseVertex: 0,   InstanceCount: 12, FirstInstance: 12, TextureIndex: 0xBB, TextureLayer: 0, Translucency: TranslucencyKind.AlphaBlend, SurfaceOpacity: 0.25f),
-            new(IndexCount: 50,  FirstIndex: 300, BaseVertex: 100, InstanceCount: 1,  FirstInstance: 24, TextureIndex: 0xCC, TextureLayer: 0, Translucency: TranslucencyKind.Opaque, SurfaceOpacity: 0.5f),
+            new(IndexCount: 100, FirstIndex: 0,   BaseVertex: 0,   InstanceCount: 12, FirstInstance: 0,  TextureIndex: 0xAA, TextureLayer: 0, Translucency: TranslucencyKind.Opaque, MaterialState: RetailSetSurfaceMaterialState.Opaque, SurfaceOpacity: 0.75f),
+            new(IndexCount: 200, FirstIndex: 100, BaseVertex: 0,   InstanceCount: 12, FirstInstance: 12, TextureIndex: 0xBB, TextureLayer: 0, Translucency: TranslucencyKind.AlphaBlend, MaterialState: RetailSetSurfaceMaterialState.Opaque, SurfaceOpacity: 0.25f),
+            new(IndexCount: 50,  FirstIndex: 300, BaseVertex: 100, InstanceCount: 1,  FirstInstance: 24, TextureIndex: 0xCC, TextureLayer: 0, Translucency: TranslucencyKind.Opaque, MaterialState: RetailSetSurfaceMaterialState.Opaque, SurfaceOpacity: 0.5f),
         };
 
         var indirect = new DrawElementsIndirectCommand[16];
@@ -75,12 +75,15 @@ public sealed class WbDrawDispatcherIndirectBuilderTests
         {
             new(IndexCount: 10, FirstIndex: 0, BaseVertex: 0, InstanceCount: 1, FirstInstance: 0,
                 TextureIndex: 0x1, TextureLayer: 0, Translucency: TranslucencyKind.Opaque,
+                MaterialState: RetailSetSurfaceMaterialState.Opaque,
                 CullMode: CullMode.Clockwise),
             new(IndexCount: 20, FirstIndex: 10, BaseVertex: 0, InstanceCount: 1, FirstInstance: 1,
                 TextureIndex: 0x2, TextureLayer: 0, Translucency: TranslucencyKind.AlphaBlend,
+                MaterialState: RetailSetSurfaceMaterialState.Opaque,
                 CullMode: CullMode.None),
             new(IndexCount: 30, FirstIndex: 30, BaseVertex: 0, InstanceCount: 1, FirstInstance: 2,
                 TextureIndex: 0x3, TextureLayer: 0, Translucency: TranslucencyKind.ClipMap,
+                MaterialState: RetailSetSurfaceMaterialState.Opaque,
                 CullMode: CullMode.Landblock),
         };
         var indirect = new DrawElementsIndirectCommand[4];
@@ -116,7 +119,7 @@ public sealed class WbDrawDispatcherIndirectBuilderTests
         // because the discard handles transparency, not blending.
         var groups = new List<WbDrawDispatcher.IndirectGroupInput>
         {
-            new(IndexCount: 10, FirstIndex: 0, BaseVertex: 0, InstanceCount: 1, FirstInstance: 0, TextureIndex: 0x1, TextureLayer: 0, Translucency: TranslucencyKind.ClipMap),
+            new(IndexCount: 10, FirstIndex: 0, BaseVertex: 0, InstanceCount: 1, FirstInstance: 0, TextureIndex: 0x1, TextureLayer: 0, Translucency: TranslucencyKind.ClipMap, MaterialState: RetailSetSurfaceMaterialState.Opaque),
         };
         var indirect = new DrawElementsIndirectCommand[4];
         var batch = new WbDrawDispatcher.BatchDataPublic[4];
@@ -146,7 +149,8 @@ public sealed class WbDrawDispatcherIndirectBuilderTests
             FirstInstance: index,
             TextureIndex: (uint)index,
             TextureLayer: 0,
-            Translucency: kind)).ToList();
+            Translucency: kind,
+            MaterialState: RetailSetSurfaceMaterialState.Opaque)).ToList();
         var indirect = new DrawElementsIndirectCommand[kinds.Length];
         var batches = new WbDrawDispatcher.BatchDataPublic[kinds.Length];