@ifc-lite/renderer 1.41.0 → 1.43.0

package/dist/renderer-overlays.js

@@ -0,0 +1,257 @@
+/* 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 { SectionPlaneRenderer } from './section-plane.js';
+import { Section2DOverlayRenderer } from './section-2d-overlay.js';
+import { SymbolicOverlays } from './renderer-symbolic-overlays.js';
+import { aabbEdgeLineList } from './aabb-edges.js';
+import { projectedBoundsRange } from './render-section-plane.js';
+import { drawSectionOverlays } from './render-section-draw.js';
+export class RendererOverlays {
+    host;
+    sectionPlaneRenderer = null;
+    section2DOverlayRenderer = null;
+    // Overlay/section-cut line colour, kept here so it survives a
+    // pre-init call and a section2DOverlayRenderer re-creation (re-applied below).
+    overlayLineColor = [0, 0, 0, 1];
+    symbolic;
+    constructor(host) {
+        this.host = host;
+        this.symbolic = new SymbolicOverlays(host);
+    }
+    /**
+     * Create the overlay GPU objects. Called from `Renderer.init()` once the
+     * device and the main pipeline (for its sample count) exist.
+     */
+    init(device, format, sampleCount) {
+        this.sectionPlaneRenderer = new SectionPlaneRenderer(device, format, sampleCount);
+        this.section2DOverlayRenderer = new Section2DOverlayRenderer(device, format, sampleCount);
+        // Re-apply any colour set before this (re)creation so it isn't lost.
+        this.section2DOverlayRenderer.setOverlayLineColor(this.overlayLineColor);
+        this.symbolic.init(device, format, sampleCount);
+    }
+    /** Release every overlay GPU resource. Idempotent, like `Renderer.destroy()`. */
+    destroy() {
+        this.sectionPlaneRenderer?.destroy();
+        this.sectionPlaneRenderer = null;
+        this.section2DOverlayRenderer?.dispose();
+        this.section2DOverlayRenderer = null;
+        this.symbolic.destroy();
+    }
+    /**
+     * Draw every overlay into the frame's render pass, in the documented order.
+     * Called from the encode region right before `pass.end()`.
+     */
+    draw(pass, ctx) {
+        const { viewProj, camera } = ctx;
+        drawSectionOverlays(pass, this.sectionPlaneRenderer, this.section2DOverlayRenderer, ctx);
+        // Standalone IFC annotation overlay (issue #653). The line
+        // vertices were pre-lifted to world space at upload time, so
+        // this draw happens regardless of whether a section plane is
+        // active — annotations are a free-floating "drawing layer"
+        // that sits at each annotation's storey elevation.
+        //
+        // This block was previously nested inside the `if (options.sectionPlane && ...)`
+        // guard above, contradicting its own comment. Loading an
+        // annotation-only model with no section plane meant the entire
+        // overlay was skipped at draw time even though 9000+ vertices
+        // had been uploaded successfully. Pulled out to its own block.
+        //
+        // Order: fills (background) → lines (outlines on top) →
+        // texts (labels above everything).
+        this.symbolic.drawFills(pass, viewProj);
+        if (this.section2DOverlayRenderer?.hasAnnotationLines3D()) {
+            this.section2DOverlayRenderer.drawAnnotationLines3D(pass, viewProj);
+        }
+        if (this.section2DOverlayRenderer?.hasAlignmentLines3D()) {
+            this.section2DOverlayRenderer.drawAlignmentLines3D(pass, viewProj);
+        }
+        if (this.section2DOverlayRenderer?.hasGridLines3D()) {
+            this.section2DOverlayRenderer.drawGridLines3D(pass, viewProj);
+        }
+        if (this.section2DOverlayRenderer?.hasDxfLines3D()) {
+            this.section2DOverlayRenderer.drawDxfLines3D(pass, viewProj);
+        }
+        if (this.section2DOverlayRenderer?.hasClashBoxLines3D()) {
+            this.section2DOverlayRenderer.drawClashBoxLines3D(pass, viewProj);
+        }
+        this.symbolic.drawTexts(pass, viewProj, ctx.canvasWidth, ctx.canvasHeight, camera);
+    }
+    /** See `Renderer.uploadSection2DOverlay` for the published contract. */
+    uploadSection2DOverlay(polygons, lines, axis, position, // 0-100 percentage
+    sectionRange, // Same storey-based range as section plane
+    flipped = false, customPlane) {
+        // Rendering is dirty-flag gated, so every path that actually CHANGES
+        // overlay geometry has to request a frame or the new drawing only
+        // appears when something unrelated next dirties the viewport (#2442).
+        // The two early returns below leave the geometry untouched, so they
+        // correctly ask for nothing — matching `uploadGridLines3D` and friends.
+        if (!this.section2DOverlayRenderer)
+            return;
+        if (customPlane) {
+            // Custom-plane path: planePosition / axis are unused — the
+            // basis the cap shader needs travels in `customPlane`. We pass
+            // 0 for `planePosition` and the existing `axis` so the cardinal
+            // shader code path that callers depend on (e.g. legacy SVG
+            // export) keeps working when customPlane is omitted.
+            this.section2DOverlayRenderer.uploadDrawing(polygons, lines, axis, 0, flipped, customPlane);
+            this.host.requestRender();
+            return;
+        }
+        // Same range formula as the clip plane (`resolveSectionPlaneFrame`),
+        // shared rather than copied — but deliberately evaluated against the
+        // UN-ROTATED axis normal, which is what makes the two agree instead of
+        // merely look alike (#2447).
+        //
+        // `planePosition` is not a plane distance here: `transform2Dto3D` lifts
+        // the cardinal drawing onto an AXIS-ALIGNED plane at that world
+        // coordinate (`side` -> `[planePosition, y, x]`), and the polygons it
+        // lifts were cut on that same axis-aligned plane upstream. Feeding it
+        // the rotated plane's distance would move the cap off the geometry it
+        // was cut from. A rotated or face-picked plane reaches the cap through
+        // `customPlane` above, which carries its own basis.
+        const axisNormal = axis === 'side' ? [1, 0, 0] : axis === 'down' ? [0, 1, 0] : [0, 0, 1];
+        const modelBounds = this.host.getModelBounds();
+        // Allow upload if either sectionRange has both values, or modelBounds exists as fallback
+        const hasFullRange = sectionRange?.min !== undefined && sectionRange?.max !== undefined;
+        if (!hasFullRange && !modelBounds)
+            return;
+        const axisRange = modelBounds ? projectedBoundsRange(modelBounds.min, modelBounds.max, axisNormal) : null;
+        const minVal = sectionRange?.min ?? axisRange.min;
+        const maxVal = sectionRange?.max ?? axisRange.max;
+        const planePosition = minVal + (position / 100) * (maxVal - minVal);
+        this.section2DOverlayRenderer.uploadDrawing(polygons, lines, axis, planePosition, flipped);
+        this.host.requestRender();
+    }
+    /** See `Renderer.clearSection2DOverlay` for the published contract. */
+    clearSection2DOverlay() {
+        if (this.section2DOverlayRenderer) {
+            this.section2DOverlayRenderer.clearGeometry();
+            this.host.requestRender();
+        }
+    }
+    /** See `Renderer.setOverlayLineColor` for the published contract. */
+    setOverlayLineColor(color) {
+        // Persist here so a pre-init call (and any later overlay
+        // re-creation) keeps the colour — init() re-applies this.overlayLineColor.
+        this.overlayLineColor = color;
+        this.section2DOverlayRenderer?.setOverlayLineColor(color);
+        this.host.requestRender();
+    }
+    /** See `Renderer.uploadAnnotationLines3D` for the published contract. */
+    uploadAnnotationLines3D(vertices) {
+        if (!this.section2DOverlayRenderer)
+            return;
+        this.section2DOverlayRenderer.uploadAnnotationLines3D(vertices);
+        // Contribute annotation extents to modelBounds + camera sceneBounds
+        // so an annotation-only model (no IfcProduct meshes — common for
+        // separate "annotation sheets") gets framed by Home / fit-to-view
+        // AND has correct near/far clipping. Without sceneBounds the camera
+        // frustum doesn't include the annotation cluster and they're clipped
+        // away even when the camera is pointed at them. Mirror the
+        // point-cloud upload path (`addPointClouds`, `setPointClouds`) which
+        // does the same thing.
+        this.host.expandModelBoundsWithFlatVertices(vertices, 3);
+        this.host.syncCameraSceneBounds();
+        this.host.requestRender();
+    }
+    /** See `Renderer.clearAnnotationLines3D` for the published contract. */
+    clearAnnotationLines3D() {
+        if (this.section2DOverlayRenderer) {
+            this.section2DOverlayRenderer.clearAnnotationLines3D();
+            this.host.requestRender();
+        }
+    }
+    /** See `Renderer.uploadAlignmentLines3D` for the published contract. */
+    uploadAlignmentLines3D(vertices) {
+        if (!this.section2DOverlayRenderer)
+            return;
+        this.section2DOverlayRenderer.uploadAlignmentLines3D(vertices);
+        // Frame alignment-only files the same way annotation overlays are
+        // framed (see uploadAnnotationLines3D).
+        this.host.expandModelBoundsWithFlatVertices(vertices, 3);
+        this.host.syncCameraSceneBounds();
+        this.host.requestRender();
+    }
+    /** See `Renderer.clearAlignmentLines3D` for the published contract. */
+    clearAlignmentLines3D() {
+        if (this.section2DOverlayRenderer) {
+            this.section2DOverlayRenderer.clearAlignmentLines3D();
+            this.host.requestRender();
+        }
+    }
+    /**
+     * See `Renderer.uploadGridLines3D` for the published contract. Unlike
+     * alignment, grids do NOT expand model bounds: they're behind a visibility
+     * toggle, so toggling them on must not reframe the camera.
+     */
+    uploadGridLines3D(vertices) {
+        if (!this.section2DOverlayRenderer)
+            return;
+        this.section2DOverlayRenderer.uploadGridLines3D(vertices);
+        this.host.requestRender();
+    }
+    /** See `Renderer.clearGridLines3D` for the published contract. */
+    clearGridLines3D() {
+        if (this.section2DOverlayRenderer) {
+            this.section2DOverlayRenderer.clearGridLines3D();
+            this.host.requestRender();
+        }
+    }
+    /** See `Renderer.uploadDxfLines3D` for the published contract. */
+    uploadDxfLines3D(vertices) {
+        if (!this.section2DOverlayRenderer)
+            return;
+        this.section2DOverlayRenderer.uploadDxfLines3D(vertices);
+        this.host.requestRender();
+    }
+    /** See `Renderer.clearDxfLines3D` for the published contract. */
+    clearDxfLines3D() {
+        if (this.section2DOverlayRenderer) {
+            this.section2DOverlayRenderer.clearDxfLines3D();
+            this.host.requestRender();
+        }
+    }
+    /** See `Renderer.setClashOverlapBox` for the published contract. */
+    setClashOverlapBox(box) {
+        if (!this.section2DOverlayRenderer)
+            return;
+        if (!box) {
+            this.section2DOverlayRenderer.clearClashBoxLines3D();
+            this.host.requestRender();
+            return;
+        }
+        this.section2DOverlayRenderer.setClashBoxLineColor(box.color);
+        this.section2DOverlayRenderer.uploadClashBoxLines3D(aabbEdgeLineList(box.min, box.max));
+        this.host.requestRender();
+    }
+    /**
+     * See `Renderer.setClashContactLines` for the published contract. Shares the
+     * clash-box line buffer, so only one of this / setClashOverlapBox shows.
+     */
+    setClashContactLines(lines) {
+        if (!this.section2DOverlayRenderer)
+            return;
+        if (!lines || lines.vertices.length === 0) {
+            this.section2DOverlayRenderer.clearClashBoxLines3D();
+            this.host.requestRender();
+            return;
+        }
+        this.section2DOverlayRenderer.setClashBoxLineColor(lines.color);
+        this.section2DOverlayRenderer.uploadClashBoxLines3D(lines.vertices);
+        this.host.requestRender();
+    }
+    /** See `Renderer.uploadAnnotationFills3D` for the published contract. */
+    uploadAnnotationFills3D(fills) {
+        this.symbolic.uploadFills(fills);
+    }
+    /** See `Renderer.uploadAnnotationTexts3D` for the published contract. */
+    uploadAnnotationTexts3D(texts) {
+        this.symbolic.uploadTexts(texts);
+    }
+    /** See `Renderer.hasSection2DOverlay` for the published contract. */
+    hasSection2DOverlay() {
+        return this.section2DOverlayRenderer?.hasGeometry() ?? false;
+    }
+}
+//# sourceMappingURL=renderer-overlays.js.map

