@ifc-lite/renderer 4.2.0 → 6.0.0

package/dist/selection-mask-pass.js

@@ -0,0 +1,170 @@
+/* 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 { mainShaderSource } from './shaders/main.wgsl.js';
+import { SELECTION_MASK_DEPTH_GROUP, selectionMaskFragmentSource } from './shaders/selection-mask.wgsl.js';
+import { createMaskPipelines, InstancedSelectionMask, isInstancedMaskEmpty, MASK_ALL_FORMAT, MASK_VISIBLE_FORMAT, } from './selection-mask-pipelines.js';
+/** The regular (non-instanced) mesh vertex layout `vs_main` reads. */
+const MESH_VERTEX_BUFFERS = [{
+        arrayStride: 28,
+        attributes: [
+            { shaderLocation: 0, offset: 0, format: 'float32x3' },
+            { shaderLocation: 1, offset: 12, format: 'float32x3' },
+            { shaderLocation: 2, offset: 24, format: 'uint32' },
+        ],
+    }];
+export class SelectionMaskPass {
+    device;
+    meshBindGroupLayout;
+    depthLayout;
+    multisampled;
+    pipelines;
+    /** Built on the first frame with an instanced selection or hover. */
+    instanced = null;
+    targets = null;
+    cachedDepthView = null;
+    cachedDepthBindGroup = null;
+    /** One owned uniform buffer + bind group per hovered piece, grown on demand. */
+    hoverUniforms = [];
+    destroyed = false;
+    constructor(device, meshBindGroupLayout, sampleCount) {
+        this.device = device.getDevice();
+        this.meshBindGroupLayout = meshBindGroupLayout;
+        this.depthLayout = this.device.createBindGroupLayout({
+            label: 'selection-mask-depth-bgl',
+            entries: [{
+                    binding: 0,
+                    visibility: GPUShaderStage.FRAGMENT,
+                    texture: { sampleType: 'depth', viewDimension: '2d', multisampled: sampleCount > 1 },
+                }],
+        });
+        const layout = this.device.createPipelineLayout({
+            bindGroupLayouts: [this.meshBindGroupLayout, this.depthLayout],
+        });
+        this.multisampled = sampleCount > 1;
+        const vertexModule = this.device.createShaderModule({ label: 'selection-mask-vs', code: mainShaderSource });
+        const fragmentModule = this.device.createShaderModule({
+            label: 'selection-mask-fs',
+            code: selectionMaskFragmentSource(this.multisampled),
+        });
+        const vertex = { module: vertexModule, entryPoint: 'vs_main', buffers: MESH_VERTEX_BUFFERS };
+        this.pipelines = createMaskPipelines(this.device, 'selection-mask', layout, vertex, fragmentModule);
+    }
+    /** Nothing to draw this frame: caller skips the pass and the outline composite entirely. */
+    static isEmpty(frame) {
+        return frame.selected.length === 0 && frame.hovered.length === 0 && isInstancedMaskEmpty(frame.instanced);
+    }
+    encode(frame) {
+        const targets = this.ensureTargets(frame.width, frame.height);
+        const depthGroup = this.ensureDepthBindGroup(frame.depthView);
+        const instancedFrame = frame.instanced && !isInstancedMaskEmpty(frame.instanced) ? frame.instanced : null;
+        const instanced = instancedFrame ? this.ensureInstanced() : null;
+        if (instanced && instancedFrame)
+            instanced.prepare(instancedFrame);
+        // The selected-visible and hover passes share `visibleView` (channels r
+        // and g): only the FIRST pass into a target may clear it, or the hover
+        // pass wipes the selection's visible mask (#5390, seen in a real frame).
+        const cleared = new Set();
+        const draw = (view, kind, meshes) => {
+            const loadOp = cleared.has(view) ? 'load' : 'clear';
+            cleared.add(view);
+            const pass = frame.encoder.beginRenderPass({
+                colorAttachments: [{ view, loadOp, storeOp: 'store', clearValue: { r: 0, g: 0, b: 0, a: 0 } }],
+            });
+            pass.setPipeline(this.pipelines[kind]);
+            pass.setBindGroup(SELECTION_MASK_DEPTH_GROUP, depthGroup);
+            for (const mesh of meshes) {
+                pass.setBindGroup(0, mesh.bindGroup);
+                pass.setVertexBuffer(0, mesh.vertexBuffer);
+                pass.setIndexBuffer(mesh.indexBuffer, 'uint32');
+                pass.drawIndexed(mesh.indexCount, 1, 0, 0, 0);
+            }
+            if (instanced && instancedFrame) {
+                instanced.draw(pass, kind, depthGroup, kind === 'hoverVisible' ? instancedFrame.hovered : instancedFrame.selected);
+            }
+            pass.end();
+        };
+        draw(targets.visibleView, 'selectedVisible', frame.selected);
+        if (frame.hovered.length > 0 || (instancedFrame?.hovered.length ?? 0) > 0) {
+            draw(targets.visibleView, 'hoverVisible', frame.hovered.map((h, i) => ({
+                vertexBuffer: h.vertexBuffer, indexBuffer: h.indexBuffer, indexCount: h.indexCount, bindGroup: this.hoverGroup(h, i),
+            })));
+        }
+        draw(targets.allView, 'selectedAll', frame.selected);
+        return targets.views;
+    }
+    ensureInstanced() {
+        this.instanced ??= new InstancedSelectionMask(this.device, this.meshBindGroupLayout, this.depthLayout, this.multisampled);
+        return this.instanced;
+    }
+    hoverGroup(hovered, slot) {
+        if (hovered.bindGroup)
+            return hovered.bindGroup;
+        const { uniforms } = hovered;
+        let entry = this.hoverUniforms[slot];
+        if (!entry || entry.buffer.size < uniforms.byteLength) {
+            entry?.buffer.destroy();
+            const buffer = this.device.createBuffer({
+                label: 'selection-mask-hover-uniforms',
+                size: uniforms.byteLength,
+                usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+            });
+            const bindGroup = this.device.createBindGroup({
+                layout: this.meshBindGroupLayout,
+                entries: [{ binding: 0, resource: { buffer } }],
+            });
+            entry = { buffer, bindGroup };
+            this.hoverUniforms[slot] = entry;
+        }
+        this.device.queue.writeBuffer(entry.buffer, 0, uniforms);
+        return entry.bindGroup;
+    }
+    ensureTargets(width, height) {
+        const current = this.targets;
+        if (current && current.width === width && current.height === height)
+            return current;
+        this.releaseTargets();
+        const make = (label, format) => this.device.createTexture({
+            label,
+            size: { width, height },
+            format,
+            usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,
+        });
+        const visible = make('selection-mask-visible', MASK_VISIBLE_FORMAT);
+        const all = make('selection-mask-all', MASK_ALL_FORMAT);
+        const visibleView = visible.createView();
+        const allView = all.createView();
+        this.targets = { width, height, visible, all, visibleView, allView, views: { visibleView, allView } };
+        return this.targets;
+    }
+    ensureDepthBindGroup(depthView) {
+        if (this.cachedDepthView === depthView && this.cachedDepthBindGroup)
+            return this.cachedDepthBindGroup;
+        this.cachedDepthBindGroup = this.device.createBindGroup({
+            layout: this.depthLayout,
+            entries: [{ binding: 0, resource: depthView }],
+        });
+        this.cachedDepthView = depthView;
+        return this.cachedDepthBindGroup;
+    }
+    releaseTargets() {
+        this.targets?.visible.destroy();
+        this.targets?.all.destroy();
+        this.targets = null;
+    }
+    /** Release every GPU resource. Idempotent; the pass is unusable afterwards. */
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        this.releaseTargets();
+        this.cachedDepthBindGroup = null;
+        this.cachedDepthView = null;
+        for (const entry of this.hoverUniforms)
+            entry.buffer.destroy();
+        this.hoverUniforms = [];
+        this.instanced?.destroy();
+        this.instanced = null;
+    }
+}
+//# sourceMappingURL=selection-mask-pass.js.map

