@ifc-lite/renderer 6.4.0 → 6.5.0

package/dist/opaque-visibility-pass.d.ts

@@ -0,0 +1,37 @@
+export declare function opaqueVisibilityLayout(device: GPUDevice, samples: number): GPUBindGroupLayout;
+/** A compiling frame is discarded before submit; completion requests its replacement. */
+export declare function deferOpaqueVisibilityFrame(error: unknown, requestRender: () => void): boolean;
+/**
+ * Orthographic only: replay the SAME submitted opaque draws into unbiased
+ * sample-matched depth, then constrain the legacy coplanar ranking to it.
+ * No second visibility, partial-batch, texture or instancing enumeration.
+ */
+export declare class OpaqueVisibilityPass {
+    private readonly device;
+    private readonly samples;
+    private readonly sectionBinding?;
+    private readonly registrations;
+    private readonly variants;
+    private readonly pending;
+    private readonly failures;
+    private destroyed;
+    private texture;
+    private binding;
+    private width;
+    private height;
+    private active;
+    constructor(device: GPUDevice, samples: number, sectionBinding?: (() => GPUBindGroup) | undefined);
+    create(descriptor: GPURenderPipelineDescriptor, source?: string): GPURenderPipeline;
+    createAsync(descriptor: GPURenderPipelineDescriptor, source?: string): Promise<GPURenderPipeline>;
+    register(pipeline: GPURenderPipeline, descriptor: GPURenderPipelineDescriptor, source: string): GPURenderPipeline;
+    getBinding(): GPUBindGroup | undefined;
+    private ensureSize;
+    /** Explicit setup for async consumers; the render path requests only used variants. */
+    prepare(base?: GPURenderPipeline): Promise<void>;
+    private forPipeline;
+    private buildVariants;
+    begin(encoder: GPUCommandEncoder, descriptor: GPURenderPassDescriptor, orthographic: boolean, width: number, height: number): GPURenderPassEncoder;
+    private releaseTexture;
+    destroy(): void;
+}
+//# sourceMappingURL=opaque-visibility-pass.d.ts.map

package/dist/opaque-visibility-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opaque-visibility-pass.d.ts","sourceRoot":"","sources":["../src/opaque-visibility-pass.ts"],"names":[],"mappings":"AAUA,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAU7F;AAQD,yFAAyF;AACzF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,IAAI,GAAG,OAAO,CAK7F;AAED;;;;GAIG;AACH,qBAAa,oBAAoB;IAYnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAa,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAU,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAXlH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8C;IAC5E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+C;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAAS;gBAEM,MAAM,EAAE,SAAS,EAAmB,OAAO,EAAE,MAAM,EAAmB,cAAc,CAAC,GAAE,MAAM,YAAY,aAAA;IAEtI,MAAM,CAAC,UAAU,EAAE,2BAA2B,EAAE,MAAM,SAAmB,GAAG,iBAAiB;IAIvF,WAAW,CAAC,UAAU,EAAE,2BAA2B,EAAE,MAAM,SAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIjH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAKjH,UAAU,IAAI,YAAY,GAAG,SAAS;IAEtC,OAAO,CAAC,UAAU;IASlB,uFAAuF;IACjF,OAAO,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAetD,OAAO,CAAC,WAAW;YAOL,aAAa;IAkB3B,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,uBAAuB,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB;IAwDlJ,OAAO,CAAC,cAAc;IAItB,OAAO,IAAI,IAAI;CAGhB"}

package/dist/opaque-visibility-pass.js

