@forgeax/engine-render 0.1.29 → 0.1.31

package/src/index.ts

@@ -10,15 +10,15 @@ export {
   materialContribution,
   renderPipelineContribution,
   samplerContribution,
-} from './assets/asset-decoders';
+} from './assets/asset-decoders.js';
 // Runtime contract: leases, frame receipts, detached inspection, profile,
 // lifecycle state, and the single renderer event stream.
 export type {
   CubeCameraFaceView,
   CubeCameraFaceViewInput,
-} from './capture/cube-views';
-export { buildCubeCameraFaceViews } from './capture/cube-views';
-export { Atmosphere } from './components/atmosphere';
+} from './capture/cube-views.js';
+export { buildCubeCameraFaceViews } from './capture/cube-views.js';
+export { Atmosphere } from './components/atmosphere.js';
 // ECS render vocabulary and grouped closed values.
 export type {
   Antialias,
@@ -29,7 +29,7 @@ export type {
   CameraExposure,
   CameraProjection,
   Tonemap,
-} from './components/camera';
+} from './components/camera.js';
 export {
   ANTIALIAS_FXAA,
   ANTIALIAS_MSAA,
@@ -61,7 +61,7 @@ export {
   TONEMAP_REINHARD_EXTENDED,
   validateCameraColorGrading,
   validateCameraExposure,
-} from './components/camera';
+} from './components/camera.js';
 export {
   CUBE_CAMERA_FACE_ORDER,
   CUBE_CAMERA_UPDATE_CONTINUOUS,
@@ -73,27 +73,33 @@ export {
   type CubeCameraUpdateIntent,
   cubeCameraUpdateIntentFromF32,
   cubeCameraUpdateIntentToF32,
-} from './components/cube-camera';
-export * from './components/directional-light';
-export { Fog } from './components/fog';
-export { Instances, type InstancesData } from './components/instances';
-export { Layer } from './components/layer';
-export * from './components/light-helpers';
-export { LightProbe } from './components/light-probe';
-export { Lines } from './components/lines';
-export * from './components/mesh-filter';
-export * from './components/mesh-renderer';
-export { MotionBlur } from './components/motion-blur';
-export { PointLight } from './components/point-light';
-export { PointLightShadow } from './components/point-light-shadow';
+} from './components/cube-camera.js';
+export * from './components/directional-light.js';
+export {
+  DynamicResolution,
+  type DynamicResolutionData,
+  validateDynamicResolutionCamera,
+  validateDynamicResolutionParameters,
+} from './components/dynamic-resolution.js';
+export { Fog } from './components/fog.js';
+export { Instances, type InstancesData } from './components/instances.js';
+export { Layer } from './components/layer.js';
+export * from './components/light-helpers.js';
+export { LightProbe } from './components/light-probe.js';
+export { Lines } from './components/lines.js';
+export * from './components/mesh-filter.js';
+export * from './components/mesh-renderer.js';
+export { MotionBlur } from './components/motion-blur.js';
+export { PointLight } from './components/point-light.js';
+export { PointLightShadow } from './components/point-light-shadow.js';
 export {
   type PointShape,
   PointShapeValue,
   Points,
   pointShapeFromU32,
-} from './components/points';
-export { PostProcessParams } from './components/post-process-params';
-export { RectAreaLight } from './components/rect-area-light';
+} from './components/points.js';
+export { PostProcessParams } from './components/post-process-params.js';
+export { RectAreaLight } from './components/rect-area-light.js';
 export {
   REFLECTION_PROBE_UPDATE_CONTINUOUS,
   REFLECTION_PROBE_UPDATE_ON_CHANGE,
@@ -103,8 +109,8 @@ export {
   type ReflectionProbeUpdateIntent,
   reflectionProbeUpdateIntentFromF32,
   reflectionProbeUpdateIntentToF32,
-} from './components/reflection-probe';
-export { SceneInstance } from './components/scene-instance';
+} from './components/reflection-probe.js';
+export { SceneInstance } from './components/scene-instance.js';
 export {
   ScreenSpaceReflection,
   type ScreenSpaceReflectionData,
@@ -113,17 +119,17 @@ export {
   SKYBOX_MODE_CUBEMAP,
   SkyboxBackground,
   type SkyboxMode,
-} from './components/skybox-background';
-export { Skylight } from './components/skylight';
-export { SortKey } from './components/sort-key';
-export type { SpotLightAuthoring, SpotLightProjector } from './components/spot-light';
-export { SpotLight } from './components/spot-light';
+} from './components/skybox-background.js';
+export { Skylight } from './components/skylight.js';
+export { SortKey } from './components/sort-key.js';
+export type { SpotLightAuthoring, SpotLightProjector } from './components/spot-light.js';
+export { SpotLight } from './components/spot-light.js';
 export {
   Visibility,
   type VisibilityState,
   VisibilityStateValue,
   visibilityStateFromU32,
-} from './components/visibility';
+} from './components/visibility.js';
 export type {
   DynamicGeometryCandidate,
   DynamicGeometryCandidateState,
@@ -134,17 +140,17 @@ export type {
   DynamicGeometryOrdering,
   DynamicGeometryPrepareInput,
   DynamicGeometryReceipt,
-} from './dynamic-geometry';
+} from './dynamic-geometry.js';
 export {
   createDynamicGeometryLifecycle,
   DynamicGeometryError,
-} from './dynamic-geometry';
+} from './dynamic-geometry.js';
 export type {
   EnvironmentInspection,
   EnvironmentInspectionFailure,
   EnvironmentInspectionGeneration,
   EnvironmentInspectionStatus,
-} from './environment/inspection';
+} from './environment/inspection.js';
 // Public structured operation failure union. Concrete error classes stay
 // behind the Renderer Result/event boundary.
 export type {
@@ -155,6 +161,7 @@ export type {
 } from './errors/gpu-driven';
 export { GpuDrivenPreparationError } from './errors/gpu-driven';
 export type {
+  DynamicResolutionError,
   ReflectionProbeBudgetExceededDetail,
   RenderError,
   RenderErrorCode,
@@ -165,27 +172,30 @@ export type {
   RenderTargetStateInvalidDetail,
   SceneDataUnavailableDetail,
   SceneDataUnavailableReason,
-} from './errors/render';
+} from './errors/render.js';
 export {
   AtmosphereInvalidParameterError,
+  DynamicResolutionInvalidParameterError,
+  DynamicResolutionRequiresTaaError,
+  DynamicResolutionTimingUnavailableError,
   EnvironmentGenerationFailedError,
   EnvironmentSourceConflictError,
   FogCardinalityError,
   OwnerStageFailedError,
   SceneDataUnavailableError,
   TaaCapsInsufficientError,
-} from './errors/render';
+} from './errors/render.js';
 export type {
   EnvironmentFrame,
   EnvironmentSource,
   FogFrame,
   FramePlan,
-} from './extract/environment';
+} from './extract/environment.js';
 export {
   resolveVisibility,
   type VisibilityResolution,
   type VisibilitySnapshot,
-} from './extract/visibility';
+} from './extract/visibility.js';
 export type {
   RenderFeatureLogicalTarget,
   RenderFeatureMaterialShaderBindingContract,
@@ -193,7 +203,7 @@ export type {
   RenderFeaturePlan,
   RenderFeaturePlanContext,
   RenderFeatureResourceDeclaration,
-} from './features/plan';
+} from './features/plan.js';
 // Minimal declarative extension contract. Implementations use relative
 // imports; the root does not expose prepared state, graph projectors, target
 // handles, or builtin feature factories.