package/dist/selection-mask-pass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-mask-pass.js","sourceRoot":"","sources":["../src/selection-mask-pass.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAyB/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC3G,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,GAIpB,MAAM,+BAA+B,CAAC;AAEvC,sEAAsE;AACtE,MAAM,mBAAmB,GAA4B,CAAC;QACpD,WAAW,EAAE,EAAE;QACf,UAAU,EAAE;YACV,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE;YACrD,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACtD,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;SACpD;KACF,CAAC,CAAC;AAiDH,MAAM,OAAO,iBAAiB;IACX,MAAM,CAAY;IAClB,mBAAmB,CAAqB;IACxC,WAAW,CAAqB;IAChC,YAAY,CAAU;IACtB,SAAS,CAAgB;IAC1C,qEAAqE;IAC7D,SAAS,GAAkC,IAAI,CAAC;IAChD,OAAO,GAAuB,IAAI,CAAC;IACnC,eAAe,GAA0B,IAAI,CAAC;IAC9C,oBAAoB,GAAwB,IAAI,CAAC;IACzD,gFAAgF;IACxE,aAAa,GAAqD,EAAE,CAAC;IACrE,SAAS,GAAG,KAAK,CAAC;IAE1B,YAAY,MAAoB,EAAE,mBAAuC,EAAE,WAAmB;QAC5F,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;QAE/C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC;YACnD,KAAK,EAAE,0BAA0B;YACjC,OAAO,EAAE,CAAC;oBACR,OAAO,EAAE,CAAC;oBACV,UAAU,EAAE,cAAc,CAAC,QAAQ;oBACnC,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,GAAG,CAAC,EAAE;iBACrF,CAAC;SACH,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC;YAC9C,gBAAgB,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,WAAW,CAAC;SAC/D,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,WAAW,GAAG,CAAC,CAAC;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC5G,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC;YACpD,KAAK,EAAE,mBAAmB;YAC1B,IAAI,EAAE,2BAA2B,CAAC,IAAI,CAAC,YAAY,CAAC;SACrD,CAAC,CAAC;QACH,MAAM,MAAM,GAAmB,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;QAC7G,IAAI,CAAC,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IACtG,CAAC;IAED,4FAA4F;IAC5F,MAAM,CAAC,OAAO,CAAC,KAAqE;QAClF,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5G,CAAC;IAED,MAAM,CAAC,KAAyB;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAE9D,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1G,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,IAAI,SAAS,IAAI,cAAc;YAAE,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAEnE,wEAAwE;QACxE,uEAAuE;QACvE,yEAAyE;QACzE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC1C,MAAM,IAAI,GAAG,CAAC,IAAoB,EAAE,IAAc,EAAE,MAAiC,EAAE,EAAE;YACvF,MAAM,MAAM,GAAc,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;gBACzC,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;aAC/F,CAAC,CAAC;YACH,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,IAAI,CAAC,YAAY,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAC;YAC1D,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAC1B,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBACrC,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC3C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;gBAChD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,IAAI,SAAS,IAAI,cAAc,EAAE,CAAC;gBAChC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YACrH,CAAC;YACD,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,iBAAiB,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1E,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;aACrH,CAAC,CAAC,CAAC,CAAC;QACP,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAErD,OAAO,OAAO,CAAC,KAAK,CAAC;IACvB,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,SAAS,KAAK,IAAI,sBAAsB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1H,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEO,UAAU,CAAC,OAAoB,EAAE,IAAY;QACnD,IAAI,OAAO,CAAC,SAAS;YAAE,OAAO,OAAO,CAAC,SAAS,CAAC;QAChD,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAC7B,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtD,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;gBACtC,KAAK,EAAE,+BAA+B;gBACtC,IAAI,EAAE,QAAQ,CAAC,UAAU;gBACzB,KAAK,EAAE,cAAc,CAAC,OAAO,GAAG,cAAc,CAAC,QAAQ;aACxD,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;gBAC5C,MAAM,EAAE,IAAI,CAAC,mBAAmB;gBAChC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;aAChD,CAAC,CAAC;YACH,KAAK,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;QACzD,OAAO,KAAK,CAAC,SAAS,CAAC;IACzB,CAAC;IAEO,aAAa,CAAC,KAAa,EAAE,MAAc;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,OAAO,CAAC;QACpF,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,MAAwB,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;YAClF,KAAK;YACL,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;YACvB,MAAM;YACN,KAAK,EAAE,eAAe,CAAC,iBAAiB,GAAG,eAAe,CAAC,eAAe;SAC3E,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAAC;QACxD,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACtG,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEO,oBAAoB,CAAC,SAAyB;QACpD,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,IAAI,IAAI,CAAC,oBAAoB;YAAE,OAAO,IAAI,CAAC,oBAAoB,CAAC;QACtG,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;YACtD,MAAM,EAAE,IAAI,CAAC,WAAW;YACxB,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;SAC/C,CAAC,CAAC;QACH,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACjC,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,+EAA+E;IAC/E,OAAO;QACL,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;QACjC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa;YAAE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/D,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;CACF"}