@@ -0,0 +1,230 @@
+/* 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 { guardedMeshShader, unbiasedMeshShader, OPAQUE_VISIBILITY_GROUP } from './shaders/opaque-visibility.wgsl.js';
+import { mainShaderSource } from './shaders/main.wgsl.js';
+import { setOpaqueVisibilityCommands } from './opaque-visibility-commands.js';
+import { opaqueVisibilityTimestampWrites } from './renderer-frame-timing.js';
+const layouts = new WeakMap();
+export function opaqueVisibilityLayout(device, samples) {
+    let bySamples = layouts.get(device);
+    if (!bySamples) {
+        bySamples = new Map();
+        layouts.set(device, bySamples);
+    }
+    let layout = bySamples.get(samples);
+    if (!layout) {
+        layout = device.createBindGroupLayout({ entries: [{ binding: 0, visibility: GPUShaderStage.FRAGMENT,
+                    texture: { sampleType: 'depth', multisampled: samples > 1 } }] });
+        bySamples.set(samples, layout);
+    }
+    return layout;
+}
+class PendingVisibility extends Error {
+    ready;
+    alive;
+    constructor(ready, alive) {
+        super('Orthographic pipelines are compiling');
+        this.ready = ready;
+        this.alive = alive;
+    }
+}
+/** A compiling frame is discarded before submit; completion requests its replacement. */
+export function deferOpaqueVisibilityFrame(error, requestRender) {
+    if (!(error instanceof PendingVisibility))
+        return false;
+    const wake = () => { if (error.alive())
+        requestRender(); };
+    void error.ready.then(wake, wake); // Rejection is retained and thrown on the next draw.
+    return true;
+}
+/**
+ * Orthographic only: replay the SAME submitted opaque draws into unbiased
+ * sample-matched depth, then constrain the legacy coplanar ranking to it.
+ * No second visibility, partial-batch, texture or instancing enumeration.
+ */
+export class OpaqueVisibilityPass {
+    device;
+    samples;
+    sectionBinding;
+    registrations = new Map();
+    variants = new Map();
+    pending = new Map();
+    failures = new Map();
+    destroyed = false;
+    texture = null;
+    binding = null;
+    width = 0;
+    height = 0;
+    active = false;
+    constructor(device, samples, sectionBinding) {
+        this.device = device;
+        this.samples = samples;
+        this.sectionBinding = sectionBinding;
+    }
+    create(descriptor, source = mainShaderSource) {
+        return this.register(this.device.createRenderPipeline(descriptor), descriptor, source);
+    }
+    async createAsync(descriptor, source = mainShaderSource) {
+        return this.register(await this.device.createRenderPipelineAsync(descriptor), descriptor, source);
+    }
+    register(pipeline, descriptor, source) {
+        if (this.destroyed)
+            throw new Error('Visibility pass was destroyed during compilation');
+        this.registrations.set(pipeline, { descriptor, source });
+        return pipeline;
+    }
+    getBinding() { return this.active ? this.binding ?? undefined : undefined; }
+    ensureSize(width, height) {
+        if (this.texture && width === this.width && height === this.height)
+            return;
+        this.texture?.destroy();
+        this.width = width;
+        this.height = height;
+        this.texture = this.device.createTexture({ label: 'opaque-geometric-depth', size: [width, height],
+            sampleCount: this.samples, format: 'depth32float', usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING });
+        this.binding = this.device.createBindGroup({ layout: opaqueVisibilityLayout(this.device, this.samples),
+            entries: [{ binding: 0, resource: this.texture.createView() }] });
+    }
+    /** Explicit setup for async consumers; the render path requests only used variants. */
+    async prepare(base) {
+        if (!base) {
+            await Promise.all([...this.registrations.keys()].map(pipeline => this.prepare(pipeline)));
+            return;
+        }
+        if (this.variants.has(base))
+            return;
+        let ready = this.pending.get(base);
+        if (!ready) {
+            const registration = this.registrations.get(base);
+            if (!registration)
+                return;
+            ready = this.buildVariants(base, registration).then(variants => {
+                if (!this.destroyed && variants)
+                    this.variants.set(base, variants);
+            }, error => { this.failures.set(base, error); throw error; });
+            this.pending.set(base, ready);
+        }
+        await ready;
+    }
+    forPipeline(base) {
+        if (this.failures.has(base))
+            throw this.failures.get(base);
+        const variants = this.variants.get(base);
+        if (variants || !this.registrations.get(base)?.descriptor.fragment)
+            return variants;
+        throw new PendingVisibility(this.prepare(base), () => !this.destroyed);
+    }
+    async buildVariants(base, registration) {
+        const { descriptor: d, source } = registration;
+        const fragment = d.fragment;
+        if (!fragment)
+            return undefined;
+        const module = this.device.createShaderModule({ code: guardedMeshShader(source, this.samples, fragment.entryPoint ?? 'fs_main') });
+        const colour = await this.device.createRenderPipelineAsync({ ...d,
+            layout: this.device.createPipelineLayout({ bindGroupLayouts: [base.getBindGroupLayout(0), base.getBindGroupLayout(1), opaqueVisibilityLayout(this.device, this.samples), base.getBindGroupLayout(3)] }),
+            vertex: { ...d.vertex, module }, fragment: { ...fragment, module } });
+        let depth = null;
+        if (d.depthStencil?.depthWriteEnabled) {
+            const unbiased = this.device.createShaderModule({ code: unbiasedMeshShader(source, this.samples, fragment.entryPoint ?? 'fs_main') });
+            depth = await this.device.createRenderPipelineAsync({ ...d, vertex: { ...d.vertex, module: unbiased },
+                fragment: { module: unbiased, entryPoint: 'fs_geometric_depth', targets: [] },
+                depthStencil: { format: 'depth32float', depthWriteEnabled: true, depthCompare: 'greater' } });
+        }
+        return { colour, depth };
+    }
+    begin(encoder, descriptor, orthographic, width, height) {
+        this.active = orthographic;
+        const main = encoder.beginRenderPass(descriptor);
+        const section = this.sectionBinding?.();
+        if (section)
+            main.setBindGroup(3, section);
+        if (!orthographic) {
+            this.releaseTexture();
+            return main;
+        }
+        this.ensureSize(width, height);
+        const before = this.device.createCommandEncoder({ label: 'opaque-visibility-before-main' });
+        const depthPass = before.beginRenderPass({
+            timestampWrites: opaqueVisibilityTimestampWrites(encoder, before),
+            colorAttachments: [],
+            depthStencilAttachment: { view: this.texture.createView(), depthClearValue: 0, depthLoadOp: 'clear', depthStoreOp: 'store' },
+        });
+        let variant;
+        const groups = new Map(), vertices = new Map();
+        if (section)
+            groups.set(3, [3, section]);
+        let indices;
+        const raster = new Map();
+        const methods = new Map();
+        const invoke = (pass, name, args) => Reflect.apply(Reflect.get(pass, name), pass, args);
+        const draw = (name, args) => {
+            if (variant?.depth) {
+                depthPass.setPipeline(variant.depth);
+                for (const [group, args] of groups)
+                    if (group !== OPAQUE_VISIBILITY_GROUP)
+                        invoke(depthPass, 'setBindGroup', args);
+                for (const args of vertices.values())
+                    invoke(depthPass, 'setVertexBuffer', args);
+                if (indices)
+                    invoke(depthPass, 'setIndexBuffer', indices);
+                for (const [method, args] of raster)
+                    invoke(depthPass, method, args);
+                invoke(depthPass, name, args);
+            }
+            if (variant)
+                main.setBindGroup(OPAQUE_VISIBILITY_GROUP, this.binding);
+            invoke(main, name, args);
+        };
+        // Proxy retains the actual pass API for existing mesh/overlay helpers. Only
+        // orthographic frames pay interception; perspective returns the real pass.
+        return new Proxy(main, { get: (target, key) => {
+                if (methods.has(key))
+                    return methods.get(key);
+                const member = Reflect.get(target, key);
+                if (typeof member !== 'function')
+                    return member;
+                const method = (...args) => {
+                    if (key === 'setPipeline') {
+                        variant = this.forPipeline(args[0]);
+                        return main.setPipeline(variant?.colour ?? args[0]);
+                    }
+                    if (key === 'setBindGroup')
+                        groups.set(args[0], args);
+                    if (key === 'setVertexBuffer')
+                        vertices.set(args[0], args);
+                    if (key === 'setIndexBuffer')
+                        indices = args;
+                    if (key === 'setViewport' || key === 'setScissorRect' || key === 'setBlendConstant')
+                        raster.set(key, args);
+                    if (key === 'draw' || key === 'drawIndexed' || key === 'drawIndirect' || key === 'drawIndexedIndirect')
+                        return draw(key, args);
+                    if (key === 'executeBundles')
+                        throw new Error('Opaque visibility requires prepared draws, not an opaque render bundle');
+                    if (key === 'end') {
+                        depthPass.end();
+                        setOpaqueVisibilityCommands(encoder, before.finish());
+                    }
+                    return Reflect.apply(member, target, args);
+                };
+                methods.set(key, method);
+                return method;
+            } });
+    }
+    releaseTexture() {
+        this.texture?.destroy();
+        this.texture = null;
+        this.binding = null;
+        this.width = 0;
+        this.height = 0;
+    }
+    destroy() {
+        this.destroyed = true;
+        this.releaseTexture();
+        this.variants.clear();
+        this.registrations.clear();
+        this.failures.clear();
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=opaque-visibility-pass.js.map

package/dist/opaque-visibility-pass.js.map

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

package/dist/pick-types.d.ts

@@ -1,4 +1,4 @@
-import type { ClipBox } from './types.js';
+import type { ClipBox, ExtraClipPlane } from './types.js';
 /** Options for GPU picking/selection, matching rendered visibility. */
 export interface PickOptions {
     isStreaming?: boolean;
@@ -7,11 +7,15 @@ export interface PickOptions {
 }
 /** Clip state the GPU picker mirrors from the most recent rendered frame. */
 export interface PickClipState {
+    /** Full scene ids exempt from primary and extra section planes; crop boxes still apply. */
+    sectionExcludedIds?: ReadonlySet<number>;
     sectionPlane?: {
         normal: [number, number, number];
         distance: number;
         flipped: boolean;
     } | null;
+    /** Further planes (#7545), world-space; the picker clips against all of them. */
+    extraPlanes?: readonly ExtraClipPlane[] | null;
     clipBox?: ClipBox | null;
 }
 //# sourceMappingURL=pick-types.d.ts.map

package/dist/pick-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pick-types.d.ts","sourceRoot":"","sources":["../src/pick-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAClC;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/F,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B"}
+{"version":3,"file":"pick-types.d.ts","sourceRoot":"","sources":["../src/pick-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1D,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAClC;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/F,iFAAiF;IACjF,WAAW,CAAC,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B"}

package/dist/picker-rte-uniforms.d.ts

@@ -1,6 +1,6 @@
 import { type RelativeToEyeSnapshot } from './relative-to-eye.js';
 import type { Mesh, PickClipState } from './types.js';
-export declare function writePickUniforms(device: GPUDevice, buffer: GPUBuffer, scratch: Float32Array, clipFlags: Uint32Array, viewProj: Float32Array, clip?: PickClipState | null): void;
+export declare function writePickUniforms(device: GPUDevice, buffer: GPUBuffer, scratch: Float32Array, clipFlags: Uint32Array, viewProj: Float32Array, clip?: PickClipState | null, expressId?: number, slot?: number): void;
 /**
  * Write one flat mesh's pick uniforms into dynamic slot `slot`. Returns false,
  * writing nothing, for a mesh outside the snapshot's camera-relative envelope:

package/dist/picker-rte-uniforms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"picker-rte-uniforms.d.ts","sourceRoot":"","sources":["../src/picker-rte-uniforms.ts"],"names":[],"mappings":"AAOA,OAAO,EAAiB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,YAAY,EACtB,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,GAC1B,IAAI,CAMN;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,WAAW,EACtB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAaT;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,GAC1B,IAAI,CAQN"}
+{"version":3,"file":"picker-rte-uniforms.d.ts","sourceRoot":"","sources":["../src/picker-rte-uniforms.ts"],"names":[],"mappings":"AAOA,OAAO,EAAiB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,YAAY,EACtB,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,EAC3B,SAAS,SAAI,EACb,IAAI,SAAI,GACP,IAAI,CAON;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,WAAW,EACtB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAcT;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,GAC1B,IAAI,CAQN"}

package/dist/picker-rte-uniforms.js

@@ -5,7 +5,7 @@
 import { packPickClip, packPickUniforms } from './pick-uniforms.js';
 import { packRteOrigin } from './relative-to-eye.js';
 import { packRteClipBox, rtePlaneDistance } from './rte-clip-space.js';
-export function writePickUniforms(device, buffer, scratch, clipFlags, viewProj, clip) {
+export function writePickUniforms(device, buffer, scratch, clipFlags, viewProj, clip, expressId = 0, slot = 0) {
     scratch.fill(0);
     scratch.set(viewProj, 0);
     scratch[16] = 1;
@@ -13,7 +13,8 @@ export function writePickUniforms(device, buffer, scratch, clipFlags, viewProj,
     scratch[26] = 1;
     scratch[31] = 1;
     packPickClip(clip, scratch, clipFlags, 32);
-    device.queue.writeBuffer(buffer, 0, scratch);
+    clipFlags[1] = expressId;
+    device.queue.writeBuffer(buffer, slot * 256, scratch);
 }
 /**
  * Write one flat mesh's pick uniforms into dynamic slot `slot`. Returns false,
@@ -32,6 +33,7 @@ export function writeFlatPickUniform(device, buffer, scratch, clipFlags, mesh, s
     packRteClipBox(clip?.clipBox, camera, scratch, 32);
     if (clip?.sectionPlane)
         scratch[43] = rtePlaneDistance(clip.sectionPlane.distance, clip.sectionPlane.normal, camera);
+    clipFlags[1] = mesh.expressId;
     device.queue.writeBuffer(buffer, slot * 256, scratch);
     return true;
 }

package/dist/picker-rte-uniforms.js.map

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

package/dist/picker-shaders.d.ts

@@ -0,0 +1,5 @@
+/** Flat meshes: one dynamic-offset uniform slot per mesh, expressIds in a storage buffer. */
+export declare const flatPickShaderWgsl = "\n        \nstruct RteFrameUniform {\n  // Camera translation is intentionally absent. This projects positions\n  // returned by rteWorldPosition, which are already relative to the eye.\n  viewProj: mat4x4<f32>,\n}\n\nstruct RteDrawableUniform {\n  // CPU computes (drawable origin - camera origin) in f64 and splits it.\n  // This data must be refreshed whenever the RTE camera frame changes.\n  drawableDeltaHigh: vec4<f32>,\n  drawableDeltaLow: vec4<f32>,\n}\n\nfn rteWorldPosition(\n  local: vec3<f32>,\n  drawable: RteDrawableUniform,\n) -> vec4<f32> {\n  // Do not subtract a camera origin here: this delta was formed in CPU f64.\n  let highDelta = drawable.drawableDeltaHigh.xyz;\n  let lowDelta = drawable.drawableDeltaLow.xyz;\n  // A drawable template can span kilometres. Keep local with high first;\n  // The local-plus-(high-plus-low) association is not equivalent in f32.\n  return vec4<f32>((local + highDelta) + lowDelta, 1.0);\n}\n\n        \n        struct ExtraClip {\n          planeInfo: vec4<u32>,            // x = plane count, y = flipped bit mask\n          planes: array<vec4<f32>, 7>, // xyz = normal, w = distance\n        }\n\n        // True when p is on the removed side of ANY extra plane.\n        fn extraClipClipped(clip: ExtraClip, p: vec3<f32>) -> bool {\n          for (var i = 0u; i < clip.planeInfo.x; i = i + 1u) {\n            let side = select(1.0, -1.0, ((clip.planeInfo.y >> i) & 1u) == 1u);\n            if ((dot(p, clip.planes[i].xyz) - clip.planes[i].w) * side > 0.0) { return true; }\n          }\n          return false;\n        }\n\n        \n@group(3) @binding(0) var<storage, read> sectionExcludedIds: array<u32>;\n// Scene colour buckets are partitioned by 2^24 ID page. Reject an invalid anchor.\nfn sectionEntityFromLane(anchor: u32, lane: u32) -> u32 {\n  return select(anchor + ((lane - anchor) & 0x00FFFFFFu), 0xFFFFFFFFu, anchor == 0xFFFFFFFFu);\n}\nfn sectionExcluded(id: u32) -> bool {\n  var lo = 0u;\n  var hi = sectionExcludedIds[0];\n  while (lo < hi) {\n    let mid = lo + (hi - lo) / 2u;\n    let key = sectionExcludedIds[mid + 1u];\n    if (key == id) { return true; }\n    if (key < id) { lo = mid + 1u; } else { hi = mid; }\n  }\n  return false;\n}\n\n        struct Uniforms {\n          viewProj: mat4x4<f32>, // translation-free RTE projection\n          model: mat4x4<f32>,    // linear transform; translation lives in originHigh/Low\n          clipBoxMin: vec4<f32>,   // xyz = min corner (world), w = pad\n          clipBoxMax: vec4<f32>,   // xyz = max corner (world), w = pad\n          sectionPlane: vec4<f32>, // xyz = plane normal, w = plane distance\n          clipFlags: vec4<u32>,    // x: bit0 sectionEnabled, bit1 flipped, bit2 clipBox\n          originHigh: vec4<f32>,\n          originLow: vec4<f32>,\n        }\n        @binding(0) @group(0) var<uniform> uniforms: Uniforms;\n        @binding(1) @group(0) var<storage, read> expressIds: array<u32>;\n        @binding(2) @group(0) var<uniform> extraClip: ExtraClip;\n\n        struct VertexInput {\n          @location(0) position: vec3<f32>,\n          @location(1) normal: vec3<f32>,\n        }\n\n        struct VertexOutput {\n          @builtin(position) position: vec4<f32>,\n          @location(0) @interpolate(flat) objectId: u32,\n          @location(1) worldPos: vec3<f32>,\n        }\n\n        @vertex\n        fn vs_main(input: VertexInput, @builtin(instance_index) instanceIndex: u32) -> VertexOutput {\n          var output: VertexOutput;\n          let linear = (uniforms.model * vec4<f32>(input.position, 0.0)).xyz;\n          let relative = rteWorldPosition(linear, RteDrawableUniform(uniforms.originHigh, uniforms.originLow)).xyz;\n          output.position = uniforms.viewProj * vec4<f32>(relative, 1.0);\n          output.worldPos = relative;\n          // Look up expressId from storage buffer using instance index\n          output.objectId = expressIds[instanceIndex];\n          return output;\n        }\n\n        @fragment\n        fn fs_main(input: VertexOutput) -> @location(0) u32 {\n          let excluded = sectionExcluded(uniforms.clipFlags.y);\n          // Mirror the main render's clip discards so a click can't select a\n          // fragment the user has sectioned or cropped out of view.\n          if (!excluded && (uniforms.clipFlags.x & 1u) != 0u) {  // section plane enabled\n            let flipped = (uniforms.clipFlags.x & 2u) != 0u;\n            let side = select(1.0, -1.0, flipped);\n            let distToPlane = (dot(input.worldPos, uniforms.sectionPlane.xyz) - uniforms.sectionPlane.w) * side;\n            if (distToPlane > 0.0) {\n              discard;\n            }\n          }\n          if (!excluded && extraClipClipped(extraClip, input.worldPos)) {  // cutting planes beyond the first (#7545)\n            discard;\n          }\n          if ((uniforms.clipFlags.x & 4u) != 0u) {  // clip box enabled\n            let p = input.worldPos;\n            if (any(p < uniforms.clipBoxMin.xyz) || any(p > uniforms.clipBoxMax.xyz)) {\n              discard;\n            }\n          }\n          return input.objectId;\n        }\n      ";
+/** Instanced occurrences: per-instance matrix, express id and flags in the instance buffer. */
+export declare const instancedPickShaderWgsl = "\n        \nstruct RteFrameUniform {\n  // Camera translation is intentionally absent. This projects positions\n  // returned by rteWorldPosition, which are already relative to the eye.\n  viewProj: mat4x4<f32>,\n}\n\nstruct RteDrawableUniform {\n  // CPU computes (drawable origin - camera origin) in f64 and splits it.\n  // This data must be refreshed whenever the RTE camera frame changes.\n  drawableDeltaHigh: vec4<f32>,\n  drawableDeltaLow: vec4<f32>,\n}\n\nfn rteWorldPosition(\n  local: vec3<f32>,\n  drawable: RteDrawableUniform,\n) -> vec4<f32> {\n  // Do not subtract a camera origin here: this delta was formed in CPU f64.\n  let highDelta = drawable.drawableDeltaHigh.xyz;\n  let lowDelta = drawable.drawableDeltaLow.xyz;\n  // A drawable template can span kilometres. Keep local with high first;\n  // The local-plus-(high-plus-low) association is not equivalent in f32.\n  return vec4<f32>((local + highDelta) + lowDelta, 1.0);\n}\n\n        \n        struct ExtraClip {\n          planeInfo: vec4<u32>,            // x = plane count, y = flipped bit mask\n          planes: array<vec4<f32>, 7>, // xyz = normal, w = distance\n        }\n\n        // True when p is on the removed side of ANY extra plane.\n        fn extraClipClipped(clip: ExtraClip, p: vec3<f32>) -> bool {\n          for (var i = 0u; i < clip.planeInfo.x; i = i + 1u) {\n            let side = select(1.0, -1.0, ((clip.planeInfo.y >> i) & 1u) == 1u);\n            if ((dot(p, clip.planes[i].xyz) - clip.planes[i].w) * side > 0.0) { return true; }\n          }\n          return false;\n        }\n\n        \n@group(3) @binding(0) var<storage, read> sectionExcludedIds: array<u32>;\n// Scene colour buckets are partitioned by 2^24 ID page. Reject an invalid anchor.\nfn sectionEntityFromLane(anchor: u32, lane: u32) -> u32 {\n  return select(anchor + ((lane - anchor) & 0x00FFFFFFu), 0xFFFFFFFFu, anchor == 0xFFFFFFFFu);\n}\nfn sectionExcluded(id: u32) -> bool {\n  var lo = 0u;\n  var hi = sectionExcludedIds[0];\n  while (lo < hi) {\n    let mid = lo + (hi - lo) / 2u;\n    let key = sectionExcludedIds[mid + 1u];\n    if (key == id) { return true; }\n    if (key < id) { lo = mid + 1u; } else { hi = mid; }\n  }\n  return false;\n}\n\n        struct Uniforms {\n          viewProj: mat4x4<f32>,\n          clipBoxMin: vec4<f32>,   // xyz = min corner (world), w = pad\n          clipBoxMax: vec4<f32>,   // xyz = max corner (world), w = pad\n          sectionPlane: vec4<f32>, // xyz = plane normal, w = plane distance\n          clipFlags: vec4<u32>,    // x: bit0 sectionEnabled, bit1 flipped, bit2 clipBox\n          cameraHigh: vec4<f32>,\n          cameraLow: vec4<f32>,\n        }\n        @binding(0) @group(0) var<uniform> uniforms: Uniforms;\n        @binding(1) @group(0) var<uniform> extraClip: ExtraClip;\n        struct VertexInput { @location(0) position: vec3<f32> }\n        struct InstanceInput {\n          @location(3) m0: vec4<f32>,\n          @location(4) m1: vec4<f32>,\n          @location(5) m2: vec4<f32>,\n          @location(6) m3: vec4<f32>,\n          @location(7) instEntityId: u32,\n          @location(9) instFlags: u32,\n          @location(10) anchorHigh: vec4<f32>,\n          @location(11) anchorLow: vec4<f32>,\n        }\n        struct VertexOutput {\n          @builtin(position) position: vec4<f32>,\n          @location(0) @interpolate(flat) objectId: u32,\n          @location(1) @interpolate(flat) instFlags: u32,\n          @location(2) worldPos: vec3<f32>,\n          @location(3) @interpolate(flat) sectionEntityId: u32,\n        }\n        @vertex\n        fn vs_main(input: VertexInput, inst: InstanceInput) -> VertexOutput {\n          var output: VertexOutput;\n          let m = mat4x4<f32>(inst.m0, inst.m1, inst.m2, inst.m3);\n          let linear = (m * vec4<f32>(input.position, 0.0)).xyz;\n          let relative = rteWorldPosition(linear, RteDrawableUniform(inst.anchorHigh, inst.anchorLow)).xyz;\n          output.position = uniforms.viewProj * vec4<f32>(relative, 1.0);\n          output.worldPos = relative;\n          // bit 30 = instanced marker; express id in the low 30 bits.\n          output.objectId = 0x40000000u | (inst.instEntityId & 0x3FFFFFFFu);\n          output.sectionEntityId = inst.instEntityId;\n          output.instFlags = inst.instFlags;\n          return output;\n        }\n        @fragment\n        fn fs_main(input: VertexOutput) -> @location(0) u32 {\n          let excluded = sectionExcluded(input.sectionEntityId);\n          // Hidden occurrences (flags bit 1) are not pickable \u2014 mirror the render-pass\n          // discard so a hidden instanced element can't be selected through the picker.\n          if ((input.instFlags & 2u) != 0u) {\n            discard;\n          }\n          // Mirror the main render's section + crop-box discards for occurrences.\n          if (!excluded && (uniforms.clipFlags.x & 1u) != 0u) {  // section plane enabled\n            let flipped = (uniforms.clipFlags.x & 2u) != 0u;\n            let side = select(1.0, -1.0, flipped);\n            let distToPlane = (dot(input.worldPos, uniforms.sectionPlane.xyz) - uniforms.sectionPlane.w) * side;\n            if (distToPlane > 0.0) {\n              discard;\n            }\n          }\n          if (!excluded && extraClipClipped(extraClip, input.worldPos)) {  // cutting planes beyond the first (#7545)\n            discard;\n          }\n          if ((uniforms.clipFlags.x & 4u) != 0u) {  // clip box enabled\n            let p = input.worldPos;\n            if (any(p < uniforms.clipBoxMin.xyz) || any(p > uniforms.clipBoxMax.xyz)) {\n              discard;\n            }\n          }\n          return input.objectId;\n        }\n      ";
+//# sourceMappingURL=picker-shaders.d.ts.map

package/dist/picker-shaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker-shaders.d.ts","sourceRoot":"","sources":["../src/picker-shaders.ts"],"names":[],"mappings":"AAeA,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,mhKAiExB,CAAC;AAER,+FAA+F;AAC/F,eAAO,MAAM,uBAAuB,mlLA2E7B,CAAC"}

package/dist/picker-shaders.js

@@ -0,0 +1,157 @@
+/* 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 GPU picker's WGSL, lifted out of `picker.ts`: the flat-mesh pick pass and
+ * the instanced-occurrence pick pass. Both mirror the colour pass's clip
+ * discards (section plane, the cutting planes beyond it, crop box), so a click
+ * cannot select a fragment the user has cut away.
+ */
+import { relativeToEyeWgsl } from './shaders/relative-to-eye.wgsl.js';
+import { sectionExclusionsWgsl } from './section-exclusions.js';
+import { extraClipWgsl } from './extra-clip-planes.js';
+/** Flat meshes: one dynamic-offset uniform slot per mesh, expressIds in a storage buffer. */
+export const flatPickShaderWgsl = `
+        ${relativeToEyeWgsl}
+        ${extraClipWgsl}
+        ${sectionExclusionsWgsl}
+        struct Uniforms {
+          viewProj: mat4x4<f32>, // translation-free RTE projection
+          model: mat4x4<f32>,    // linear transform; translation lives in originHigh/Low
+          clipBoxMin: vec4<f32>,   // xyz = min corner (world), w = pad
+          clipBoxMax: vec4<f32>,   // xyz = max corner (world), w = pad
+          sectionPlane: vec4<f32>, // xyz = plane normal, w = plane distance
+          clipFlags: vec4<u32>,    // x: bit0 sectionEnabled, bit1 flipped, bit2 clipBox
+          originHigh: vec4<f32>,
+          originLow: vec4<f32>,
+        }
+        @binding(0) @group(0) var<uniform> uniforms: Uniforms;
+        @binding(1) @group(0) var<storage, read> expressIds: array<u32>;
+        @binding(2) @group(0) var<uniform> extraClip: ExtraClip;
+
+        struct VertexInput {
+          @location(0) position: vec3<f32>,
+          @location(1) normal: vec3<f32>,
+        }
+
+        struct VertexOutput {
+          @builtin(position) position: vec4<f32>,
+          @location(0) @interpolate(flat) objectId: u32,
+          @location(1) worldPos: vec3<f32>,
+        }
+
+        @vertex
+        fn vs_main(input: VertexInput, @builtin(instance_index) instanceIndex: u32) -> VertexOutput {
+          var output: VertexOutput;
+          let linear = (uniforms.model * vec4<f32>(input.position, 0.0)).xyz;
+          let relative = rteWorldPosition(linear, RteDrawableUniform(uniforms.originHigh, uniforms.originLow)).xyz;
+          output.position = uniforms.viewProj * vec4<f32>(relative, 1.0);
+          output.worldPos = relative;
+          // Look up expressId from storage buffer using instance index
+          output.objectId = expressIds[instanceIndex];
+          return output;
+        }
+
+        @fragment
+        fn fs_main(input: VertexOutput) -> @location(0) u32 {
+          let excluded = sectionExcluded(uniforms.clipFlags.y);
+          // Mirror the main render's clip discards so a click can't select a
+          // fragment the user has sectioned or cropped out of view.
+          if (!excluded && (uniforms.clipFlags.x & 1u) != 0u) {  // section plane enabled
+            let flipped = (uniforms.clipFlags.x & 2u) != 0u;
+            let side = select(1.0, -1.0, flipped);
+            let distToPlane = (dot(input.worldPos, uniforms.sectionPlane.xyz) - uniforms.sectionPlane.w) * side;
+            if (distToPlane > 0.0) {
+              discard;
+            }
+          }
+          if (!excluded && extraClipClipped(extraClip, input.worldPos)) {  // cutting planes beyond the first (#7545)
+            discard;
+          }
+          if ((uniforms.clipFlags.x & 4u) != 0u) {  // clip box enabled
+            let p = input.worldPos;
+            if (any(p < uniforms.clipBoxMin.xyz) || any(p > uniforms.clipBoxMax.xyz)) {
+              discard;
+            }
+          }
+          return input.objectId;
+        }
+      `;
+/** Instanced occurrences: per-instance matrix, express id and flags in the instance buffer. */
+export const instancedPickShaderWgsl = `
+        ${relativeToEyeWgsl}
+        ${extraClipWgsl}
+        ${sectionExclusionsWgsl}
+        struct Uniforms {
+          viewProj: mat4x4<f32>,
+          clipBoxMin: vec4<f32>,   // xyz = min corner (world), w = pad
+          clipBoxMax: vec4<f32>,   // xyz = max corner (world), w = pad
+          sectionPlane: vec4<f32>, // xyz = plane normal, w = plane distance
+          clipFlags: vec4<u32>,    // x: bit0 sectionEnabled, bit1 flipped, bit2 clipBox
+          cameraHigh: vec4<f32>,
+          cameraLow: vec4<f32>,
+        }
+        @binding(0) @group(0) var<uniform> uniforms: Uniforms;
+        @binding(1) @group(0) var<uniform> extraClip: ExtraClip;
+        struct VertexInput { @location(0) position: vec3<f32> }
+        struct InstanceInput {
+          @location(3) m0: vec4<f32>,
+          @location(4) m1: vec4<f32>,
+          @location(5) m2: vec4<f32>,
+          @location(6) m3: vec4<f32>,
+          @location(7) instEntityId: u32,
+          @location(9) instFlags: u32,
+          @location(10) anchorHigh: vec4<f32>,
+          @location(11) anchorLow: vec4<f32>,
+        }
+        struct VertexOutput {
+          @builtin(position) position: vec4<f32>,
+          @location(0) @interpolate(flat) objectId: u32,
+          @location(1) @interpolate(flat) instFlags: u32,
+          @location(2) worldPos: vec3<f32>,
+          @location(3) @interpolate(flat) sectionEntityId: u32,
+        }
+        @vertex
+        fn vs_main(input: VertexInput, inst: InstanceInput) -> VertexOutput {
+          var output: VertexOutput;
+          let m = mat4x4<f32>(inst.m0, inst.m1, inst.m2, inst.m3);
+          let linear = (m * vec4<f32>(input.position, 0.0)).xyz;
+          let relative = rteWorldPosition(linear, RteDrawableUniform(inst.anchorHigh, inst.anchorLow)).xyz;
+          output.position = uniforms.viewProj * vec4<f32>(relative, 1.0);
+          output.worldPos = relative;
+          // bit 30 = instanced marker; express id in the low 30 bits.
+          output.objectId = 0x40000000u | (inst.instEntityId & 0x3FFFFFFFu);
+          output.sectionEntityId = inst.instEntityId;
+          output.instFlags = inst.instFlags;
+          return output;
+        }
+        @fragment
+        fn fs_main(input: VertexOutput) -> @location(0) u32 {
+          let excluded = sectionExcluded(input.sectionEntityId);
+          // Hidden occurrences (flags bit 1) are not pickable — mirror the render-pass
+          // discard so a hidden instanced element can't be selected through the picker.
+          if ((input.instFlags & 2u) != 0u) {
+            discard;
+          }
+          // Mirror the main render's section + crop-box discards for occurrences.
+          if (!excluded && (uniforms.clipFlags.x & 1u) != 0u) {  // section plane enabled
+            let flipped = (uniforms.clipFlags.x & 2u) != 0u;
+            let side = select(1.0, -1.0, flipped);
+            let distToPlane = (dot(input.worldPos, uniforms.sectionPlane.xyz) - uniforms.sectionPlane.w) * side;
+            if (distToPlane > 0.0) {
+              discard;
+            }
+          }
+          if (!excluded && extraClipClipped(extraClip, input.worldPos)) {  // cutting planes beyond the first (#7545)
+            discard;
+          }
+          if ((uniforms.clipFlags.x & 4u) != 0u) {  // clip box enabled
+            let p = input.worldPos;
+            if (any(p < uniforms.clipBoxMin.xyz) || any(p > uniforms.clipBoxMax.xyz)) {
+              discard;
+            }
+          }
+          return input.objectId;
+        }
+      `;
+//# sourceMappingURL=picker-shaders.js.map

package/dist/picker-shaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker-shaders.js","sourceRoot":"","sources":["../src/picker-shaders.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG;UACxB,iBAAiB;UACjB,aAAa;UACb,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8DxB,CAAC;AAER,+FAA+F;AAC/F,MAAM,CAAC,MAAM,uBAAuB,GAAG;UAC7B,iBAAiB;UACjB,aAAa;UACb,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwExB,CAAC"}

package/dist/picker.d.ts

@@ -21,6 +21,9 @@ export declare class Picker {
     private instancedPickPipeline;
     private instancedPickBindGroup;
     private instancedUniformBuffer;
+    /** Extra cutting planes (#7545), one block shared by every pick draw; rewritten per pass. */
+    private extraClipBuffer;
+    private readonly extraClipScratch;
     private depthTexture;
     private depthSample;
     private colorTexture;

package/dist/picker.d.ts.map

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