@forgeax/engine-render 0.1.33 → 0.1.34

package/dist/gpu-driven/production-raster-material.d.ts

@@ -0,0 +1,178 @@
+import type { BindGroup, Buffer, RenderPipeline, Result, RhiDevice, TextureFormat } from '@forgeax/engine-rhi';
+import { RhiError } from '@forgeax/engine-rhi';
+import type { MaterialShaderArtifact } from '@forgeax/engine-shader';
+import type { MaterialDynamicInputLayout, MaterialRenderState } from '@forgeax/engine-types';
+import type { MeshGpuHandles } from '../device/gpu-residency';
+import { GpuDrivenPreparationError } from '../errors/gpu-driven';
+import type { PipelineState, RenderSystemInternals } from '../record/render-context';
+import type { DynamicInputRange, SurfaceDynamicInputFrame } from '../surface/dynamic-input';
+import type { GpuDrivenBatch } from './batch-topology';
+interface SurfaceFrameRange {
+    readonly frameIndex: number;
+    readonly range?: DynamicInputRange;
+    readonly directMember?: {
+        readonly worldId: number;
+        readonly entityKey: number;
+        readonly drawItemIndex: number;
+        readonly instanceOrdinal: number;
+    };
+}
+interface SurfaceSharedFrameState {
+    readonly buffer: Buffer;
+    frameTime: number;
+    writes: number;
+}
+type MaterialPipelineFactory = NonNullable<RenderSystemInternals['getMaterialShaderPipelineEntry']>;
+export declare class MaterialAbiRasterAdapter {
+    private readonly device;
+    private readonly pipelineLayout;
+    private readonly meshLayout;
+    private readonly instancesBindGroupLayout;
+    private readonly surfaceDirectInstancesBindGroupLayout;
+    private readonly programs;
+    private instancesBindGroup;
+    private readonly instanceBuffer;
+    private readonly instanceBufferSize;
+    private visibleBuffer;
+    private probeBlendRecordBuffer;
+    private readonly artifact;
+    private readonly deformation;
+    private readonly pipelineFactory;
+    private paletteBuffer;
+    private paletteBindingWindowBytes;
+    private readonly pipelines;
+    private readonly projectionBuffers;
+    private readonly projectionBindings;
+    /**
+     * Projection rows are graph-generation resources. A new topology may stage
+     * a replacement before the graph is promoted; keeping staged bindings out
+     * of the active map lets an aborted graph leave the last submitted rows
+     * intact. Superseded buffers are fence-retired on promotion.
+     */
+    private readonly stagedProjectionBindings;
+    private readonly pendingProjectionRetirements;
+    private readonly destroyedProjectionBuffers;
+    private projectionDisposed;
+    private stagedProjectionKeys;
+    private readonly activeProjectionRowsAtStage;
+    private readonly visibleWindowBindGroups;
+    private readonly surfaceInputBuffers;
+    /**
+     * Material-raster-owned buffers only. Visible, probe, palette and mesh
+     * buffers are supplied by their respective owners and are deliberately not
+     * registered here, so the production projection cannot double-count them.
+     */
+    private readonly allocationTokens;
+    private readonly allocationLedger;
+    private dynamicInputPage;
+    private dynamicInputPageGeneration;
+    private dynamicInputBuffer;
+    private dynamicInputBufferSize;
+    private dynamicFrameBuffer;
+    private dynamicFrameBufferSize;
+    private readonly dynamicSharedFrame;
+    private directAddressBuffer;
+    private directAddressBufferSize;
+    private readonly directAddresses;
+    private readonly directBindGroups;
+    /** Last successfully queued frame rows, keyed by visible member identity. */
+    private readonly dynamicFrameRows;
+    private dynamicFrameRangeSource;
+    private dynamicInputRangeSource;
+    private dynamicInputFrameRanges;
+    private dynamicFrameRangeCapacity;
+    private dynamicFrameMemberScans;
+    private dynamicFrameRowAllocations;
+    private pendingDynamicInputUpload;
+    private constructor();
+    static create(input: {
+        readonly device: RhiDevice;
+        readonly pipelineState: PipelineState;
+        readonly artifact: MaterialShaderArtifact;
+        readonly visibleBuffer: Buffer;
+        readonly deformation?: 'rigid' | 'skin';
+        readonly paletteBuffer?: Buffer;
+        readonly paletteBindingWindowBytes?: number;
+        readonly sharedSurfaceFrame?: SurfaceSharedFrameState;
+        readonly probeBlendRecordBuffer?: Buffer;
+        /** Renderer-owned factory for the selected artifact's actual PSO. */
+        readonly pipelineFactory?: MaterialPipelineFactory;
+    }): Result<MaterialAbiRasterAdapter, RhiError | GpuDrivenPreparationError>;
+    ensurePaletteBuffer(paletteBuffer: Buffer | undefined, paletteBindingWindowBytes: number | undefined): Result<void, RhiError>;
+    skinPaletteBinding(): {
+        readonly buffer: Buffer;
+        readonly bindingWindowBytes: number;
+    } | undefined;
+    ensureVisibleBuffer(visibleBuffer: Buffer): Result<void, RhiError>;
+    ensureProbeBlendRecordBuffer(buffer: Buffer | undefined): Result<void, RhiError>;
+    visibleWindowBindGroup(visibleBase: number, visibleCapacity: number, surfaceFrameBase?: number, surfaceFrameCapacity?: number): Result<BindGroup, RhiError>;
+    visibleWindowBindGroupForBuffer(visibleBuffer: Buffer, visibleBase: number, visibleCapacity: number, surfaceFrameBase?: number, surfaceFrameCapacity?: number, shadowVisibleAlias?: boolean): Result<BindGroup, RhiError>;
+    shadowVisibleWindowBindGroupForBuffer(visibleBuffer: Buffer, visibleBase: number, visibleCapacity: number): Result<BindGroup, RhiError>;
+    private ensureDirectSurfaceAddresses;
+    directSurfaceInstances(input: {
+        readonly worldId: number;
+        readonly entityKey: number;
+        readonly drawItemIndex: number;
+        readonly instanceCount: number;
+        readonly firstInstanceOrdinal?: number;
+        readonly instanceBuffer: Buffer;
+        readonly probeBuffer?: Buffer;
+        readonly probeOffset?: number;
+    }): Result<{
+        readonly bindGroup: BindGroup;
+        readonly dynamicOffsets: readonly number[];
+        readonly frameBase: number;
+    }, RhiError>;
+    /**
+     * Upload the generic Surface page and frame/range records through the same
+     * prepared GPU-driven owner that binds instances and visible rows.
+     */
+    ensureSurfaceDynamicInput(frame: SurfaceDynamicInputFrame | undefined, recordCapacity: number, frameTime?: number, expectedLayout?: MaterialDynamicInputLayout, expectedDeviceGeneration?: number, frameRanges?: readonly SurfaceFrameRange[]): Result<void, RhiError>;
+    commitSurfaceDynamicInput(): Result<void, RhiError>;
+    abortSurfaceDynamicInput(): void;
+    private rebuildInstancesBindGroup;
+    pipeline(format: TextureFormat, sampleCount: 1 | 4, layoutProjection: MeshGpuHandles['layoutProjection'], shaderUvSetCount: number, topology: GpuDrivenBatch['key']['topology'], stripIndexFormat: 'uint16' | 'uint32' | undefined, renderState: MaterialRenderState | undefined, selectedArtifact?: MaterialShaderArtifact, additionalColorFormats?: readonly TextureFormat[]): Result<RenderPipeline, RhiError>;
+    /**
+     * Drop only program-derived caches when a publication switches. Resource
+     * buffers stay alive until their normal fence retirement, while the next
+     * draw must obtain a PSO for the new artifact rather than reuse the old one.
+     */
+    invalidatePipelineCache(): void;
+    projectionBindGroup(rows: Float32Array, key?: string, capacityRows?: number): Result<BindGroup, RhiError>;
+    projectionBuffer(key: string): {
+        readonly buffer: Buffer;
+        readonly bindingBytes: number;
+    } | undefined;
+    refreshProjectionRows(key: string, rows: Float32Array): Result<void, RhiError>;
+    /** Stage the projection keys required by the frame being prepared. */
+    stageProjectionKeys(keys: ReadonlySet<string>): void;
+    /** Add a shadow projection key discovered while updating a view plan. */
+    noteProjectionKey(key: string): void;
+    /** Promote staged projection resources after the command buffer submits. */
+    commitProjectionBindings(): void;
+    /** Discard resources created for an aborted graph while retaining LKG rows. */
+    abortProjectionBindings(): void;
+    private createProjectionBinding;
+    private writeProjectionRows;
+    dispose(): void;
+    private retireProjectionBuffer;
+    private destroyProjectionBuffer;
+    private trackOwnedBuffer;
+    private rollbackOwnedBuffer;
+    get instancesFrameGroup(): BindGroup;
+    get surfaceDynamicInputBuffer(): Buffer;
+    get surfaceDynamicFrameBuffer(): Buffer;
+    get surfaceDynamicSharedFrameBuffer(): Buffer;
+    get surfaceDynamicInputBufferSize(): number;
+    get surfaceDynamicFrameBufferSize(): number;
+    get surfaceDynamicSharedFrameBufferSize(): number;
+    get surfaceDynamicFrameRowAllocations(): number;
+    get surfaceDynamicFrameMemberScans(): number;
+    /** Logical bytes owned by this adapter; external scene buffers are excluded. */
+    get resourceAllocation(): import('../inspection-types').GpuResourceAllocationInspection;
+    get surfaceDynamicFrameTimeWrites(): number;
+    get surfaceDynamicSharedFrameState(): SurfaceSharedFrameState;
+    get kind(): 'rigid' | 'skin';
+}
+export {};
+//# sourceMappingURL=production-raster-material.d.ts.map