package/dist/selection-mask-pipelines.d.ts

@@ -0,0 +1,57 @@
+import type { WorldPoint } from './relative-to-eye.js';
+import type { InstancedTemplateGPU } from './scene-instance-types.js';
+export declare const MASK_VISIBLE_FORMAT: GPUTextureFormat;
+export declare const MASK_ALL_FORMAT: GPUTextureFormat;
+/** Which mask output a draw writes. */
+export type MaskKind = 'selectedVisible' | 'hoverVisible' | 'selectedAll';
+export type MaskPipelines = Record<MaskKind, GPURenderPipeline>;
+/** The three mask pipelines over one vertex stage and one fragment module. */
+export declare function createMaskPipelines(device: GPUDevice, labelPrefix: string, layout: GPUPipelineLayout, vertex: GPUVertexState, fragmentModule: GPUShaderModule): MaskPipelines;
+/** What the instanced mask draws of a template: its geometry and its instance records. */
+export type InstancedMaskTemplate = Pick<InstancedTemplateGPU, 'vertexBuffer' | 'indexBuffer' | 'indexCount' | 'instanceBuffer' | 'instanceCount' | 'canonicalAnchors' | 'rteDeltas'>;
+export interface InstancedMaskFrame {
+    /**
+     * Packed mesh uniform for `vs_instanced` and the section/clip cut: the
+     * frame's RTE view-projection, section plane, clip box and flags, as the
+     * main instanced draw sees them (`selection-outline-frame.ts`).
+     */
+    uniforms: Float32Array;
+    /**
+     * The frame's RTE camera, the one the colour pass uploaded the delta streams
+     * for. The mask shares that submission, so it must not use another (see
+     * `instanced-rte.ts`); in practice every upload here is a cache hit, except
+     * for templates the colour pass culled.
+     */
+    rteCamera: WorldPoint;
+    /** Templates holding at least one selected occurrence. */
+    selected: readonly InstancedMaskTemplate[];
+    /** Templates holding an occurrence of `hoveredId`; empty when nothing is hovered. */
+    hovered: readonly InstancedMaskTemplate[];
+    hoveredId: number;
+}
+/** True when the instanced frame has nothing to draw. */
+export declare function isInstancedMaskEmpty(frame: InstancedMaskFrame | null | undefined): boolean;
+/**
+ * The instanced mask pipelines plus the two small uniforms they read: the
+ * mesh uniform (group 0, owned so no other draw's write can race it) and the
+ * hovered entity id (group `SELECTION_MASK_HOVER_GROUP`). Built on the first
+ * frame that has an instanced selection or hover.
+ */
+export declare class InstancedSelectionMask {
+    private readonly device;
+    private readonly pipelines;
+    private readonly meshBindGroupLayout;
+    private meshUniform;
+    private readonly hoverBuffer;
+    private readonly hoverBindGroup;
+    private readonly hoverScratch;
+    /** This frame's drawable runs per template, from `prepare`. */
+    private runs;
+    constructor(device: GPUDevice, meshBindGroupLayout: GPUBindGroupLayout, depthLayout: GPUBindGroupLayout, multisampled: boolean);
+    /** Upload this frame's uniforms. Call once per frame, before `draw`. */
+    prepare(frame: InstancedMaskFrame): void;
+    /** Draw `templates` into the open mask pass, one instanced draw per in-envelope run. */
+    draw(pass: GPURenderPassEncoder, kind: MaskKind, depthGroup: GPUBindGroup, templates: readonly InstancedMaskTemplate[]): void;
+    destroy(): void;
+}
+//# sourceMappingURL=selection-mask-pipelines.d.ts.map

