@forgeax/engine-render 0.1.27 → 0.1.29

package/dist/render-pipeline.d.ts

@@ -1,15 +1,17 @@
-import type { ColorValueDomain, GraphAccess, GraphResourceResolver, GraphTexture, GraphTextureDescriptor, GraphTextureView, GraphTextureViewDescriptor, RenderGraphBuilder, RenderGraphError, RenderGraphFrame } from '@forgeax/engine-render-graph';
-import type { BindGroup, RhiCaps, RhiError, RhiRenderPassEncoder, TextureFormat } from '@forgeax/engine-rhi';
+import type { ColorValueDomain, GraphAccess, GraphBuffer, GraphResourceResolver, GraphTexture, GraphTextureDescriptor, GraphTextureView, GraphTextureViewDescriptor, RenderGraphBuilder, RenderGraphError, RenderGraphFrame } from '@forgeax/engine-render-graph';
+import type { BindGroup, Buffer, RhiCaps, RhiError, RhiRenderPassEncoder, TextureFormat } from '@forgeax/engine-rhi';
 import { type Result } from '@forgeax/engine-types';
 import type { Tonemap } from './components/camera';
 import type { DirectionalShadowFilterLabel } from './components/directional-shadow-filter';
 import type { RenderError } from './errors/render';
 import type { RenderFeatureTargetKind } from './features/targets';
+import type { ShadowViewIdentity, ShadowViewProjection } from './gpu-driven/shadow-views';
 import type { StandardTopologyInputValue } from './pipeline/standard-lighting/topology';
 import { STANDARD_POST_STAGE_NAMES, type StandardProfile } from './pipeline/standard-profile';
 import type { SurfaceProfile } from './record/render-context';
-import type { RenderPipelineContext } from './render-contract';
+import type { FrameObservationDomain, RenderPipelineContext } from './render-contract';
 import type { OcclusionFrameProjection } from './scene/visibility/occlusion-runtime';
+import type { SsrSpatialAdmission } from './ssr/admission';
 import type { TransmissionDemand } from './transmission/projection';
 export type { RenderPipelineContext } from './render-contract';
 export type RenderColorDomain = 'linearHdr' | 'linearLdr' | 'displayEncoded';
