@ifc-lite/renderer 6.3.3 → 6.5.0

package/dist/index.js

@@ -1,6 +1,7 @@
 /* This Source Code Form is subject to the terms of the Mozilla Public
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { sectionExclusions } from './section-exclusions.js';
 /**
  * @ifc-lite/renderer - WebGPU renderer
  */
@@ -10,6 +11,7 @@ export { Camera } from './camera.js';
 export { appearanceSourceTriangle, expandAppearanceCorners, equivalentAppearanceGeometry } from './appearance-uvs.js';
 export { sameCompanionParts } from './appearance-companions.js';
 export { invertAppearancePartition, validateAppearancePartition } from './appearance-preview.js';
+import { deferOpaqueVisibilityFrame } from './opaque-visibility-pass.js';
 import { createReferenceImageManager } from './reference-image-host.js';
 import { MAX_DRAWING_BUFFER_PIXEL_RATIO, measureDrawingBuffer, resizeRendererViewport } from './renderer-viewport.js';
 export { pickFitPolicy } from './camera-fit-policy.js';
@@ -35,6 +37,7 @@ export { SymbolicTextAtlas } from './symbolic-text-atlas.js';
 // holds the styling primitives shared with the store and UI.
 export { DEFAULT_CAP_STYLE, HATCH_PATTERN_IDS } from './section-cap-style.js';
 export { planeBasis, nearestCardinalAxis } from './section-plane-basis.js';
+export { capHighlightKey } from './section-2d-overlay.js';
 export { LINE_OVERLAY_CHANNELS } from './section-2d-overlay.js';
 export { Raycaster } from './raycaster.js';
 export { SnapDetector, SnapType } from './snap-detector.js';
@@ -42,6 +45,7 @@ export { BVH } from './bvh.js';
 export { hostsOtherEntities } from './mesh-entity-hosting.js';
 export { FederationRegistry, federationRegistry } from './federation-registry.js';
 export * from './types.js';
+export { MAX_EXTRA_CLIP_PLANES } from './extra-clip-planes.js';
 export { resolveEnvironment, deriveSkyGradient, packEnvironmentUniforms, ENVIRONMENT_UNIFORM_SIZE, } from './environment.js';
 export { DEFAULT_OVERLAY_THEME } from './overlay-theme.js';
 import { DEFAULT_OVERLAY_THEME } from './overlay-theme.js';
@@ -58,6 +62,7 @@ export { isEntityVisible } from './entity-visibility.js';
 // Alpha constants the Cesium world view must match, since it renders the model
 // through its own glTF pipeline rather than this one (#2591).
 export { DEFAULT_GHOST_ALPHA, OPAQUE_ALPHA_CUTOFF } from './overlay-routing.js';
+export { DEFAULT_MIN_CAST_ALPHA } from './shadow-occluders.js';
 export { VisibilityEpochTracker } from './visibility-epoch.js';
 export { decideTimingMode, passDurationsMs, frameTotalMs, aggregateFrameTimings } from './frame-timing.js';
 export { computeDurationStats, nsToMs, isNegativeDelta } from './frame-timing-stats.js';
@@ -81,7 +86,8 @@ import { viewBasis } from './math.js';
 import { isRteAabbVisible, rteFrustum, sourceFrustumFromRte } from './rte-frustum.js';
 import { VisualEnhancementResolver, livePostEffects } from './visual-enhancement.js';
 import { packClipBox } from './clip-box.js';
-import { MESH_FLAGS_BYTE_OFFSET, MESH_FLAG_RTE_DRAWABLE, MESH_UNIFORM_FLOATS, MESH_UNIFORM_OFFSET, packRteCameraOrigin, packRteFragmentSpace, } from './mesh-rte-uniforms.js';
+import { resolveSectionPlaneFrames } from './section-plane-frames.js';
+import { MESH_FLAGS_BYTE_OFFSET, MESH_FLAG_RTE_DRAWABLE, MESH_UNIFORM_FLOATS, MESH_UNIFORM_OFFSET, packRteCameraOrigin, packRteFragmentSpace, packSectionPlaneLanes, } from './mesh-rte-uniforms.js';
 import { packMeshMaterial } from './mesh-material.js';
 import { RendererOverlays } from './renderer-overlays.js';
 import { resolveSectionPlaneFrame } from './render-section-plane.js';