package/dist/selection-mask-pipelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-mask-pipelines.d.ts","sourceRoot":"","sources":["../src/selection-mask-pipelines.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAQtE,eAAO,MAAM,mBAAmB,EAAE,gBAA6B,CAAC;AAChE,eAAO,MAAM,eAAe,EAAE,gBAA4B,CAAC;AAQ3D,uCAAuC;AACvC,MAAM,MAAM,QAAQ,GAAG,iBAAiB,GAAG,cAAc,GAAG,aAAa,CAAC;AAE1E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAQhE,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,cAAc,EACtB,cAAc,EAAE,eAAe,GAC9B,aAAa,CAYf;AAED,0FAA0F;AAC1F,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,oBAAoB,EACpB,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,gBAAgB,GAAG,eAAe,GAAG,kBAAkB,GAAG,WAAW,CACtH,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,EAAE,YAAY,CAAC;IACvB;;;;;OAKG;IACH,SAAS,EAAE,UAAU,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C,qFAAqF;IACrF,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE1F;AAED;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,WAAW,CAA+D;IAClF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAY;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAe;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,+DAA+D;IAC/D,OAAO,CAAC,IAAI,CAA4D;gBAE5D,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,OAAO;IAkC9H,wEAAwE;IACxE,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAyBxC,wFAAwF;IACxF,IAAI,CAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI;IAe7H,OAAO,IAAI,IAAI;CAMhB"}

package/dist/selection-mask-pipelines.js

