@forgeax/engine-render 0.1.28 → 0.1.29

package/dist/recovery/render-system-candidate.d.ts

@@ -10,9 +10,9 @@ import type { PipelineBuilderShaderModuleFactory } from '../pipeline-builder';
 import type { PreparedGraphicsResolver } from '../prepare/prepared-graphics-resolver';
 import type { RenderFrameState, ValidatedRenderable } from '../record/frame-snapshot';
 import type { PointsLinesRecordOwner, RenderSystemInternals } from '../record/render-context';
-import type { RecoveryGraphCandidate, RecoveryGraphCandidatePreparation, RecoveryGraphCandidateRuntime, RecoveryGraphSetupSubmission, RecoveryPointsLinesCandidate } from '../render-system';
 import type { ExtractedFrame, MaterialSnapshot } from '../render-system-extract';
 import type { PersistentRenderScene } from '../scene/render-scene';
+import type { RecoveryGraphCandidate, RecoveryGraphCandidatePreparation, RecoveryGraphCandidateRuntime, RecoveryGraphSetupSubmission, RecoveryPointsLinesCandidate } from './types';
 export interface PreparedResolverCaches {
     readonly preparedPipelineIds: WeakMap<object, string>;
     readonly preparedMaterialPipelineShaders: WeakMap<object, string>;
@@ -54,11 +54,19 @@ export interface RenderSystemRecoveryDependencies {
 }
 export interface RenderSystemRecoveryOwner {
     setLastSuccessfulFrameSeed(seed: RecoveryFrameSeed): void;
-    prepareRecoveryGraphCandidate(runtime: RecoveryGraphCandidateRuntime): Promise<RecoveryGraphCandidatePreparation>;
+    prepareRecoveryGraphCandidate(runtime: RecoveryGraphCandidateRuntime): RecoveryGraphCandidatePreparation;
     submitCandidateSetup(candidate: RecoveryGraphCandidate, isValid: () => boolean): Result<RecoveryGraphSetupSubmission, RhiError>;
     publishRecoveryGraphCandidate(candidate: RecoveryGraphCandidate): void;
     discardRecoveryGraphCandidate(candidate: RecoveryGraphCandidate): void;
 }
+/**
+ * Keep the missing-texture sentinel out of residency preparation. A zero
+ * handle is the same absent-reference value used by materialHandle; resolving
+ * it as a real TextureAsset would otherwise pass an undefined pod to the GPU
+ * store and fail before the renderer can produce a structured readiness
+ * result.
+ */
+export declare function materialTextureHandlesForResidency(candidates: Iterable<Handle<'TextureAsset', 'shared'> | undefined>): readonly Handle<'TextureAsset', 'shared'>[];
 export declare function materialTextureHandles(material: MaterialSnapshot): readonly Handle<'TextureAsset', 'shared'>[];
 export declare function materialSamplerHandles(material: MaterialSnapshot): readonly Handle<'SamplerAsset', 'shared'>[];
 export declare function createRenderSystemRecovery(deps: RenderSystemRecoveryDependencies): RenderSystemRecoveryOwner;

package/dist/recovery/render-system-candidate.d.ts.map

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

package/dist/recovery/render-system-roots.d.ts

@@ -0,0 +1,11 @@
+import type { EnvironmentLifecycle } from '../environment/lifecycle';
+import type { RenderFrameState } from '../record/frame-snapshot';
+import type { RecoveryRootBundle, RecoveryRootRuntime } from '../render-system';
+/**
+ * Assemble replacement-device roots without letting candidate construction
+ * publish through the active RenderSystem owner.  The caller supplies the
+ * small state handoff explicitly so this recovery seam remains independent
+ * from frame orchestration.
+ */
+export declare function prepareRenderSystemRecoveryRoots(runtime: RecoveryRootRuntime, environmentLifecycle: EnvironmentLifecycle, frameState: RenderFrameState, publishEnvironmentLifecycle: (lifecycle: EnvironmentLifecycle) => void): RecoveryRootBundle;
+//# sourceMappingURL=render-system-roots.d.ts.map

package/dist/recovery/render-system-roots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-system-roots.d.ts","sourceRoot":"","sources":["../../src/recovery/render-system-roots.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEhF;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,mBAAmB,EAC5B,oBAAoB,EAAE,oBAAoB,EAC1C,UAAU,EAAE,gBAAgB,EAC5B,2BAA2B,EAAE,CAAC,SAAS,EAAE,oBAAoB,KAAK,IAAI,GACrE,kBAAkB,CA+FpB"}

package/dist/recovery/types.d.ts

@@ -0,0 +1,76 @@
+import type { MipmapEncoderWork } from '@forgeax/engine-assets-runtime';
+import type { Buffer, RenderPipeline, RhiDevice } from '@forgeax/engine-rhi';
+import type { DeviceScope, LifecycleResourceSpec } from '../device/device-scope';
+import type { GpuResidencyCache } from '../device/gpu-residency';
+import type { RenderFeatureHost } from '../features/host';
+import type { RenderFeatureGpuWorkOwner } from '../features/prepared-gpu-work';
+import type { GpuDrivenProduction } from '../gpu-driven/production-raster';
+import type { RenderFrameState } from '../record/frame-snapshot';
+import type { RecoveryPipelineReadiness } from '../record/recovery-pipeline';
+import type { PipelineState, RenderSystemInternals } from '../record/render-context';
+import type { RenderFeatureGraphCandidate } from '../record/typed-frame-graph';
+import type { PersistentGpuDrivenCandidate } from '../scene/render-scene';
+/** The single Points/Lines owner's staged device-generation handoff. */
+export interface RecoveryPointsLinesCandidate {
+    createRecoveryRoot(scope: DeviceScope): LifecycleResourceSpec<unknown>;
+    publish(): void;
+    release(): void;
+}
+/** Candidate-only device/runtime inputs used by the recovery prepare seam. */
+export interface RecoveryGraphCandidateRuntime {
+    readonly internals: RenderSystemInternals;
+    readonly pipelineState: PipelineState;
+}
+/** Detached graph state prepared on a replacement device, before publication. */
+export interface RecoveryGraphCandidate {
+    readonly frameState: RenderFrameState;
+    readonly setupWorks: readonly MipmapEncoderWork[];
+    readonly device: RhiDevice;
+    readonly generation: number;
+    readonly gpuDrivenProduction?: GpuDrivenProduction;
+    readonly gpuDrivenScene?: PersistentGpuDrivenCandidate;
+    /** Staged CPU-expanded Points/Lines buffers owned by the same RenderSystem. */
+    readonly pointsLines?: RecoveryPointsLinesCandidate;
+    readonly featureHost?: RenderFeatureHost;
+    readonly featureGpuWork?: RenderFeatureGpuWorkOwner;
+    readonly featureGraphCandidate?: RenderFeatureGraphCandidate;
+    readonly postProcessPipelines?: ReadonlyMap<string, RenderPipeline>;
+    readonly recoveryReadiness: RecoveryPipelineReadiness;
+    /** Release all candidate roots before publication; safe to call repeatedly. */
+    readonly release: () => void;
+    /** Transfer candidate-root ownership to the published RenderSystem. */
+    readonly markPublished: () => void;
+}
+/** Candidate setup completion; completion is bounded by the recovery owner. */
+export interface RecoveryGraphSetupSubmission {
+    readonly completion?: PromiseLike<unknown>;
+}
+export type RecoveryGraphCandidatePreparation = {
+    readonly kind: 'no-seed';
+} | {
+    readonly kind: 'ready';
+    readonly candidate: RecoveryGraphCandidate;
+} | {
+    readonly kind: 'failed';
+    readonly reason: string;
+    readonly cause?: unknown;
+};
+/** Explicit candidate-owned inputs for lifecycle-root preparation. */
+export interface RecoveryRootRuntime {
+    readonly scope: DeviceScope;
+    readonly device: RhiDevice;
+    readonly gpuStore: GpuResidencyCache;
+    readonly graphCandidate?: RecoveryGraphCandidate | undefined;
+}
+/** Candidate roots plus the one synchronous owner switch at publication. */
+export interface RecoveryRootBundle {
+    readonly roots: readonly LifecycleResourceSpec<unknown>[];
+    publish(): void;
+    discard(): void;
+}
+/** Device-bound post-process resources prepared off to the side of the active renderer. */
+export interface RecoveryPostProcessResources {
+    readonly device: RhiDevice;
+    readonly paramsBuffers: Map<string, Buffer>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/recovery/types.d.ts.map

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

package/dist/reflection/record-owner.d.ts

@@ -19,7 +19,6 @@ export declare class ReflectionProbeRecordOwner {
     private outputFormat;
     private fallbackFormatAvailable;
     private nextFallbackTicket;
-    private pendingFallback;
     private latestFallbackTickets;
     private fallbackRetiredFrames;
     private fallbackCommittedFrames;
@@ -43,7 +42,6 @@ export declare class ReflectionProbeRecordOwner {
     private completeSubmission;
     private stageFallbackProjections;
     private selectFallbackReceiptKey;
-    private discardFallbackTickets;
     /** Commit exact-zero neutral rows even when a non-neutral MRT readback fails. */
     private commitNeutralFallbacks;
     private commitFallbackProjection;

package/dist/reflection/record-owner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record-owner.d.ts","sourceRoot":"","sources":["../../src/reflection/record-owner.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAGV,yBAAyB,EAE1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGlG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AASjE,OAAO,EAKL,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,EAKpC,MAAM,cAAc,CAAC;AAqDtB,4EAA4E;AAC5E,qBAAa,0BAA0B;IAiCzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAhCtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,qBAAqB,CAAqB;IAClD,OAAO,CAAC,sBAAsB,CAAK;IACnC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,0BAA0B,CAAK;IACvC,OAAO,CAAC,aAAa,CAA4D;IACjF,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,uBAAuB,CAAU;IACzC,OAAO,CAAC,kBAAkB,CAAK;IAK/B,OAAO,CAAC,eAAe,CAAsC;IAC7D,OAAO,CAAC,qBAAqB,CAA6B;IAC1D,OAAO,CAAC,qBAAqB,CAA6B;IAC1D,OAAO,CAAC,uBAAuB,CAA6B;IAC5D,OAAO,CAAC,mBAAmB,CAGvB;IACJ,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,eAAe,CAA4B;gBAEtB,SAAS,EAAE,qBAAqB;IAQ7D,OAAO,IAAI,yBAAyB;IA0CpC,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,sBAAsB;IAwB9B,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,2BAA2B;IA4BnC,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CACL,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,8BAA8B,CAAC,EAC/D,aAAa,EAAE,cAAc,GAAG,SAAS,EACzC,OAAO,SAA8B,EACrC,QAAQ,GAAE,gBAAgB,GAAG,SAAqB,GACjD,0BAA0B;YAmMf,kBAAkB;IAoEhC,OAAO,CAAC,wBAAwB;IAkIhC,OAAO,CAAC,wBAAwB;IA2ChC,OAAO,CAAC,sBAAsB;IAM9B,iFAAiF;IACjF,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,wBAAwB;IAoChC,4EAA4E;IAC5E,OAAO,CAAC,mBAAmB;YA2Bb,0BAA0B;IA6LxC,OAAO,IAAI,IAAI;IA0Bf,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,WAAW;IAuEnB,OAAO,CAAC,qBAAqB;IAgD7B,OAAO,CAAC,aAAa;CAqEtB"}
+{"version":3,"file":"record-owner.d.ts","sourceRoot":"","sources":["../../src/reflection/record-owner.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAGV,yBAAyB,EAE1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGlG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AASjE,OAAO,EAKL,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,EAKpC,MAAM,cAAc,CAAC;AAqDtB,4EAA4E;AAC5E,qBAAa,0BAA0B;IA+BzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IA9BtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,qBAAqB,CAAqB;IAClD,OAAO,CAAC,sBAAsB,CAAK;IACnC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,0BAA0B,CAAK;IACvC,OAAO,CAAC,aAAa,CAA4D;IACjF,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,uBAAuB,CAAU;IACzC,OAAO,CAAC,kBAAkB,CAAK;IAI/B,OAAO,CAAC,qBAAqB,CAAsC;IACnE,OAAO,CAAC,qBAAqB,CAA6B;IAC1D,OAAO,CAAC,uBAAuB,CAA6B;IAC5D,OAAO,CAAC,mBAAmB,CAGvB;IACJ,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,eAAe,CAA4B;gBAEtB,SAAS,EAAE,qBAAqB;IAQ7D,OAAO,IAAI,yBAAyB;IA0CpC,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,sBAAsB;IAwB9B,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,2BAA2B;IA4BnC,OAAO,CAAC,mBAAmB;IAkB3B,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CACL,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,8BAA8B,CAAC,EAC/D,aAAa,EAAE,cAAc,GAAG,SAAS,EACzC,OAAO,SAA8B,EACrC,QAAQ,GAAE,gBAAgB,GAAG,SAAqB,GACjD,0BAA0B;YAmMf,kBAAkB;IAmEhC,OAAO,CAAC,wBAAwB;IAwHhC,OAAO,CAAC,wBAAwB;IA2ChC,iFAAiF;IACjF,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,wBAAwB;IAoChC,4EAA4E;IAC5E,OAAO,CAAC,mBAAmB;YA2Bb,0BAA0B;IAsLxC,OAAO,IAAI,IAAI;IAyBf,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,WAAW;IAuEnB,OAAO,CAAC,qBAAqB;IAgD7B,OAAO,CAAC,aAAa;CAqEtB"}

package/dist/render-contract.d.ts

@@ -8,14 +8,17 @@ import type { BindGroupLayout, Buffer, Result, RhiCanvasSurfacePresentationProof
 import type { SkinError } from '@forgeax/engine-skinning';
 import type { ImageError } from '@forgeax/engine-types';
 import type { RhiBackendInstrumentation } from './assembly/backend-contract';
-import type { Antialias, BloomEnabled, Tonemap } from './components/camera';
+import type { Antialias, BloomEnabled, CameraExposure, Tonemap } from './components/camera';
+import type { ScreenSpaceReflectionData } from './components/screen-space-reflection';
 import type { EnvironmentInspection } from './environment/inspection';
+import type { GpuDrivenPreparationError } from './errors/gpu-driven';
 import type { RecoveryOutcome, RecoveryPhase } from './errors/recover';
 import type { RenderError } from './errors/render';
 import type { RenderFeature, RenderFeatureDiagnostics } from './features/types';
 import type { PostProcessShaderEntry } from './fullscreen-post-process-pass';
-import type { BloomInspection, DirectionalShadowInspection, LightInspection, LodOcclusionInspection, MotionBlurInspection, ReflectionProbeInspection, RenderSceneInspection, SsrDependenciesInspection, TemporalTargetInspection, TransmissionInspection } from './inspection-types';
-import type { InstanceCollectionInspection } from './instances';
+import type { BloomInspection, DirectionalShadowInspection, LightInspection, LodOcclusionInspection, MotionBlurInspection, ReflectionProbeInspection, RenderFeatureGraphInspection, RenderFeatureHostInspection, RenderSceneInspection, SsrDependenciesInspection, SsrSpatialInspection, TemporalTargetInspection, TransmissionInspection } from './inspection-types';
+import type { InstanceCollectionInspection, InstanceCollectionStore } from './instances';
+import type { RenderSceneBounds } from './scene/render-scene-types';
 import type { SsrAdmissionIdentity } from './ssr/identity';
 import type { RenderTarget, RenderTargetDescriptor, RenderTargetReadbackData, RenderTargetReadbackRequest, RenderTargetReadbackTicket, RenderTargetTextureSource, RenderTargetTextureSourceOptions } from './targets/contracts';
 import type { TemporalInspection } from './temporal/inspection';
@@ -24,6 +27,8 @@ export type { PointsLinesInspection } from './points-lines/inspection';
 import type { DynamicGeometryCandidate, DynamicGeometryError, DynamicGeometryInspection, DynamicGeometryOrdering, DynamicGeometryPrepareInput, DynamicGeometryReceipt } from './dynamic-geometry';
 import type { IblBindingInspection, MeshMaterialBindingObservation } from './mesh-material-bindings';
 import type { StandardLightingInspection } from './pipeline/standard-lighting/inspection';
+import type { AutoExposureInspection } from './pipeline/standard-output/auto-exposure/inspection';
+import type { StandardLutInspection } from './pipeline/standard-output/lut-state';
 import type { StandardProfile } from './pipeline/standard-profile';
 import type { PointShadowInspection } from './point-shadow-inspection';
 import type { PostProcessError } from './post-process-errors';
@@ -51,6 +56,14 @@ export type RenderResult<T, E> = {
 };
 /** The only World data boundary accepted by the M6 renderer contract. */
 export type RenderWorldLease = RenderReadLease;
+/** Camera-owned color/exposure facts projected once at the frame boundary. */
+export interface CameraOutputSnapshot {
+    readonly exposure: CameraExposure;
+    readonly temperature: number;
+    readonly tint: number;
+    readonly colorLut: number;
+    readonly colorLutStrength: number;
+}
 /**
  * Camera facts shared by extract, record, and scene owners.
  *
@@ -84,12 +97,16 @@ export interface CameraSnapshot {
     readonly tonemap: Tonemap;
     readonly exposure: number;
     readonly whitePoint: number;
+    /** Camera schema output projection consumed by Standard prepare/inspection. */
+    readonly output?: CameraOutputSnapshot;
     readonly antialias: Antialias;
     readonly bloom: BloomEnabled;
     readonly bloomThreshold: number;
     readonly bloomIntensity: number;
     readonly bloomBlurRadius: number;
     readonly clearColor: readonly [number, number, number, number];
+    /** Optional active-camera SSR authoring fact, copied from the ECS schema. */
+    readonly screenSpaceReflection?: ScreenSpaceReflectionData;
     /** Renderer-owned temporal projection used by Standard's TAA producer. */
     readonly temporal?: TemporalView;
     /** Active-camera motion blur parameters, present only when demanded. */
@@ -124,8 +141,41 @@ interface RenderPipelineStateView {
  * RenderSystemRuntime structurally satisfies this contract, but the public
  * frame surface does not depend on that assembly owner.
  */
+interface RenderPipelineObservationCapture {
+    readonly domain: 'linear-hdr' | 'linear-ldr' | 'final-srgb';
+    readonly format: TextureFormat;
+    readonly device: RhiDevice;
+    readonly texture: Texture;
+    readonly buffer: Buffer;
+    readonly frameNumber: number;
+    readonly deviceGeneration: number;
+    readonly graphGeneration: number;
+    readonly backendId: string;
+    readonly width: number;
+    readonly height: number;
+    readonly bytesPerRow: number;
+}
+interface RenderPipelineObservationCaptureOwner {
+    readonly register: (capture: RenderPipelineObservationCapture) => void;
+    readonly consume: (frameNumber: number) => readonly RenderPipelineObservationCapture[];
+    readonly drain: () => readonly RenderPipelineObservationCapture[];
+}
 interface RenderPipelineRuntime {
     readonly device: RhiDevice;
+    /** Current renderer device generation used to fence graph captures. */
+    readonly deviceGeneration?: number | undefined;
+    /** Public receipt identity reserved for the frame currently being encoded. */
+    readonly observationFrameId?: number | undefined;
+    /** Renderer-issued graph fence populated by the graph owner during encoding. */
+    observationGraphGeneration?: number | undefined;
+    /** Per-renderer bridge for receipt-bound graph color captures. */
+    readonly observationCaptureOwner?: RenderPipelineObservationCaptureOwner | undefined;
+    /**
+     * Domains armed for the frame currently being encoded. An absent or empty
+     * set is the normal zero-cost path; typed graph capture passes remain
+     * declared for topology inspection but do not allocate or copy anything.
+     */
+    readonly observationCaptureDomains?: readonly FrameObservationDomain[] | undefined;
     /** Runtime-owned shader module factory used by built-in graph producers. */
     readonly shaderModuleFactory?: {
         createShaderModule(input: {
@@ -133,13 +183,20 @@ interface RenderPipelineRuntime {
             readonly label?: string | undefined;
         }): import('@forgeax/engine-types').Result<import('@forgeax/engine-rhi').ShaderModule, RhiError>;
     };
+    /** Immediate factory used by same-frame built-in producers after runtime warm-up. */
+    readonly immediateShaderModuleFactory?: {
+        createShaderModule(input: {
+            readonly code: string;
+            readonly label?: string | undefined;
+        }): import('@forgeax/engine-types').Result<import('@forgeax/engine-rhi').ShaderModule, RhiError>;
+    };
     readonly errorRegistry: {
         fire(error: RendererError): void;
     };
     readonly debugOverlay?: RenderDebugOverlay | undefined;
     readonly lookupPostProcess?: (id: string) => PostProcessShaderEntry | undefined;
     readonly getPostProcessParamsBuffer?: (id: string) => Buffer | undefined;
-    readonly getPostProcessPipeline?: (id: string, bgl: BindGroupLayout, colorFormat: GPUTextureFormat, entry?: PostProcessShaderEntry) => RhiRenderPipeline | null;
+    readonly getPostProcessPipeline?: (id: string, bgl: BindGroupLayout, colorFormats: readonly GPUTextureFormat[], entry?: PostProcessShaderEntry) => RhiRenderPipeline | null;
 }
 /**
  * Render-owned declaration for an app-provided debug overlay. App owns the
@@ -175,6 +232,10 @@ export interface RenderPipelineContext {
     readonly spotLightProjector?: SpotLightProjectorFrameContext;
     /** Build-time composed utility sources for the renderer-owned volume passes. */
     readonly volumetricFogShaders?: VolumetricFogShaderSources;
+    /** Build-time composed utility sources for the renderer-owned SSR passes. */
+    readonly ssrShaders?: SsrShaderSources;
+    /** Build-time composed utility sources for the renderer-owned atmosphere passes. */
+    readonly atmosphereShaders?: AtmosphereShaderSources;
 }
 /** Stable utility entry-point sources emitted by the shader manifest. */
 export interface VolumetricFogShaderSources {
@@ -183,6 +244,19 @@ export interface VolumetricFogShaderSources {
     readonly integrate: string;
     readonly composite: string;
 }
+/** Stable utility entry-point sources emitted by the shader manifest. */
+export interface SsrShaderSources {
+    readonly hiz: string;
+    readonly hizReduce: string;
+    readonly trace: string;
+    readonly temporal: string;
+    readonly compose: string;
+}
+/** Stable analytic-atmosphere entry-point sources emitted by the shader manifest. */
+export interface AtmosphereShaderSources {
+    readonly cube: string;
+    readonly background: string;
+}
 /**
  * GPU resources for one validated volumetric-fog candidate.  The record stage
  * owns residency and parameter uploads; graph passes consume this narrow view
@@ -225,6 +299,7 @@ export interface SpotLightProjectorFrameContext {
  */
 export interface Renderer {
     /** Renderer-owned authoring and update path for large instance collections. */
+    readonly instances: InstanceCollectionStore;
     attach(world: World): RenderResult<RenderWorldLease, RenderError>;
     /** Prepare a standard MeshAsset for the active device generation. */
     prepareDynamicGeometry(input: DynamicGeometryPrepareInput): Result<DynamicGeometryCandidate, DynamicGeometryError>;
@@ -234,6 +309,16 @@ export interface Renderer {
     cancelDynamicGeometry(candidate: DynamicGeometryCandidate): Result<void, DynamicGeometryError>;
     retireDynamicGeometry(candidate: DynamicGeometryCandidate): Result<void, DynamicGeometryError>;
     draw(input: RenderFrameInput): RenderResult<FrameReceipt, RenderError>;
+    /**
+     * Arm one upcoming submitted frame for explicit color-domain observation.
+     * Observation buffers are not created, copied, mapped, or retained until a
+     * host calls this method before `draw()`. The demand is consumed only by a
+     * successful submit; a failed frame keeps it armed for a retry.
+     *
+     * This optional extension keeps older injected Renderer test doubles source
+     * compatible while concrete Engine renderers always implement it.
+     */
+    requestObservation?: (domains: readonly FrameObservationDomain[]) => RenderResult<void, RenderError>;
     createRenderTarget(descriptor: RenderTargetDescriptor): RenderResult<RenderTarget, RenderError>;
     resizeRenderTarget(target: RenderTarget, descriptor: RenderTargetDescriptor): RenderResult<void, RenderError>;
     createRenderTargetTextureSource(target: RenderTarget, options: RenderTargetTextureSourceOptions): RenderResult<RenderTargetTextureSource, RenderError>;
@@ -241,6 +326,8 @@ export interface Renderer {
     destroyRenderTarget(target: RenderTarget): RenderResult<void, RenderError>;
     setProfile(profile: RenderProfile): RenderResult<void, RenderError>;
     state(): RendererState;
+    /** Detached world bounds for one record in the last extracted World; undefined if unavailable. */
+    bounds(world: World, entity: number): RenderSceneBounds | undefined;
     inspect(): RenderInspection;
     observe(receipt: FrameReceipt, request: FrameObservationRequest): Promise<RenderResult<FrameReceiptObservation, RenderError>>;
     subscribe(listener: (event: RendererEvent) => void): () => void;
@@ -273,6 +360,8 @@ export type RendererEvent = {
     readonly kind: 'frame-submitted';
     readonly frameId: number;
     readonly deviceGeneration: number;
+    /** The exact receipt returned by the renderer's submit boundary. */
+    readonly receipt: FrameReceipt;
 };
 /** Package-local listener alias used by the renderer assembly implementation. */
 export type RendererEventListener = (event: RendererEvent) => void;
@@ -298,8 +387,10 @@ export interface FrameEnvironment {
  * only with the matching FrameReceipt after `receipt.completed` and returns a
  * structured Result error when the generation or frame identity is stale.
  */
+export type FrameObservationDomain = 'linear-hdr' | 'linear-ldr' | 'final-srgb';
+export type FrameObservationInclude = 'timings' | 'draws' | 'bindings' | 'target-readbacks' | FrameObservationDomain;
 export interface FrameObservationRequest {
-    readonly include: readonly ('timings' | 'draws' | 'bindings' | 'target-readbacks')[];
+    readonly include: readonly FrameObservationInclude[];
     readonly targetReadbacks?: readonly RenderTargetReadbackTicket[];
 }
 /**
@@ -311,6 +402,10 @@ export interface FrameObservationRequest {
 export interface FrameReceipt {
     readonly frameId: number;
     readonly deviceGeneration: number;
+    /** Backend identity captured at submit and checked before observation. */
+    readonly backendId?: RhiCaps['backendKind'];
+    /** Monotonic compiled graph identity used by renderer-issued observations. */
+    readonly graphGeneration?: number;
     readonly completed: Promise<RenderResult<void, RenderError>>;
 }
 /**
@@ -331,15 +426,42 @@ export interface RenderFrameInput {
 export interface FrameReceiptObservation {
     readonly frameId: number;
     readonly deviceGeneration: number;
-    readonly include: readonly ('timings' | 'draws' | 'bindings' | 'target-readbacks')[];
+    readonly include: readonly FrameObservationInclude[];
     /** Receipt-bound Render-owned GPU pass facts; absent when not requested. */
     readonly timings?: GpuPassTimingObservation | undefined;
     /** Receipt-bound volume GPU timing facts; absent when not requested. */
     readonly volumeTimings?: VolumeTimingObservation | undefined;
     readonly targetReadbacks?: readonly RenderTargetReadbackData[];
+    /** Independent raw bytes captured from the requested linear/display domains. */
+    readonly observations?: readonly FrameDomainObservation[] | undefined;
+}
+export interface FrameDomainObservation {
+    readonly domain: FrameObservationDomain;
+    readonly bytes: Uint8Array;
+    readonly metadata: {
+        readonly frameId: number;
+        readonly deviceGeneration: number;
+        readonly backendId?: RhiCaps['backendKind'];
+        /** Native texture format of the copied attachment, including BGRA order. */
+        readonly format: TextureFormat;
+        readonly graphGeneration: number;
+        readonly textureIdentity: number;
+        readonly readbackIdentity: number;
+        readonly width: number;
+        readonly height: number;
+        readonly bytesPerRow: number;
+        readonly footprint: {
+            readonly resourceCount: number;
+            readonly bindGroupCount: number;
+        };
+    };
 }
 /** Stable backend facts for the Standard output transform projection. */
 export interface RenderOutputInspection {
+    /** Camera-owned auto-exposure facts, detached from GPU state when available. */
+    readonly autoExposure?: AutoExposureInspection;
+    /** Renderer-owned detached LUT residency and receipt facts. */
+    readonly standardLut?: StandardLutInspection;
     readonly outputTransform?: typeof STANDARD_OUTPUT_TRANSFORM_FEATURE_ID;
     readonly displayEncoded: boolean;
     readonly intermediateFormat?: TextureFormat;
@@ -383,6 +505,15 @@ export interface RenderObservationInspection {
     /** Exact pass names and target descriptor from the committed graph. */
     readonly passNames: readonly string[];
     readonly standardOutputColor?: RenderStandardOutputColorInspection;
+    /** Monotonic, renderer-owned observation resource facts; no GPU handles. */
+    readonly resourceStats?: {
+        readonly allocationCount: number;
+        readonly liveCount: number;
+        readonly peakLiveCount: number;
+        readonly mapCount: number;
+        readonly readbackCount: number;
+        readonly liveByteLength: number;
+    };
 }
 /**
  * Detached renderer facts for host diagnostics and capability selection.
@@ -420,6 +551,12 @@ export interface RenderInspection {
     readonly features: readonly string[];
     /** Truthful lifecycle facts for every registered declarative feature. */
     readonly featureDiagnostics: readonly RenderFeatureDiagnostics[];
+    /** Detached signature and prepared-resource counters for feature planning. */
+    readonly featureHost?: RenderFeatureHostInspection;
+    /** Detached typed-graph compile/reuse and candidate lifecycle counters. */
+    readonly featureGraph?: RenderFeatureGraphInspection;
+    /** Detached material texture-source probe counters from the last extract. */
+    readonly materialTextureSources?: import('./inspection-types').MaterialTextureSourceInspection;
     readonly frustumStats: {
         readonly culled: number;
         readonly total: number;
@@ -435,6 +572,8 @@ export interface RenderInspection {
     readonly reflectionProbes: ReflectionProbeInspection;
     /** Renderer-owned SSR dependency seam; consumer facts are projected from live owners. */
     readonly ssrDependencies: SsrDependenciesInspection;
+    /** Renderer-owned SSR spatial status and bounded execution facts. */
+    readonly ssr: SsrSpatialInspection;
     /** Last completed transmission candidate facts, detached from GPU handles. */
     readonly transmission?: TransmissionInspection;
     /** Last prepared Standard transport facts, detached from GPU handles. */
@@ -479,16 +618,12 @@ export interface RenderInspection {
             readonly lastGeneration: number | undefined;
         };
     };
-    /** Output transform facts; never includes fixture metrics or pixel bytes. */
-    readonly outputTransform?: typeof STANDARD_OUTPUT_TRANSFORM_FEATURE_ID;
-    readonly displayEncoded: boolean;
-    readonly intermediateFormat?: TextureFormat;
-    readonly surfaceStorage: TextureFormat;
-    readonly surfaceDisplay: TextureFormat;
-    readonly endpoint: 'surface.storage.raw';
-    readonly capability: RenderOutputInspection['capability'];
-    readonly presentationProof?: RhiCanvasSurfacePresentationProof;
-    readonly error: RenderOutputInspection['error'];
+    /**
+     * Output-transform facts from the same committed graph and physical surface.
+     * Keep this as one named subtree so AI consumers do not have to guess which
+     * detached fields belong to the output contract versus renderer lifecycle.
+     */
+    readonly output: RenderOutputInspection;
     readonly observation: RenderObservationInspection;
     readonly environment: EnvironmentInspection;
     readonly temporal: TemporalInspection;
@@ -521,6 +656,8 @@ export interface RenderInspection {
 export type DrawOwnerOptions = {
     readonly cameraOwner: number;
     readonly resourceOwner: number;
+    /** Optional FrameCamera entity selection; absent preserves ActiveCamera semantics. */
+    readonly cameraEntityKey?: number;
     readonly profileFrame?: ProfileFrameToken;
 };
 /** Information attached to a device-loss notification. */
@@ -541,17 +678,18 @@ export type RendererLostListener = (info: RendererLostInfo) => void;
  * exception), NOT the eliminated cross-cluster `RuntimeError` SSOT (D-3).
  *
  * Composition = `RhiError | RenderError | AssetRuntimeError | SkinError |
- * PostProcessError`. This equals the pre-decomposition
- * `RhiError | RuntimeError | PostProcessError` exactly: `RuntimeError` was
- * `RenderError | AssetRuntimeError | SkinError` (27 classes). `RecoverError`
- * and `EngineEnvironmentError` are intentionally excluded — neither is ever
- * emitted through the Renderer event stream (`RecoverError` returns from `recover()`,
- * `EngineEnvironmentError` throws at construction), matching the original
- * `RuntimeError` union which excluded both (OOS-3 behavior equivalence).
+ * GpuDrivenPreparationError | PostProcessError`. The GPU preparation arm is
+ * the renderer-owned producer contract: its closed `code` and typed `detail`
+ * identify the material, geometry, skin, generation, or shadow owner without making
+ * RHI errors carry render policy. `RecoverError` and `EngineEnvironmentError`
+ * are intentionally excluded — neither is ever emitted through the Renderer
+ * event stream (`RecoverError` returns from `recover()`,
+ * `EngineEnvironmentError` throws at construction).
  *
  * AI consumers do `switch (err.code)` over the union: the disjoint
  * `RhiErrorCode` / `RenderErrorCode` / `AssetRuntimeErrorCode` / `SkinErrorCode`
- * / `PostProcessErrorCode` literal sets let TS narrow each arm to the concrete
+ * / `GpuDrivenPreparationErrorCode` / `PostProcessErrorCode` literal sets let
+ * TS narrow each arm to the concrete
  * class (charter P3 union discoverability — every fan-out member is reachable
  * in an exhaustive switch, no untyped escape). Example:
  *
@@ -562,13 +700,14 @@ export type RendererLostListener = (info: RendererLostInfo) => void;
  *     case 'asset-not-registered': // AssetRuntimeError arm, err narrowed here
  *       return report(err.hint);
  *     // ...one arm per RhiErrorCode | RenderErrorCode | AssetRuntimeErrorCode
- *     //    | SkinErrorCode | PostProcessErrorCode member; no default needed,
+ *     //    | SkinErrorCode | GpuDrivenPreparationErrorCode |
+ *     //    PostProcessErrorCode member; no default needed,
  *     //    TS flags every unhandled code at compile time.
  *   }
  * });
  * ```
  */
-export type RendererError = RhiError | RenderGraphError | ImageError | RenderError | AssetRuntimeError | SkinError | PostProcessError;
+export type RendererError = RhiError | RenderGraphError | ImageError | RenderError | GpuDrivenPreparationError | AssetRuntimeError | SkinError | PostProcessError;
 /**
  * Package-local error listener retained for host assembly. Public consumers
  * use `Renderer.subscribe` and receive `RendererEvent` instead.
@@ -580,7 +719,7 @@ export type RendererErrorListener = (error: RendererError) => void;
  * pipelines retain a bounded catalog while the default render workload gets
  * actionable owner attribution.
  */
-export declare const RENDER_GRAPH_EXECUTION_PHASE_CATALOG: readonly ["record/graph-execute/point-shadow", "record/graph-execute/cluster-binner-upload", "record/graph-execute/g-buffer", "record/graph-execute/g-buffer/geometry-loop", "record/graph-execute/g-buffer/material-bind-groups", "record/graph-execute/g-buffer/pipeline-selection", "record/graph-execute/g-buffer/draw-submit", "record/graph-execute/ssao-calc", "record/graph-execute/ssao-blur", "record/graph-execute/lighting", "record/graph-execute/forward", "record/graph-execute/forward/geometry-loop", "record/graph-execute/forward/material-bind-groups", "record/graph-execute/forward/pipeline-selection", "record/graph-execute/forward/draw-submit", "record/graph-execute/output-transform", "record/graph-execute/present", "record/graph-execute/debug-overlay", "record/graph-execute/shadow", "record/graph-execute/spot-shadow", "record/graph-execute/skybox", "record/graph-execute/main", "record/graph-execute/fxaa", "record/graph-execute/bloom-bright", "record/graph-execute/bloom-blur-h", "record/graph-execute/bloom-blur-v", "record/graph-execute/bloom-composite", "record/graph-execute/other"];
+export declare const RENDER_GRAPH_EXECUTION_PHASE_CATALOG: readonly ["record/graph-execute/point-shadow", "record/graph-execute/cluster-binner-upload", "record/graph-execute/g-buffer", "record/graph-execute/g-buffer/geometry-loop", "record/graph-execute/g-buffer/material-bind-groups", "record/graph-execute/g-buffer/pipeline-selection", "record/graph-execute/g-buffer/draw-submit", "record/graph-execute/ssao-calc", "record/graph-execute/ssao-blur", "record/graph-execute/lighting", "record/graph-execute/forward", "record/graph-execute/forward/geometry-loop", "record/graph-execute/forward/material-bind-groups", "record/graph-execute/forward/pipeline-selection", "record/graph-execute/forward/draw-submit", "record/graph-execute/output-transform", "record/graph-execute/present", "record/graph-execute/debug-overlay", "record/graph-execute/shadow", "record/graph-execute/spot-shadow", "record/graph-execute/skybox", "record/graph-execute/main", "record/graph-execute/fxaa", "record/graph-execute/bloom-bright", "record/graph-execute/bloom-blur-h", "record/graph-execute/bloom-blur-v", "record/graph-execute/bloom-composite", "record/graph-execute/ssr-hiz", "record/graph-execute/ssr-trace", "record/graph-execute/ssr-temporal", "record/graph-execute/ssr-reflection-mip", "record/graph-execute/ssr-compose", "record/graph-execute/other"];
 export type RenderGraphExecutionPhase = (typeof RENDER_GRAPH_EXECUTION_PHASE_CATALOG)[number];
 /** Bounded producer-owned children of the scene-state record owner. */
 export declare const RENDER_HDRP_BINNER_PHASE_CATALOG: readonly ["record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/light-aabb", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/cluster-occupancy", "record/scene-state/hdrp-cluster/binner/cluster-reserve", "record/scene-state/hdrp-cluster/binner/input-preparation", "record/scene-state/hdrp-cluster/binner/bin-core", "record/scene-state/hdrp-cluster/binner/light-index-write", "record/scene-state/hdrp-cluster/binner/light-index-write/bounds-read", "record/scene-state/hdrp-cluster/binner/light-index-write/cluster-write"];
@@ -594,9 +733,9 @@ export declare const RENDER_SCENE_STATE_PHASE_CATALOG: readonly ["record/scene-s
  * engine-owned Extract / Prepare / Record orchestration so a host can measure
  * attribution without guessing from RHI command counts.
  */
-export declare const RENDER_RECORD_PHASE_CATALOG: readonly ["record/occlusion-query-submit", "record/occlusion-global-advance", "record/scene-state", "record/scene-state/fold-buckets", "record/scene-state/lighting-prep", "record/scene-state/ambient-resolution", "record/scene-state/directional-shadow-cache", "record/scene-state/hdrp-cluster", "record/scene-state/hdrp-cluster/binner", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/light-aabb", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/cluster-occupancy", "record/scene-state/hdrp-cluster/binner/cluster-reserve", "record/scene-state/hdrp-cluster/binner/input-preparation", "record/scene-state/hdrp-cluster/binner/bin-core", "record/scene-state/hdrp-cluster/binner/light-index-write", "record/scene-state/hdrp-cluster/binner/light-index-write/bounds-read", "record/scene-state/hdrp-cluster/binner/light-index-write/cluster-write", "record/scene-state/hdrp-cluster/payload-packing", "record/scene-state/hdrp-cluster/buffer-upload", "record/swapchain", "record/render-graph", "record/target-views", "record/validation", "record/dispatch-plan", "record/uploads", "record/bind-groups", "record/graph-execute", "record/graph-execute/point-shadow", "record/graph-execute/cluster-binner-upload", "record/graph-execute/g-buffer", "record/graph-execute/g-buffer/geometry-loop", "record/graph-execute/g-buffer/material-bind-groups", "record/graph-execute/g-buffer/pipeline-selection", "record/graph-execute/g-buffer/draw-submit", "record/graph-execute/ssao-calc", "record/graph-execute/ssao-blur", "record/graph-execute/lighting", "record/graph-execute/forward", "record/graph-execute/forward/geometry-loop", "record/graph-execute/forward/material-bind-groups", "record/graph-execute/forward/pipeline-selection", "record/graph-execute/forward/draw-submit", "record/graph-execute/output-transform", "record/graph-execute/present", "record/graph-execute/debug-overlay", "record/graph-execute/shadow", "record/graph-execute/spot-shadow", "record/graph-execute/skybox", "record/graph-execute/main", "record/graph-execute/fxaa", "record/graph-execute/bloom-bright", "record/graph-execute/bloom-blur-h", "record/graph-execute/bloom-blur-v", "record/graph-execute/bloom-composite", "record/graph-execute/other"];
+export declare const RENDER_RECORD_PHASE_CATALOG: readonly ["record/occlusion-query-submit", "record/occlusion-global-advance", "record/scene-state", "record/scene-state/fold-buckets", "record/scene-state/lighting-prep", "record/scene-state/ambient-resolution", "record/scene-state/directional-shadow-cache", "record/scene-state/hdrp-cluster", "record/scene-state/hdrp-cluster/binner", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/light-aabb", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/cluster-occupancy", "record/scene-state/hdrp-cluster/binner/cluster-reserve", "record/scene-state/hdrp-cluster/binner/input-preparation", "record/scene-state/hdrp-cluster/binner/bin-core", "record/scene-state/hdrp-cluster/binner/light-index-write", "record/scene-state/hdrp-cluster/binner/light-index-write/bounds-read", "record/scene-state/hdrp-cluster/binner/light-index-write/cluster-write", "record/scene-state/hdrp-cluster/payload-packing", "record/scene-state/hdrp-cluster/buffer-upload", "record/swapchain", "record/render-graph", "record/target-views", "record/validation", "record/dispatch-plan", "record/uploads", "record/bind-groups", "record/graph-execute", "record/graph-execute/point-shadow", "record/graph-execute/cluster-binner-upload", "record/graph-execute/g-buffer", "record/graph-execute/g-buffer/geometry-loop", "record/graph-execute/g-buffer/material-bind-groups", "record/graph-execute/g-buffer/pipeline-selection", "record/graph-execute/g-buffer/draw-submit", "record/graph-execute/ssao-calc", "record/graph-execute/ssao-blur", "record/graph-execute/lighting", "record/graph-execute/forward", "record/graph-execute/forward/geometry-loop", "record/graph-execute/forward/material-bind-groups", "record/graph-execute/forward/pipeline-selection", "record/graph-execute/forward/draw-submit", "record/graph-execute/output-transform", "record/graph-execute/present", "record/graph-execute/debug-overlay", "record/graph-execute/shadow", "record/graph-execute/spot-shadow", "record/graph-execute/skybox", "record/graph-execute/main", "record/graph-execute/fxaa", "record/graph-execute/bloom-bright", "record/graph-execute/bloom-blur-h", "record/graph-execute/bloom-blur-v", "record/graph-execute/bloom-composite", "record/graph-execute/ssr-hiz", "record/graph-execute/ssr-trace", "record/graph-execute/ssr-temporal", "record/graph-execute/ssr-reflection-mip", "record/graph-execute/ssr-compose", "record/graph-execute/other"];
 export type RenderRecordPhase = (typeof RENDER_RECORD_PHASE_CATALOG)[number];
-export declare const RENDER_PHASE_CATALOG: readonly ["extract", "occlusion-prepare", "bind-groups", "features", "sort", "record", "record/occlusion-query-submit", "record/occlusion-global-advance", "record/scene-state", "record/scene-state/fold-buckets", "record/scene-state/lighting-prep", "record/scene-state/ambient-resolution", "record/scene-state/directional-shadow-cache", "record/scene-state/hdrp-cluster", "record/scene-state/hdrp-cluster/binner", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/light-aabb", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/cluster-occupancy", "record/scene-state/hdrp-cluster/binner/cluster-reserve", "record/scene-state/hdrp-cluster/binner/input-preparation", "record/scene-state/hdrp-cluster/binner/bin-core", "record/scene-state/hdrp-cluster/binner/light-index-write", "record/scene-state/hdrp-cluster/binner/light-index-write/bounds-read", "record/scene-state/hdrp-cluster/binner/light-index-write/cluster-write", "record/scene-state/hdrp-cluster/payload-packing", "record/scene-state/hdrp-cluster/buffer-upload", "record/swapchain", "record/render-graph", "record/target-views", "record/validation", "record/dispatch-plan", "record/uploads", "record/bind-groups", "record/graph-execute", "record/graph-execute/point-shadow", "record/graph-execute/cluster-binner-upload", "record/graph-execute/g-buffer", "record/graph-execute/g-buffer/geometry-loop", "record/graph-execute/g-buffer/material-bind-groups", "record/graph-execute/g-buffer/pipeline-selection", "record/graph-execute/g-buffer/draw-submit", "record/graph-execute/ssao-calc", "record/graph-execute/ssao-blur", "record/graph-execute/lighting", "record/graph-execute/forward", "record/graph-execute/forward/geometry-loop", "record/graph-execute/forward/material-bind-groups", "record/graph-execute/forward/pipeline-selection", "record/graph-execute/forward/draw-submit", "record/graph-execute/output-transform", "record/graph-execute/present", "record/graph-execute/debug-overlay", "record/graph-execute/shadow", "record/graph-execute/spot-shadow", "record/graph-execute/skybox", "record/graph-execute/main", "record/graph-execute/fxaa", "record/graph-execute/bloom-bright", "record/graph-execute/bloom-blur-h", "record/graph-execute/bloom-blur-v", "record/graph-execute/bloom-composite", "record/graph-execute/other"];
+export declare const RENDER_PHASE_CATALOG: readonly ["extract", "occlusion-prepare", "bind-groups", "features", "sort", "record", "record/occlusion-query-submit", "record/occlusion-global-advance", "record/scene-state", "record/scene-state/fold-buckets", "record/scene-state/lighting-prep", "record/scene-state/ambient-resolution", "record/scene-state/directional-shadow-cache", "record/scene-state/hdrp-cluster", "record/scene-state/hdrp-cluster/binner", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/light-aabb", "record/scene-state/hdrp-cluster/binner/light-bounds-and-occupancy/cluster-occupancy", "record/scene-state/hdrp-cluster/binner/cluster-reserve", "record/scene-state/hdrp-cluster/binner/input-preparation", "record/scene-state/hdrp-cluster/binner/bin-core", "record/scene-state/hdrp-cluster/binner/light-index-write", "record/scene-state/hdrp-cluster/binner/light-index-write/bounds-read", "record/scene-state/hdrp-cluster/binner/light-index-write/cluster-write", "record/scene-state/hdrp-cluster/payload-packing", "record/scene-state/hdrp-cluster/buffer-upload", "record/swapchain", "record/render-graph", "record/target-views", "record/validation", "record/dispatch-plan", "record/uploads", "record/bind-groups", "record/graph-execute", "record/graph-execute/point-shadow", "record/graph-execute/cluster-binner-upload", "record/graph-execute/g-buffer", "record/graph-execute/g-buffer/geometry-loop", "record/graph-execute/g-buffer/material-bind-groups", "record/graph-execute/g-buffer/pipeline-selection", "record/graph-execute/g-buffer/draw-submit", "record/graph-execute/ssao-calc", "record/graph-execute/ssao-blur", "record/graph-execute/lighting", "record/graph-execute/forward", "record/graph-execute/forward/geometry-loop", "record/graph-execute/forward/material-bind-groups", "record/graph-execute/forward/pipeline-selection", "record/graph-execute/forward/draw-submit", "record/graph-execute/output-transform", "record/graph-execute/present", "record/graph-execute/debug-overlay", "record/graph-execute/shadow", "record/graph-execute/spot-shadow", "record/graph-execute/skybox", "record/graph-execute/main", "record/graph-execute/fxaa", "record/graph-execute/bloom-bright", "record/graph-execute/bloom-blur-h", "record/graph-execute/bloom-blur-v", "record/graph-execute/bloom-composite", "record/graph-execute/ssr-hiz", "record/graph-execute/ssr-trace", "record/graph-execute/ssr-temporal", "record/graph-execute/ssr-reflection-mip", "record/graph-execute/ssr-compose", "record/graph-execute/other"];
 export type RenderPhase = (typeof RENDER_PHASE_CATALOG)[number];
 export type RenderPhaseSkipReason = 'feature-host-unavailable' | 'feature-host-empty' | 'pipeline-state-unavailable' | 'camera-unavailable';
 /** First-version options bag (intentionally empty; reserved for v0.1). */
@@ -613,7 +752,11 @@ export interface RendererOptions {
     readonly rhiInstrumentation?: RhiBackendInstrumentation | undefined;
     /** Optional bounded GPU pass timing facts; this is not frame latency. */
     readonly gpuPassTiming?: GpuPassTimingOptions | undefined;
-    /** Exact source/tree/lock/build identity binding for the renderer-owned SSR seam. */
+    /**
+     * Exact source/tree/lock/build identity binding for the renderer-owned SSR seam.
+     * Opts into one format-capability probe during device-generation initialization;
+     * camera ScreenSpaceReflection still controls all per-frame SSR work.
+     */
     readonly ssrIdentity?: SsrAdmissionIdentity | undefined;
     /**
      * M3 D-P4 escape hatch (feat-20260511-rhi-wgpu-impl): explicit