@@ -207,7 +217,7 @@ export type {
   RenderFeatureShaderModuleMode,
   RenderFeatureStatus,
   RenderFeatureWorldVisibilitySnapshot,
-} from './features/types';
+} from './features/types.js';
 export {
   beginProbeIblUpdate,
   createIblKernelCache,
@@ -219,7 +229,7 @@ export {
   REFLECTION_PROBE_IBL_STAGES,
   type ReflectionProbeIblStage,
   resetIblKernelCaches,
-} from './ibl/kernel-cache';
+} from './ibl/kernel-cache.js';
 export type {
   BloomInspection,
   GpuDrivenLane,
@@ -243,7 +253,7 @@ export type {
   RenderFeatureGraphInspection,
   RenderFeatureHostInspection,
   TransmissionInspection,
-} from './inspection-types';
+} from './inspection-types.js';
 export {
   type InstanceBackendKind,
   type InstanceCollectionCreateInput,
@@ -272,7 +282,7 @@ export {
   Materials,
   MaterialTransmissionContractError,
   srgb,
-} from './materials';
+} from './materials.js';
 export {
   type MeshMaterialBindingObservation,
   type MeshMaterialBindingPreparationFailure,
@@ -283,12 +293,13 @@ export {
   type MeshMaterialBindingTextureObservation,
   projectMeshMaterialBindingObservation,
   summarizeMeshMaterialBindings,
-} from './mesh-material-bindings';
+} from './mesh-material-bindings.js';
+export type { RenderExtent } from './pipeline/render-extent.js';
 export type {
   StandardClusterTransportInspection,
   StandardLightingInspection,
   StandardNoLocalLightingInspection,
-} from './pipeline/standard-lighting/inspection';
+} from './pipeline/standard-lighting/inspection.js';
 export type {
   AutoExposureCapabilityUnavailableDetail,
   AutoExposureError,
@@ -303,7 +314,7 @@ export type {
   AutoExposureResetReason,
   AutoExposureStageFailedDetail,
   AutoExposureStaleGenerationDetail,
-} from './pipeline/standard-output/auto-exposure/inspection';
+} from './pipeline/standard-output/auto-exposure/inspection.js';
 export {
   AutoExposureCapabilityUnavailableError,
   AutoExposureInvalidParameterError,
@@ -311,24 +322,24 @@ export {
   AutoExposureStaleGenerationError,
   createAutoExposureError,
   createAutoExposureInspection,
-} from './pipeline/standard-output/auto-exposure/inspection';
+} from './pipeline/standard-output/auto-exposure/inspection.js';
 export type {
   StandardLutFailure,
   StandardLutInspection,
   StandardLutState,
-} from './pipeline/standard-output/lut-state';
+} from './pipeline/standard-output/lut-state.js';
 // The host-facing default is a stable profile value; implementation-only
 // pipeline helpers remain behind the package boundary.
 export {
   DEFAULT_STANDARD_PROFILE,
   type StandardVolumetricFogProfile,
   type StandardVolumetricFogQuality,
-} from './pipeline/standard-profile';
-export { renderComponentsPlugin } from './plugin';
+} from './pipeline/standard-profile.js';
+export { renderComponentsPlugin } from './plugin.js';
 export {
   inspectPointShadow,
   type PointShadowInspection,
-} from './point-shadow-inspection';
+} from './point-shadow-inspection.js';
 export {
   admitPointsLines,
   type LinesStyleInput,
@@ -337,8 +348,8 @@ export {
   type PointsLinesAdmissionInput,
   type PointsLinesAdmissionLimits,
   type PointsStyleInput,
-} from './points-lines/admission';
-export type { PointsLinesInspection } from './points-lines/inspection';
+} from './points-lines/admission.js';
+export type { PointsLinesInspection } from './points-lines/inspection.js';
 /**
  * Public bounded GPU pass facts. Use the single `gpuPassTiming` opt-in,
  * `draw()` receipt, and `observe(receipt, { include: ['timings'] })` route.
@@ -375,17 +386,17 @@ export {
   createProbeFilterState,
   type ProbeFilterState,
   probeFilterIsSteady,
-} from './reflection/filter';
+} from './reflection/filter.js';
 export {
   buildReflectionProbeTable,
   type ReflectionProbeTable,
   type ReflectionProbeTableRow,
   reflectionProbeTableBytes,
-} from './reflection/gpu-table';
+} from './reflection/gpu-table.js';
 export {
   inspectReflectionFallback,
   type ReflectionFallbackFailureInput,
-} from './reflection/inspection';
+} from './reflection/inspection.js';
 export {
   admitReflectionProbe,
   DEFAULT_REFLECTION_PROBE_LIMITS,
@@ -401,7 +412,7 @@ export {
   type SkylightSelection,
   selectReflectionProbe,
   validateReflectionProbeInput,
-} from './reflection/projection';
+} from './reflection/projection.js';
 export type {
   CameraOutputSnapshot,
   CubeCameraSnapshot,
@@ -419,25 +430,25 @@ export type {
   RenderProfile,
   RenderResult,
   RenderWorldLease,
-} from './render-contract';
-export { RENDER_PHASE_CATALOG } from './render-contract';
+} from './render-contract.js';
+export { RENDER_PHASE_CATALOG } from './render-contract.js';
 export type {
   TemporalInspectionInput,
   TemporalInspectionStatus,
-} from './renderer-inspect';
-export type { RenderSceneBounds } from './scene/render-scene-types';
+} from './renderer-inspect.js';
+export type { RenderSceneBounds } from './scene/render-scene-types.js';
 export type {
   GpuFrameTiming,
   GpuFrameTimingProtocol,
   GpuFrameTimingRecord,
   GpuFrameTimingSample,
   GpuFrameTimingSummary,
-} from './scene/visibility/gpu-frame-timing';
+} from './scene/visibility/gpu-frame-timing.js';
 export {
   createGpuFrameTiming,
   recordGpuFrameTiming,
   summarizeGpuFrameTiming,
-} from './scene/visibility/gpu-frame-timing';
+} from './scene/visibility/gpu-frame-timing.js';
 export type {
   LodOcclusionDegradation,
   LodOcclusionFallback,
@@ -451,19 +462,19 @@ export type {
   LodOcclusionWorldAttribution,
   LodOcclusionWorldInspection,
   LodOcclusionWorldInspectionInput,
-} from './scene/visibility/inspection';
+} from './scene/visibility/inspection.js';
 export {
   consumeLodOcclusionInspection,
   inspectLodOcclusion,
   LOD_OCCLUSION_INSPECTION_MAX_BYTES,
   LOD_OCCLUSION_INSPECTION_SCHEMA,
   serializeLodOcclusionInspection,
-} from './scene/visibility/inspection';
+} from './scene/visibility/inspection.js';
 export {
   SHADOW_ATLAS_DEFAULT_FACE_SIZE,
   SHADOW_ATLAS_DEFAULT_LAYERS,
   ShadowAtlas,
-} from './shadow-atlas';
+} from './shadow-atlas.js';
 export type {
   SsrAdmissionBudget,
   SsrAdmissionFailure,
@@ -482,7 +493,7 @@ export type {
   SsrSpatialStatus,
   SsrSpatialWork,
   SsrTemporalReceipt,
-} from './ssr/admission';
+} from './ssr/admission.js';
 export {
   admitSsrM0,
   admitSsrSpatial,
@@ -492,32 +503,32 @@ export {
   SSR_FORMAT_STAGES,
   validateScreenSpaceReflection,
   zeroSsrAdmissionWork,
-} from './ssr/admission';
+} from './ssr/admission.js';
 export {
   composeSsrReflection,
   type SsrCompositionInput,
   type SsrCompositionInputError,
   type SsrCompositionResult,
   type SsrReflectionColor,
-} from './ssr/composition';
+} from './ssr/composition.js';
 export type {
   SsrConfigField,
   SsrConfigInvalidError,
   SsrConfigRange,
   SsrSpatialUnavailableReason,
   SsrUnavailableError,
-} from './ssr/errors';
+} from './ssr/errors.js';
 export type {
   SsrSpatialHistoryInspection,
   SsrSpatialInspection,
   SsrSpatialInspectionFailure,
   SsrSpatialInspectionProjection,
-} from './ssr/inspection';
+} from './ssr/inspection.js';
 export {
   projectSsrSpatialInspection,
   serializeSsrSpatialInspection,
-} from './ssr/inspection';
-export { getActiveCamera, setActiveCamera } from './systems/active-camera';
+} from './ssr/inspection.js';
+export { getActiveCamera, setActiveCamera } from './systems/active-camera.js';
 export type {
   RenderTarget,
   RenderTargetAdmissionLimits,
@@ -533,8 +544,8 @@ export type {
   RenderTargetTextureAspect,
   RenderTargetTextureSource,
   RenderTargetTextureSourceOptions,
-} from './targets/contracts';
-export type { TemporalInspection, TemporalResourceInspection } from './temporal/inspection';
+} from './targets/contracts.js';
+export type { TemporalInspection, TemporalResourceInspection } from './temporal/inspection.js';
 export {
   SCENE_DATA_TEMPORAL_V1_DESCRIPTOR,
   SCENE_DATA_TEMPORAL_V1_SCHEMA,
@@ -542,15 +553,15 @@ export {
   type SceneDataSchemaId,
   type SceneDataTarget,
   type SceneDataTemporalV1Descriptor,
-} from './temporal/scene-data';
+} from './temporal/scene-data.js';
 export {
   createSceneDataCatalog,
   type SceneDataAvailability,
   type SceneDataCatalog,
   type SceneDataCatalogOptions,
   type SceneDataInspection,
-} from './temporal/scene-data-catalog';
-export type { TemporalView } from './temporal/view';
+} from './temporal/scene-data-catalog.js';
+export type { TemporalView } from './temporal/view.js';
 export {
   hasVolumetricFogCapability,
   type IntegratedVolumeResource,
@@ -561,7 +572,7 @@ export {
   type VolumetricFogLightKind,
   type VolumetricFogLightPairResolution,
   type VolumetricFogLightResolution,
-} from './volume/capability';
+} from './volume/capability.js';
 export {
   type ValidatedVolumetricFog,
   type VolumeBounds,
@@ -570,12 +581,12 @@ export {
   type VolumetricFogAuthoring,
   type VolumetricFogLightSelection,
   validateVolumetricFog,
-} from './volume/component';
-export { extractVolumetricFog, type VolumetricFogExtract } from './volume/extract';
+} from './volume/component.js';
+export { extractVolumetricFog, type VolumetricFogExtract } from './volume/extract.js';
 export {
   inspectVolumetricFog,
   type VolumetricFogInspection,
   type VolumetricFogInspectionInput,
   type VolumetricFogInspectionStatus,
   type VolumetricFogResourceStage,
-} from './volume/inspection';
+} from './volume/inspection.js';

package/src/inspection-types.ts

@@ -455,7 +455,9 @@ export interface ReflectionFallbackReceipt {
 }
 
 /**
- * One completed readback for the frame-owned fallback attachment.
+ * Completed fallback attachment proof, available only when the renderer opts
+ * into captureReflectionFallbackReadback. Normal rendering publishes source
+ * receipts after GPU completion without copying, mapping, or hashing pixels.
  *
  * This is an aggregate attachment fact, not a per-renderable row.  Row
  * receipts deliberately carry source/coverage identity only, so one pixel
@@ -502,6 +504,19 @@ export interface ReflectionFallbackInspection {
 }
 
 export interface ReflectionProbeInspection {
+  readonly workBudgetPerFrame?: number;
+  readonly updates?: readonly {
+    readonly worldId: number;
+    readonly entityKey: number;
+    readonly intent: 'once' | 'on-change' | 'continuous';
+    readonly activeGeneration: number;
+    readonly requestedRevision: number;
+    readonly capturedRevision: number;
+    readonly pending: boolean;
+    readonly captureStartedFrame: number;
+    readonly lastCompletedFrame: number;
+    readonly latencyFrames: number | undefined;
+  }[];
   readonly selection: ReflectionProbeSelectionInspection;
   readonly factCount: number;
   readonly acceptedCount: number;

package/src/material-row.ts

@@ -2,15 +2,12 @@ import {
   type MaterialShaderArtifactReceipt,
   STANDARD_PIPELINE_PARAM_SCHEMA,
 } from '@forgeax/engine-shader';
-import { derive, type UboFieldLayout } from '@forgeax/engine-types';
+import { derive, type ParamSchemaEntry, type UboFieldLayout } from '@forgeax/engine-types';
 import { GPU_SCENE_LAYOUTS } from './gpu-scene-schema';
 import type { MaterialSnapshot } from './render-system-extract';
 
 const ROW = GPU_SCENE_LAYOUTS.material;
 const STANDARD_PIPELINE_DERIVED = derive(STANDARD_PIPELINE_PARAM_SCHEMA);
-const STANDARD_PARAM_ENTRIES = new Map(
-  STANDARD_PIPELINE_PARAM_SCHEMA.map((entry) => [entry.name, entry]),
-);
 
 function isNumericValue(value: unknown): value is number | readonly number[] {
   return typeof value === 'number' || Array.isArray(value);
@@ -42,19 +39,26 @@ function numericFallback(
       return material.normalScale ?? 1;
     case 'specularColor':
       return material.specularColor ?? [1, 1, 1];
-    default: {
-      const defaultValue = STANDARD_PARAM_ENTRIES.get(name)?.default;
-      return isNumericValue(defaultValue) ? defaultValue : undefined;
-    }
+    default:
+      return undefined;
   }
 }
 
 function numericValue(
   name: string,
   material: MaterialSnapshot,
+  schema: readonly ParamSchemaEntry[],
+  allowStandardFallback = false,
 ): number | readonly number[] | undefined {
   const snapshotValue = material.paramSnapshot?.[name];
-  return isNumericValue(snapshotValue) ? snapshotValue : numericFallback(name, material);
+  if (isNumericValue(snapshotValue)) return snapshotValue;
+  if (allowStandardFallback) {
+    const materialValue = numericFallback(name, material);
+    if (materialValue !== undefined) return materialValue;
+  }
+  const defaultValue = schema.find((entry) => entry.name === name)?.default;
+  if (isNumericValue(defaultValue)) return defaultValue;
+  return undefined;
 }
 
 function writeScalar(view: DataView, member: UboFieldLayout, value: number): void {
@@ -102,7 +106,9 @@ function writeVec4(view: DataView, offset: number, values: readonly number[]): v
 }
 
 function validateReceipt(receipt: MaterialShaderArtifactReceipt): void {
-  const expectedFields = ROW.fields.map((field) => field.name);
+  const expectedFields = ROW.fields
+    .filter((field) => !field.name.startsWith('_gpuDrivenPadding'))
+    .map((field) => field.name);
   if (
     receipt.materialRow.byteLength !== ROW.stride ||
     receipt.materialRow.fields.length !== expectedFields.length ||
@@ -123,7 +129,11 @@ export function packStandardPbrMaterialRow(
   const payload = new Uint8Array(ROW.stride);
   const view = new DataView(payload.buffer);
   for (const member of STANDARD_PIPELINE_DERIVED.numericMembers) {
-    writeNumeric(view, member, numericValue(member.name, material));
+    writeNumeric(
+      view,
+      member,
+      numericValue(member.name, material, STANDARD_PIPELINE_PARAM_SCHEMA, true),
+    );
   }
   for (const record of STANDARD_PIPELINE_DERIVED.coordinateRecords) {
     const coordinates = material.textureCoordinates?.get(record.parameter);
@@ -143,3 +153,42 @@ export function packStandardPbrMaterialRow(
   }
   return payload;
 }
+
+/**
+ * Pack any producer-owned numeric/coordinate schema into the shared GPU Scene
+ * row page. Resource handles are intentionally absent: the scene-index shader
+ * reads texture/sampler bindings from the ordinary material group while this
+ * row carries only the values its generated `MaterialParameters` struct owns.
+ * `undefined` means the schema exceeds the page and must remain outside the
+ * capable lane.
+ */
+export function packMaterialProgramRow(
+  schema: readonly ParamSchemaEntry[],
+  material: MaterialSnapshot,
+  rowStride = ROW.stride,
+): Uint8Array | undefined {
+  const derived = derive(schema);
+  if (derived.totalBytes > rowStride || rowStride < 16 || rowStride % 16 !== 0) return undefined;
+  const payload = new Uint8Array(rowStride);
+  const view = new DataView(payload.buffer);
+  for (const member of derived.numericMembers) {
+    writeNumeric(view, member, numericValue(member.name, material, schema));
+  }
+  for (const record of derived.coordinateRecords) {
+    const coordinates = material.textureCoordinates?.get(record.parameter);
+    const transform = coordinates?.transform;
+    writeVec4(view, record.offset, [
+      transform?.offset?.[0] ?? 0,
+      transform?.offset?.[1] ?? 0,
+      transform?.scale?.[0] ?? 1,
+      transform?.scale?.[1] ?? 1,
+    ]);
+    writeVec4(view, record.offset + 16, [
+      coordinates?.set ?? 0,
+      transform?.rotation ?? 0,
+      coordinates?.physicalUvScale?.[0] ?? 1,
+      coordinates?.physicalUvScale?.[1] ?? 1,
+    ]);
+  }
+  return payload;
+}