package/dist/renderer-overlays.js.map

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

package/dist/renderer-symbolic-overlays.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The symbolic annotation overlay: filled IfcAnnotation regions and world-space
+ * text labels (issue #653).
+ *
+ * Split out of `RendererOverlays` because these are a genuinely separate pair of
+ * GPU objects — `SymbolicFillPipeline` and `SymbolicTextPipeline` own their own
+ * buffers, sampler and glyph-atlas texture, and share no state whatsoever with
+ * the `Section2DOverlayRenderer` that backs the section cap and every 3D line
+ * layer. `RendererOverlays` composes this and drives the draw order, because the
+ * order is the one thing the two families do share: fills paint underneath the
+ * line layers, text labels on top of everything.
+ */
+import type { Camera } from './camera.js';
+import { type SymbolicFillInput, type SymbolicTextInput } from './symbolic-overlay-pipelines.js';
+/**
+ * The model-bounds bookkeeping the symbolic uploads borrow from `Renderer`.
+ * Structurally narrower than `OverlayHost` on purpose: this module never reads
+ * the bounds back, it only grows them and asks for a frame.
+ */
+export interface SymbolicOverlayHost {
+    expandModelBoundsWithFlatVertices(positions: Float32Array, stride: number): void;
+    syncCameraSceneBounds(): void;
+    requestRender(): void;
+}
+export declare class SymbolicOverlays {
+    private readonly host;
+    private fillPipeline;
+    private textPipeline;
+    constructor(host: SymbolicOverlayHost);
+    /**
+     * Share the device + presentation format AND the MSAA sample count +
+     * objectId attachment shape with the rest of the renderer so these
+     * composite into the same RGBA pass without WebGPU pass-compatibility
+     * validation errors.
+     */
+    init(device: GPUDevice, format: GPUTextureFormat, sampleCount: number): void;
+    /**
+     * These pipelines own their own GPU buffers, sampler, and atlas texture —
+     * recreating the viewer without releasing them leaks resources on every
+     * reload.
+     */
+    destroy(): void;
+    /** Background layer: painted before the 3D line overlays. */
+    drawFills(pass: GPURenderPassEncoder, viewProj: Float32Array): void;
+    /** Label layer: painted after everything else. */
+    drawTexts(pass: GPURenderPassEncoder, viewProj: Float32Array, canvasWidth: number, canvasHeight: number, camera: Camera): void;
+    /** See `Renderer.uploadAnnotationFills3D` for the published contract. */
+    uploadFills(fills: readonly SymbolicFillInput[]): void;
+    /** See `Renderer.uploadAnnotationTexts3D` for the published contract. */
+    uploadTexts(texts: readonly SymbolicTextInput[]): void;
+}
+//# sourceMappingURL=renderer-symbolic-overlays.d.ts.map

package/dist/renderer-symbolic-overlays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-symbolic-overlays.d.ts","sourceRoot":"","sources":["../src/renderer-symbolic-overlays.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAGH,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACzB,MAAM,iCAAiC,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,iCAAiC,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACjF,qBAAqB,IAAI,IAAI,CAAC;IAC9B,aAAa,IAAI,IAAI,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAIb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,YAAY,CAAqC;IACzD,OAAO,CAAC,YAAY,CAAqC;gBAE5B,IAAI,EAAE,mBAAmB;IAEtD;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAK5E;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAOf,6DAA6D;IAC7D,SAAS,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAMnE,kDAAkD;IAClD,SAAS,CACL,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACf,IAAI;IAuCP,yEAAyE;IACzE,WAAW,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI;IAqBtD,yEAAyE;IACzE,WAAW,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI;CAkBzD"}

package/dist/renderer-symbolic-overlays.js

@@ -0,0 +1,120 @@
+/* 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 { SymbolicFillPipeline, SymbolicTextPipeline, } from './symbolic-overlay-pipelines.js';
+export class SymbolicOverlays {
+    host;
+    fillPipeline = null;
+    textPipeline = null;
+    constructor(host) {
+        this.host = host;
+    }
+    /**
+     * Share the device + presentation format AND the MSAA sample count +
+     * objectId attachment shape with the rest of the renderer so these
+     * composite into the same RGBA pass without WebGPU pass-compatibility
+     * validation errors.
+     */
+    init(device, format, sampleCount) {
+        this.fillPipeline = new SymbolicFillPipeline(device, format, sampleCount);
+        this.textPipeline = new SymbolicTextPipeline(device, format, sampleCount);
+    }
+    /**
+     * These pipelines own their own GPU buffers, sampler, and atlas texture —
+     * recreating the viewer without releasing them leaks resources on every
+     * reload.
+     */
+    destroy() {
+        this.fillPipeline?.destroy();
+        this.fillPipeline = null;
+        this.textPipeline?.destroy();
+        this.textPipeline = null;
+    }
+    /** Background layer: painted before the 3D line overlays. */
+    drawFills(pass, viewProj) {
+        if (this.fillPipeline?.hasGeometry()) {
+            this.fillPipeline.render(pass, viewProj);
+        }
+    }
+    /** Label layer: painted after everything else. */
+    drawTexts(pass, viewProj, canvasWidth, canvasHeight, camera) {
+        if (!this.textPipeline?.hasGeometry())
+            return;
+        // Pass viewport pixel dimensions so the shader can scale glyphs
+        // to a constant on-screen size (BIMvision-style annotations)
+        // regardless of camera distance or authored text height.
+        //
+        // Also pass the screen-aligned camera basis (right, up) so
+        // billboarded glyphs (grid bubble tags) can face the camera
+        // in any orientation — top-down, eye-level, oblique alike.
+        const camPos = camera.getPosition();
+        const camTgt = camera.getTarget();
+        const camUpVec = camera.getUp();
+        // Forward = normalize(target - position).
+        let fx = camTgt.x - camPos.x;
+        let fy = camTgt.y - camPos.y;
+        let fz = camTgt.z - camPos.z;
+        let flen = Math.hypot(fx, fy, fz) || 1;
+        fx /= flen;
+        fy /= flen;
+        fz /= flen;
+        // Right = normalize(cross(forward, world-up)).
+        let rx = fy * camUpVec.z - fz * camUpVec.y;
+        let ry = fz * camUpVec.x - fx * camUpVec.z;
+        let rz = fx * camUpVec.y - fy * camUpVec.x;
+        let rlen = Math.hypot(rx, ry, rz) || 1;
+        rx /= rlen;
+        ry /= rlen;
+        rz /= rlen;
+        // True up = normalize(cross(right, forward)) — guaranteed
+        // perpendicular to both, defines screen-space vertical.
+        const ux = ry * fz - rz * fy;
+        const uy = rz * fx - rx * fz;
+        const uz = rx * fy - ry * fx;
+        this.textPipeline.render(pass, viewProj, canvasWidth, canvasHeight, [rx, ry, rz], [ux, uy, uz]);
+    }
+    /** See `Renderer.uploadAnnotationFills3D` for the published contract. */
+    uploadFills(fills) {
+        if (!this.fillPipeline)
+            return;
+        this.fillPipeline.upload(fills);
+        // Contribute fill extents to modelBounds — see uploadAnnotationLines3D.
+        for (const fill of fills) {
+            const pts = fill.points;
+            if (pts.length === 0)
+                continue;
+            // points are flat [x,z,x,z,...]; lift to (x, fill.worldY, z) per
+            // vertex so we expand bounds in the same world space the renderer draws in.
+            const lifted = new Float32Array((pts.length / 2) * 3);
+            for (let i = 0, j = 0; i < pts.length; i += 2, j += 3) {
+                lifted[j] = pts[i];
+                lifted[j + 1] = fill.worldY;
+                lifted[j + 2] = pts[i + 1];
+            }
+            this.host.expandModelBoundsWithFlatVertices(lifted, 3);
+        }
+        this.host.syncCameraSceneBounds();
+        this.host.requestRender();
+    }
+    /** See `Renderer.uploadAnnotationTexts3D` for the published contract. */
+    uploadTexts(texts) {
+        if (!this.textPipeline)
+            return;
+        this.textPipeline.upload(texts);
+        // Text origins are single points; pack them into a flat buffer and
+        // expand bounds. Glyph extents are small enough that origin-only
+        // suffices for framing.
+        if (texts.length > 0) {
+            const buf = new Float32Array(texts.length * 3);
+            for (let i = 0; i < texts.length; i++) {
+                buf[i * 3 + 0] = texts[i].worldPos[0];
+                buf[i * 3 + 1] = texts[i].worldPos[1];
+                buf[i * 3 + 2] = texts[i].worldPos[2];
+            }
+            this.host.expandModelBoundsWithFlatVertices(buf, 3);
+            this.host.syncCameraSceneBounds();
+        }
+        this.host.requestRender();
+    }
+}
+//# sourceMappingURL=renderer-symbolic-overlays.js.map