@@ -73,6 +75,8 @@ export interface RenderPipelineTopology {
      * clear directly to the surface.
      */
     readonly clearOnly?: boolean | undefined;
+    /** Selected atmosphere requires the graph-owned sky producer and background. */
+    readonly atmosphere?: boolean | undefined;
     /** Whether Standard main draws carry the producer-owned fallback MRT. */
     readonly reflectionFallback?: {
         readonly enabled: boolean;
@@ -85,6 +89,19 @@ export interface RenderPipelineTopology {
         readonly profile?: SurfaceProfile | undefined;
     };
     readonly camera: Pick<RenderPipelineContext['camera'], 'tonemap' | 'antialias' | 'bloom'>;
+    /** Frame-stable Standard output policy; no raw RHI handles enter topology. */
+    readonly output?: {
+        readonly autoExposure: boolean;
+        /** Camera-owned Bradford white balance is part of the same output pass. */
+        readonly whiteBalance?: boolean;
+        readonly temperature?: number;
+        readonly tint?: number;
+        readonly colorLut: boolean;
+        readonly colorLutStrength: number;
+        readonly lutSourceKey?: string;
+    };
+    /** Detached spatial SSR admission; graph resources remain renderer-owned. */
+    readonly ssr?: SsrSpatialAdmission | undefined;
     readonly temporal?: {
         readonly taa: boolean;
         readonly motionBlur: boolean;
@@ -175,10 +192,22 @@ export interface RenderPipelineFeatureTarget {
 }
 export interface RenderPipelineGpuDrivenProjection {
     readonly accesses: readonly GraphAccess[];
-    encode(viewBindGroup: BindGroup, pass: RhiRenderPassEncoder, resources: GraphResourceResolver): void;
+    encode(viewBindGroup: BindGroup, pass: RhiRenderPassEncoder, resources: GraphResourceResolver, frameResources: GpuDrivenStandardPbrFrameResources): void;
+}
+/** Producer-owned Standard PBR resources resolved during graph execution. */
+export interface GpuDrivenStandardPbrFrameResources {
+    readonly materialBindGroups: (BindGroup | undefined)[];
+    /** Frame-global material slots keyed by the retained scene entity identity. */
+    readonly materialSlotIndicesByEntity: Map<number, readonly number[]>;
+    readonly instancesBindGroup: BindGroup;
+    readonly materialStride: number;
+    /** Exact producer-owned numeric Material table consumed by scene-index PBR. */
+    readonly sceneMaterialBuffer: Buffer;
 }
 export interface RenderPipelineBuildContext<FrameCtx extends RenderPipelineFrame> {
     readonly graph: RenderGraphBuilder<FrameCtx>;
+    /** Explicit receipt-bound color domains requested for this frame. */
+    readonly observationCaptureDomains?: readonly FrameObservationDomain[] | undefined;
     /**
      * The single prepared Standard lighting projection for this frame.  The
      * Forward and Deferred adapters consume this value; they never inspect raw
@@ -191,6 +220,23 @@ export interface RenderPipelineBuildContext<FrameCtx extends RenderPipelineFrame
      * inferring rgba16float support from the selected surface format.
      */
     readonly capabilities?: Pick<RhiCaps, 'rgba16floatRenderable'>;
+    /** Prepared typed graph resources owned by RenderSystem/RenderFrameState. */
+    readonly standardOutput?: {
+        readonly autoExposure?: {
+            readonly histogram: GraphBuffer;
+            readonly state: GraphBuffer;
+            readonly candidate: GraphBuffer;
+            /** Authored camera/time parameters consumed by the GPU adapt stage. */
+            readonly parameters: GraphBuffer;
+        };
+        readonly colorLut?: {
+            readonly view: GraphTextureView;
+            readonly sampler: import('@forgeax/engine-rhi').Sampler;
+            readonly strength: number;
+            readonly bindGroupLayout: import('@forgeax/engine-rhi').BindGroupLayout;
+            readonly bindGroup: BindGroup;
+        };
+    };
     /**
      * Renderer-owned TAA history targets. The graph sees only imported typed
      * targets; opaque RHI handles remain inside RenderFrameState.
@@ -200,6 +246,16 @@ export interface RenderPipelineBuildContext<FrameCtx extends RenderPipelineFrame
         readonly previousColor: RenderPipelineTarget;
         readonly currentTemporal: RenderPipelineTarget;
         readonly previousTemporal: RenderPipelineTarget;
+        readonly currentStability: RenderPipelineTarget;
+        readonly previousStability: RenderPipelineTarget;
+    };
+    /** Renderer-owned SSR temporal history targets for the admitted spatial chain. */
+    readonly ssrHistory?: {
+        readonly previous: RenderPipelineTarget;
+        readonly output: RenderPipelineTarget;
+        readonly previousSurface: RenderPipelineTarget;
+        readonly outputSurface: RenderPipelineTarget;
+        readonly params: GraphBuffer;
     };
     /** Renderer-owned, prewarmed encoder for one graph mip level. */
     readonly encodeTransmissionMip?: (input: {
@@ -216,7 +272,10 @@ export interface RenderPipelineBuildContext<FrameCtx extends RenderPipelineFrame
         readonly format: TextureFormat;
         readonly sampleCount: 1 | 4;
     }): Result<RenderPipelineGpuDrivenProjection | undefined, RenderPipelineBuildError>;
-    contributeFeatures(targets: readonly RenderPipelineFeatureTarget[], semanticTargets?: readonly RenderPipelineTarget[], namedTargets?: Readonly<Record<string, RenderPipelineTarget>>): Result<void, RenderPipelineBuildError>;
+    projectGpuDrivenShadow?(identity: ShadowViewIdentity): Result<ShadowViewProjection | undefined, RenderGraphError>;
+    contributeFeatures(targets: readonly RenderPipelineFeatureTarget[], semanticTargets?: readonly RenderPipelineTarget[], namedTargets?: Readonly<Record<string, RenderPipelineTarget>>, standardSurfaceAccesses?: readonly GraphAccess[]): Result<void, RenderPipelineBuildError>;
+    /** Prepare feature-owned shadow draws and their early compute producers once. */
+    contributeShadowFeatures?(): Result<import('./features/render-graph-raster').RenderFeatureShadowDraws<FrameCtx> | undefined, RenderPipelineBuildError>;
     /** Add renderer-owned cube capture work to the active pipeline graph. */
     contributeCubeCaptures?(): Result<void, RenderPipelineBuildError>;
     /** Whether a producer-owned feature is installed for this graph build. */

package/dist/render-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-pipeline.d.ts","sourceRoot":"","sources":["../src/render-pipeline.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"render-pipeline.d.ts","sourceRoot":"","sources":["../src/render-pipeline.ts"],"names":[],"mappings":"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"}

package/dist/render-system-extract-tail.d.ts

@@ -2,16 +2,18 @@ import type { AssetRegistry } from '@forgeax/engine-assets-runtime';
 import type { World } from '@forgeax/engine-ecs';
 import type { MaterialCookProgramContext } from '@forgeax/engine-pack/material-cook';
 import type { MaterialShaderArtifact } from '@forgeax/engine-shader';
-import type { InstanceProjectionStore } from './instances';
+import { type InstanceCollectionStore } from './instances';
 import type { ExtractedFrame, ExtractFramesOwner, ExtractPipelineSurface, MaterialSnapshot, MaterialSnapshotCachesByWorld, PreparedExtractContext } from './render-system-extract';
 export declare function extractFrames(worlds: readonly World[], owner: number | ExtractFramesOwner, assets?: AssetRegistry | null, pipelineState?: ExtractPipelineSurface | null, materialSnapshotCachesByWorld?: MaterialSnapshotCachesByWorld, options?: {
     readonly materialContext?: MaterialCookProgramContext;
     readonly cull?: 'normal' | 'none';
-    readonly renderables?: 'full' | 'none';
-    readonly renderableEntitiesByWorld?: readonly (ReadonlySet<number> | undefined)[];
+    readonly renderables?: 'full' | 'none' | {
+        readonly kind: 'partial';
+        readonly entitiesByWorld: readonly (ReadonlySet<number> | undefined)[];
+    };
     readonly retainHidden?: boolean;
-    readonly getMaterialShaderArtifact?: (materialShaderId: string) => MaterialShaderArtifact | undefined;
-    readonly instanceCollections?: InstanceProjectionStore;
+    readonly getMaterialShaderArtifact?: (materialShaderId: string, vertexColorAvailable?: boolean) => MaterialShaderArtifact | undefined;
+    readonly instanceCollections?: InstanceCollectionStore;
 }): ExtractedFrame;
 export declare function extractFrame(world: World, context: PreparedExtractContext): ExtractedFrame;
 export declare function defaultMaterialSnapshot(materialHandle?: number): MaterialSnapshot;

package/dist/render-system-extract-tail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-system-extract-tail.d.ts","sourceRoot":"","sources":["../src/render-system-extract-tail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAKpE,OAAO,KAAK,EAAgB,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAY/D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGrF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAuErE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAa3D,OAAO,KAAK,EAKV,cAAc,EAEd,kBAAkB,EAClB,sBAAsB,EAGtB,gBAAgB,EAEhB,6BAA6B,EAI7B,sBAAsB,EAQvB,MAAM,yBAAyB,CAAC;AA0CjC,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAClC,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,EAC7B,aAAa,CAAC,EAAE,sBAAsB,GAAG,IAAI,EAC7C,6BAA6B,CAAC,EAAE,6BAA6B,EAC7D,OAAO,GAAE;IACP,QAAQ,CAAC,eAAe,CAAC,EAAE,0BAA0B,CAAC;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;IAClF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CACnC,gBAAgB,EAAE,MAAM,KACrB,sBAAsB,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;CACnD,GACL,cAAc,CAyXhB;AAsED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,sBAAsB,GAAG,cAAc,CAs3E1F;AAED,wBAAgB,uBAAuB,CAAC,cAAc,SAAI,GAAG,gBAAgB,CAW5E"}
+{"version":3,"file":"render-system-extract-tail.d.ts","sourceRoot":"","sources":["../src/render-system-extract-tail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAKpE,OAAO,KAAK,EAAgB,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAU/D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGrF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AA2ErE,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,aAAa,CAAC;AAcrB,OAAO,KAAK,EAKV,cAAc,EAEd,kBAAkB,EAClB,sBAAsB,EAGtB,gBAAgB,EAEhB,6BAA6B,EAM7B,sBAAsB,EASvB,MAAM,yBAAyB,CAAC;AAqDjC,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAClC,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,EAC7B,aAAa,CAAC,EAAE,sBAAsB,GAAG,IAAI,EAC7C,6BAA6B,CAAC,EAAE,6BAA6B,EAC7D,OAAO,GAAE;IACP,QAAQ,CAAC,eAAe,CAAC,EAAE,0BAA0B,CAAC;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EACjB,MAAM,GACN,MAAM,GACN;QACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;QACzB,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;KACxE,CAAC;IACN,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CACnC,gBAAgB,EAAE,MAAM,EACxB,oBAAoB,CAAC,EAAE,OAAO,KAC3B,sBAAsB,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;CACnD,GACL,cAAc,CA8ahB;AAsED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,sBAAsB,GAAG,cAAc,CA8hF1F;AAUD,wBAAgB,uBAAuB,CAAC,cAAc,SAAI,GAAG,gBAAgB,CAI5E"}

package/dist/render-system-extract.d.ts

@@ -4,19 +4,20 @@ import type { Component, ComponentSchema, EntityHandle, World } from '@forgeax/e
 import { type Mat4, type Vec3 } from '@forgeax/engine-math';
 import { type AssetGuid as AssetGuidBytes } from '@forgeax/engine-pack/guid';
 import { type MaterialShaderArtifact } from '@forgeax/engine-shader';
-import type { Handle, MaterialAsset, MaterialColorParameterSchema, MaterialParameter, MaterialPass, MaterialRenderState, MaterialTextureCoordinates, MaterialTextureValue, MeshLodLevel, ParamSchemaEntry, PrimitiveTopology, TextureAsset } from '@forgeax/engine-types';
+import type { Handle, MaterialAsset, MaterialColorParameterSchema, MaterialParameter, MaterialPass, MaterialRenderState, MaterialTextureCoordinates, MaterialTextureValue, MeshLodLevel, ParamSchemaEntry, TextureAsset } from '@forgeax/engine-types';
 import type { DirectionalShadowQuality } from './components/directional-shadow-filter';
 import type { LightValidationError } from './components/light-helpers';
 import type { EnvironmentFrame, FogFrame, FogSelectionFailure } from './extract/environment';
+import type { GpuDrivenDrawSnapshot } from './extract/gpu-driven';
 import { type VisibilitySnapshot } from './extract/visibility';
 import type { RenderFeatureHiddenEntityReport, RenderFeatureWorldVisibilitySnapshot } from './features/types';
-import type { InstanceCollectionId, InstanceProjectionStore } from './instances';
+import type { InstanceCollectionId, InstanceCollectionStore } from './instances';
 import type { MeshMaterialBindingDiagnostic, MeshMaterialBindingSource } from './mesh-material-bindings';
 import type { PointsLinesRetainedSnapshot } from './points-lines/snapshot';
 import type { ReflectionProbeFact } from './reflection/projection';
 import type { CameraSnapshot, CubeCameraSnapshot } from './render-contract';
 import type { SkinPaletteAllocator } from './systems/skin-palette-allocator';
-import type { SkinPaletteSlice } from './systems/skin-palette-types';
+import type { SkinPaletteReceipt } from './systems/skin-palette-types';
 import type { RenderTarget, RenderTargetTextureSource } from './targets/contracts';
 import { type ValidatedVolumetricFog } from './volume/component';
 import type { VolumeProjectorTuple } from './volume/temporal';
@@ -45,6 +46,8 @@ export interface DirectionalLightSnapshot {
 export interface PointLightSnapshot {
     readonly kind: 'point';
     readonly entity?: EntityHandle | number;
+    /** World identity stamped by the composited extract owner. */
+    readonly worldId?: number;
     readonly position: Vec3;
     readonly color: Vec3;
     readonly intensity: number;
@@ -97,12 +100,16 @@ export interface PointLightSnapshot {
 export interface PointShadowSnapshot {
     /** Spawning entity index (joins PointLight + PointLightShadow + Transform). */
     readonly entity: number;
+    /** World identity stamped by the composited extract owner. */
+    readonly worldId?: number;
     /** World-space light position (sourced from companion Transform). */
     readonly position: Vec3;
     /** PointLightShadow.mapSize (per-face cube square dimension; 512 default). */
     readonly mapSize: number;
     readonly nearPlane: number;
     readonly farPlane: number;
+    readonly depthBias: number;
+    readonly normalBias: number;
     /**
      * Atlas layer assigned by extract in spawn order while capacity remains.
      * Sentinel -1 is used for a request that cannot be admitted and is
@@ -137,6 +144,8 @@ export interface SpotLightSnapshot {
     readonly kind: 'spot';
     /** Entity identity is branded in extracted frames; numeric fixtures remain compatible. */
     readonly entity?: EntityHandle | number;
+    /** World identity stamped by the composited extract owner. */
+    readonly worldId?: number;
     readonly position: Vec3;
     readonly direction: Vec3;
     readonly color: Vec3;
@@ -357,6 +366,8 @@ export interface SkylightSnapshot {
 /** Local diffuse probe facts; specular remains owned by Skylight/ReflectionProbe. */
 export interface LightProbeSnapshot {
     readonly identity: string;
+    /** World identity stamped by the composited extract owner. */
+    readonly worldId?: number;
     readonly position: readonly [number, number, number];
     readonly radius: number;
     readonly irradiance: Float32Array;
@@ -411,6 +422,8 @@ export interface ExtractedVolumetricFog {
     readonly projectorAsset?: TextureAsset;
 }
 export interface RenderableSnapshot {
+    /** Authored hierarchical visibility; retained hidden rows remain addressable. */
+    readonly authorVisible?: boolean;
     readonly assetHandle: number;
     readonly transform: TransformSnapshot;
     /** Producer-authored lower-detail references projected from MeshAsset. */
@@ -448,8 +461,6 @@ export interface RenderableSnapshot {
     readonly materialBindingSources: readonly MeshMaterialBindingSource[];
     /** Active structured override diagnostics for this renderable. */
     readonly materialBindingDiagnostics?: readonly MeshMaterialBindingDiagnostic[];
-    /** Effective authored visibility retained by the persistent scene owner. */
-    readonly authorVisible?: boolean;
     /**
      * feat-20260708-composited-multi-world-rendering M1 / D-1: the worldId
      * of the world this renderable was extracted from. Defaults to 0 in
@@ -514,9 +525,11 @@ export interface RenderableSnapshot {
      * draw to `forgeax::pbr-skin` pipeline + set the palette dynamic offset.
      * Absent (`undefined`) means the entity is not skinned.
      */
-    readonly skin?: SkinPaletteSlice;
-    /** Joint entity identities used by the persistent skin dependency index. */
+    readonly skin?: SkinPaletteReceipt;
+    /** Joint identities consumed by the retained scene dependency index. */
     readonly skinJointEntities?: readonly number[];
+    /** Source pass ownership retained with the scene record across view changes. */
+    readonly shadowCasterPasses?: readonly Omit<ShadowCasterMembership, 'worldEntity' | 'renderableIndex'>[];
     /**
      * ECS-owned morph weights. Presence selects the Standard Pipeline CPU
      * specialized deformation lane; the asset remains the source of target
@@ -539,33 +552,14 @@ export interface RenderableTemporalSnapshot {
     readonly reactiveReasons: readonly RenderableReactiveReason[];
     readonly previousTransform: TransformSnapshot;
     readonly previousInstances: InstancesSnapshot | undefined;
-    readonly previousSkin: SkinPaletteSlice | undefined;
+    readonly previousSkin: SkinPaletteReceipt | undefined;
     readonly previousMorphWeights: Float32Array | undefined;
 }
 export interface MorphSnapshot {
     readonly weights: Float32Array;
     readonly targetCount: number;
 }
-export interface GpuDrivenDrawSnapshot {
-    readonly kind: 'indexed' | 'non-indexed';
-    readonly first: number;
-    readonly count: number;
-    readonly baseVertex: number;
-    readonly materialSlot: number;
-    readonly topology: PrimitiveTopology;
-    readonly pipelineClass: string;
-    readonly materialResourceClass: string;
-    /** Producer-owned prepared ABI facts used by the Standard PBR GPU lane. */
-    readonly prepared?: import('./gpu-driven/prepared-draw').PreparedGpuDrivenDraw;
-    /** Optional projected height supplied by direct GPU-view evidence/tests. */
-    readonly projectedHeight?: number;
-    /** Root plus lower-detail index/vertex ranges, in LOD order. */
-    readonly lodRanges?: readonly {
-        readonly first: number;
-        readonly count: number;
-        readonly baseVertex: number;
-    }[];
-}
+export type { GpuDrivenDrawSnapshot } from './extract/gpu-driven';
 export interface InstancesSnapshot {
     /** Renderer-owned collection identity. */
     readonly collectionId?: InstanceCollectionId;
@@ -575,6 +569,13 @@ export interface InstancesSnapshot {
     readonly instanceCount: number;
     /** Collection revision captured by this detached frame snapshot. */
     readonly revision?: number;
+    /** Logical collection capacity at snapshot time. */
+    readonly capacity?: number;
+    /** Coalesced matrix ordinals dirtied since the previous authoring update. */
+    readonly dirtyRanges?: readonly {
+        readonly start: number;
+        readonly end: number;
+    }[];
     /** Stable per-entity GPU buffer cache key (the packed Entity u32). */
     readonly cacheKey: number;
     /**
@@ -686,6 +687,8 @@ export interface MaterialSnapshot {
     readonly paramSnapshot?: Readonly<Record<string, number | number[] | string>> | undefined;
     /** Effective MaterialAsset parameter contract used to lay out this snapshot. */
     readonly materialParamSchema?: readonly ParamSchemaEntry[] | undefined;
+    /** Authored texture presence, separate from the shared GPU layout schema. */
+    readonly standardTextureMask?: number | undefined;
     /** Authored per-slot UV set and KHR texture transform metadata. */
     readonly textureCoordinates?: ReadonlyMap<string, MaterialTextureCoordinates> | undefined;
     /**
@@ -705,6 +708,8 @@ export interface MaterialSnapshot {
      * them in a lightmap injection region.
      */
     readonly textureHandles?: ReadonlyMap<string, Handle<'TextureAsset', 'shared'>> | undefined;
+    /** Explicitly authored texture fields that must resolve before GPU admission. */
+    readonly authoredTextureFields?: ReadonlySet<string> | undefined;
     /** Renderer-local target sources; never projected as TextureAsset handles. */
     readonly textureSources?: ReadonlyMap<string, RenderTargetTextureSource> | undefined;
     /**
@@ -725,6 +730,8 @@ export interface MaterialSnapshot {
     readonly videoTextureFields?: ReadonlyMap<string, Handle<'VideoAsset', 'shared'>> | undefined;
     /** Authored sampler handles keyed by their matching texture parameter. */
     readonly samplerHandles?: ReadonlyMap<string, Handle<'SamplerAsset', 'shared'>> | undefined;
+    /** Explicitly authored sampler fields that must resolve before GPU admission. */
+    readonly authoredSamplerFields?: ReadonlySet<string> | undefined;
     readonly baseColorTexture?: Handle<'TextureAsset', 'shared'> | undefined;
     /**
      * PBR metallic-roughness texture handle (present for PBR/sprite/skin
@@ -857,6 +864,11 @@ export interface ExtractedFrame {
      * three-bucket model per plan-strategy D-3.
      */
     readonly dispatch: DispatchEntry[];
+    readonly shadowCasterEntityKeys: ReadonlySet<number>;
+    /** ShadowCaster ownership keyed by concrete draw item and pass. */
+    readonly shadowCasterDrawKeys: ReadonlySet<string>;
+    /** Structured ShadowCaster ownership facts retained for exact residual routing. */
+    readonly shadowCasterMembership?: readonly ShadowCasterMembership[];
     readonly skylight: SkylightSnapshot | undefined;
     readonly skylightCount: number;
     /** World-local diffuse probe candidates; never a direct-light slot. */
@@ -881,6 +893,8 @@ export interface ExtractedFrame {
     readonly visibilityStats: {
         readonly explicitlyHidden: number;
     };
+    /** Detached material-source probe accounting for this extraction. */
+    readonly materialTextureSources?: MaterialTextureSourceStats;
     /**
      * Per-frame post-process params snapshot collected from PostProcessParams
      * entities (D-1: data-driven params channel). Maps shader id to the
@@ -896,6 +910,19 @@ export interface ExtractedFrame {
     /** Built-in hidden candidates, retained for host-side producer deduplication. */
     readonly hiddenEntityReports: readonly RenderFeatureHiddenEntityReport[];
 }
+/** Extracted ownership fact for one concrete ShadowCaster pass. */
+export interface ShadowCasterMembership {
+    readonly worldEntity: number;
+    readonly renderableIndex: number;
+    readonly drawItemIndex: number;
+    readonly materialHandle: number;
+    readonly passIndex: number;
+    readonly materialShaderId?: string;
+    readonly renderState?: MaterialRenderState;
+    readonly cpuReason?: ShadowCasterCpuReason;
+}
+/** Producer evidence for a concrete ShadowCaster pass that remains on CPU. */
+export type ShadowCasterCpuReason = 'transparent' | 'morph' | 'unsupported-shader' | 'unsupported-render-state' | 'missing-skin-bounds' | 'missing-gpu-draw' | 'unprepared' | 'prepared-contract' | 'multi-pass';
 export type CameraTargetUpdate = 'once' | 'on-demand' | 'continuous';
 export interface CameraTargetCandidate {
     readonly worldId: number;
@@ -953,6 +980,10 @@ export declare function resolveCameraTarget(world: World, raw: number | undefine
  */
 export declare const BUILTIN_USER_REGION_TEXTURE_FIELDS: readonly string[];
 export declare function materialTextureFields(shaderId: string | undefined, fields: ReadonlySet<string> | undefined): ReadonlySet<string> | undefined;
+/** Preserve authored-vs-default intent for the GPU resource readiness gate. */
+export declare function collectAuthoredMaterialTextureFields(values: Readonly<Record<string, unknown>>, shaderId: string | undefined, paramSchema: readonly ParamSchemaEntry[] | undefined, assets: AssetRegistry): ReadonlySet<string> | undefined;
+/** Preserve explicit sampler intent; omitted samplers use the default sampler. */
+export declare function collectAuthoredMaterialSamplerFields(values: Readonly<Record<string, unknown>>, textureFields: ReadonlySet<string> | undefined): ReadonlySet<string> | undefined;
 /**
  * The authored material surface uses the module IDs declared by built-in WGSL
  * sources. Runtime pipeline caches still use the existing engine registration
@@ -972,6 +1003,7 @@ export declare function pipelineRenderState(renderState: (MaterialRenderState &
     readonly queue?: number;
     readonly stencilReference?: number;
 }) | undefined): MaterialRenderState | undefined;
+export declare function shadowCasterCpuReason(material: MaterialSnapshot, draw: GpuDrivenDrawSnapshot | undefined, shadowEntries: readonly DispatchEntry[], morph: MorphSnapshot | undefined, skin: SkinPaletteReceipt | undefined): ShadowCasterCpuReason | undefined;
 export declare function internSharedRefFromGuid<B extends string>(world: World, assetsRef: AssetRegistry, guid: string, brand: B): Handle<B, 'shared'> | undefined;
 /**
  * feat-20260623-world-space-video-asset M4 / w14 (D-5): if a user-region
@@ -998,7 +1030,27 @@ export declare function isAssetGuidBytes(value: Uint8Array): value is AssetGuidB
 export declare function materialNormalScale(values: Readonly<Record<string, unknown>>): number;
 export declare function materialTextureRef(value: unknown): unknown;
 export declare function collectMaterialTextureCoordinates(values: Readonly<Record<string, unknown>>): Map<string, MaterialTextureCoordinates>;
-export declare function collectMaterialTextureSources(values: Readonly<Record<string, unknown>>, world: World): Map<string, RenderTargetTextureSource>;
+/**
+ * Return the schema-owned fields that may carry a texture source handle.
+ * Numeric material values are otherwise scalar parameters (roughness,
+ * metallic, custom steps, ...), so probing them through SharedRefStore is
+ * both wasted work and an accidental dependency on slot-number collisions.
+ */
+export declare function materialTextureSourceFields(schema: readonly ParamSchemaEntry[] | undefined): ReadonlySet<string> | undefined;
+export interface MaterialTextureSourceStats {
+    sourceFieldsVisited: number;
+    numericSharedRefProbes: number;
+    sourceCacheHits: number;
+    sourceCacheMisses: number;
+    producerRoutes: Record<string, number>;
+}
+/**
+ * Extract-local cache for numeric shared references. `null` is a deliberate
+ * negative entry: a handle that is not a render-target source must not be
+ * resolved repeatedly for every material field in the same frame.
+ */
+export type MaterialTextureSourceCache = Map<number, RenderTargetTextureSource | null>;
+export declare function collectMaterialTextureSources(values: Readonly<Record<string, unknown>>, world: World, textureFields?: ReadonlySet<string>, stats?: MaterialTextureSourceStats, cache?: MaterialTextureSourceCache): Map<string, RenderTargetTextureSource>;
 export declare function collectMaterialTextureSamplers(values: Readonly<Record<string, unknown>>, resolveSampler: (value: unknown) => Handle<'SamplerAsset', 'shared'> | undefined): Map<string, Handle<'SamplerAsset', 'shared'>>;
 /**
  * feat-20260621-learn-render-5-5-parallax M2 / w7 (D-3): collect the
@@ -1023,6 +1075,7 @@ export declare function collectMaterialTextureSamplers(values: Readonly<Record<s
  */
 export declare function collectUserRegionTextureHandles(pv: Readonly<Record<string, unknown>>, shaderId: string | undefined, paramSchema: readonly ParamSchemaEntry[] | undefined, assetsRef: AssetRegistry, world: World, resolveTex: (value: unknown, brand: 'TextureAsset') => Handle<'TextureAsset', 'shared'> | undefined, videoOut: Map<string, Handle<'VideoAsset', 'shared'>>): Map<string, Handle<'TextureAsset', 'shared'>>;
 export declare function isEngineInjectedTextureField(shaderId: string | undefined, fieldName: string): boolean;
+export declare function materialStandardTextureMask(parameters: readonly MaterialParameter[] | undefined, shaderId: string | undefined, values: Readonly<Record<string, unknown>>): number | undefined;
 /**
  * Project one material's authoring parameters into the runtime ABI.
  *
@@ -1078,7 +1131,7 @@ export declare function storeMaterialSnapshot(cache: MaterialSnapshotCache, hand
  * the resolvable submeshes; the count-mismatch validator already filtered
  * the count-disagreement case earlier).
  */
-export declare function resolveMaterialSnapshot(handleRaw: number, world: World, assetsRef: AssetRegistry, materialSnapshotCache?: MaterialSnapshotCache, persistentMaterialSnapshotCache?: MaterialSnapshotCache, materialContext?: MaterialCookProgramContext): MaterialSnapshot;
+export declare function resolveMaterialSnapshot(handleRaw: number, world: World, assetsRef: AssetRegistry, materialSnapshotCache?: MaterialSnapshotCache, persistentMaterialSnapshotCache?: MaterialSnapshotCache, materialContext?: MaterialCookProgramContext, materialTextureSourceStats?: MaterialTextureSourceStats, materialTextureSourceCache?: MaterialTextureSourceCache): MaterialSnapshot;
 /**
  * feat-20260612-skin-palette-per-frame-upload M2 / m2-6: narrow per-frame
  * pipeline surface consumed by `extractFrame`. Today only `skinPaletteAllocator`
@@ -1095,11 +1148,12 @@ export declare function pssmSplit(nearPlane: number, farPlane: number, cascadeCo
 /**
  * Build 6 face view-proj matrices for an omnidirectional shadow caster
  * (point-light cube map). Returns 6 mat4 (column-major 16-float each) in face
- * order [+X, -X, +Y, -Y, +Z, -Z] matching WebGPU cube layer convention.
+ * order [+X, -X, +Y, -Y, +Z, -Z] matching the WebGPU cube-camera layer
+ * convention.
  *
- * Each matrix is `proj * view` where:
- *   - `view = lookAt(lightPos, lightPos + faceLook[i], faceUp[i])`
- *   - `proj = perspective(PI/2, 1, near, far)` (WebGPU [0, 1] NDC short name)
+ * Derive face directions from the shared CubeCamera owner, then reflect clip X
+ * to match WebGPU cubemap texel orientation. The point-shadow raster lane
+ * mirrors authored front-face winding when it uses these reflected matrices.
  *
  * The returned `Mat4[]` length is always exactly 6. Caller can flatten into a
  * 96-float (6 mat4) Float32Array for UBO upload (T-M1-7).
@@ -1191,6 +1245,8 @@ export declare function computeDirectionalCsm(direction: Vec3, config: Direction
 export interface ExtractFramesOwner {
     readonly cameraOwner: number;
     readonly resourceOwner: number;
+    /** Explicit display-camera entity selected by the frame owner. */
+    readonly cameraEntityKey?: number;
 }
 export interface PreparedExtractContext {
     readonly materialContext?: MaterialCookProgramContext | undefined;
@@ -1202,16 +1258,18 @@ export interface PreparedExtractContext {
     readonly resourceOwnerFog: FogFrame | null | undefined;
     readonly cull: 'self' | 'none' | 'external';
     readonly cullCameras: readonly CameraSnapshot[] | undefined;
+    /** Explicit display-camera entity for this world's camera-owner extract. */
+    readonly cameraEntityKey?: number;
     readonly renderables: 'full' | 'none';
-    /** Restrict renderable extraction to these entities while still reading frame resources. */
     readonly renderableEntities: ReadonlySet<number> | undefined;
-    /** Keep authored-hidden renderables in the persistent source projection. */
     readonly retainHidden: boolean;
+    /** World identity used to form cross-world producer ownership keys. */
+    readonly worldId: number;
     readonly visibility: VisibilitySnapshot;
     /** Producer-owned artifact lookup; extraction only, never record-time asset reads. */
-    readonly getMaterialShaderArtifact: ((materialShaderId: string) => MaterialShaderArtifact | undefined) | undefined;
+    readonly getMaterialShaderArtifact: ((materialShaderId: string, vertexColorAvailable?: boolean) => MaterialShaderArtifact | undefined) | undefined;
     /** Renderer-owned canonical source for explicit large instance collections. */
-    readonly instanceCollections: InstanceProjectionStore | undefined;
+    readonly instanceCollections: InstanceCollectionStore | undefined;
 }
 export declare function collectCubeCameraSnapshots(world: World): CubeCameraSnapshot[];
 export declare function collectReflectionProbeFacts(world: World): ReflectionProbeFact[];
@@ -1219,7 +1277,7 @@ interface CameraRoleSelection {
     readonly display: readonly CameraSnapshot[];
     readonly auxiliary: readonly CameraSnapshot[];
 }
-export declare function selectCameraRoles(world: World): CameraRoleSelection;
+export declare function selectCameraRoles(world: World, requestedEntityKey?: number): CameraRoleSelection;
 export declare function extractCameraSnapshots(world: World): CameraSnapshot[];
 export declare function extractCameraTargetSnapshots(world: World): readonly CameraSnapshot[];
 export declare function tonemapParams(camera: CameraSnapshot): Uint8Array;
@@ -1231,11 +1289,13 @@ export declare function prepareExtractContext(world: World, options?: {
     readonly resourceOwnerFog?: FogFrame | null;
     readonly cull?: 'self' | 'none' | 'external';
     readonly cullCameras?: readonly CameraSnapshot[];
+    readonly cameraEntityKey?: number;
     readonly renderables?: 'full' | 'none';
     readonly renderableEntities?: ReadonlySet<number>;
     readonly retainHidden?: boolean;
-    readonly getMaterialShaderArtifact?: (materialShaderId: string) => MaterialShaderArtifact | undefined;
-    readonly instanceCollections?: InstanceProjectionStore;
+    readonly worldId?: number;
+    readonly getMaterialShaderArtifact?: (materialShaderId: string, vertexColorAvailable?: boolean) => MaterialShaderArtifact | undefined;
+    readonly instanceCollections?: InstanceCollectionStore;
 }): PreparedExtractContext;
 export declare function fogState(world: World): {
     lkg: FogFrame | undefined;