package/src/pbr-pipeline.ts

@@ -444,6 +444,8 @@ export interface PbrCaps {
   readonly probeBlend?: boolean;
   /** Whether the device can carry the optional SpotLight projector texture. */
   readonly projectorAvailable?: boolean;
+  /** Omit unused backdrop slots on minimum-limit devices; physical slots stay fixed. */
+  readonly transmissionBackdrop?: boolean;
 }
 
 /**
@@ -777,6 +779,7 @@ export function shadowCasterVariantSet(
   skinned: boolean,
   gpuDrivenSceneIndex = false,
   alphaMask = false,
+  vertexColorAvailable = false,
 ): string {
   const skinningDisabled = !skinned;
   const defines: Record<string, boolean> = {
@@ -786,6 +789,7 @@ export function shadowCasterVariantSet(
     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)}`)
@@ -1501,7 +1505,7 @@ export function buildBindGroupLayoutDescriptor(
       const afterIbl = [...userRegion, ...appendInjection(userRegion, 'ibl')];
       const afterTransmission = [...afterIbl, ...appendInjection(afterIbl, 'transmission')];
       const merged = [
-        ...afterTransmission,
+        ...(options.caps?.transmissionBackdrop === false ? afterIbl : afterTransmission),
         ...appendTextureInjection(afterTransmission, physicalFields),
       ];
       // Scene-index Standard variants consume one producer-owned material row
@@ -1516,7 +1520,14 @@ export function buildBindGroupLayoutDescriptor(
       }
       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': {