package/dist/renderer-symbolic-overlays.js.map

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

package/dist/scene.d.ts

@@ -34,6 +34,23 @@ export interface TexturedMesh {
     bindGroup: GPUBindGroup;
     /** Authored tint (multiplies the sampled texel); white = texture passthrough. */
     color: [number, number, number, number];
+    /**
+     * The mesh's per-element local frame (`MeshData.origin`, already Y-up) — the
+     * renderer must reconstruct `world = origin + position`.
+     *
+     * The interleaved vertex buffer stores positions RELATIVE to this, which is
+     * the whole point of the local frame (#1114): keeping the world magnitude out
+     * of f32 so building-scale coordinates don't collapse adjacent vertices into
+     * degenerate fans. So it is applied as the draw's model translation, never
+     * folded back into the vertex data.
+     *
+     * `[0, 0, 0]` for the #961 orphan type-geometry path, whose positions are
+     * already absolute (`transform_mesh_local`); non-zero for the #1793
+     * occurrence path (`apply_submesh_placement` → `transform_mesh_world`), which
+     * is what real exporters write. Dropping it drew every textured occurrence
+     * collapsed toward the world origin (#1973).
+     */
+    origin: [number, number, number];
     /** Set when `texture` lives in the shared registry (#1781: one GPU texture
      *  per `IfcImageTexture`, sampled by many meshes) — released by refcount,
      *  never destroyed per-mesh. Undefined for per-mesh #961 blob/pixel uploads. */
@@ -46,6 +63,11 @@ export interface TexturedMesh {
  * `drawIndexed(indexCount, instanceCount)`. Buffers are Scene-owned, freed in clear().
  */
 export interface InstancedTemplateGPU {
+    /** Owning model (federation index). Templates are identified by
+     *  `(modelIndex, slot)`, so one model's templates can be freed without
+     *  disturbing another's — see `removeInstancedTemplatesForModel`. Defaults to
+     *  0, the single-model / primary case. */
+    modelIndex: number;
     vertexBuffer: GPUBuffer;
     indexBuffer: GPUBuffer;
     indexCount: number;
@@ -80,9 +102,22 @@ export declare class Scene {
      *  Refcounted: entries die when the last referencing mesh is removed / on clear(). */
     private sharedTextures;
     private texturedDevice?;
+    /** GPU-instancing: unique templates + per-occurrence buffers (fed by
+     *  addInstancedShard). SLOT-STABLE and therefore SPARSE: a per-model removal
+     *  (`removeInstancedTemplatesForModel`) leaves `undefined` holes instead of
+     *  splicing, because `InstancedOccurrence.templateIndex` holds the slot by
+     *  value and a splice would silently repoint every later occurrence at the
+     *  wrong template. New templates always append at `length`; freed slots are
+     *  never recycled. Iterate `getInstancedTemplates()` (compacted, cached) for
+     *  the draw/pick/accounting walks — never this array directly. */
     private instancedTemplates;
+    /** Compacted live view of `instancedTemplates`, rebuilt on mutation. */
+    private liveInstancedTemplates;
     private instancedVisible;
     private instancedEntityMap;
+    /** Compact CPU geometry per template, slot-aligned with `instancedTemplates`
+     *  (so equally sparse) for CPU consumers. Also emptied wholesale on geometry
+     *  release — every reader already tolerates a missing entry. */
     private instancedTemplateCpu;
     private instancedDevice?;
     private instancedSelected;
@@ -682,6 +717,46 @@ export declare class Scene {
     /** GPU-instancing templates for the renderer's instanced draw pass. Empty when
      *  hidden (Types view mode) so the draw loop skips it. */
     getInstancedTemplates(): readonly InstancedTemplateGPU[];
+    /** Rebuild the compacted live-template view after a slot add/remove. */
+    private refreshLiveInstancedTemplates;
+    /** Model indices that currently own at least one instanced template. Unlike
+     *  `getInstancedTemplates()` this ignores the Types-view visibility toggle —
+     *  hiding the pass does not change who owns what. */
+    getInstancedModelIndices(): number[];
+    /**
+     * Free every instanced template owned by `modelIndex`: destroy exactly its
+     * own vertex/index/instance buffers, blank its slots (leaving holes, so no
+     * other model's `templateIndex` shifts), prune its occurrences from
+     * `instancedEntityMap`, and drop the per-id selection/hidden/override
+     * bookkeeping for ids that lost their LAST occurrence. Express ids shared
+     * with another model — the federated case before id offsetting — keep the
+     * surviving model's occurrences.
+     *
+     * `boundingBoxes` bookkeeping (#2073): an id that ALSO owns flat geometry is
+     * a mixed id — `removeMeshesForEntity` owns that cache, so it is left alone
+     * here even when the id's last instanced occurrence is pruned. An
+     * instanced-only id that loses its last occurrence has nothing left to keep
+     * a cached box for, so its entry is dropped — otherwise bbox-raycast and
+     * `getBounds()` (post geometry-release) keep finding/sizing an element that
+     * no longer has geometry. An id that keeps SOME occurrences (the shared,
+     * federated case) has its box recomputed from just the survivors, not left
+     * as the stale union that also covered the freed model's occurrences.
+     *
+     * Returns the number of templates removed (0 for an unknown model, which is a
+     * no-op).
+     */
+    removeInstancedTemplatesForModel(modelIndex: number): number;
+    /**
+     * Recompute `boundingBoxes[eid]` from exactly `occurrences` (REPLACING any
+     * existing entry rather than unioning into it), reading each occurrence's
+     * template-local AABB + packed instance matrix the same way
+     * `unionInstancedWorldAabb` does at upload time. Used when a model-level
+     * template removal (`removeInstancedTemplatesForModel`) prunes some but not
+     * all of a shared id's occurrences — a plain union only ever grows, so it
+     * cannot shrink to reflect occurrences that no longer exist. Deletes the
+     * entry outright if no surviving occurrence has a finite local box (#2073).
+     */
+    private recomputeInstancedWorldAabb;
     /**
      * Decode a per-batch IFNS instancing shard (`processGeometryBatchInstanced`)
      * and upload its templates for GPU-instanced drawing. Each unique geometry
@@ -698,7 +773,7 @@ export declare class Scene {
      * type-only dependency on @ifc-lite/geometry and the Scene stays focused on
      * GPU upload.
      */
-    addInstancedShard(device: GPUDevice, shard: DecodedInstancedShard): void;
+    addInstancedShard(device: GPUDevice, shard: DecodedInstancedShard, modelIndex?: number): void;
     /** Transform a template's local AABB by an occurrence's column-major mat4 (read
      *  from the packed instance record at `matOffset`) and union the world box into
      *  boundingBoxes[eid]. Returns the occurrence's world box so the caller can also
@@ -788,7 +863,34 @@ export declare class Scene {
      *  the registry refcount and die with their LAST reference; per-mesh (#961)
      *  uploads are destroyed outright. */
     private releaseTexturedMeshTexture;
+    /**
+     * Destroy every GPU-instanced template's buffers and reset all instanced
+     * bookkeeping, regardless of owning model. Shared by `clear()` (full reset)
+     * — `clearFlatGeometry()` deliberately does NOT call this, so a reshape
+     * that still has models present can retain their instanced geometry
+     * (#2073).
+     */
+    private destroyAllInstancedTemplates;
     clear(): void;
+    /**
+     * Clear flat/batched geometry (meshes, batches, buckets, textured meshes,
+     * colour overlays, streaming state, residency bookkeeping) WITHOUT
+     * touching GPU-instanced templates (#2073). A reshape that still has at
+     * least one model present should call this instead of `clear()`, then
+     * reconcile instanced ownership with `removeInstancedTemplatesForModel`
+     * for any model that did NOT survive — that way a still-loaded model's
+     * repeated geometry (windows, doors, bolts, ...) stays resident across a
+     * visibility toggle / in-place content mutation / federated model add
+     * instead of silently vanishing (nothing re-uploads instanced shard bytes
+     * after their one-time drain).
+     *
+     * Bounding boxes are only dropped for ids with NO surviving instanced
+     * occurrence — an instanced-only id's box must outlive this call so
+     * raycast / measure / section keep working for the geometry that was
+     * just retained; a flat-only id's box is stale the moment its mesh data
+     * is gone, so it is dropped like everything else here.
+     */
+    clearFlatGeometry(): void;
     /**
      * Calculate bounding box from actual mesh vertex data
      */