@forgeax/engine-render 0.1.20 → 0.1.23

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

@@ -1,18 +1,91 @@
 import type { RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
-import type { BindGroupLayout, Result, RhiDevice, TextureFormat } from '@forgeax/engine-rhi';
+import type { BindGroup, BindGroupLayout, Result, RhiDevice, TextureFormat } from '@forgeax/engine-rhi';
 import { RhiError } from '@forgeax/engine-rhi';
+import type { MaterialShaderArtifact } from '@forgeax/engine-shader';
 import type { MeshGpuHandles } from '../device/gpu-residency';
 import type { GpuDrivenProductionInspection } from '../inspection-types';
 import type { PipelineBuilderShaderModuleFactory } from '../pipeline-builder';
+import type { PipelineState } from '../record/render-context';
 import type { CameraSnapshot } from '../render-contract';
 import type { RenderPipelineFrame, RenderPipelineGpuDrivenProjection } from '../render-pipeline';
 import type { RenderableSnapshot } from '../render-system-extract';
 import type { PersistentGpuDrivenState } from '../scene/render-scene';
+import type { OcclusionFrameProjection } from '../scene/visibility/occlusion-runtime';
+import { type GpuDrivenLodSelectionInspection } from './view-gpu';
+export interface StandardPbrSceneCandidate {
+    readonly primitiveIndex: number;
+    readonly world: Float32Array;
+}
+export interface StandardPbrSceneProjection {
+    readonly entryPoint: string;
+    readonly layoutIdentity: string;
+    readonly receiptGeneration: number;
+    /** Packed Mesh rows: mat4 + padded mat3 + previous mat4 + temporal vec4. */
+    readonly rows: Float32Array;
+}
+/**
+ * Build the producer-owned Standard PBR scene-index projection. The receipt is
+ * the only source of the vertex entry and layout identity; callers cannot
+ * silently fall back to the legacy GPU-driven shader ABI.
+ */
+export declare function projectStandardPbrScene(input: {
+    readonly artifact: MaterialShaderArtifact;
+    readonly candidates: readonly StandardPbrSceneCandidate[];
+}): {
+    readonly ok: true;
+    readonly value: StandardPbrSceneProjection;
+} | {
+    readonly ok: false;
+    readonly error: {
+        readonly code: 'missing-material-receipt' | 'invalid-material-receipt';
+    };
+};
+export interface StandardPbrFrameResourceBinding {
+    readonly entryPoint: string;
+    readonly layoutIdentity: string;
+    readonly receiptGeneration: number;
+    readonly bindGroups: readonly [BindGroup, BindGroup, BindGroup, BindGroup];
+    readonly resourceSlots: NonNullable<MaterialShaderArtifact['receipt']>['resourceSlots'];
+}
+/**
+ * Adapt the frame's already-created Standard PBR groups to the GPU-driven
+ * scene-index draw. This deliberately accepts group handles rather than
+ * rebuilding layouts or shader artifacts; the receipt remains the binding
+ * contract and the regular frame producers remain the resource owners.
+ */
+export declare function adaptStandardPbrFrameResources(input: {
+    readonly artifact: MaterialShaderArtifact;
+    readonly view: BindGroup;
+    readonly material: BindGroup;
+    readonly mesh: BindGroup;
+    readonly instances: BindGroup;
+}): {
+    readonly ok: true;
+    readonly value: StandardPbrFrameResourceBinding;
+} | {
+    readonly ok: false;
+    readonly error: {
+        readonly code: 'missing-material-receipt' | 'invalid-material-receipt';
+    };
+};
 export declare const GPU_DRIVEN_RIGID_UNLIT_WGSL: string;
+export interface GpuDrivenWorldLodSelectionInspection {
+    readonly worldKey: number;
+    readonly primitiveSlot: number;
+    readonly slotGeneration: number;
+    readonly candidateCount: number;
+    readonly visible: number;
+    readonly occluded: number;
+    readonly lodHistogram: readonly {
+        readonly level: number;
+        readonly count: number;
+    }[];
+}
 export interface PreparedGpuDrivenFrame {
     readonly topologySignature: string;
     readonly entityKeys: ReadonlySet<number>;
     readonly ownsAllRenderables: boolean;
+    readonly occlusion?: OcclusionFrameProjection;
     /** @internal Commits a replacement generation only after graph promotion. */
     readonly _commitResourceReplacement: () => void;
     project(graph: RenderGraphBuilder<RenderPipelineFrame>, format: TextureFormat, sampleCount: 1 | 4): Result<RenderPipelineGpuDrivenProjection, RenderGraphError | RhiError>;
@@ -22,6 +95,7 @@ export declare class GpuDrivenProduction {
     private readonly shaderModuleFactory;
     private view;
     private raster;
+    private standardRaster;
     private readonly sceneIdentities;
     private nextSceneIdentity;
     private filteredCache;
@@ -31,6 +105,13 @@ export declare class GpuDrivenProduction {
     private batchBindGroupCreates;
     private validatedGpuOwnedRows;
     private cpuFallbackDrawItems;
+    private telemetryPrepared;
+    private telemetryCandidateCount;
+    private telemetryGeometryWork;
+    private telemetryRootGeometryWork;
+    private indirectDrawCount;
+    private sceneRowsRequired;
+    private standardPbrProjection;
     private signatureCache;
     constructor(device: RhiDevice, shaderModuleFactory: PipelineBuilderShaderModuleFactory);
     prepare(input: {
@@ -40,12 +121,26 @@ export declare class GpuDrivenProduction {
         readonly viewBindGroupLayout: BindGroupLayout;
         readonly meshResidencyEpoch: number;
         readonly hdrp: boolean;
+        /** Entity keys admitted by the persistent visibility facet for this view. */
+        readonly activeEntityKeys?: ReadonlySet<number>;
+        /** Collision-free renderer-owned revision for the active visibility set. */
+        readonly activeEntityRevision?: number;
+        /** Total extracted candidates, including facet-suppressed rows. */
+        readonly telemetryCandidateCount?: number;
+        readonly occlusion?: OcclusionFrameProjection;
+        /** Cooked producer artifact selected from the frame material catalog. */
+        readonly standardPbrArtifact?: MaterialShaderArtifact;
+        readonly standardPbrPipelineState?: PipelineState;
     }): Result<PreparedGpuDrivenFrame | undefined, RhiError>;
     dispose(): void;
+    /** Whether the current production topology can consume GPU Scene row updates. */
+    requiresSceneRows(): boolean;
     inspect(): GpuDrivenProductionInspection;
+    /** Read renderer-owned LOD counters copied by the last GPU submission. */
+    readLodSelection(): Promise<GpuDrivenLodSelectionInspection | undefined>;
     recordCpuValidation(validated: readonly {
         readonly source: RenderableSnapshot;
-    }[], gpuOwned: ReadonlySet<number>): void;
+    }[], gpuOwned: ReadonlySet<number>, worldKeys?: readonly number[]): void;
     private sceneIdentity;
 }
 //# sourceMappingURL=production-raster.d.ts.map

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":"AACA,OAAO,KAAK,EAIV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAEV,eAAe,EAEf,MAAM,EACN,SAAS,EAET,aAAa,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAW,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAO9D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AAG9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAQtE,eAAO,MAAM,2BAA2B,QA0CvC,CAAC;AAsSF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,6EAA6E;IAC7E,QAAQ,CAAC,0BAA0B,EAAE,MAAM,IAAI,CAAC;IAChD,OAAO,CACL,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,EAC9C,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,CAAC,GAAG,CAAC,GACjB,MAAM,CAAC,iCAAiC,EAAE,gBAAgB,GAAG,QAAQ,CAAC,CAAC;CAC3E;AAED,qBAAa,mBAAmB;IA6B5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IA7BtC,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiC;IACjE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,aAAa,CAMP;IACd,OAAO,CAAC,6BAA6B,CAAK;IAC1C,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,cAAc,CAQR;gBAGK,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,kCAAkC;IAG1E,OAAO,CAAC,KAAK,EAAE;QACb,QAAQ,CAAC,KAAK,EAAE,wBAAwB,GAAG,SAAS,CAAC;QACrD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;QAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACrD,QAAQ,CAAC,mBAAmB,EAAE,eAAe,CAAC;QAC9C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;KACxB,GAAG,MAAM,CAAC,sBAAsB,GAAG,SAAS,EAAE,QAAQ,CAAC;IA2NxD,OAAO,IAAI,IAAI;IAQf,OAAO,IAAI,6BAA6B;IAiBxC,mBAAmB,CACjB,SAAS,EAAE,SAAS;QAAE,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;KAAE,EAAE,EAC7D,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,IAAI;IASP,OAAO,CAAC,aAAa;CAQtB"}
+{"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/view-gpu.d.ts

@@ -5,7 +5,13 @@ import { RhiError } from '@forgeax/engine-rhi';
 import type { GpuScene } from '../gpu-scene';
 import type { PipelineBuilderShaderModuleFactory } from '../pipeline-builder';
 import type { SubmissionPlan } from './batch-topology';
-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 CandidateRecord {\n  primitiveIndex: u32,\n  generation: u32,\n  instanceOrdinal: u32,\n  materialSlot: u32,\n  batchIndex: u32,\n  visibleBase: u32,\n  visibleCapacity: u32,\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};\n\nstruct ViewConstants {\n  planes: array<vec4<f32>, 6>,\n  candidateCount: u32,\n  batchCount: u32,\n  pad0: u32,\n  pad1: u32,\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 * 2u; }\nfn overflowIndex(batchIndex: u32) -> u32 { return batchIndex * 2u + 1u; }\n\nfn isVisible(primitive: PrimitiveRecord, world: mat4x4<f32>) -> bool {\n  if ((primitive.flags & 7u) != 7u) { return false; }\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}\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  if (!isVisible(primitive, world)) { return; }\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  visibleIndices[candidate.visibleBase + localVisible] = vec2<u32>(\n    instanceIndex,\n    primitive.materialIndex + candidate.materialSlot,\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  let visibleCount = min(\n    atomicLoad(&counters[counterIndex(batchIndex)]),\n    batch.visibleCapacity,\n  );\n  let args = batch.indirectIndex * 5u;\n  indirectArgs[args] = batch.count;\n  indirectArgs[args + 1u] = visibleCount;\n  indirectArgs[args + 2u] = batch.first;\n  indirectArgs[args + 3u] = select(0u, bitcast<u32>(batch.baseVertex), batch.indexed != 0u);\n  indirectArgs[args + 4u] = 0u;\n}\n";
+export type GpuLodLane = 'gpu' | 'cpu';
+export declare function selectGpuLodLane(caps: {
+    readonly compute: boolean;
+    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  // Admission is separate from selector membership: suppressed candidates\n  // still contribute to the all-candidate LOD histogram, but never enter the\n  // compacted visible stream.\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 == 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  visibleIndices[candidate.visibleBase + localVisible] = vec2<u32>(\n    instanceIndex,\n    primitive.materialIndex + candidate.materialSlot,\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  let visibleCount = min(\n    atomicLoad(&counters[counterIndex(batchIndex)]),\n    batch.visibleCapacity,\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 interface GpuDrivenViewGraphResources {
     readonly primitive: GraphBuffer;
     readonly instance: GraphBuffer;
@@ -21,6 +27,8 @@ export interface GpuDrivenViewInspection {
     readonly batchCount: number;
     readonly visibleCapacity: number;
     readonly candidateCapacity: number;
+    /** Allocated visible-index capacity; distinct from logical candidates. */
+    readonly visibleBufferCapacity: number;
     readonly batchCapacity: number;
     readonly indirectCapacity: number;
     readonly updateCount: number;
@@ -32,6 +40,55 @@ export interface GpuDrivenViewInspection {
     readonly bufferRebuilds: number;
     readonly resourceGeneration: number;
 }
+export interface GpuDrivenViewBufferCapacities {
+    readonly candidate: number;
+    readonly visible: number;
+    readonly batch: number;
+    readonly indirect: number;
+}
+export interface GpuDrivenLodSelectionInspection {
+    readonly candidateCount: number;
+    readonly batchCount: number;
+    readonly indirectDrawCount: number;
+    readonly visible: number;
+    readonly occluded: number;
+    readonly lodHistogram: readonly {
+        readonly level: number;
+        readonly count: number;
+    }[];
+    readonly batches: readonly {
+        readonly batchId: number;
+        readonly candidateCount: number;
+        readonly visible: number;
+        readonly occluded: number;
+        readonly lodHistogram: readonly {
+            readonly level: number;
+            readonly count: number;
+        }[];
+    }[];
+    readonly worldSelections?: readonly {
+        readonly worldKey: number;
+        readonly primitiveSlot: number;
+        readonly slotGeneration: number;
+        readonly candidateCount: number;
+        readonly visible: number;
+        readonly occluded: number;
+        readonly lodHistogram: readonly {
+            readonly level: number;
+            readonly count: number;
+        }[];
+    }[];
+    readonly geometryWork: number;
+    readonly rootGeometryWork: number;
+}
+/**
+ * Derive each GPU-driven allocation from its own logical capacity domain.
+ * Candidate records are dense; visible indices use the sparse, 64-entry
+ * aligned ranges assigned by BatchTopology. Keeping these values separate is
+ * what makes a large LOD candidate set bounded instead of multiplying the
+ * candidate record and inline LOD-row buffers by the visible address space.
+ */
+export declare function deriveGpuDrivenViewBufferCapacities(plan: Pick<SubmissionPlan, 'candidateCount' | 'visibleCapacity' | 'batches'>): GpuDrivenViewBufferCapacities;
 export declare class GpuDrivenView {
     private readonly device;
     private readonly bindGroupLayout;
@@ -43,6 +100,7 @@ export declare class GpuDrivenView {
     private supersededBuffers;
     private bindGroup;
     private candidateCapacity;
+    private visibleBufferCapacity;
     private batchCapacity;
     private indirectCapacity;
     private plan;
@@ -59,6 +117,8 @@ export declare class GpuDrivenView {
     private bindGroupCreates;
     private bufferRebuilds;
     private resourceGeneration;
+    private telemetryPending;
+    private lodSelection;
     private constructor();
     static create(input: {
         readonly device: RhiDevice;
@@ -70,6 +130,8 @@ export declare class GpuDrivenView {
     get indirectBuffer(): Buffer | undefined;
     get overflowBuffer(): Buffer | undefined;
     get overflowByteOffset(): number;
+    /** Read selected levels written by the GPU cull pass for the last submit. */
+    readLodSelection(): Promise<GpuDrivenLodSelectionInspection | undefined>;
     addPasses<FrameCtx extends RenderGraphFrame>(builder: RenderGraphBuilder<FrameCtx>): Result<GpuDrivenViewGraphResources, RenderGraphError>;
     dispose(): void;
     /**
@@ -82,4 +144,5 @@ export declare class GpuDrivenView {
     private rebuildBuffers;
     private destroyAfterSubmittedWork;
 }
+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-schema.d.ts

@@ -22,6 +22,19 @@ export declare function deriveGpuSceneTableLayout(schema: GpuSceneTableSchema):
 export declare function gpuSceneFieldOffset(layout: GpuSceneTableLayout, name: string): number;
 export declare function gpuSceneWgsl(layout: GpuSceneTableLayout): string;
 export declare const GPU_SCENE_SCHEMAS: Readonly<{
+    lod: {
+        name: string;
+        fields: ({
+            name: string;
+            type: "u32";
+        } | {
+            name: string;
+            type: "i32";
+        } | {
+            name: string;
+            type: "f32";
+        })[];
+    };
     primitive: {
         name: string;
         fields: ({
@@ -68,6 +81,7 @@ export declare const GPU_SCENE_SCHEMAS: Readonly<{
     };
 }>;
 export declare const GPU_SCENE_LAYOUTS: Readonly<{
+    readonly lod: GpuSceneTableLayout;
     readonly primitive: GpuSceneTableLayout;
     readonly instance: GpuSceneTableLayout;
     readonly transform: GpuSceneTableLayout;

package/dist/gpu-scene-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gpu-scene-schema.d.ts","sourceRoot":"","sources":["../src/gpu-scene-schema.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,WAAW,GAAG,aAAa,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACjD;AAgBD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAY1F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAGhE;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0D4B,CAAC;AAE3D,eAAO,MAAM,iBAAiB;;;;;;EAS7B,CAAC;AAEF,eAAO,MAAM,cAAc,QAAkE,CAAC"}
+{"version":3,"file":"gpu-scene-schema.d.ts","sourceRoot":"","sources":["../src/gpu-scene-schema.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,WAAW,GAAG,aAAa,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACjD;AAgBD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAY1F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAGhE;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuE4B,CAAC;AAE3D,eAAO,MAAM,iBAAiB;;;;;;;EAS7B,CAAC;AAEF,eAAO,MAAM,cAAc,QAAkE,CAAC"}

package/dist/gpu-scene.d.ts

@@ -21,6 +21,8 @@ export declare class GpuScene {
     private readonly device;
     private capacity;
     private tableBytes;
+    private transformBytes;
+    private transformView;
     private buffers;
     private uploadRanges;
     private uploadBytes;
@@ -28,11 +30,13 @@ export declare class GpuScene {
     private fullRebuilds;
     private clearedSlots;
     private noChangeFrames;
+    private identityUploaded;
     private readonly allocations;
     private readonly instances;
     private readonly transforms;
     private readonly draws;
     private readonly materials;
+    private readonly writesByTable;
     private constructor();
     static create(device: RhiDevice, initialCapacity?: number): Result<GpuSceneAvailability, RhiError>;
     get primitiveBuffer(): Buffer;
@@ -42,16 +46,19 @@ export declare class GpuScene {
     get materialBuffer(): Buffer;
     sync(delta: RenderSceneApplyResult): Result<GpuSceneSyncResult, RhiError>;
     /** Publish current transforms as previous only after a successful submit. */
-    commitTemporalFrame(): Result<void, RhiError>;
+    commitTemporalFrame(enabled?: boolean): Result<void, RhiError>;
     rebuild(slots: readonly RenderSceneSlot[]): Result<GpuSceneSyncResult, RhiError>;
     inspect(): GpuSceneInspection;
     dispose(): void;
     private writeSlot;
+    private writeRootTransform;
     private clearSlot;
     private uploadRows;
     private ensureAllocation;
     private clearAllocation;
     private grow;
     private allocateCpuTables;
+    private refreshTransformViews;
+    private writeIdentityTransform;
 }
 //# sourceMappingURL=gpu-scene.d.ts.map

package/dist/gpu-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gpu-scene.d.ts","sourceRoot":"","sources":["../src/gpu-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAW,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAWxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE1F,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AA0F7D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAA;CAAE,CAAC;AA8EtF,yEAAyE;AACzE,qBAAa,QAAQ;IAgBjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ;IAhBlB,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;IACtE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IAExD,OAAO;IASP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,eAAe,SAAM,GAAG,MAAM,CAAC,oBAAoB,EAAE,QAAQ,CAAC;IAa/F,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAAC,kBAAkB,EAAE,QAAQ,CAAC;IA8CzE,6EAA6E;IAC7E,mBAAmB,IAAI,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC;IAuB7C,OAAO,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAAC,kBAAkB,EAAE,QAAQ,CAAC;IA2ChF,OAAO,IAAI,kBAAkB;IAkC7B,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,SAAS;IAgMjB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,eAAe;IA8CvB,OAAO,CAAC,IAAI;IA+BZ,OAAO,CAAC,iBAAiB;CAS1B"}
+{"version":3,"file":"gpu-scene.d.ts","sourceRoot":"","sources":["../src/gpu-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAW,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAWxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE1F,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AA4F7D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAA;CAAE,CAAC;AAqFtF,yEAAyE;AACzE,qBAAa,QAAQ;IA0BjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ;IA1BlB,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,aAAa,CAAW;IAChC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8C;IAC1E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAM5B;IAEF,OAAO;IAaP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,eAAe,SAAM,GAAG,MAAM,CAAC,oBAAoB,EAAE,QAAQ,CAAC;IAa/F,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAAC,kBAAkB,EAAE,QAAQ,CAAC;IAuDzE,6EAA6E;IAC7E,mBAAmB,CAAC,OAAO,UAAO,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC;IAyB3D,OAAO,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAAC,kBAAkB,EAAE,QAAQ,CAAC;IA6ChF,OAAO,IAAI,kBAAkB;IAkC7B,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,SAAS;IA2LjB,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,gBAAgB;IAyCxB,OAAO,CAAC,eAAe;IAgDvB,OAAO,CAAC,IAAI;IAgCZ,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,sBAAsB;CAI/B"}

package/dist/gpu-usage.d.ts

@@ -6,6 +6,5 @@ export declare const GPU_BUFFER_USAGE_UNIFORM = 64;
 export declare const GPU_BUFFER_USAGE_STORAGE = 128;
 export declare const GPU_BUFFER_USAGE_INDIRECT = 256;
 export declare const GPU_BUFFER_USAGE_MAP_READ = 1;
-/** GPUBufferUsage.QUERY_RESOLVE, used by optional timestamp captures. */
 export declare const GPU_BUFFER_USAGE_QUERY_RESOLVE = 512;
 //# sourceMappingURL=gpu-usage.d.ts.map

package/dist/gpu-usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gpu-usage.d.ts","sourceRoot":"","sources":["../src/gpu-usage.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,uBAAuB,KAAO,CAAC;AAC5C,eAAO,MAAM,sBAAsB,KAAO,CAAC;AAC3C,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAC9C,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAC9C,eAAO,MAAM,wBAAwB,KAAO,CAAC;AAC7C,eAAO,MAAM,wBAAwB,MAAO,CAAC;AAC7C,eAAO,MAAM,yBAAyB,MAAQ,CAAC;AAC/C,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAC9C,yEAAyE;AACzE,eAAO,MAAM,8BAA8B,MAAQ,CAAC"}
+{"version":3,"file":"gpu-usage.d.ts","sourceRoot":"","sources":["../src/gpu-usage.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,uBAAuB,KAAO,CAAC;AAC5C,eAAO,MAAM,sBAAsB,KAAO,CAAC;AAC3C,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAC9C,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAC9C,eAAO,MAAM,wBAAwB,KAAO,CAAC;AAC7C,eAAO,MAAM,wBAAwB,MAAO,CAAC;AAC7C,eAAO,MAAM,yBAAyB,MAAQ,CAAC;AAC/C,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAC9C,eAAO,MAAM,8BAA8B,MAAQ,CAAC"}

package/dist/hdrp-buffers.d.ts

@@ -1,21 +1,14 @@
 import { type BindGroup, type BindGroupLayout, type BindGroupLayoutDescriptor, type Buffer, RhiError, type TextureView } from '@forgeax/engine-rhi';
 import type { RenderSystemRuntime } from './record/render-context';
 export { getOrCreateSsaoFallbackTexture } from './ssao-buffers';
-/**
- * WebGL2 HDRP downlevel light-list capacity. 128 x 64 B = 8 KiB, below the
- * WebGL2 minimum uniform-buffer binding size of 16 KiB. The storage path
- * keeps the full MAX_LIGHTS budget; the uniform path uses the same LightSlot
- * POD and only changes the transport.
- */
-export declare const HDRP_UNIFORM_LIGHT_CAPACITY = 128;
 /** Bind-group layout used only by the WebGPU cluster membership producer. */
 export declare function createHdrpClusterMembershipBindGroupLayoutDescriptor(): BindGroupLayoutDescriptor;
 /**
  * The persistent HDRP GPU buffers (plan D-1, BGL slot 3..6) plus the unified
  * BGL layout for group(2) (plan D-6, feat-20260609-hdrp-cluster-fragment-ggx M3).
  *
- * AC-11: light_data stride = `BYTES_PER_LIGHT_SLOT` = 64 (double-sided lock with
- * WGSL hdrp-cluster-forward.wgsl LightSlot).
+ * AC-11: light_data stride = `BYTES_PER_DIRECT_LIGHT_SLOT` = 80 (double-sided
+ * lock with WGSL hdrp-cluster-forward.wgsl DirectLightSlot).
  * AC-13: 4 distinct RHI Buffer handles, ready for slot-3..6 BGL binding.
  * AC-14: clusterUniform is a uniform buffer (not storage); runtime grid change
  * is a writeBuffer field update, not a PSO rebuild.
@@ -23,9 +16,9 @@ export declare function createHdrpClusterMembershipBindGroupLayoutDescriptor():
  * cluster 4 buffer).
  */
 export interface HdrpBuffers {
-    /** Whether bindings 3..5 carry storage buffers or uniform-buffer fallback data. */
-    readonly storageBuffer: boolean;
-    /** light_data -- 256 x 64 B on storage, 128 x 64 B on uniform fallback. */
+    /** Device identity that owns every handle in this bundle. */
+    readonly device: RenderSystemRuntime['device'];
+    /** light_data -- the full 256 x 80 B DirectLightSlot budget. */
     readonly lightDataBuffer: Buffer;
     readonly lightDataBytes: number;
     /** cluster_grid SSBO -- gridX*gridY*gridZ * 2 u32, BGL slot 4. */
@@ -58,23 +51,30 @@ export interface HdrpBuffers {
  * pipeline disable (charter P3 explicit failure).
  *
  * `grid` defaults to `DEFAULT_CLUSTER_GRID` when undefined (matches the M5
- * record-stage default). The buffers are sized at the *first* call's grid; a
- * later install with a different grid keeps the existing allocation as long as
- * it has enough capacity (gridX*gridY*gridZ <= cached.grid product). Different
- * grids that exceed capacity are not currently re-allocated -- M-future.
+ * record-stage default). A smaller grid reuses the existing capacity. When a
+ * later install requests a larger grid, this owner allocates a complete new
+ * bundle, publishes it atomically, and retires the previous bundle after the
+ * device queue fence so graph and bind-group caches never observe a partially
+ * replaced resource set.
  */
 export declare function getOrCreateHdrpBuffers(runtime: RenderSystemRuntime, grid?: {
     x: number;
     y: number;
     z: number;
 }): HdrpBuffers | null;
+/**
+ * Drop the cached bundle before a device recovery or renderer disposal. The
+ * bundle carries the old device identity, so retirement fences that device's
+ * queue instead of consulting the replacement runtime device.
+ */
+export declare function resetHdrpBuffers(runtime: RenderSystemRuntime): void;
 /**
  * Build the 8-float cluster_uniform std140 payload.
  *
  *   [0] gridX  u32 (cast in shader)
  *   [1] gridY  u32
  *   [2] gridZ  u32
- *   [3] lightCount u32 (vec4 alignment; capped by the active transport)
+ *   [3] lightCount u32 (vec4 alignment; capped by MAX_LIGHTS)
  *   [4] near   f32
  *   [5] far    f32
  *   [6] logFarOverNear  f32
@@ -93,7 +93,7 @@ export declare function packClusterUniform(grid: {
     x: number;
     y: number;
     z: number;
-}, near: number, far: number, ssaoIntensity?: number, lightCount?: number, lightCapacity?: number): ArrayBuffer;
+}, near: number, far: number, ssaoIntensity?: number, lightCount?: number): ArrayBuffer;
 /**
  * Consumers pass the same mesh storage buffer + stride that URP uses, so the
  * dynamic offset (`i * MESH_PER_ENTITY_STRIDE`) at `setBindGroup(2, ...)`
@@ -107,7 +107,7 @@ export declare function packClusterUniform(grid: {
  * feat-20260609-hdrp-cluster-fragment-ggx M4 / w19. Called per-frame from the
  * recordFrame HDRP block after binner+writeBuffer; the resulting BindGroup
  * lands on `passCtx.hdrpClusterBindGroup` and recordMainPass binds it at
- * group(2) when `frameState.isHdrpActive`.
+ * group(2) when the prepared Standard topology selects clustered lighting.
  *
  * Returns `null` on `device.createBindGroup` failure (a structured RhiError
  * is fired on `runtime.errorRegistry`); recordMainPass gracefully falls back
@@ -150,6 +150,8 @@ export type SsaoBindOptions = {
     readonly enabled: false;
 };
 export declare function createHdrpUnifiedBindGroup(runtime: RenderSystemRuntime, hdrpBuffers: HdrpBuffers, meshStorageBuffer: Buffer, ssaoOptions?: SsaoBindOptions): BindGroup | null;
+/** Build the clustered skin group(2) bind group with one shared palette window. */
+export declare function createHdrpSkinUnifiedBindGroup(runtime: RenderSystemRuntime, hdrpBuffers: HdrpBuffers, layout: BindGroupLayout, meshStorageBuffer: Buffer, paletteBuffer: Buffer, paletteBindingWindowBytes: number, ssaoOptions?: SsaoBindOptions): BindGroup | null;
 /**
  * Build the compute-only bind group for ordered cluster membership output.
  * Its group is intentionally separate from the fragment group: the same

package/dist/hdrp-buffers.d.ts.map

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

package/dist/ibl/IblPipelineCache.d.ts

@@ -1,5 +1,7 @@
 import { type BindGroupLayout, type Buffer, type RenderPipeline, type Result, type RhiDevice, type RhiError, type ShaderModule, type Texture, type TextureFormat, type TextureView } from '@forgeax/engine-rhi';
 import type { DeviceScope } from '../device/device-scope';
+import { type IblKernelCache } from './kernel-cache';
+export { createIblKernelCache, type IblKernelCache, resetIblKernelCaches, } from './kernel-cache';
 /**
  * Shader module factory (async, injected via configureGpuDevice).
  * Mirrors `MipmapShaderModuleFactory` from mipmap-generator.
@@ -39,6 +41,8 @@ export interface IblPipelineError {
  * (idempotent).
  */
 export interface IblPipelineCache {
+    /** Reusable generation-scoped kernel state; per-probe outputs stay elsewhere. */
+    readonly probeKernel: IblKernelCache;
     /** Color format shared by all precompute outputs for this device. */
     outputFormat?: TextureFormat;
     /** Equirectangular-to-cubemap pipeline. */

package/dist/ibl/IblPipelineCache.d.ts.map

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

package/dist/ibl/kernel-cache.d.ts

@@ -0,0 +1,36 @@
+export declare const REFLECTION_PROBE_IBL_STAGES: readonly ["raw", "filtered", "publish"];
+export type ReflectionProbeIblStage = (typeof REFLECTION_PROBE_IBL_STAGES)[number];
+export interface IblKernelCache {
+    readonly generation: number;
+    readonly pipelineIdentity: object;
+    readonly samplerIdentity: object;
+    readonly brdfLutIdentity: object;
+}
+export declare function createIblKernelCache(generation: number): IblKernelCache;
+export interface ProbeIblOutput {
+    readonly entityKey: number;
+    readonly resolution: number;
+    readonly deviceGeneration: number;
+    readonly raw: object;
+    readonly filtered: object;
+    readonly rawGeneration: number;
+    readonly filteredGeneration: number;
+    readonly lkg: boolean;
+}
+export interface ProbeIblUpdate extends ProbeIblOutput {
+    readonly stages: typeof REFLECTION_PROBE_IBL_STAGES;
+    readonly nextStage: ReflectionProbeIblStage;
+    readonly candidateGeneration: number;
+}
+export declare function createProbeIblOutput(input: {
+    readonly entityKey: number;
+    readonly resolution: number;
+    readonly deviceGeneration: number;
+}): ProbeIblOutput;
+export declare function beginProbeIblUpdate(output: ProbeIblOutput): ProbeIblUpdate;
+export declare function publishProbeIblOutput(update: ProbeIblUpdate, result: {
+    readonly stage: ReflectionProbeIblStage;
+    readonly ok: boolean;
+}): ProbeIblOutput;
+export declare function resetIblKernelCaches(): void;
+//# sourceMappingURL=kernel-cache.d.ts.map

package/dist/ibl/kernel-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-cache.d.ts","sourceRoot":"","sources":["../../src/ibl/kernel-cache.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,yCAA0C,CAAC;AACnF,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAID,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAWvE;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,QAAQ,CAAC,MAAM,EAAE,OAAO,2BAA2B,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC,GAAG,cAAc,CASjB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAO1E;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;CAAE,GACxE,cAAc,CAchB;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}