@forgeax/engine-render 0.1.21 → 0.1.23

package/src/render-contract.ts

@@ -32,12 +32,16 @@ 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 { SsrAdmissionIdentity } from './ssr/identity';
 import type {
   RenderTarget,
   RenderTargetDescriptor,
@@ -104,9 +108,9 @@ export interface CameraSnapshot {
   readonly worldId?: number;
   /** Camera-owned history generation forwarded into the frame plan. */
   readonly historyVersion?: number;
-  /** World-space camera translation (mat4.getTranslation of Transform.world). */
+  /** World-space camera translation (mat4.getTranslation of GlobalTransform.world). */
   readonly position: Vec3;
-  /** Resolved world-space camera mat4, copied from Transform.world. */
+  /** Resolved world-space camera mat4, copied from GlobalTransform.world. */
   readonly world: Float32Array;
   readonly fov: number;
   readonly aspect: number;
@@ -161,9 +165,6 @@ interface RenderPipelineStateView {
   readonly colorAttachmentFormat: TextureFormat;
   /** Renderer-owned View UBO shared by Standard lighting, shadows, and fog. */
   readonly viewUniformBuffer: Buffer;
-  /** Renderer-owned SpotLight std430 buffer shared by Standard and volume. */
-  readonly pointLightsBuffer: Buffer;
-  readonly spotLightsBuffer: Buffer;
   /** Fallback resources keep the shared view layout valid when no projector is authored. */
   readonly defaultWhiteTextureView: TextureView;
   readonly defaultSampler: Sampler;
@@ -482,6 +483,8 @@ export interface RenderInspection {
   readonly visibilityStats: { readonly explicitlyHidden: number };
   readonly renderScene: RenderSceneInspection;
   readonly reflectionProbes: ReflectionProbeInspection;
+  /** Renderer-owned SSR dependency seam; consumer facts are projected from live owners. */
+  readonly ssrDependencies: SsrDependenciesInspection;
   /** Last completed transmission candidate facts, detached from GPU handles. */
   readonly transmission?: TransmissionInspection;
   /** Last prepared Standard transport facts, detached from GPU handles. */
@@ -508,11 +511,15 @@ export interface RenderInspection {
   readonly environment: EnvironmentInspection;
   readonly temporal: TemporalInspection;
   readonly bloom: BloomInspection;
+  /** Candidate/accepted/LKG facts for the single extendedLighting topology. */
+  readonly extendedLighting: LightInspection;
   readonly directionalShadow: DirectionalShadowInspection;
   /** Semantic Standard temporal target metadata; no graph or RHI handles. */
   readonly temporalTarget?: TemporalTargetInspection;
   /** Renderer-owned Motion Blur facts; absent when no component is active. */
   readonly motionBlur?: MotionBlurInspection;
+  /** Bounded renderer-owned LOD/occlusion facts; absent before a candidate frame. */
+  readonly lodOcclusion?: LodOcclusionInspection;
 }
 
 /** Backend marker — single-element union preserved for future extensibility (D-2). */
@@ -676,6 +683,8 @@ export const RENDER_SCENE_STATE_PHASE_CATALOG = [
  * attribution without guessing from RHI command counts.
  */
 export const RENDER_RECORD_PHASE_CATALOG = [
+  'record/occlusion-query-submit',
+  'record/occlusion-global-advance',
   'record/scene-state',
   ...RENDER_SCENE_STATE_PHASE_CATALOG,
   'record/swapchain',
@@ -693,6 +702,7 @@ export type RenderRecordPhase = (typeof RENDER_RECORD_PHASE_CATALOG)[number];
 
 export const RENDER_PHASE_CATALOG = [
   'extract',
+  'occlusion-prepare',
   'bind-groups',
   'features',
   'sort',
@@ -722,6 +732,8 @@ 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. */
+  readonly ssrIdentity?: SsrAdmissionIdentity | undefined;
   // feat-20260608-create-app-param-surface-trim / M1 / AC-02: `clearColor`
   // was deleted as a one-cut breaking change (AGENTS.md Change stance +
   // requirements constraint #1: no deprecation window, no shim). Scene

package/src/render-pipeline.ts

@@ -46,6 +46,7 @@ import type { StandardTopologyInputValue } from './pipeline/standard-lighting/to
 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 { OcclusionFrameProjection } from './scene/visibility/occlusion-runtime';
 import type { TransmissionDemand } from './transmission/projection';
 
 export type { RenderPipelineContext } from './render-contract';
@@ -215,6 +216,8 @@ export interface RenderPipelineTopology {
    * clear directly to the surface.
    */
   readonly clearOnly?: boolean | undefined;
+  /** Whether Standard main draws carry the producer-owned fallback MRT. */
+  readonly reflectionFallback?: { readonly enabled: boolean } | undefined;
   readonly surface: {
     readonly width: number;
     readonly height: number;
@@ -458,6 +461,8 @@ export interface RenderPipelineBuildContext<FrameCtx extends RenderPipelineFrame
     readonly destination: GraphTextureView;
     readonly level: number;
   }) => void;
+  /** Renderer-owned occlusion query state for the primary scene pass. */
+  readonly occlusion?: OcclusionFrameProjection;
   projectGpuDriven(target: {
     readonly format: TextureFormat;
     readonly sampleCount: 1 | 4;