@@ -117,6 +123,7 @@ import { appendPointCloudChunk as appendPointCloudChunkImpl, beginPointCloudStre
 import { DeviationComputer } from './deviation/deviation-computer.js';
 export { computeDeviationStatistics, computeDeviationStatisticsAsync, countWithinToleranceAsync, deviationHistogramAsync, summarizeDeviationAssetsAsync } from './deviation/deviation-statistics.js';
 import { runGuardedGpuUpload, isDeviceLossThrow } from './gpu-upload-guard.js';
+import { enableRendererQuantizedBatches } from './quantized-lifecycle.js';
 import { recoverRendererDevice, rendererDeviceLostError } from './device-recovery.js';
 /**
  * The reason `whenReady()` rejects when the renderer is destroyed.
@@ -405,13 +412,17 @@ export class Renderer {
     // One 336-byte buffer serves all frame batches/meshes (84 floats including RTE lanes).
     uniformScratch = new Float32Array(MESH_UNIFORM_FLOATS);
     uniformScratchU32 = new Uint32Array(this.uniformScratch.buffer, MESH_FLAGS_BYTE_OFFSET, 4);
-    // overrideParams lanes (#6076): zero except inside a painting renderBatch call.
+    // overrideParams: full entity anchor for clipping, plus colour-override mode (#6076).
     uniformOverrideU32 = new Uint32Array(this.uniformScratch.buffer, MESH_UNIFORM_OFFSET.overrideParams * 4, 4);
     // What the last render() actually clipped, so the GPU picker can mirror it and
     // section/crop-clipped geometry stays unpickable, not just invisible. Updated
     // every render; read by pick()/pickRect(). null = nothing clipped that frame.
     _activePickSection = null;
     _activePickClipBox = null;
+    _sectionExcludedIds = new Set();
+    /** Snapshot of the extra planes the last frame clipped against (#7545), mirrored by the pickers. */
+    _activePickExtraPlanes = null;
+    _sectionFrameInput = null; // what the last frame resolved the section planes from
     constructor(canvas) {
         this.canvas = canvas;
         this.device = new WebGPUDevice();
@@ -451,6 +462,7 @@ export class Renderer {
         // init there is nothing to invalidate and this is a no-op.
         const generation = ++this.initGeneration;
         this.ready = false;
+        this.scene.setQuantizedBatches(false); // #7655: admission belongs to the retired GPU lifetime.
         // Re-arm `whenReady()`: this instance is being brought back up, so a
         // wait requested from here on is "not ready yet" again, not "destroyed".
         this.destroyed = false;
@@ -633,8 +645,8 @@ export class Renderer {
             w.reject(error);
     }
     /**
-     * Subscribe to non-intentional GPU device loss (driver reset / VRAM
-     * exhaustion — NOT an intentional `destroy()`). Fired at most once per
+     * Subscribe to GPU device loss outside owned teardown (including browser
+     * destruction, driver reset or VRAM exhaustion). Fired at most once per
      * device. After it fires, `render()` is a no-op and the renderer reports
      * itself un-ready (`isReady()` false, `whenReady()` rejecting with
      * `RendererDeviceLostError`) until it is re-initialised, so the typical
@@ -1317,13 +1329,7 @@ export class Renderer {
      * rejecting pipeline creation) batches stay on the f32 path.
      */
     async enableQuantizedBatches() {
-        this.recovery.quantizedBatchesRequested = true;
-        if (!this.pipeline)
-            return false;
-        const ok = await this.pipeline.ensureQuantizedPipelines();
-        if (ok)
-            this.scene.setQuantizedBatches(true);
-        return ok;
+        return enableRendererQuantizedBatches(this);
     }
     /** Draw a frame through the shared submission path, preserving the void API. */
     render(options = {}) { this.renderWithResult(options); }
@@ -1569,10 +1575,6 @@ export class Renderer {
         // would never show it. See issue #677. Pure routing decision lives in
         // overlay-routing.ts and is unit-tested there.
         const colorOverrides = this.scene.getColorOverrides();
-        // PERFORMANCE FIX: Use batch-level visibility filtering instead of creating individual meshes
-        // Only create individual meshes for selected elements (for highlighting)
-        // Batches are filtered at render time - fully visible batches render normally,
-        // partially visible batches are skipped (their visible elements will be in other batches or individual meshes)
         // Ensure all existing meshes have GPU resources
         this.ensureMeshResources();
         // Frustum culling (if enabled and spatial index available)
@@ -1666,6 +1668,9 @@ export class Renderer {
                 spendLogLatch: () => { this._loggedSectionBounds = true; },
             });
             const sectionPlaneData = sectionFrame.sectionPlaneData;
+            const extraClipPlanes = sectionFrame.extraPlanes;
+            const { bounds: frameBounds } = sectionFrame;
+            this._sectionFrameInput = frameBounds && { primary: options.sectionPlane ?? null, extras: options.extraSectionPlanes ?? [], bounds: frameBounds, buildingRotation: options.buildingRotation };
             if (sectionFrame.bounds) {
                 // Store bounds for section plane visual and camera near/far.
                 // Two wrappers over the same min/max, exactly as before the
@@ -1688,6 +1693,9 @@ export class Renderer {
                     flipped: !!options.sectionPlane?.flipped,
                 }
                 : null;
+            this._sectionExcludedIds = new Set(options.sectionExcludedIds);
+            sectionExclusions(device).update(this._sectionExcludedIds);
+            this._activePickExtraPlanes = extraClipPlanes.length > 0 ? extraClipPlanes.map((p) => ({ normal: [...p.normal], distance: p.distance, flipped: p.flipped })) : null;
             this._activePickClipBox = options.clipBox?.enabled
                 ? {
                     enabled: true,
@@ -1722,18 +1730,7 @@ export class Renderer {
                     meshBuf[35] = isSelected ? mesh.color[3] : alphaForMesh(mesh.expressId, mesh.color[3]);
                     packMeshMaterial(meshBuf, mesh.color[3], mesh.finish ?? mesh.material);
                     // Section plane data (offset 40-43)
-                    if (sectionPlaneData) {
-                        meshBuf[40] = sectionPlaneData.normal[0];
-                        meshBuf[41] = sectionPlaneData.normal[1];
-                        meshBuf[42] = sectionPlaneData.normal[2];
-                        meshBuf[43] = sectionPlaneData.distance;
-                    }
-                    else {
-                        meshBuf[40] = 0;
-                        meshBuf[41] = 0;
-                        meshBuf[42] = 0;
-                        meshBuf[43] = 0;
-                    }
+                    packSectionPlaneLanes(sectionPlaneData, meshBuf);
                     // Clip box (offset 48-55: min.xyz + pad, max.xyz + pad) → enable bit
                     const clipBit = packClipBox(options.clipBox, meshBuf, 48);
                     // Flags (offset 44-47 as u32)
@@ -1747,7 +1744,7 @@ export class Renderer {
                     meshFlags[3] = 0;
                     // Individual meshes retain their origin and share the RTE
                     // fragment contract with colour batches.
-                    packRteFragmentSpace(relativeToEyeFrame, sectionPlaneData, options.clipBox, meshBuf);
+                    packRteFragmentSpace(relativeToEyeFrame, sectionPlaneData, options.clipBox, meshBuf, extraClipPlanes);
                     const meshOrigin = mesh.rteOrigin
                         ?? [mesh.transform.m[12], mesh.transform.m[13], mesh.transform.m[14]];
                     if (!relativeToEyeFrame.tryPackDrawableOrigin(meshOrigin, meshBuf, MESH_UNIFORM_OFFSET.drawableDelta)) {
@@ -1755,6 +1752,7 @@ export class Renderer {
                         continue;
                     }
                     meshFlags[0] |= MESH_FLAG_RTE_DRAWABLE;
+                    new Uint32Array(meshBuf.buffer)[MESH_UNIFORM_OFFSET.overrideParams] = mesh.expressId;
                     device.queue.writeBuffer(mesh.uniformBuffer, 0, meshBuf);
                 }
             }
@@ -1848,6 +1846,7 @@ export class Renderer {
                     // floor it no longer covers. `sectionPlaneData` already
                     // folds in the terrain clip, so that is covered as well.
                     this.shadowPass.render(encoder, fit.lightViewProj, occluders, {
+                        sectionExcludedIds: this._sectionExcludedIds,
                         section: sectionPlaneData?.enabled
                             ? {
                                 normal: sectionPlaneData.normal,
@@ -1858,6 +1857,7 @@ export class Renderer {
                         box: options.clipBox?.enabled
                             ? { min: options.clipBox.min, max: options.clipBox.max }
                             : null,
+                        extraPlanes: extraClipPlanes,
                     }, { cameraWorld: shadowEye });
                     // Shadow uniform: light matrix + sampling params. The kernel
                     // width follows the sun's angular size (physical, ~0.53°
@@ -1925,7 +1925,7 @@ export class Renderer {
                 clearValue: { r: 0, g: 0, b: 0, a: 0 },
                 storeOp: (needsObjectIdPass ? 'store' : 'discard'),
             });
-            const pass = encoder.beginRenderPass({
+            const pass = this.pipeline.visibility.begin(encoder, {
                 timestampWrites: renderPassTimestampWrites(encoder, 'main'),
                 colorAttachments,
                 depthStencilAttachment: {
@@ -1939,7 +1939,7 @@ export class Renderer {
                     stencilLoadOp: 'clear',
                     stencilStoreOp: 'store',
                 },
-            });
+            }, this.camera.getProjectionMode() === 'orthographic', this.canvas.width, this.canvas.height);
             // Global lighting environment: write the uniform once per frame.
             // The group(1) bind is deferred until AFTER the sky pass below —
             // the sky pipeline has an incompatible layout (its own group(0),
@@ -1995,6 +1995,7 @@ export class Renderer {
             // valid for every main-family draw that follows.
             this.pipeline.setEntityColorTableBuffer(this.scene.getEntityColorTable().getBuffer());
             pass.setBindGroup(1, this.pipeline.getEnvironmentBindGroup());
+            pass.setBindGroup(3, sectionExclusions(device).bindGroup);
             // Selected meshes drawn this frame, for the selection-mask pass
             // (#5390) after `pass.end()` below. Populated inside the batched
             // branch, where the highlight draw itself happens; empty in the
@@ -2183,9 +2184,6 @@ export class Renderer {
                 if (partialEpochChanged) {
                     this.scene.retireUnusedAlphaSlots(partialRequests.requestedKeys());
                 }
-                // Build a uniform template ONCE per frame — shared across all batches.
-                // Only the 4-float color (offset 32) differs per batch; everything else
-                // (viewProj, identity model, material, section plane, flags) is identical.
                 const tpl = this.uniformScratch;
                 const tplFlags = this.uniformScratchU32;
                 tpl.set(viewProj, 0);
@@ -2211,18 +2209,7 @@ export class Renderer {
                 // Colour + material row (tpl[32..39]) are patched per draw; the
                 // instanced passes keep this opaque default.
                 packMeshMaterial(tpl);
-                if (sectionPlaneData) {
-                    tpl[40] = sectionPlaneData.normal[0];
-                    tpl[41] = sectionPlaneData.normal[1];
-                    tpl[42] = sectionPlaneData.normal[2];
-                    tpl[43] = sectionPlaneData.distance;
-                }
-                else {
-                    tpl[40] = 0;
-                    tpl[41] = 0;
-                    tpl[42] = 0;
-                    tpl[43] = 0;
-                }
+                packSectionPlaneLanes(sectionPlaneData, tpl);
                 // Clip box (offset 48-55: min.xyz + pad, max.xyz + pad) → enable bit
                 const tplClipBit = packClipBox(options.clipBox, tpl, 48);
                 // flags layout (main shader):
@@ -2243,7 +2230,7 @@ export class Renderer {
                 // camera-relative frame. Their fragment clip inputs must use
                 // that same frame; mixing a local vertex with a 5,000 km f32
                 // world plane loses centimetre cuts before the comparison.
-                packRteFragmentSpace(relativeToEyeFrame, sectionPlaneData, options.clipBox, tpl);
+                packRteFragmentSpace(relativeToEyeFrame, sectionPlaneData, options.clipBox, tpl, extraClipPlanes);
                 // Helper function to render a batch — patches color into the shared template.
                 // `paint` = a depth-writing opaque draw: colour overrides shade it from the
                 // entity colour table (#6076); transparent draws keep their own colour.
@@ -2257,12 +2244,7 @@ export class Renderer {
                     tpl[34] = batch.color[2];
                     tpl[35] = alphaForBatch(batch, batch.color[3]);
                     packMeshMaterial(tpl, batch.color[3], batch.finish);
-                    // Per-batch local frame: the batch's vertices are stored
-                    // RELATIVE to batch.origin (f32-small), so set the model
-                    // matrix translation column to origin (world = origin + pos).
-                    // The 12 rotation/scale floats stay identity from the template;
-                    // the translation lives at column-major indices 12/13/14 →
-                    // tpl[28/29/30]. [0,0,0] for legacy absolute batches.
+                    // Rebase batch-local vertices; translation lives in tpl[28..30].
                     const o = batch.origin;
                     tpl[28] = o ? o[0] : 0;
                     tpl[29] = o ? o[1] : 0;
@@ -2281,7 +2263,8 @@ export class Renderer {
                     tpl[58] = qz ? qz.min[2] : 0;
                     tpl[59] = qz ? qz.step : 0;
                     const painted = paint && batchHasColorOverride(batch, colorOverrides, colorOverrideGen);
-                    packOverrideParams(this.uniformOverrideU32, painted ? batchEntityIdAnchor(batch) : null, painted, options.emphasizeOverrides === true);
+                    packOverrideParams(this.uniformOverrideU32, batchEntityIdAnchor(batch), painted, options.emphasizeOverrides === true);
+                    this.uniformOverrideU32[0] = batchEntityIdAnchor(batch) ?? 0xFFFFFFFF;
                     device.queue.writeBuffer(batch.uniformBuffer, 0, tpl);
                     this.uniformOverrideU32.fill(0);
                     // Single draw call for entire batch! LOD1-selected batches
@@ -2385,6 +2368,7 @@ export class Renderer {
                     pass.setPipeline(this.pipeline.getInstancedPipeline());
                     pass.setBindGroup(0, this.pipeline.getBindGroup());
                     pass.setBindGroup(1, this.pipeline.getEnvironmentBindGroup());
+                    pass.setBindGroup(3, sectionExclusions(device).bindGroup);
                     for (const [i, it] of visibleInstanced.entries()) {
                         pass.setVertexBuffer(0, it.vertexBuffer);
                         pass.setVertexBuffer(1, it.instanceBuffer);
@@ -2460,6 +2444,7 @@ export class Renderer {
                         // CHOICE in the shader follows the same rule as everywhere
                         // else, for the same reason `tm.material` does.
                         packMeshMaterial(tpl, tm.color[3], tm.finish ?? tm.material);
+                        this.uniformOverrideU32[0] = tm.expressId;
                         device.queue.writeBuffer(tm.uniformBuffer, 0, tpl);
                         pass.setBindGroup(0, tm.bindGroup);
                         pass.setVertexBuffer(0, tm.vertexBuffer);
@@ -2585,6 +2570,7 @@ export class Renderer {
                     pass.setPipeline(instancedTransparentPipeline);
                     pass.setBindGroup(0, this.pipeline.getBindGroup());
                     pass.setBindGroup(1, this.pipeline.getEnvironmentBindGroup());
+                    pass.setBindGroup(3, sectionExclusions(device).bindGroup);
                     for (const [i, it] of visibleInstanced.entries()) {
                         pass.setVertexBuffer(0, it.vertexBuffer);
                         pass.setVertexBuffer(1, it.instanceBuffer);
@@ -2616,18 +2602,7 @@ export class Renderer {
                         tpl[34] = mesh.color[2];
                         tpl[35] = alphaForMesh(mesh.expressId, mesh.color[3]);
                         packMeshMaterial(tpl, mesh.color[3], mesh.finish ?? mesh.material);
-                        if (sectionPlaneData) {
-                            tpl[40] = sectionPlaneData.normal[0];
-                            tpl[41] = sectionPlaneData.normal[1];
-                            tpl[42] = sectionPlaneData.normal[2];
-                            tpl[43] = sectionPlaneData.distance;
-                        }
-                        else {
-                            tpl[40] = 0;
-                            tpl[41] = 0;
-                            tpl[42] = 0;
-                            tpl[43] = 0;
-                        }
+                        packSectionPlaneLanes(sectionPlaneData, tpl);
                         tplFlags[0] = 0;
                         tplFlags[1] =
                             (sectionPlaneData?.enabled ? 1 : 0) |
@@ -2635,11 +2610,12 @@ export class Renderer {
                                 tplClipBit;
                         tplFlags[2] = 0;
                         tplFlags[3] = 0;
-                        packRteFragmentSpace(relativeToEyeFrame, sectionPlaneData, options.clipBox, tpl);
+                        packRteFragmentSpace(relativeToEyeFrame, sectionPlaneData, options.clipBox, tpl, extraClipPlanes);
                         const transparentOrigin = mesh.rteOrigin ?? [mesh.transform.m[12], mesh.transform.m[13], mesh.transform.m[14]];
                         if (!relativeToEyeFrame.tryPackDrawableOrigin(transparentOrigin, tpl, MESH_UNIFORM_OFFSET.drawableDelta))
                             continue;
                         tplFlags[0] |= MESH_FLAG_RTE_DRAWABLE;
+                        this.uniformOverrideU32[0] = mesh.expressId;
                         device.queue.writeBuffer(mesh.uniformBuffer, 0, tpl);
                         pass.setBindGroup(0, mesh.bindGroup);
                         pass.setVertexBuffer(0, mesh.vertexBuffer);
@@ -2678,18 +2654,7 @@ export class Renderer {
                     tpl[34] = mesh.color[2];
                     tpl[35] = mesh.color[3];
                     packMeshMaterial(tpl, mesh.color[3], mesh.finish ?? mesh.material);
-                    if (sectionPlaneData) {
-                        tpl[40] = sectionPlaneData.normal[0];
-                        tpl[41] = sectionPlaneData.normal[1];
-                        tpl[42] = sectionPlaneData.normal[2];
-                        tpl[43] = sectionPlaneData.distance;
-                    }
-                    else {
-                        tpl[40] = 0;
-                        tpl[41] = 0;
-                        tpl[42] = 0;
-                        tpl[43] = 0;
-                    }
+                    packSectionPlaneLanes(sectionPlaneData, tpl);
                     tplFlags[0] = 1; // isSelected
                     tplFlags[1] =
                         (sectionPlaneData?.enabled ? 1 : 0) |
@@ -2697,11 +2662,12 @@ export class Renderer {
                             tplClipBit;
                     tplFlags[2] = 0;
                     tplFlags[3] = 0;
-                    packRteFragmentSpace(relativeToEyeFrame, sectionPlaneData, options.clipBox, tpl);
+                    packRteFragmentSpace(relativeToEyeFrame, sectionPlaneData, options.clipBox, tpl, extraClipPlanes);
                     const selectedOrigin = mesh.rteOrigin ?? [mesh.transform.m[12], mesh.transform.m[13], mesh.transform.m[14]];
                     if (!relativeToEyeFrame.tryPackDrawableOrigin(selectedOrigin, tpl, MESH_UNIFORM_OFFSET.drawableDelta))
                         continue;
                     tplFlags[0] |= MESH_FLAG_RTE_DRAWABLE;
+                    this.uniformOverrideU32[0] = mesh.expressId;
                     device.queue.writeBuffer(mesh.uniformBuffer, 0, tpl);
                     pass.setPipeline(this.pipeline.getSelectionPipeline());
                     pass.setBindGroup(0, mesh.bindGroup);
@@ -2759,6 +2725,7 @@ export class Renderer {
                         ? { ...sectionPlaneData, flipped: options.sectionPlane?.flipped === true }
                         : null,
                     clipBox: options.clipBox,
+                    extraPlanes: extraClipPlanes,
                     viewport: { width: this.canvas.width / this.pixelRatio, height: this.canvas.height / this.pixelRatio },
                 });
             }
@@ -2776,6 +2743,8 @@ export class Renderer {
                 relativeToEyeFrame,
                 rteViewProj: relativeToEyeFrame.getViewProjection().m,
                 rteCamera: relativeToEyeFrame.getCameraWorld(),
+                extraPlanes: extraClipPlanes,
+                primaryPlane: sectionPlaneData && options.sectionPlane?.enabled ? { ...sectionPlaneData, flipped: options.sectionPlane.flipped === true } : null,
             });
             pass.end();
             // Selection/hover outline input (#5390): built from the meshes the
@@ -2790,7 +2759,7 @@ export class Renderer {
                 : (this.hoverMeshes.release(), []);
             const selectionOutline = buildSelectionOutlineFrame({
                 uniformBufferSize: this.pipeline.getUniformBufferSize(), viewProj, relativeToEyeFrame,
-                section: sectionPlaneData, sectionFlipped: options.sectionPlane?.flipped, clipBox: options.clipBox,
+                section: sectionPlaneData, sectionFlipped: options.sectionPlane?.flipped, clipBox: options.clipBox, extraPlanes: extraClipPlanes,
                 selectedMeshes: selectedMeshesForMask, hoverPieces, hoveredId: hoverId, selectedModelIndex: hoverModel,
                 instancedTemplates: this.scene.getInstancedTemplates(),
                 instancedHovered: hoverId != null ? this.scene.getInstancedTemplatesOf(hoverId, hoverModel) : [],
@@ -2812,7 +2781,7 @@ export class Renderer {
                 pixelRatio: this.pixelRatio,
                 // EDL only when point clouds are loaded and the user enabled it.
                 edl: this.edlOptions.enabled && this.pointCloudRenderer?.hasAssets() ? this.edlOptions : null,
-                selectionOutline,
+                selectionOutline, geometricVisibility: this.pipeline.visibility.getBinding(),
             });
             colorReadback = colorCapture && encodeRendererColorFrameCapture(device, encoder, colorCapture);
             submitRendererGpuTiming(this, device, encoder);
@@ -2880,8 +2849,10 @@ export class Renderer {
             // `getOrCreatePartialBatch`'s CPU-side geometry merge running out of
             // host memory, and that throws a `RangeError` — which is exactly why
             // the discriminator keys on the TYPE and not on "a frame threw".
-            this.containFrameThrow(error, 'encode');
             cancelRendererColorFrame(this);
+            if (deferOpaqueVisibilityFrame(error, () => this.requestRender()))
+                return false;
+            this.containFrameThrow(error, 'encode');
             return false;
         }
     }
@@ -2926,7 +2897,7 @@ export class Renderer {
      * same fragments and clipped-away geometry can't be selected.
      */
     activePickClip() {
-        return { sectionPlane: this._activePickSection, clipBox: this._activePickClipBox };
+        return { sectionExcludedIds: this._sectionExcludedIds, sectionPlane: this._activePickSection, extraPlanes: this._activePickExtraPlanes, clipBox: this._activePickClipBox };
     }
     /**
      * GPU-based rectangle pick. Drag-select returns the set of
@@ -2946,7 +2917,7 @@ export class Renderer {
     }
     /** Whether the last rendered frame clipped surfaces (section, terrain or box). */
     hasActiveClipping() {
-        return this._activePickSection !== null || this._activePickClipBox !== null;
+        return this._activePickSection !== null || this._activePickExtraPlanes !== null || this._activePickClipBox !== null;
     }
     /** Exact visible-surface raycast in CSS canvas coordinates. */
     raycastScene(x, y, options) {
@@ -3059,14 +3030,21 @@ export class Renderer {
      */
     uploadSection2DOverlay(polygons, lines, axis, position, // 0-100 percentage
     sectionRange, // Same storey-based range as section plane
-    flipped = false, customPlane) {
-        this.overlays.uploadSection2DOverlay(polygons, lines, axis, position, sectionRange, flipped, customPlane);
+    flipped = false, customPlane, planeId) {
+        this.overlays.uploadSection2DOverlay(polygons, lines, axis, position, sectionRange, flipped, customPlane, planeId);
     }
     /**
-     * Clear the 2D section overlay
+     * Clear the 2D section overlay: the primary plane's cap, or with `planeId`
+     * the cap of that cutting plane beyond the first (#7545).
      */
-    clearSection2DOverlay() {
-        this.overlays.clearSection2DOverlay();
+    clearSection2DOverlay(planeId) {
+        this.overlays.clearSection2DOverlay(planeId);
+    }
+    /** Every section plane's world frame (#7545), for the UI's tags and handle: the last frame's bounds and rotation, and `planes` (the caller's newest) when given. */
+    getSectionPlaneFrames(planes) { const i = this._sectionFrameInput; return i ? resolveSectionPlaneFrames(planes ? { ...i, ...planes } : i) : []; }
+    /** Clear the caps of every cutting plane beyond the first whose id is not in `keep` (#7545). */
+    clearSection2DExtraOverlays(keep = []) {
+        this.overlays.clearSection2DExtraOverlays(keep);
     }
     /**
      * Set the one colour vocabulary every overlay draws in (#5484): the selection
@@ -3300,6 +3278,7 @@ export class Renderer {
         // Render pipelines (textures + uniform buffers)
         this.pipeline?.destroy();
         this.pipeline = null;
+        this.scene.setQuantizedBatches(false);
         // Picker GPU resources. The manager holds its own reference, so clear
         // that too — otherwise its `if (!this.picker) return null` guard keeps
         // pointing at a destroyed picker and a stray click still drives dead
@@ -3334,7 +3313,7 @@ export class Renderer {
         // above was created from it and has already been destroyed, so nothing
         // will touch the device after this. Without it, an app that spins up a
         // renderer per model keeps N live devices (and their VRAM) alive. The
-        // lost-handler special-cases reason 'destroyed' so this is not reported
+        // lost-handler excludes this retired lifetime so this is not reported
         // as a fault. render() early-returns while the device is uninitialised.
         this.device.destroy();
     }