@@ -0,0 +1,150 @@
+/* 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/. */
+/**
+ * The selection/hover mask pipelines (#5390), and the instanced variant that
+ * outlines GPU-instanced occurrences (#5745): repeated windows, doors,
+ * furniture and fasteners, whose "selected" flag lives in the per-instance
+ * record rather than in a mesh uniform.
+ *
+ * Both variants write the same three outputs into the same targets, so
+ * `edge-pass.ts`'s `encodeOutline` sees one mask whatever drew it. The
+ * instanced one differs only in its vertex stage (`vs_instanced` over
+ * `INSTANCED_VERTEX_BUFFERS`, exactly as the main instanced draw, so the
+ * mask lands where the occurrence was drawn) and in a per-occurrence filter
+ * in the fragment stage (`selection-mask.wgsl.ts`). Each template draws the
+ * same in-envelope instance runs the colour pass draws, over the same
+ * camera-relative delta stream (#6393); the fragment keeps the selected
+ * occurrences, or the hovered id's.
+ */
+import { INSTANCED_RTE_DELTA_SLOT, INSTANCED_VERTEX_BUFFERS } from './instanced-vertex-layout.js';
+import { drawInstanceRuns, uploadInstancedRteDeltas } from './instanced-rte.js';
+import { mainShaderSource } from './shaders/main.wgsl.js';
+import { SELECTION_MASK_DEPTH_GROUP, SELECTION_MASK_HOVER_GROUP, selectionMaskFragmentSource, } from './shaders/selection-mask.wgsl.js';
+export const MASK_VISIBLE_FORMAT = 'rg8unorm';
+export const MASK_ALL_FORMAT = 'r8unorm';
+/** Additive blend: two draws to the same target OR their channels together (binary flags, unorm-clamped). */
+const ADDITIVE_BLEND = {
+    color: { srcFactor: 'one', dstFactor: 'one' },
+    alpha: { srcFactor: 'one', dstFactor: 'one' },
+};
+const MASK_OUTPUTS = {
+    selectedVisible: { label: 'selected-visible', entryPoint: 'fs_mask_selected_visible', format: MASK_VISIBLE_FORMAT },
+    hoverVisible: { label: 'hover-visible', entryPoint: 'fs_mask_hover_visible', format: MASK_VISIBLE_FORMAT },
+    selectedAll: { label: 'selected-all', entryPoint: 'fs_mask_selected_all', format: MASK_ALL_FORMAT },
+};
+/** The three mask pipelines over one vertex stage and one fragment module. */
+export function createMaskPipelines(device, labelPrefix, layout, vertex, fragmentModule) {
+    const make = (kind) => {
+        const out = MASK_OUTPUTS[kind];
+        return device.createRenderPipeline({
+            label: `${labelPrefix}-${out.label}`,
+            layout,
+            vertex,
+            fragment: { module: fragmentModule, entryPoint: out.entryPoint, targets: [{ format: out.format, blend: ADDITIVE_BLEND }] },
+            primitive: { topology: 'triangle-list', cullMode: 'none' },
+        });
+    };
+    return { selectedVisible: make('selectedVisible'), hoverVisible: make('hoverVisible'), selectedAll: make('selectedAll') };
+}
+/** True when the instanced frame has nothing to draw. */
+export function isInstancedMaskEmpty(frame) {
+    return !frame || (frame.selected.length === 0 && frame.hovered.length === 0);
+}
+/**
+ * The instanced mask pipelines plus the two small uniforms they read: the
+ * mesh uniform (group 0, owned so no other draw's write can race it) and the
+ * hovered entity id (group `SELECTION_MASK_HOVER_GROUP`). Built on the first
+ * frame that has an instanced selection or hover.
+ */
+export class InstancedSelectionMask {
+    device;
+    pipelines;
+    meshBindGroupLayout;
+    meshUniform = null;
+    hoverBuffer;
+    hoverBindGroup;
+    hoverScratch = new Uint32Array(4);
+    /** This frame's drawable runs per template, from `prepare`. */
+    runs = new Map();
+    constructor(device, meshBindGroupLayout, depthLayout, multisampled) {
+        this.device = device;
+        this.meshBindGroupLayout = meshBindGroupLayout;
+        const hoverLayout = device.createBindGroupLayout({
+            label: 'selection-mask-instanced-hover-bgl',
+            entries: [{ binding: 0, visibility: GPUShaderStage.FRAGMENT, buffer: { type: 'uniform' } }],
+        });
+        const groups = [];
+        groups[0] = meshBindGroupLayout;
+        groups[SELECTION_MASK_DEPTH_GROUP] = depthLayout;
+        groups[SELECTION_MASK_HOVER_GROUP] = hoverLayout;
+        const layout = device.createPipelineLayout({ label: 'selection-mask-instanced-layout', bindGroupLayouts: groups });
+        const vertex = {
+            module: device.createShaderModule({ label: 'selection-mask-instanced-vs', code: mainShaderSource }),
+            entryPoint: 'vs_instanced',
+            buffers: INSTANCED_VERTEX_BUFFERS,
+        };
+        const fragmentModule = device.createShaderModule({
+            label: 'selection-mask-instanced-fs',
+            code: selectionMaskFragmentSource(multisampled, true),
+        });
+        this.pipelines = createMaskPipelines(device, 'selection-mask-instanced', layout, vertex, fragmentModule);
+        this.hoverBuffer = device.createBuffer({
+            label: 'selection-mask-instanced-hover',
+            size: this.hoverScratch.byteLength,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        this.hoverBindGroup = device.createBindGroup({
+            layout: hoverLayout,
+            entries: [{ binding: 0, resource: { buffer: this.hoverBuffer } }],
+        });
+    }
+    /** Upload this frame's uniforms. Call once per frame, before `draw`. */
+    prepare(frame) {
+        const { uniforms } = frame;
+        if (!this.meshUniform || this.meshUniform.buffer.size < uniforms.byteLength) {
+            this.meshUniform?.buffer.destroy();
+            const buffer = this.device.createBuffer({
+                label: 'selection-mask-instanced-uniforms',
+                size: uniforms.byteLength,
+                usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+            });
+            const bindGroup = this.device.createBindGroup({
+                layout: this.meshBindGroupLayout,
+                entries: [{ binding: 0, resource: { buffer } }],
+            });
+            this.meshUniform = { buffer, bindGroup };
+        }
+        this.device.queue.writeBuffer(this.meshUniform.buffer, 0, uniforms);
+        this.hoverScratch[0] = frame.hoveredId >>> 0;
+        this.device.queue.writeBuffer(this.hoverBuffer, 0, this.hoverScratch);
+        // Without this a template the colour pass culled this frame would read a
+        // delta stream packed for an older camera (or never packed at all).
+        const templates = [...new Set([...frame.selected, ...frame.hovered])];
+        const runs = uploadInstancedRteDeltas(this.device, templates, frame.rteCamera);
+        this.runs = new Map(templates.map((t, i) => [t, runs[i]]));
+    }
+    /** Draw `templates` into the open mask pass, one instanced draw per in-envelope run. */
+    draw(pass, kind, depthGroup, templates) {
+        if (templates.length === 0 || !this.meshUniform)
+            return;
+        pass.setPipeline(this.pipelines[kind]);
+        pass.setBindGroup(0, this.meshUniform.bindGroup);
+        pass.setBindGroup(SELECTION_MASK_DEPTH_GROUP, depthGroup);
+        pass.setBindGroup(SELECTION_MASK_HOVER_GROUP, this.hoverBindGroup);
+        for (const t of templates) {
+            pass.setVertexBuffer(0, t.vertexBuffer);
+            pass.setVertexBuffer(1, t.instanceBuffer);
+            pass.setVertexBuffer(INSTANCED_RTE_DELTA_SLOT, t.rteDeltas.buffer);
+            pass.setIndexBuffer(t.indexBuffer, 'uint32');
+            drawInstanceRuns(pass, t.indexCount, this.runs.get(t) ?? []);
+        }
+    }
+    destroy() {
+        this.meshUniform?.buffer.destroy();
+        this.meshUniform = null;
+        this.runs.clear();
+        this.hoverBuffer.destroy();
+    }
+}
+//# sourceMappingURL=selection-mask-pipelines.js.map

package/dist/selection-mask-pipelines.js.map

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

package/dist/selection-outline-frame.d.ts

@@ -0,0 +1,47 @@
+import { packRteFragmentSpace } from './mesh-rte-uniforms.js';
+import type { RelativeToEyeFrame } from './relative-to-eye.js';
+import type { IndividualMeshGpu } from './individual-mesh-upload.js';
+import type { HoveredMesh, SelectableMesh } from './selection-mask-pass.js';
+import type { InstancedMaskFrame, InstancedMaskTemplate } from './selection-mask-pipelines.js';
+import type { InstancedTemplateGPU } from './scene-instance-types.js';
+import type { ClipBox, Mesh } from './types.js';
+export interface SelectionOutlineSource {
+    uniformBufferSize: number;
+    viewProj: Float32Array | number[];
+    relativeToEyeFrame: RelativeToEyeFrame;
+    /** Meshes the highlight-draw loop already prepared this frame (may be empty). */
+    selectedMeshes: readonly Mesh[];
+    /** GPU copies of the hovered entity's pieces, used when it is not among `selectedMeshes`. */
+    hoverPieces: readonly IndividualMeshGpu[];
+    hoveredId: number | null | undefined;
+    selectedModelIndex: number | undefined;
+    /** This frame's resolved section plane (the one every mesh draw packs). */
+    section: Parameters<typeof packRteFragmentSpace>[1];
+    sectionFlipped: boolean | undefined;
+    clipBox: ClipBox | null | undefined;
+    /** This frame's live instanced templates; those with a selected occurrence are outlined (#5745). */
+    instancedTemplates?: readonly InstancedTemplateGPU[];
+    /** Instanced templates holding an occurrence of `hoveredId` (#5745). */
+    instancedHovered?: readonly InstancedMaskTemplate[];
+}
+/**
+ * Whether `mesh` is the one `hoveredId` names, honouring the same
+ * per-model disambiguation `selectedMeshes` filters by. Pure and exported
+ * for unit testing; the two GPU-facing lookups above call it with `.find`.
+ */
+export declare function matchesHoveredMesh(mesh: Mesh, hoveredId: number, selectedModelIndex: number | undefined): boolean;
+/**
+ * Packs the mask pipeline's mesh uniform for a mesh that may not have one
+ * yet: the frame fields plus the mesh's model matrix and RTE drawable origin.
+ * Exported for unit testing.
+ */
+export declare function packHoverUniforms(source: SelectionOutlineSource, mesh: Pick<Mesh, 'transform' | 'rteOrigin'>): Float32Array;
+export interface SelectionOutlineFrameResult {
+    selected: SelectableMesh[];
+    /** Every piece of the hovered entity (empty when nothing is hovered). */
+    hovered: HoveredMesh[];
+    /** Instanced occurrences to outline, or null when none are selected or hovered. */
+    instanced: InstancedMaskFrame | null;
+}
+export declare function buildSelectionOutlineFrame(source: SelectionOutlineSource): SelectionOutlineFrameResult;
+//# sourceMappingURL=selection-outline-frame.d.ts.map

package/dist/selection-outline-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-outline-frame.d.ts","sourceRoot":"","sources":["../src/selection-outline-frame.ts"],"names":[],"mappings":"AAsCA,OAAO,EAAuE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnI,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;IAClC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,iFAAiF;IACjF,cAAc,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,6FAA6F;IAC7F,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC1C,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,2EAA2E;IAC3E,OAAO,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,oGAAoG;IACpG,kBAAkB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACrD,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACrD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEjH;AA6BD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,sBAAsB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG,YAAY,CAM3H;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,yEAAyE;IACzE,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,mFAAmF;IACnF,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACtC;AAeD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,GAAG,2BAA2B,CAwBtG"}

package/dist/selection-outline-frame.js

@@ -0,0 +1,122 @@
+/* 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/. */
+/**
+ * Builds the selection/hover outline pass's per-frame input (#5390) from
+ * the meshes the main render pass already drew this frame. Extracted from
+ * `index.ts`'s `renderFrame`, which sits close to its module-size budget.
+ *
+ * Selected meshes reuse their EXISTING uniform buffer/bind group verbatim:
+ * `renderFrame`'s highlight-draw loop already wrote the correct
+ * view-projection, transform and RTE drawable origin into it earlier in
+ * the same frame (before this runs), and GPU queue writes are visible to
+ * command buffers submitted in the same `queue.submit` call, in submission
+ * order — so no re-pack is needed here.
+ *
+ * A hovered entity that is not selected has no individual mesh on a batched
+ * model, so the caller supplies GPU copies of ALL its pieces
+ * (`hover-mesh-cache.ts`); a selected one reuses its selection meshes. Either
+ * way every piece is outlined, not just the first. For the copies this packs
+ * the fields the mask pipeline reads:
+ * view-projection, model transform and RTE drawable origin (vertex
+ * position), plus the section plane, clip box and their `flags.y` bits
+ * (the mask fragments clip exactly like `fs_main`). It returns the packed
+ * floats, not a GPU buffer: `SelectionMaskPass` writes them into the one
+ * hover uniform buffer it owns, so hovering allocates nothing per frame.
+ *
+ * GPU-instanced occurrences (#5745) are not copied at all: the mask draws the
+ * templates themselves with `vs_instanced`, and the fragment keeps the
+ * selected occurrences (their instance flag) or the hovered id's. This packs
+ * the one uniform those draws read: the same frame fields as a hover copy, with
+ * an identity model matrix and no drawable origin. `vs_instanced` reads neither; each
+ * occurrence's origin comes from its per-instance RTE delta, exactly as in the
+ * main instanced colour pass. Packing a stand-in origin of [0, 0, 0] threw once
+ * the camera was over 1,000 km from the world origin (#6400).
+ */
+import { packClipBox } from './clip-box.js';
+import { MESH_FLAG_RTE_DRAWABLE, MESH_FLAGS_BYTE_OFFSET, MESH_UNIFORM_OFFSET, packRteFragmentSpace } from './mesh-rte-uniforms.js';
+/**
+ * Whether `mesh` is the one `hoveredId` names, honouring the same
+ * per-model disambiguation `selectedMeshes` filters by. Pure and exported
+ * for unit testing; the two GPU-facing lookups above call it with `.find`.
+ */
+export function matchesHoveredMesh(mesh, hoveredId, selectedModelIndex) {
+    return mesh.expressId === hoveredId && (selectedModelIndex === undefined || mesh.modelIndex === selectedModelIndex);
+}
+function toSelectable(mesh) {
+    if (!mesh.bindGroup)
+        return null;
+    return { vertexBuffer: mesh.vertexBuffer, indexBuffer: mesh.indexBuffer, indexCount: mesh.indexCount, bindGroup: mesh.bindGroup };
+}
+const IDENTITY_TRANSFORM = { m: new Float32Array([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]) };
+/**
+ * Packs the per-frame fields every mask draw reads: view-projection, RTE
+ * view-projection, section plane, clip box and flags, with an identity model
+ * matrix and no drawable origin. Section / clip data go through the same
+ * `packClipBox` + `packRteFragmentSpace` pair `index.ts`'s mesh loop uses.
+ */
+function packMaskFrameUniforms(source) {
+    const scratch = new Float32Array(source.uniformBufferSize / 4);
+    scratch.set(source.viewProj, 0);
+    scratch.set(IDENTITY_TRANSFORM.m, MESH_UNIFORM_OFFSET.model);
+    source.relativeToEyeFrame.packUniforms(scratch, MESH_UNIFORM_OFFSET.rteViewProj);
+    const clipBit = packClipBox(source.clipBox, scratch, MESH_UNIFORM_OFFSET.clipBoxMin);
+    packRteFragmentSpace(source.relativeToEyeFrame, source.section, source.clipBox, scratch);
+    const flags = new Uint32Array(scratch.buffer, MESH_FLAGS_BYTE_OFFSET, 2);
+    flags[0] = MESH_FLAG_RTE_DRAWABLE;
+    // flags.y: bit 0 = section enabled, bit 1 = flipped, bit 2 = clip box (as index.ts packs it).
+    flags[1] = (source.section?.enabled ? 1 : 0) | (source.sectionFlipped ? 2 : 0) | clipBit;
+    return scratch;
+}
+/**
+ * Packs the mask pipeline's mesh uniform for a mesh that may not have one
+ * yet: the frame fields plus the mesh's model matrix and RTE drawable origin.
+ * Exported for unit testing.
+ */
+export function packHoverUniforms(source, mesh) {
+    const scratch = packMaskFrameUniforms(source);
+    scratch.set(mesh.transform.m, MESH_UNIFORM_OFFSET.model);
+    const origin = mesh.rteOrigin ?? [mesh.transform.m[12], mesh.transform.m[13], mesh.transform.m[14]];
+    source.relativeToEyeFrame.packDrawableOrigin(origin, scratch, MESH_UNIFORM_OFFSET.drawableDelta);
+    return scratch;
+}
+function buildInstancedMaskFrame(source) {
+    const selected = (source.instancedTemplates ?? []).filter((t) => t.selectedCount > 0);
+    const hovered = source.hoveredId != null ? source.instancedHovered ?? [] : [];
+    if (selected.length === 0 && hovered.length === 0)
+        return null;
+    return {
+        uniforms: packMaskFrameUniforms(source),
+        rteCamera: source.relativeToEyeFrame.getCameraWorld(),
+        selected,
+        hovered,
+        hoveredId: source.hoveredId ?? 0,
+    };
+}
+export function buildSelectionOutlineFrame(source) {
+    const selected = [];
+    for (const mesh of source.selectedMeshes) {
+        const s = toSelectable(mesh);
+        if (s)
+            selected.push(s);
+    }
+    const hovered = [];
+    if (source.hoveredId != null) {
+        const hoveredId = source.hoveredId;
+        const already = source.selectedMeshes.filter((m) => matchesHoveredMesh(m, hoveredId, source.selectedModelIndex));
+        if (already.length > 0) {
+            for (const mesh of already) {
+                const s = toSelectable(mesh);
+                if (s)
+                    hovered.push(s);
+            }
+        }
+        else {
+            for (const piece of source.hoverPieces) {
+                hovered.push({ vertexBuffer: piece.vertexBuffer, indexBuffer: piece.indexBuffer, indexCount: piece.indexCount, uniforms: packHoverUniforms(source, piece) });
+            }
+        }
+    }
+    return { selected, hovered, instanced: buildInstancedMaskFrame(source) };
+}
+//# sourceMappingURL=selection-outline-frame.js.map

package/dist/selection-outline-frame.js.map

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

package/dist/shaders/color-transfer.wgsl.d.ts

@@ -16,9 +16,11 @@
  *    irradiance, renders as authored; brighter colours roll off with their
  *    hue preserved (pure white lands at 0.88, about 241/255, leaving
  *    headroom for sunlit highlights). It is the Khronos PBR Neutral operator
- *    without its toe: the toe subtracts up to 0.04 to cancel a specular F0
- *    offset, and this renderer has no specular term, so keeping it would only
- *    crush dark materials.
+ *    without its toe: the toe subtracts up to 0.04 to cancel the specular F0
+ *    offset a dielectric picks up under a unit-radiance environment. This
+ *    renderer's sky is far dimmer, so its specular term (specular.wgsl.ts)
+ *    lifts a dark matte surface by only about 0.01-0.02, and keeping the toe
+ *    would crush dark materials below their authored value.
  *  - `linearToSrgb` is the exact piecewise encode. The canvas is configured
  *    with a non-sRGB format, so the shader must encode.
  */

package/dist/shaders/color-transfer.wgsl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color-transfer.wgsl.d.ts","sourceRoot":"","sources":["../../src/shaders/color-transfer.wgsl.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,iBAAiB,8gCAwB7B,CAAC"}
+{"version":3,"file":"color-transfer.wgsl.d.ts","sourceRoot":"","sources":["../../src/shaders/color-transfer.wgsl.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,iBAAiB,8gCAwB7B,CAAC"}

package/dist/shaders/color-transfer.wgsl.js

@@ -19,9 +19,11 @@
  *    irradiance, renders as authored; brighter colours roll off with their
  *    hue preserved (pure white lands at 0.88, about 241/255, leaving
  *    headroom for sunlit highlights). It is the Khronos PBR Neutral operator
- *    without its toe: the toe subtracts up to 0.04 to cancel a specular F0
- *    offset, and this renderer has no specular term, so keeping it would only
- *    crush dark materials.
+ *    without its toe: the toe subtracts up to 0.04 to cancel the specular F0
+ *    offset a dielectric picks up under a unit-radiance environment. This
+ *    renderer's sky is far dimmer, so its specular term (specular.wgsl.ts)
+ *    lifts a dark matte surface by only about 0.01-0.02, and keeping the toe
+ *    would crush dark materials below their authored value.
  *  - `linearToSrgb` is the exact piecewise encode. The canvas is configured
  *    with a non-sRGB format, so the shader must encode.
  */

package/dist/shaders/color-transfer.wgsl.js.map

@@ -1 +1 @@
-{"version":3,"file":"color-transfer.wgsl.js","sourceRoot":"","sources":["../../src/shaders/color-transfer.wgsl.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBhC,CAAC"}
+{"version":3,"file":"color-transfer.wgsl.js","sourceRoot":"","sources":["../../src/shaders/color-transfer.wgsl.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBhC,CAAC"}