package/dist/gpu-driven/production-raster-material.d.ts.map

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

package/dist/gpu-driven/production-raster.d.ts

@@ -1,5 +1,5 @@
 import type { RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
-import type { BindGroup, BindGroupLayout, Result, RhiDevice, TextureFormat } from '@forgeax/engine-rhi';
+import type { BindGroup, BindGroupLayout, Buffer, Result, RhiDevice, TextureFormat } from '@forgeax/engine-rhi';
 import { RhiError } from '@forgeax/engine-rhi';
 import type { MaterialShaderArtifact } from '@forgeax/engine-shader';
 import type { MaterialRenderState } from '@forgeax/engine-types';
@@ -15,6 +15,9 @@ import type { GpuDrivenStandardPbrFrameResources, RenderPipelineFrame, RenderPip
 import type { DispatchEntry, MaterialSnapshot, RenderableSnapshot, ShadowCasterMembership } from '../render-system-extract';
 import type { PersistentGpuDrivenState } from '../scene/render-scene';
 import type { OcclusionFrameProjection } from '../scene/visibility/occlusion-runtime';
+import type { SurfaceDynamicInputFrame } from '../surface/dynamic-input';
+import { type SurfaceGpuSubmissionAdmission } from '../surface/gpu-driven';
+import type { SurfaceSubmissionCandidate } from '../surface/submission-observation';
 import { type GpuDrivenBatch, type SubmissionPlan } from './batch-topology';
 import { type ShadowViewIdentity, type ShadowViewProjection, ShadowViewStatePool, type ShadowViewUpdateInput } from './shadow-views';
 import { type GpuDrivenLodSelectionInspection, type GpuDrivenLodSubmitIdentity } from './view-gpu';
@@ -26,6 +29,19 @@ export interface StandardPbrSceneCandidate {
     /** Optional GPU Scene material row carried by the shadow projection. */
     readonly materialIndex?: number;
 }
+/** Keep visible.x and the selected group(2) mesh page in one address domain. */
+export declare function resolveGpuDrivenMeshGroup(input: {
+    readonly clustered: boolean;
+    readonly deformation: 'rigid' | 'skin';
+    readonly meshBindGroup: BindGroup;
+    readonly meshProjectionBuffer: Buffer;
+    readonly meshProjectionBytes: number;
+    readonly frameResources: Pick<GpuDrivenStandardPbrFrameResources, 'clusterBindGroup' | 'clusterBindGroupForMesh' | 'clusterBindGroupForSkin'>;
+    readonly skinPaletteBinding?: {
+        readonly buffer: Buffer;
+        readonly bindingWindowBytes: number;
+    } | undefined;
+}): BindGroup | undefined;
 export interface StandardPbrSceneProjection {
     readonly entryPoint: string;
     readonly layoutIdentity: string;
@@ -131,8 +147,11 @@ export interface GpuDrivenWorldLodSelectionInspection {
     }[];
 }
 type MaterialPipelineFactory = NonNullable<RenderSystemInternals['getMaterialShaderPipelineEntry']>;
+/** The GPU-driven bridge to the existing four-group Standard PBR pipeline. */
 export interface PreparedGpuDrivenFrame {
     readonly topologySignature: string;
+    /** Composition-local world indices mapped to the stable identities used by draw keys. */
+    readonly worldKeys: readonly number[];
     /** True when every source draw item/instance is claimed by the GPU lane. */
     readonly ownsAllDrawItems: boolean;
     /** True only when the extracted ShadowCaster channel is fully represented. */
@@ -140,6 +159,8 @@ export interface PreparedGpuDrivenFrame {
     /** Concrete main-pass draw identities claimed by the GPU projection. */
     readonly drawKeys?: ReadonlySet<string>;
     readonly standardPbrFrameResources: GpuDrivenStandardPbrFrameResources;
+    /** Published Surface admission and its pass lane decision. */
+    readonly surfaceSubmission?: SurfaceGpuSubmissionAdmission;
     readonly occlusion?: OcclusionFrameProjection;
     /** @internal Commits a replacement generation only after graph promotion. */
     readonly _commitResourceReplacement: () => void;
@@ -147,6 +168,8 @@ export interface PreparedGpuDrivenFrame {
     readonly _commitGpuResourceReplacement?: () => void;
     /** @internal Discards staged shadow cache publication after a failed frame. */
     readonly _abortResourceReplacement?: () => void;
+    /** @internal Marks validated dynamic ranges consumed only after queue submit. */
+    readonly _consumeSurfaceDynamicInput?: (frameNumber: number) => Result<void, RhiError>;
     /** Concrete ShadowCaster keys claimed by the GPU subset for this frame. */
     readonly shadowDrawKeys?: ReadonlySet<string>;
     /** View-scoped ShadowCaster claims consumed by each shadow record pass. */
@@ -155,7 +178,7 @@ export interface PreparedGpuDrivenFrame {
     readonly updateShadowViews?: (views: readonly Omit<ShadowViewUpdateInput, 'sourcePlan' | 'scene'>[]) => Result<void, RhiError>;
     readonly shadowViewPool?: ShadowViewStatePool;
     readonly shadowBatchProjections?: ReadonlyMap<string, ReadonlyMap<number, GpuDrivenShadowBatchProjection>>;
-    project(graph: RenderGraphBuilder<RenderPipelineFrame>, format: TextureFormat, sampleCount: 1 | 4, additionalColorFormats?: readonly TextureFormat[]): Result<RenderPipelineGpuDrivenProjection, RenderGraphError | RhiError>;
+    project(graph: RenderGraphBuilder<RenderPipelineFrame>, format: TextureFormat, sampleCount: 1 | 4, surfaceSubmissionObservation?: () => SurfaceSubmissionCandidate | undefined, additionalColorFormats?: readonly TextureFormat[]): Result<RenderPipelineGpuDrivenProjection, RenderGraphError | RhiError>;
 }
 /**
  * Renderer-owned identity token for the validation that resolves renderable
@@ -209,6 +232,10 @@ export declare class GpuDrivenProduction {
     private readonly sceneIdentities;
     private nextSceneIdentity;
     private filteredCache;
+    private surfaceFrameRangeCache;
+    private consumedSurfaceInput;
+    private surfaceFrameRangeBuilds;
+    private surfaceFrameRangeMemberScans;
     private shadowFilteredCache;
     private gpuOwnedSnapshotsMaterialized;
     private filteredPlanBuilds;
@@ -242,6 +269,8 @@ export declare class GpuDrivenProduction {
     private shadowBatchProjections;
     private shadowDrawKeysByView;
     private shadowExpectedDrawKeys;
+    private surfaceSubmission;
+    private surfaceArtifactInspection;
     private shadowBatchProjectionSource;
     private skinPaletteBuffer;
     private committedPaletteContentRevision;
@@ -256,6 +285,9 @@ export declare class GpuDrivenProduction {
     private structureMetrics;
     private signatureCache;
     constructor(device: RhiDevice, shaderModuleFactory: PipelineBuilderShaderModuleFactory, recoveryCount?: number);
+    private resolveSurfaceFrameRanges;
+    private rememberSurfaceFrameProjection;
+    private consumeSurfaceDynamicInput;
     /**
      * Reuse the last producer-resolved residency rows when all source identity
      * and generation fences still match. Renderables and dispatch entries are
@@ -275,6 +307,10 @@ export declare class GpuDrivenProduction {
         readonly meshBySlot: ReadonlyMap<number, MeshGpuHandles>;
         readonly viewBindGroupLayout: BindGroupLayout;
         readonly meshResidencyEpoch: number;
+        /** Optional for legacy Standard callers; omitted means non-HDRP. */
+        readonly hdrp?: boolean;
+        /** Explicit Standard topology; cluster resources are bound by main-pass. */
+        readonly clustered?: boolean;
         readonly materialBindingClasses?: ReadonlyMap<string, string>;
         /** Cooked producer artifact selected from the frame material catalog. */
         readonly materialArtifact?: MaterialShaderArtifact;
@@ -288,6 +324,8 @@ export declare class GpuDrivenProduction {
         readonly materialArtifacts?: ReadonlyMap<string, MaterialShaderArtifact>;
         /** Per-draw shadow-pass artifacts keyed by the same prepared identity. */
         readonly shadowMaterialArtifacts?: ReadonlyMap<string, MaterialShaderArtifact>;
+        /** Retained ProbeBlend record page; slot N is addressed at aligned lane N+1. */
+        readonly probeBlendRecordBuffer?: Buffer;
         readonly materialPipelineState?: PipelineState;
         readonly standardPbrPipelineState?: PipelineState;
         /** Existing renderer owner that builds the selected artifact PSO/BGL. */
@@ -307,6 +345,12 @@ export declare class GpuDrivenProduction {
         readonly occlusion?: OcclusionFrameProjection;
         /** Per-frame deltas from the existing RenderScene/GPU Scene/palette owners. */
         readonly structureMetrics?: GpuDrivenStructureMetrics;
+        /** World/App frame-time snapshot consumed by authored Surface code. */
+        readonly frameTime?: number;
+        /** Current RHI device generation used for Surface admission. */
+        readonly deviceGeneration?: number;
+        /** Renderer-owned generic read-only Surface page and instance ranges. */
+        readonly surfaceDynamicInput?: SurfaceDynamicInputFrame;
     }): Result<PreparedGpuDrivenFrame | undefined, RhiError | GpuDrivenPreparationError>;
     updateShadowViews(views: readonly Omit<ShadowViewUpdateInput, 'sourcePlan' | 'scene'>[], artifact: MaterialShaderArtifact | undefined, skinArtifact: MaterialShaderArtifact | undefined, materialArtifacts: ReadonlyMap<string, MaterialShaderArtifact> | undefined, shadowMaterialArtifacts: ReadonlyMap<string, MaterialShaderArtifact> | undefined, filtered: FilteredProductionPlan, scene: PersistentGpuDrivenState, shadowCasterDrawKeys: ReadonlySet<string> | undefined, shadowCasterMembership: readonly ShadowCasterMembership[] | undefined): Result<void, RhiError>;
     private disableShadowViews;
@@ -316,7 +360,7 @@ export declare class GpuDrivenProduction {
     readLodSelection(): Promise<GpuDrivenLodSelectionInspection | undefined>;
     recordCpuValidation(validated: readonly {
         readonly source: RenderableSnapshot;
-    }[], gpuOwnedDrawKeys: ReadonlySet<string>, cacheKey?: string): void;
+    }[], gpuOwnedDrawKeys: ReadonlySet<string>, cacheKey?: string, worldKeys?: readonly number[]): void;
     private sceneIdentity;
 }
 export {};

package/dist/gpu-driven/production-raster.d.ts.map

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

package/dist/gpu-driven/resource-allocation.d.ts

@@ -0,0 +1,31 @@
+import type { GpuResourceAllocationInspection } from '../inspection-types';
+export interface GpuResourceAllocationToken {
+    readonly id: number;
+    readonly bytes: number;
+}
+/**
+ * Tracks logical Engine allocation ownership independently of physical GPU
+ * residency. A replacement is live and pending at the same time until the
+ * queue fence releases the old generation.
+ */
+export declare class GpuResourceAllocationLedger {
+    private nextId;
+    private readonly live;
+    private readonly pending;
+    private liveBytes;
+    private pendingBytes;
+    private peakBytes;
+    private successfulAllocationCount;
+    private successfulAllocationBytes;
+    private retiredBytes;
+    private failedAllocationRollbacks;
+    private failedAllocationRollbackBytes;
+    allocate(bytes: number): GpuResourceAllocationToken;
+    retire(token: GpuResourceAllocationToken): void;
+    release(token: GpuResourceAllocationToken): void;
+    rollback(token: GpuResourceAllocationToken): void;
+    inspect(): GpuResourceAllocationInspection;
+    private updatePeak;
+}
+export declare function combineGpuResourceAllocationInspections(inspections: readonly GpuResourceAllocationInspection[]): GpuResourceAllocationInspection | undefined;
+//# sourceMappingURL=resource-allocation.d.ts.map

package/dist/gpu-driven/resource-allocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-allocation.d.ts","sourceRoot":"","sources":["../../src/gpu-driven/resource-allocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAE3E,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,yBAAyB,CAAK;IACtC,OAAO,CAAC,yBAAyB,CAAK;IACtC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,yBAAyB,CAAK;IACtC,OAAO,CAAC,6BAA6B,CAAK;IAE1C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,0BAA0B;IAanD,MAAM,CAAC,KAAK,EAAE,0BAA0B,GAAG,IAAI;IAU/C,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,IAAI;IAgBhD,QAAQ,CAAC,KAAK,EAAE,0BAA0B,GAAG,IAAI;IASjD,OAAO,IAAI,+BAA+B;IAgB1C,OAAO,CAAC,UAAU;CAGnB;AAED,wBAAgB,uCAAuC,CACrD,WAAW,EAAE,SAAS,+BAA+B,EAAE,GACtD,+BAA+B,GAAG,SAAS,CA6C7C"}

package/dist/gpu-driven/shadow-ownership.d.ts

@@ -0,0 +1,14 @@
+import type { World } from '@forgeax/engine-ecs';
+import type { ShadowCasterMembership } from '../render-system-extract';
+/**
+ * Extract emits world/entity keys in the transient `worlds[]` index domain,
+ * while PersistentRenderScene owns stable renderer-local World keys for the
+ * retained GPU scene. Rebase ShadowCaster ownership at this orchestration
+ * boundary before both GPU projection and CPU residual recording consume it.
+ */
+export declare function rebaseShadowCasterOwnership(worlds: readonly World[], stableWorldKeys: readonly number[], entityKeys: ReadonlySet<number>, drawKeys: ReadonlySet<string>, membership: readonly ShadowCasterMembership[] | undefined): {
+    readonly entityKeys: ReadonlySet<number>;
+    readonly drawKeys: ReadonlySet<string>;
+    readonly membership: readonly ShadowCasterMembership[] | undefined;
+};
+//# sourceMappingURL=shadow-ownership.d.ts.map

package/dist/gpu-driven/shadow-ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-ownership.d.ts","sourceRoot":"","sources":["../../src/gpu-driven/shadow-ownership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAIvE;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,eAAe,EAAE,SAAS,MAAM,EAAE,EAClC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/B,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,UAAU,EAAE,SAAS,sBAAsB,EAAE,GAAG,SAAS,GACxD;IACD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,sBAAsB,EAAE,GAAG,SAAS,CAAC;CACpE,CA+CA"}

package/dist/gpu-driven/view-gpu.d.ts

@@ -4,6 +4,7 @@ import type { Buffer, Result, RhiDevice } from '@forgeax/engine-rhi';
 import { RhiError } from '@forgeax/engine-rhi';
 import type { GpuScene } from '../gpu-scene';
 import type { PipelineBuilderShaderModuleFactory } from '../pipeline-builder';
+import type { SurfaceGpuIndirectParameters, SurfaceGpuIndirectReadbackError, SurfaceGpuReadbackSnapshot, SurfaceSubmissionCandidate } from '../surface/submission-observation';
 import type { SubmissionPlan } from './batch-topology';
 export type GpuLodLane = 'gpu' | 'cpu';
 export declare function selectGpuLodLane(caps: {
@@ -11,7 +12,7 @@ export declare function selectGpuLodLane(caps: {
     readonly storageBuffer: boolean;
     readonly indirectDrawing: boolean;
 }): GpuLodLane;
-export declare const GPU_DRIVEN_VIEW_WGSL = "\nstruct PrimitiveRecord {\n  generation: u32,\n  flags: u32,\n  transformIndex: u32,\n  materialIndex: u32,\n  drawTemplateIndex: u32,\n  instanceStart: u32,\n  instanceCount: u32,\n  assetHandle: u32,\n  localBoundsMin: vec4<f32>,\n  localBoundsMax: vec4<f32>,\n};\n\nstruct TransformRecord {\n  currentWorld: mat4x4<f32>,\n  previousWorld: mat4x4<f32>,\n};\n\nstruct LodRecord {\n  generation: u32,\n  level: u32,\n  firstIndex: u32,\n  indexCount: u32,\n  baseVertex: i32,\n  screenCoverage: f32,\n  hysteresis: f32,\n  ready: u32,\n};\n\nstruct CandidateRecord {\n  primitiveIndex: u32,\n  generation: u32,\n  instanceOrdinal: u32,\n  materialSlot: u32,\n  batchIndex: u32,\n  visibleBase: u32,\n  visibleCapacity: u32,\n  // Low bit is admission; upper bits carry the batch-local projected Mesh row.\n  // Suppressed candidates still contribute to the all-candidate LOD histogram,\n  // but never enter the compacted visible stream. Packing both facts here\n  // keeps the candidate ABI single-source when visibility compacts rows.\n  submitAdmission: u32,\n  projectedHeight: f32,\n  previousLevel: u32,\n  historyValid: u32,\n  lodCount: u32,\n  lodRows: array<LodRecord, 8>,\n};\n\nstruct InstanceRecord {\n  primitiveIndex: u32,\n  transformIndex: u32,\n  customDataStart: u32,\n  flags: u32,\n};\n\nstruct BatchRecord {\n  visibleBase: u32,\n  visibleCapacity: u32,\n  count: u32,\n  first: u32,\n  baseVertex: i32,\n  indirectIndex: u32,\n  indexed: u32,\n  candidateBase: u32,\n};\n\nstruct ViewConstants {\n  planes: array<vec4<f32>, 6>,\n  candidateCount: u32,\n  batchCount: u32,\n  pad0: u32,\n  pad1: u32,\n};\n\nfn selectLodLevel(\n  projectedHeight: f32,\n  previousLevel: u32,\n  historyValid: bool,\n  rows: array<LodRecord, 8>,\n  levelCount: u32,\n) -> u32 {\n  // Row zero is the implicit root and has no transition threshold. Lower\n  // levels carry the absolute boundary that introduces the preceding row.\n  // This mirrors the CPU selector: height >= rows[1] selects root, height\n  // between rows[2] and rows[1] selects level 1, and so on.\n  var selected = levelCount - 1u;\n  for (var level = 1u; level < levelCount; level += 1u) {\n    if (projectedHeight >= rows[level].screenCoverage) {\n      selected = level - 1u;\n      break;\n    }\n  }\n  if (historyValid && previousLevel < levelCount && selected != previousLevel) {\n    var boundary = rows[previousLevel + 1u].screenCoverage;\n    if (selected < previousLevel) { boundary = rows[previousLevel].screenCoverage; }\n    let band = boundary * rows[previousLevel].hysteresis;\n    if (abs(projectedHeight - boundary) <= band) { selected = previousLevel; }\n  }\n  if (selected >= levelCount || rows[selected].ready == 0u) { return 0u; }\n  return selected;\n}\n\n@group(0) @binding(0) var<storage, read> primitives: array<PrimitiveRecord>;\n@group(0) @binding(1) var<storage, read> instances: array<InstanceRecord>;\n@group(0) @binding(2) var<storage, read> transforms: array<TransformRecord>;\n@group(0) @binding(3) var<storage, read> candidates: array<CandidateRecord>;\n@group(0) @binding(4) var<storage, read> batches: array<BatchRecord>;\n@group(0) @binding(5) var<uniform> view: ViewConstants;\n@group(0) @binding(6) var<storage, read_write> counters: array<atomic<u32>>;\n@group(0) @binding(7) var<storage, read_write> visibleIndices: array<vec2<u32>>;\n@group(0) @binding(8) var<storage, read_write> indirectArgs: array<u32>;\n\nfn counterIndex(batchIndex: u32) -> u32 { return batchIndex * 12u; }\nfn overflowIndex(batchIndex: u32) -> u32 { return counterIndex(batchIndex) + 1u; }\nfn lodCounterIndex(batchIndex: u32, level: u32) -> u32 {\n  return counterIndex(batchIndex) + 2u + level;\n}\n\nfn isVisible(primitive: PrimitiveRecord, world: mat4x4<f32>) -> bool {\n  // GPU Scene bounds are optional. A producer that has not published local\n  // bounds still belongs in the GPU lane; keep it conservatively visible\n  // instead of silently dropping a valid draw.\n  if ((primitive.flags & 5u) != 5u) { return false; }\n  if ((primitive.flags & 2u) == 0u) { return true; }\n  let localCenter = (primitive.localBoundsMin.xyz + primitive.localBoundsMax.xyz) * 0.5;\n  let localExtent = (primitive.localBoundsMax.xyz - primitive.localBoundsMin.xyz) * 0.5;\n  let worldCenter = (world * vec4<f32>(localCenter, 1.0)).xyz;\n  let worldExtent =\n    abs(world[0].xyz) * localExtent.x +\n    abs(world[1].xyz) * localExtent.y +\n    abs(world[2].xyz) * localExtent.z;\n  for (var planeIndex = 0u; planeIndex < 6u; planeIndex += 1u) {\n    let plane = view.planes[planeIndex];\n    let radius = dot(abs(plane.xyz), worldExtent);\n    if (dot(plane.xyz, worldCenter) + plane.w < -radius) { return false; }\n  }\n  return true;\n}\n\n@compute @workgroup_size(64)\nfn resetView(@builtin(global_invocation_id) id: vec3<u32>) {\n  let batchIndex = id.x;\n  if (batchIndex >= view.batchCount) { return; }\n  atomicStore(&counters[counterIndex(batchIndex)], 0u);\n  atomicStore(&counters[overflowIndex(batchIndex)], 0u);\n  for (var level = 0u; level < 8u; level += 1u) {\n    atomicStore(&counters[lodCounterIndex(batchIndex, level)], 0u);\n  }\n  atomicStore(&counters[counterIndex(batchIndex) + 10u], 0u);\n  atomicStore(&counters[counterIndex(batchIndex) + 11u], 0u);\n}\n\n@compute @workgroup_size(64)\nfn cullView(@builtin(global_invocation_id) id: vec3<u32>) {\n  let candidateIndex = id.x;\n  if (candidateIndex >= view.candidateCount) { return; }\n  let candidate = candidates[candidateIndex];\n  let primitive = primitives[candidate.primitiveIndex];\n  if (primitive.generation != candidate.generation) { return; }\n  if (candidate.instanceOrdinal >= primitive.instanceCount) { return; }\n  let instanceIndex = primitive.instanceStart + candidate.instanceOrdinal;\n  let instance = instances[instanceIndex];\n  let world = transforms[primitive.transformIndex].currentWorld * transforms[instance.transformIndex].currentWorld;\n  let selectedLod = selectLodLevel(\n    candidate.projectedHeight,\n    candidate.previousLevel,\n    candidate.historyValid != 0u,\n    candidate.lodRows,\n    candidate.lodCount,\n  );\n  if (candidate.lodRows[selectedLod].ready == 0u) { return; }\n  // Selector counters describe the complete LOD population, including\n  // candidates outside the frustum and candidates suppressed by the CPU\n  // visibility facet. Submission counters below remain compacted draw facts.\n  atomicAdd(&counters[lodCounterIndex(candidate.batchIndex, selectedLod)], 1u);\n  if ((candidate.submitAdmission & 1u) == 0u) { return; }\n  if (!isVisible(primitive, world)) { return; }\n  atomicAdd(\n    &counters[counterIndex(candidate.batchIndex) + 10u],\n    candidate.lodRows[selectedLod].indexCount,\n  );\n  atomicAdd(\n    &counters[counterIndex(candidate.batchIndex) + 11u],\n    candidate.lodRows[0u].indexCount,\n  );\n  let localVisible = atomicAdd(&counters[counterIndex(candidate.batchIndex)], 1u);\n  if (localVisible >= candidate.visibleCapacity) {\n    atomicStore(&counters[overflowIndex(candidate.batchIndex)], 1u);\n    return;\n  }\n  var materialOrPalette = primitive.materialIndex + (candidate.materialSlot & 0x7fffffffu);\n  if ((candidate.materialSlot & 0x80000000u) != 0u) {\n    materialOrPalette = instance.customDataStart;\n  }\n  visibleIndices[candidate.visibleBase + localVisible] = vec2<u32>(\n    candidate.submitAdmission >> 1u,\n    materialOrPalette,\n  );\n}\n\n@compute @workgroup_size(64)\nfn finalizeView(@builtin(global_invocation_id) id: vec3<u32>) {\n  let batchIndex = id.x;\n  if (batchIndex >= view.batchCount) { return; }\n  let batch = batches[batchIndex];\n  var visibleCount = min(\n    atomicLoad(&counters[counterIndex(batchIndex)]),\n    batch.visibleCapacity,\n  );\n  // Overflow is a failed generation, never a partially valid draw. Keep the\n  // telemetry flag for the producer retry path but emit zero instances so no\n  // subset of a visible batch reaches the rasterizer.\n  if (atomicLoad(&counters[overflowIndex(batchIndex)]) != 0u) {\n    visibleCount = 0u;\n  }\n  let args = batch.indirectIndex * 5u;\n  let candidate = candidates[batch.candidateBase];\n  let selectedLod = selectLodLevel(candidate.projectedHeight, candidate.previousLevel, candidate.historyValid != 0u, candidate.lodRows, candidate.lodCount);\n  let lod = candidate.lodRows[selectedLod];\n  indirectArgs[args] = select(batch.count, lod.indexCount, candidate.lodCount > 0u);\n  indirectArgs[args + 1u] = visibleCount;\n  indirectArgs[args + 2u] = select(batch.first, lod.firstIndex, candidate.lodCount > 0u && batch.indexed != 0u);\n  indirectArgs[args + 3u] = select(0u, bitcast<u32>(lod.baseVertex), candidate.lodCount > 0u && batch.indexed != 0u);\n  indirectArgs[args + 4u] = 0u;\n}\n";
+export declare const GPU_DRIVEN_VIEW_WGSL = "\nstruct PrimitiveRecord {\n  generation: u32,\n  flags: u32,\n  transformIndex: u32,\n  materialIndex: u32,\n  drawTemplateIndex: u32,\n  instanceStart: u32,\n  instanceCount: u32,\n  assetHandle: u32,\n  localBoundsMin: vec4<f32>,\n  localBoundsMax: vec4<f32>,\n};\n\nstruct TransformRecord {\n  currentWorld: mat4x4<f32>,\n  previousWorld: mat4x4<f32>,\n};\n\nstruct LodRecord {\n  generation: u32,\n  level: u32,\n  firstIndex: u32,\n  indexCount: u32,\n  baseVertex: i32,\n  screenCoverage: f32,\n  hysteresis: f32,\n  ready: u32,\n};\n\nstruct CandidateRecord {\n  primitiveIndex: u32,\n  generation: u32,\n  instanceOrdinal: u32,\n  materialSlot: u32,\n  batchIndex: u32,\n  visibleBase: u32,\n  visibleCapacity: u32,\n  // Low bit is admission; upper bits carry the batch-local projected Mesh row.\n  // Suppressed candidates still contribute to the all-candidate LOD histogram,\n  // but never enter the compacted visible stream. Packing both facts here\n  // keeps the candidate ABI single-source when visibility compacts rows.\n  submitAdmission: u32,\n  projectedHeight: f32,\n  previousLevel: u32,\n  historyValid: u32,\n  lodCount: u32,\n  lodRows: array<LodRecord, 8>,\n};\n\nstruct InstanceRecord {\n  primitiveIndex: u32,\n  transformIndex: u32,\n  customDataStart: u32,\n  flags: u32,\n};\n\nstruct BatchRecord {\n  visibleBase: u32,\n  visibleCapacity: u32,\n  count: u32,\n  first: u32,\n  baseVertex: i32,\n  indirectIndex: u32,\n  indexed: u32,\n  candidateBase: u32,\n};\n\nstruct ViewConstants {\n  planes: array<vec4<f32>, 6>,\n  candidateCount: u32,\n  batchCount: u32,\n  pad0: u32,\n  pad1: u32,\n};\n\nfn selectLodLevel(\n  projectedHeight: f32,\n  previousLevel: u32,\n  historyValid: bool,\n  rows: array<LodRecord, 8>,\n  levelCount: u32,\n) -> u32 {\n  // Row zero is the implicit root and has no transition threshold. Lower\n  // levels carry the absolute boundary that introduces the preceding row.\n  // This mirrors the CPU selector: height >= rows[1] selects root, height\n  // between rows[2] and rows[1] selects level 1, and so on.\n  var selected = levelCount - 1u;\n  for (var level = 1u; level < levelCount; level += 1u) {\n    if (projectedHeight >= rows[level].screenCoverage) {\n      selected = level - 1u;\n      break;\n    }\n  }\n  if (historyValid && previousLevel < levelCount && selected != previousLevel) {\n    var boundary = rows[previousLevel + 1u].screenCoverage;\n    if (selected < previousLevel) { boundary = rows[previousLevel].screenCoverage; }\n    let band = boundary * rows[previousLevel].hysteresis;\n    if (abs(projectedHeight - boundary) <= band) { selected = previousLevel; }\n  }\n  if (selected >= levelCount || rows[selected].ready == 0u) { return 0u; }\n  return selected;\n}\n\n@group(0) @binding(0) var<storage, read> primitives: array<PrimitiveRecord>;\n@group(0) @binding(1) var<storage, read> instances: array<InstanceRecord>;\n@group(0) @binding(2) var<storage, read> transforms: array<TransformRecord>;\n@group(0) @binding(3) var<storage, read> candidates: array<CandidateRecord>;\n@group(0) @binding(4) var<storage, read> batches: array<BatchRecord>;\n@group(0) @binding(5) var<uniform> view: ViewConstants;\n@group(0) @binding(6) var<storage, read_write> counters: array<atomic<u32>>;\n@group(0) @binding(7) var<storage, read_write> visibleIndices: array<vec4<u32>>;\n@group(0) @binding(8) var<storage, read_write> indirectArgs: array<u32>;\n\nfn counterIndex(batchIndex: u32) -> u32 { return batchIndex * 12u; }\nfn overflowIndex(batchIndex: u32) -> u32 { return counterIndex(batchIndex) + 1u; }\nfn lodCounterIndex(batchIndex: u32, level: u32) -> u32 {\n  return counterIndex(batchIndex) + 2u + level;\n}\n\nfn isVisible(primitive: PrimitiveRecord, world: mat4x4<f32>) -> bool {\n  // GPU Scene bounds are optional. A producer that has not published local\n  // bounds still belongs in the GPU lane; keep it conservatively visible\n  // instead of silently dropping a valid draw.\n  if ((primitive.flags & 5u) != 5u) { return false; }\n  if ((primitive.flags & 2u) == 0u) { return true; }\n  let localCenter = (primitive.localBoundsMin.xyz + primitive.localBoundsMax.xyz) * 0.5;\n  let localExtent = (primitive.localBoundsMax.xyz - primitive.localBoundsMin.xyz) * 0.5;\n  let worldCenter = (world * vec4<f32>(localCenter, 1.0)).xyz;\n  let worldExtent =\n    abs(world[0].xyz) * localExtent.x +\n    abs(world[1].xyz) * localExtent.y +\n    abs(world[2].xyz) * localExtent.z;\n  for (var planeIndex = 0u; planeIndex < 6u; planeIndex += 1u) {\n    let plane = view.planes[planeIndex];\n    let radius = dot(abs(plane.xyz), worldExtent);\n    if (dot(plane.xyz, worldCenter) + plane.w < -radius) { return false; }\n  }\n  return true;\n}\n\n@compute @workgroup_size(64)\nfn resetView(@builtin(global_invocation_id) id: vec3<u32>) {\n  let batchIndex = id.x;\n  if (batchIndex >= view.batchCount) { return; }\n  atomicStore(&counters[counterIndex(batchIndex)], 0u);\n  atomicStore(&counters[overflowIndex(batchIndex)], 0u);\n  for (var level = 0u; level < 8u; level += 1u) {\n    atomicStore(&counters[lodCounterIndex(batchIndex, level)], 0u);\n  }\n  atomicStore(&counters[counterIndex(batchIndex) + 10u], 0u);\n  atomicStore(&counters[counterIndex(batchIndex) + 11u], 0u);\n}\n\n@compute @workgroup_size(64)\nfn cullView(@builtin(global_invocation_id) id: vec3<u32>) {\n  let candidateIndex = id.x;\n  if (candidateIndex >= view.candidateCount) { return; }\n  let candidate = candidates[candidateIndex];\n  let primitive = primitives[candidate.primitiveIndex];\n  if (primitive.generation != candidate.generation) { return; }\n  if (candidate.instanceOrdinal >= primitive.instanceCount) { return; }\n  let instanceIndex = primitive.instanceStart + candidate.instanceOrdinal;\n  let instance = instances[instanceIndex];\n  let world = transforms[primitive.transformIndex].currentWorld * transforms[instance.transformIndex].currentWorld;\n  let selectedLod = selectLodLevel(\n    candidate.projectedHeight,\n    candidate.previousLevel,\n    candidate.historyValid != 0u,\n    candidate.lodRows,\n    candidate.lodCount,\n  );\n  if (candidate.lodRows[selectedLod].ready == 0u) { return; }\n  // Selector counters describe the complete LOD population, including\n  // candidates outside the frustum and candidates suppressed by the CPU\n  // visibility facet. Submission counters below remain compacted draw facts.\n  atomicAdd(&counters[lodCounterIndex(candidate.batchIndex, selectedLod)], 1u);\n  if ((candidate.submitAdmission & 1u) == 0u) { return; }\n  if (!isVisible(primitive, world)) { return; }\n  atomicAdd(\n    &counters[counterIndex(candidate.batchIndex) + 10u],\n    candidate.lodRows[selectedLod].indexCount,\n  );\n  atomicAdd(\n    &counters[counterIndex(candidate.batchIndex) + 11u],\n    candidate.lodRows[0u].indexCount,\n  );\n  let localVisible = atomicAdd(&counters[counterIndex(candidate.batchIndex)], 1u);\n  if (localVisible >= candidate.visibleCapacity) {\n    atomicStore(&counters[overflowIndex(candidate.batchIndex)], 1u);\n    return;\n  }\n  var materialOrPalette = primitive.materialIndex + (candidate.materialSlot & 0x7fffffffu);\n  if ((candidate.materialSlot & 0x80000000u) != 0u) {\n    materialOrPalette = instance.customDataStart;\n  }\n  visibleIndices[candidate.visibleBase + localVisible] = vec4<u32>(\n    candidate.submitAdmission >> 1u,\n    materialOrPalette,\n    candidate.primitiveIndex + 1u,\n    candidate.generation,\n  );\n}\n\n@compute @workgroup_size(64)\nfn finalizeView(@builtin(global_invocation_id) id: vec3<u32>) {\n  let batchIndex = id.x;\n  if (batchIndex >= view.batchCount) { return; }\n  let batch = batches[batchIndex];\n  var visibleCount = min(\n    atomicLoad(&counters[counterIndex(batchIndex)]),\n    batch.visibleCapacity,\n  );\n  // Overflow is a failed generation, never a partially valid draw. Keep the\n  // telemetry flag for the producer retry path but emit zero instances so no\n  // subset of a visible batch reaches the rasterizer.\n  if (atomicLoad(&counters[overflowIndex(batchIndex)]) != 0u) {\n    visibleCount = 0u;\n  }\n  let args = batch.indirectIndex * 5u;\n  let candidate = candidates[batch.candidateBase];\n  let selectedLod = selectLodLevel(candidate.projectedHeight, candidate.previousLevel, candidate.historyValid != 0u, candidate.lodRows, candidate.lodCount);\n  let lod = candidate.lodRows[selectedLod];\n  var drawCount = batch.count;\n  var drawFirst = batch.first;\n  var drawBaseVertex: i32 = 0;\n  if (candidate.lodCount > 0u) {\n    drawCount = lod.indexCount;\n    if (batch.indexed != 0u) {\n      drawFirst = lod.firstIndex;\n      drawBaseVertex = lod.baseVertex;\n    }\n  } else if (batch.indexed != 0u) {\n    drawBaseVertex = batch.baseVertex;\n  }\n  indirectArgs[args] = drawCount;\n  indirectArgs[args + 1u] = visibleCount;\n  indirectArgs[args + 2u] = drawFirst;\n  indirectArgs[args + 3u] = bitcast<u32>(drawBaseVertex);\n  indirectArgs[args + 4u] = 0u;\n}\n";
 export interface GpuDrivenLodSubmitIdentity {
     readonly frameId: number;
     readonly deviceGeneration: number;
@@ -43,6 +44,8 @@ export interface GpuDrivenViewInspection {
     readonly bindGroupCreates: number;
     readonly bufferRebuilds: number;
     readonly resourceGeneration: number;
+    /** Logical Engine allocation facts; physical VRAM residency is unknown. */
+    readonly resourceAllocation: import('../inspection-types').GpuResourceAllocationInspection;
 }
 export interface GpuDrivenViewBufferCapacities {
     readonly candidate: number;
@@ -51,6 +54,8 @@ export interface GpuDrivenViewBufferCapacities {
     readonly indirect: number;
 }
 export interface GpuDrivenLodSelectionInspection {
+    /** Exact resource generation whose selector rows were copied. */
+    readonly resourceGeneration?: number;
     readonly candidateCount: number;
     readonly batchCount: number;
     readonly indirectDrawCount: number;
@@ -87,6 +92,22 @@ export interface GpuDrivenLodSelectionInspection {
     }[];
     readonly geometryWork: number;
     readonly rootGeometryWork: number;
+    /** Actual visible rows copied from the submitted GPU selector. */
+    readonly actualMembers: readonly {
+        readonly batchId: number;
+        readonly primitiveIndex: number;
+        readonly generation: number;
+        readonly drawItemIndex: number;
+        readonly instanceOrdinal: number;
+    }[];
+    /** Surface subset projected by the material producer after readback. */
+    readonly surfaceActualMemberIds?: readonly string[];
+    /** Decoded indexed/non-indexed command words for the exact Surface copy. */
+    readonly surfaceIndirectParameters?: readonly SurfaceGpuIndirectParameters[];
+    /** Fail-closed readback reason when the copied command range is unusable. */
+    readonly surfaceIndirectReadbackError?: SurfaceGpuIndirectReadbackError;
+    /** Exact Surface recording whose selector bytes were copied. */
+    readonly surfaceReadback?: SurfaceGpuReadbackSnapshot;
     /** Public receipt identity captured when the telemetry copy was encoded. */
     readonly submit?: GpuDrivenLodSubmitIdentity;
 }
@@ -127,6 +148,8 @@ export declare class GpuDrivenView {
     private bindGroupCreates;
     private bufferRebuilds;
     private resourceGeneration;
+    private readonly allocationLedger;
+    private readonly allocationTokens;
     /** The last readback copy that was actually encoded and is not consumed. */
     private telemetryPending;
     /** Receipt identity for the copy pass encoded by the current frame. */
@@ -150,7 +173,7 @@ export declare class GpuDrivenView {
     /** Read selected levels written by the GPU cull pass for the last submit. */
     readLodSelection(): Promise<GpuDrivenLodSelectionInspection | undefined>;
     private readLodSelectionCopy;
-    addPasses<FrameCtx extends RenderGraphFrame>(builder: RenderGraphBuilder<FrameCtx>, labelPrefix?: string, includeCompute?: boolean): Result<GpuDrivenViewGraphResources, RenderGraphError>;
+    addPasses<FrameCtx extends RenderGraphFrame>(builder: RenderGraphBuilder<FrameCtx>, labelPrefix?: string, includeCompute?: boolean, surfaceSubmissionObservation?: () => SurfaceSubmissionCandidate | undefined): Result<GpuDrivenViewGraphResources, RenderGraphError>;
     dispose(): void;
     /**
      * @internal
@@ -168,6 +191,7 @@ export declare class GpuDrivenView {
     _recoverFromOverflow(): Result<void, RhiError>;
     private rebuildBuffers;
     private destroyAfterSubmittedWork;
+    private retireGeneration;
 }
 export { decideVisibility } from '../scene/visibility/occlusion-confidence';
 //# sourceMappingURL=view-gpu.d.ts.map

package/dist/gpu-driven/view-gpu.d.ts.map

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

package/dist/gpu-scene.d.ts

@@ -22,6 +22,9 @@ export type GpuSceneAvailability = {
 export declare class GpuScene {
     private readonly device;
     private capacity;
+    private readonly dirtyRanges;
+    private readonly rowScratch;
+    private readonly rowScratchView;
     private disposed;
     private tableBytes;
     private transformBytes;
@@ -71,6 +74,8 @@ export declare class GpuScene {
     inspect(): GpuSceneInspection;
     dispose(): void;
     private writeSlot;
+    /** Compare against the resident CPU bytes; pending upload rows survive failure. */
+    private writeRow;
     private writeMaterialSlot;
     /** Consume changed instance fields independently of root or material changes. */
     private writeInstanceTransforms;