@ifc-lite/renderer 5.0.0 → 6.0.1

package/dist/edge-pass.js

@@ -14,7 +14,8 @@
  * straight onto the resolved canvas.
  */
 import { EDGE_UNIFORM_BYTES, packEdgeUniforms } from './edge-params.js';
-import { edgeShaderSource } from './shaders/edges.wgsl.js';
+import { OUTLINE_UNIFORM_BYTES, packOutlineUniforms } from './outline-params.js';
+import { edgeShaderSource, outlineFragmentSource } from './shaders/edges.wgsl.js';
 export class EdgePass {
     device;
     uniformBuffer;
@@ -24,6 +25,12 @@ export class EdgePass {
     cachedDepthView = null;
     cachedObjectIdView = null;
     cachedBindGroup = null;
+    outlineUniformBuffer;
+    outlineUniformScratch = new Float32Array(OUTLINE_UNIFORM_BYTES / 4);
+    outlineLayout;
+    outlinePipeline;
+    cachedMask = null;
+    cachedOutlineBindGroup = null;
     destroyed = false;
     constructor(device, colorFormat, sampleCount) {
         this.device = device;
@@ -67,6 +74,43 @@ export class EdgePass {
             },
             primitive: { topology: 'triangle-list', cullMode: 'none' },
         });
+        // Selection/hover outline composite (#5390): a separate pipeline, since
+        // it needs a normal alpha-over blend (it draws an actual colour) rather
+        // than the darken-only blend above, and reads the mask textures rather
+        // than depth/id — but shares this module's fullscreen-triangle vertex
+        // stage (DRY).
+        this.outlineUniformBuffer = device.createBuffer({
+            label: 'outline-uniforms',
+            size: OUTLINE_UNIFORM_BYTES,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        this.outlineLayout = device.createBindGroupLayout({
+            label: 'outline-bgl',
+            entries: [
+                { binding: 0, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: 'unfilterable-float' } },
+                { binding: 1, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: 'unfilterable-float' } },
+                { binding: 2, visibility: GPUShaderStage.FRAGMENT, buffer: { type: 'uniform' } },
+            ],
+        });
+        const outlineModule = device.createShaderModule({ label: 'outline-shader', code: outlineFragmentSource() });
+        this.outlinePipeline = device.createRenderPipeline({
+            label: 'outline-pipeline',
+            layout: device.createPipelineLayout({ bindGroupLayouts: [this.outlineLayout] }),
+            vertex: { module: outlineModule, entryPoint: 'vs_fullscreen' },
+            fragment: {
+                module: outlineModule,
+                entryPoint: 'fs_outline',
+                targets: [{
+                        format: colorFormat,
+                        // Premultiplied-over: the shader already returns rgb*alpha.
+                        blend: {
+                            color: { srcFactor: 'one', dstFactor: 'one-minus-src-alpha' },
+                            alpha: { srcFactor: 'one', dstFactor: 'one-minus-src-alpha' },
+                        },
+                    }],
+            },
+            primitive: { topology: 'triangle-list', cullMode: 'none' },
+        });
     }
     encode(frame) {
         if (this.destroyed)
@@ -97,6 +141,33 @@ export class EdgePass {
         pass.draw(3, 1, 0, 0);
         pass.end();
     }
+    /** Outline the selection/hover mask (#5390) onto `frame.targetView`. */
+    encodeOutline(frame) {
+        if (this.destroyed)
+            return;
+        packOutlineUniforms(this.outlineUniformScratch, frame.params);
+        this.device.queue.writeBuffer(this.outlineUniformBuffer, 0, this.outlineUniformScratch);
+        if (this.cachedMask !== frame.mask || this.cachedOutlineBindGroup === null) {
+            this.cachedOutlineBindGroup = this.device.createBindGroup({
+                label: 'outline-bg',
+                layout: this.outlineLayout,
+                entries: [
+                    { binding: 0, resource: frame.mask.visibleView },
+                    { binding: 1, resource: frame.mask.allView },
+                    { binding: 2, resource: { buffer: this.outlineUniformBuffer } },
+                ],
+            });
+            this.cachedMask = frame.mask;
+        }
+        const pass = frame.encoder.beginRenderPass({
+            label: 'selection-hover-outline',
+            colorAttachments: [{ view: frame.targetView, loadOp: 'load', storeOp: 'store' }],
+        });
+        pass.setPipeline(this.outlinePipeline);
+        pass.setBindGroup(0, this.cachedOutlineBindGroup);
+        pass.draw(3, 1, 0, 0);
+        pass.end();
+    }
     /** Release all GPU resources. Idempotent; the pass is unusable afterwards. */
     destroy() {
         if (this.destroyed)
@@ -106,6 +177,9 @@ export class EdgePass {
         this.cachedBindGroup = null;
         this.cachedDepthView = null;
         this.cachedObjectIdView = null;
+        this.outlineUniformBuffer.destroy();
+        this.cachedOutlineBindGroup = null;
+        this.cachedMask = null;
     }
 }
 //# sourceMappingURL=edge-pass.js.map

package/dist/edge-pass.js.map

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

package/dist/entity-color-table.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Per-entity colour table (#6076): colour overrides (lens, charts, IDS,
+ * compare, 4D) are applied in the BASE pass by looking the entity up in one
+ * GPU storage buffer, instead of copying the overridden geometry into overlay
+ * batches drawn in a second equal-depth pass.
+ *
+ * WHAT THE SHADER CAN KNOW. Every flat vertex carries a u32 entity lane whose
+ * low 24 bits are the scene id (`MeshData.expressId`, the federated global id)
+ * masked to 24 bits, and whose high 8 bits are a colour salt for the depth
+ * nudge (`packEntityLane` in scene-geometry.ts). It does NOT carry a model
+ * index: federated global ids exceed 2^24 as soon as a few models load (each
+ * model's range is its max express id plus a 1,000,000 headroom), so the lane
+ * alone is ambiguous across models. Each draw therefore also passes an
+ * ANCHOR, the smallest full id it draws (`uniforms.overrideParams.x`), and the
+ * shader rebuilds the full id as `anchor + ((lane - anchor) mod 2^24)`. That is
+ * exact whenever the draw's ids span less than 2^24. Scene bucket keys carry
+ * each id's 2^24 page ({@link entityIdPageKey}), so every bucket batch,
+ * streaming fragment and partial sub-batch lies inside one page and meets
+ * that by construction. {@link entityIdAnchor} still returns null for a draw
+ * that does not (a hand-built batch), and the renderer then leaves it
+ * unpainted rather than paint the wrong entity.
+ *
+ * TABLE LAYOUT: an open-addressing hash table keyed by the full id, one
+ * `array<u32>` storage buffer:
+ *
+ *   [0] capacity (power of two, 0 when empty)   [1] max probe distance
+ *   [2] entry count                              [3] colourBase = 4 + capacity
+ *   [4 .. 4 + capacity)                         keys, EMPTY = 0xFFFFFFFF
+ *   [colourBase + 4 * slot .. + 4)              rgba as f32 bit patterns
+ *
+ * Linear probing from `fmix32(id) & (capacity - 1)`, load factor at most 1/2,
+ * and the longest displacement recorded in the header so the shader's probe
+ * loop has a bound. A dense per-model table (slot = express id) was the other
+ * candidate; it is sized by the model's STEP line count rather than by what
+ * is overridden, which on a large federation is tens of millions of slots and
+ * exceeds the 128 MiB default `maxStorageBufferBindingSize`. This table is
+ * sized by the number of overridden entities only.
+ *
+ * MEMORY BOUND: 20 bytes per slot plus a 16-byte header, capacity =
+ * nextPow2(2n) with a 16-slot minimum (336 bytes), so past that minimum
+ * (n >= 8) under 80 bytes per overridden entity and at least 40. 100,000 overridden entities take 262,144 slots = 5.0 MiB. The
+ * capacity is capped by `maxStorageBufferBindingSize` and `maxBufferSize`
+ * (2,097,152 entries at the 128 MiB default); past that the extra entries are
+ * dropped with one console warning.
+ *
+ * `EntityColorTable.write` rebuilds the image on the CPU (O(n)) and uploads it
+ * with one `queue.writeBuffer`; the GPU buffer is reallocated only when the
+ * image outgrows it (or the device changed, after a device-loss recovery), and
+ * the renderer rebinds it at frame start (`RenderPipeline.setEntityColorTableBuffer`).
+ */
+type Rgba = readonly [number, number, number, number];
+/** Key value of an unused slot. Federated ids stop far below it (`FederationRegistry`'s 2e9 limit). */
+export declare const ENTITY_COLOR_EMPTY_KEY = 4294967295;
+/** Header words before the key section. */
+export declare const ENTITY_COLOR_HEADER_WORDS = 4;
+/** Distinct full ids one draw can resolve from the 24-bit lane (see the module doc). */
+export declare const ENTITY_LANE_ID_SPAN = 16777216;
+/** `overrideParams.y` bit: this draw applies the table. */
+export declare const OVERRIDE_PARAM_PAINT = 1;
+/** `overrideParams.y` bit: paint the override unlit and opaque (`RenderOptions.emphasizeOverrides`). */
+export declare const OVERRIDE_PARAM_EMPHASIZE = 2;
+/** murmur3's 32-bit finalizer; `entityColorSlotHash` in the WGSL is the same function. */
+export declare function entityColorSlotHash(key: number): number;
+/** The table as uploaded: `words` is the whole buffer image. */
+export interface EntityColorTableImage {
+    readonly words: Uint32Array;
+    readonly capacity: number;
+    readonly count: number;
+    readonly maxProbe: number;
+    /** Overrides that did not fit under the device's buffer limits. */
+    readonly dropped: number;
+}
+/** Build the buffer image for `overrides` (keys are scene ids, colours linear 0..1 RGBA). */
+export declare function buildEntityColorTableImage(overrides: ReadonlyMap<number, Rgba>, maxBytes?: number): EntityColorTableImage;
+/** CPU mirror of the shader lookup: the colour stored for `id`, or null (sentinel). */
+export declare function lookupEntityColor(image: EntityColorTableImage, id: number): [number, number, number, number] | null;
+/**
+ * The anchor a draw passes so the shader can rebuild full ids from 24-bit
+ * lanes: the smallest id, or null when the ids span 2^24 or more (or are not
+ * table keys) and the draw must stay unpainted.
+ */
+export declare function entityIdAnchor(ids: ArrayLike<number>): number | null;
+/** CPU mirror of the shader's `resolveLaneEntityId`: the full id behind a lane under `anchor`. */
+export declare function resolveLaneEntityId(anchor: number, lane: number): number;
+/**
+ * `key` qualified by the 2^24 page of `id` (unchanged for ids below 2^24).
+ * Scene bucket keys go through this, so no batch holds ids from two pages and
+ * {@link entityIdAnchor} never refuses a bucket batch or its fragments.
+ */
+export declare function entityIdPageKey(id: number, key: string): string;
+/** {@link entityIdAnchor} of a batch, cached per batch object (a batch's `expressIds` never change). */
+export declare function batchEntityIdAnchor(batch: {
+    readonly expressIds: readonly number[];
+}): number | null;
+/**
+ * Whether any entity of `batch` is overridden, cached per batch for one
+ * override `generation` (`Scene.getColorOverrideGeneration`). A batch with none
+ * is drawn with the table off, so its fragments skip the lookup entirely.
+ */
+export declare function batchHasColorOverride(batch: {
+    readonly expressIds: readonly number[];
+}, overrides: ReadonlyMap<number, unknown> | null, generation: number): boolean;
+/**
+ * Write a draw's `overrideParams` lanes (x = anchor, y = mode bits). A null
+ * anchor, or `paint = false`, writes zeros: the draw keeps its own colour.
+ */
+export declare function packOverrideParams(out: Uint32Array, anchor: number | null, paint: boolean, emphasize: boolean): void;
+interface TableDevice {
+    readonly limits?: {
+        readonly maxStorageBufferBindingSize?: number;
+        readonly maxBufferSize?: number;
+    };
+    createBuffer(descriptor: GPUBufferDescriptor): GPUBuffer;
+    readonly queue: {
+        writeBuffer(buffer: GPUBuffer, offset: number, data: Uint32Array): void;
+    };
+}
+/** Owns the table's CPU image and its GPU buffer. One per `Scene`. */
+export declare class EntityColorTable {
+    private image;
+    private buffer;
+    private bufferDevice;
+    private bufferBytes;
+    private uploadedBytes;
+    private warnedDropped;
+    /** Replace the table with `overrides` and upload it. */
+    write(device: TableDevice, overrides: ReadonlyMap<number, Rgba>): void;
+    /** Empty the table: only the 16-byte header is rewritten (count 0 disables every lookup). */
+    clear(): void;
+    /** Drop the GPU buffer (device loss, scene teardown); the CPU image survives for re-upload. */
+    releaseGpu(): void;
+    /** The buffer the renderer binds, or null while nothing was ever written. */
+    getBuffer(): GPUBuffer | null;
+    /** The current CPU image (what the GPU buffer holds after the last write). */
+    getImage(): EntityColorTableImage;
+    /** Bytes the last `write` / `clear` uploaded. */
+    getLastUploadBytes(): number;
+}
+export {};
+//# sourceMappingURL=entity-color-table.d.ts.map

package/dist/entity-color-table.d.ts.map

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

package/dist/entity-color-table.js

@@ -0,0 +1,238 @@
+/* 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/. */
+/** Key value of an unused slot. Federated ids stop far below it (`FederationRegistry`'s 2e9 limit). */
+export const ENTITY_COLOR_EMPTY_KEY = 0xFFFFFFFF;
+/** Header words before the key section. */
+export const ENTITY_COLOR_HEADER_WORDS = 4;
+const MIN_CAPACITY = 16;
+const BYTES_PER_SLOT = 20; // one u32 key + four f32 colour lanes
+/** Distinct full ids one draw can resolve from the 24-bit lane (see the module doc). */
+export const ENTITY_LANE_ID_SPAN = 0x1000000;
+/** Used when a device reports no limit (the WebGPU default for `maxStorageBufferBindingSize`). */
+const DEFAULT_MAX_TABLE_BYTES = 128 * 1024 * 1024;
+/** `overrideParams.y` bit: this draw applies the table. */
+export const OVERRIDE_PARAM_PAINT = 1;
+/** `overrideParams.y` bit: paint the override unlit and opaque (`RenderOptions.emphasizeOverrides`). */
+export const OVERRIDE_PARAM_EMPHASIZE = 2;
+/** murmur3's 32-bit finalizer; `entityColorSlotHash` in the WGSL is the same function. */
+export function entityColorSlotHash(key) {
+    let h = key >>> 0;
+    h ^= h >>> 16;
+    h = Math.imul(h, 0x85ebca6b) >>> 0;
+    h ^= h >>> 13;
+    h = Math.imul(h, 0xc2b2ae35) >>> 0;
+    h ^= h >>> 16;
+    return h >>> 0;
+}
+const EMPTY_IMAGE = {
+    words: new Uint32Array(ENTITY_COLOR_HEADER_WORDS), capacity: 0, count: 0, maxProbe: 0, dropped: 0,
+};
+function isTableKey(id) {
+    return Number.isInteger(id) && id >= 0 && id < ENTITY_COLOR_EMPTY_KEY;
+}
+function capacityFor(entries, maxBytes) {
+    let capacity = MIN_CAPACITY;
+    while (capacity < entries * 2)
+        capacity *= 2;
+    while (capacity > MIN_CAPACITY && ENTITY_COLOR_HEADER_WORDS * 4 + capacity * BYTES_PER_SLOT > maxBytes)
+        capacity /= 2;
+    return capacity;
+}
+/** Build the buffer image for `overrides` (keys are scene ids, colours linear 0..1 RGBA). */
+export function buildEntityColorTableImage(overrides, maxBytes = DEFAULT_MAX_TABLE_BYTES) {
+    let entries = 0;
+    for (const id of overrides.keys())
+        if (isTableKey(id))
+            entries++;
+    if (entries === 0)
+        return EMPTY_IMAGE;
+    const capacity = capacityFor(entries, maxBytes);
+    const limit = Math.min(entries, capacity / 2);
+    const colorBase = ENTITY_COLOR_HEADER_WORDS + capacity;
+    const words = new Uint32Array(colorBase + capacity * 4);
+    const colors = new Float32Array(words.buffer);
+    words.fill(ENTITY_COLOR_EMPTY_KEY, ENTITY_COLOR_HEADER_WORDS, colorBase);
+    const mask = capacity - 1;
+    let count = 0;
+    let maxProbe = 0;
+    for (const [id, rgba] of overrides) {
+        if (count === limit)
+            break;
+        if (!isTableKey(id))
+            continue;
+        let slot = entityColorSlotHash(id) & mask;
+        let probe = 0;
+        while (words[ENTITY_COLOR_HEADER_WORDS + slot] !== ENTITY_COLOR_EMPTY_KEY) {
+            slot = (slot + 1) & mask;
+            probe++;
+        }
+        words[ENTITY_COLOR_HEADER_WORDS + slot] = id;
+        colors.set([rgba[0], rgba[1], rgba[2], rgba[3]], colorBase + slot * 4);
+        if (probe > maxProbe)
+            maxProbe = probe;
+        count++;
+    }
+    words[0] = capacity;
+    words[1] = maxProbe;
+    words[2] = count;
+    words[3] = colorBase;
+    return { words, capacity, count, maxProbe, dropped: entries - count };
+}
+/** CPU mirror of the shader lookup: the colour stored for `id`, or null (sentinel). */
+export function lookupEntityColor(image, id) {
+    if (image.count === 0 || !isTableKey(id))
+        return null;
+    const { words, capacity } = image;
+    const colorBase = words[3];
+    const mask = capacity - 1;
+    let slot = entityColorSlotHash(id) & mask;
+    for (let i = 0; i <= image.maxProbe && i < capacity; i++) {
+        const key = words[ENTITY_COLOR_HEADER_WORDS + slot];
+        if (key === id) {
+            const c = new Float32Array(words.buffer, (colorBase + slot * 4) * 4, 4);
+            return [c[0], c[1], c[2], c[3]];
+        }
+        if (key === ENTITY_COLOR_EMPTY_KEY)
+            return null;
+        slot = (slot + 1) & mask;
+    }
+    return null;
+}
+/**
+ * The anchor a draw passes so the shader can rebuild full ids from 24-bit
+ * lanes: the smallest id, or null when the ids span 2^24 or more (or are not
+ * table keys) and the draw must stay unpainted.
+ */
+export function entityIdAnchor(ids) {
+    if (ids.length === 0)
+        return null;
+    let min = Infinity;
+    let max = -Infinity;
+    for (let i = 0; i < ids.length; i++) {
+        const id = ids[i];
+        if (!isTableKey(id))
+            return null;
+        if (id < min)
+            min = id;
+        if (id > max)
+            max = id;
+    }
+    return max - min < ENTITY_LANE_ID_SPAN ? min : null;
+}
+/** CPU mirror of the shader's `resolveLaneEntityId`: the full id behind a lane under `anchor`. */
+export function resolveLaneEntityId(anchor, lane) {
+    return (anchor + (((lane >>> 0) - anchor) & 0x00FFFFFF)) >>> 0;
+}
+/**
+ * `key` qualified by the 2^24 page of `id` (unchanged for ids below 2^24).
+ * Scene bucket keys go through this, so no batch holds ids from two pages and
+ * {@link entityIdAnchor} never refuses a bucket batch or its fragments.
+ */
+export function entityIdPageKey(id, key) {
+    const page = Math.floor(id / ENTITY_LANE_ID_SPAN);
+    return page > 0 ? `p${page}~${key}` : key;
+}
+const anchorCache = new WeakMap();
+/** {@link entityIdAnchor} of a batch, cached per batch object (a batch's `expressIds` never change). */
+export function batchEntityIdAnchor(batch) {
+    let anchor = anchorCache.get(batch);
+    if (anchor === undefined) {
+        anchor = entityIdAnchor(batch.expressIds);
+        anchorCache.set(batch, anchor);
+    }
+    return anchor;
+}
+const hasOverrideCache = new WeakMap();
+/**
+ * Whether any entity of `batch` is overridden, cached per batch for one
+ * override `generation` (`Scene.getColorOverrideGeneration`). A batch with none
+ * is drawn with the table off, so its fragments skip the lookup entirely.
+ */
+export function batchHasColorOverride(batch, overrides, generation) {
+    if (!overrides || overrides.size === 0)
+        return false;
+    const cached = hasOverrideCache.get(batch);
+    if (cached && cached.generation === generation)
+        return cached.has;
+    const has = batch.expressIds.some((id) => overrides.has(id));
+    hasOverrideCache.set(batch, { generation, has });
+    return has;
+}
+/**
+ * Write a draw's `overrideParams` lanes (x = anchor, y = mode bits). A null
+ * anchor, or `paint = false`, writes zeros: the draw keeps its own colour.
+ */
+export function packOverrideParams(out, anchor, paint, emphasize) {
+    if (paint && anchor !== null) {
+        out[0] = anchor;
+        out[1] = OVERRIDE_PARAM_PAINT | (emphasize ? OVERRIDE_PARAM_EMPHASIZE : 0);
+    }
+    else {
+        out[0] = 0;
+        out[1] = 0;
+    }
+    out[2] = 0;
+    out[3] = 0;
+}
+/** Owns the table's CPU image and its GPU buffer. One per `Scene`. */
+export class EntityColorTable {
+    image = EMPTY_IMAGE;
+    buffer = null;
+    bufferDevice = null;
+    bufferBytes = 0;
+    uploadedBytes = 0;
+    warnedDropped = false; // per table, i.e. per scene
+    /** Replace the table with `overrides` and upload it. */
+    write(device, overrides) {
+        const limits = device.limits;
+        const maxBytes = Math.min(limits?.maxStorageBufferBindingSize ?? DEFAULT_MAX_TABLE_BYTES, limits?.maxBufferSize ?? DEFAULT_MAX_TABLE_BYTES);
+        this.image = buildEntityColorTableImage(overrides, maxBytes);
+        if (this.image.dropped > 0 && !this.warnedDropped) {
+            this.warnedDropped = true;
+            console.warn(`[EntityColorTable] ${this.image.dropped} colour overrides exceed the device's storage-buffer limit and are not painted.`);
+        }
+        const bytes = this.image.words.byteLength;
+        if (!this.buffer || this.bufferDevice !== device || this.bufferBytes < bytes) {
+            this.buffer?.destroy();
+            this.bufferBytes = Math.max(bytes, ENTITY_COLOR_HEADER_WORDS * 4);
+            this.buffer = device.createBuffer({
+                label: 'entity-color-table',
+                size: this.bufferBytes,
+                usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
+            });
+            this.bufferDevice = device;
+        }
+        device.queue.writeBuffer(this.buffer, 0, this.image.words);
+        this.uploadedBytes = bytes;
+    }
+    /** Empty the table: only the 16-byte header is rewritten (count 0 disables every lookup). */
+    clear() {
+        this.image = EMPTY_IMAGE;
+        this.uploadedBytes = 0;
+        if (this.buffer && this.bufferDevice) {
+            this.bufferDevice.queue.writeBuffer(this.buffer, 0, EMPTY_IMAGE.words);
+            this.uploadedBytes = EMPTY_IMAGE.words.byteLength;
+        }
+    }
+    /** Drop the GPU buffer (device loss, scene teardown); the CPU image survives for re-upload. */
+    releaseGpu() {
+        this.buffer?.destroy();
+        this.buffer = null;
+        this.bufferDevice = null;
+        this.bufferBytes = 0;
+    }
+    /** The buffer the renderer binds, or null while nothing was ever written. */
+    getBuffer() {
+        return this.buffer;
+    }
+    /** The current CPU image (what the GPU buffer holds after the last write). */
+    getImage() {
+        return this.image;
+    }
+    /** Bytes the last `write` / `clear` uploaded. */
+    getLastUploadBytes() {
+        return this.uploadedBytes;
+    }
+}
+//# sourceMappingURL=entity-color-table.js.map

package/dist/entity-color-table.js.map

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

package/dist/gpu-upload-guard.d.ts

@@ -6,7 +6,7 @@
  * pre-check skips the frame, and `containFrameThrow` catches whatever a
  * mid-frame call throws. Every upload call site that runs OUTSIDE that loop —
  * `addMeshes`, `loadGeometry`, `addMesh`, `ensureMeshResources`,
- * `createMeshFromData`, and the viewer's `setSpaceOverlayMeshes` — has none of
+ * `createMeshFromData`, and the viewer's `setAuthoringOverlayMeshes` — has none of
  * that. Before this module, a `device.createBuffer()` on a lost-but-not-yet-
  * `isInitialized()==false` device (see `getGPUDevice()`'s doc: a loss never
  * calls `destroy()`, so the zombie device stays "initialized") threw straight

package/dist/gpu-upload-guard.js

@@ -9,7 +9,7 @@
  * pre-check skips the frame, and `containFrameThrow` catches whatever a
  * mid-frame call throws. Every upload call site that runs OUTSIDE that loop —
  * `addMeshes`, `loadGeometry`, `addMesh`, `ensureMeshResources`,
- * `createMeshFromData`, and the viewer's `setSpaceOverlayMeshes` — has none of
+ * `createMeshFromData`, and the viewer's `setAuthoringOverlayMeshes` — has none of
  * that. Before this module, a `device.createBuffer()` on a lost-but-not-yet-
  * `isInitialized()==false` device (see `getGPUDevice()`'s doc: a loss never
  * calls `destroy()`, so the zombie device stays "initialized") threw straight

package/dist/hover-mesh-cache.d.ts

@@ -0,0 +1,29 @@
+/**
+ * GPU copies of the hovered entity's pieces for the hover pre-highlight mask
+ * (#5390). A batched model has no individual mesh for an entity that is not
+ * selected, so the hover outline would otherwise never draw.
+ *
+ * Deliberately kept OUT of `Scene.meshes`: hydrated scene meshes are also
+ * drawn by the main pass, so a hovered translucent entity would blend twice
+ * over its own batch copy. These copies are only ever drawn into the mask.
+ *
+ * Every piece of the entity is uploaded (a window or a layered wall is several
+ * pieces), through the same `uploadIndividualMesh` selection hydration uses,
+ * so the outline is bit-coincident with the batch it traces. The copies are
+ * rebuilt only when the hovered (model, id) changes, and the previous ones are
+ * destroyed then; `release()` frees them when nothing is hovered.
+ */
+import type { MeshData } from '@ifc-lite/geometry';
+import { type IndividualMeshFrame, type IndividualMeshGpu } from './individual-mesh-upload.js';
+export declare class HoverMeshCache {
+    private key;
+    private pieces;
+    /**
+     * The GPU pieces for `(modelIndex, id)`: cached while the key is unchanged,
+     * otherwise `pieces()` is re-read and uploaded.
+     */
+    resolve(device: GPUDevice, id: number, modelIndex: number | undefined, pieces: () => readonly MeshData[] | undefined, frameOf: (meshData: MeshData) => IndividualMeshFrame): readonly IndividualMeshGpu[];
+    /** Destroy the cached copies. Idempotent. */
+    release(): void;
+}
+//# sourceMappingURL=hover-mesh-cache.d.ts.map

package/dist/hover-mesh-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover-mesh-cache.d.ts","sourceRoot":"","sources":["../src/hover-mesh-cache.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAwB,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErH,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,MAAM,CAA2B;IAEzC;;;OAGG;IACH,OAAO,CACL,MAAM,EAAE,SAAS,EACjB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,SAAS,QAAQ,EAAE,GAAG,SAAS,EAC7C,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,mBAAmB,GACnD,SAAS,iBAAiB,EAAE;IAS/B,6CAA6C;IAC7C,OAAO,IAAI,IAAI;CAQhB"}

package/dist/hover-mesh-cache.js

@@ -0,0 +1,31 @@
+/* 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 { uploadIndividualMesh } from './individual-mesh-upload.js';
+export class HoverMeshCache {
+    key = null;
+    pieces = [];
+    /**
+     * The GPU pieces for `(modelIndex, id)`: cached while the key is unchanged,
+     * otherwise `pieces()` is re-read and uploaded.
+     */
+    resolve(device, id, modelIndex, pieces, frameOf) {
+        const key = `${modelIndex ?? 'any'}:${id}`;
+        if (key === this.key)
+            return this.pieces;
+        this.release();
+        this.key = key;
+        this.pieces = (pieces() ?? []).map((meshData) => uploadIndividualMesh(device, meshData, frameOf(meshData)));
+        return this.pieces;
+    }
+    /** Destroy the cached copies. Idempotent. */
+    release() {
+        for (const piece of this.pieces) {
+            piece.vertexBuffer.destroy();
+            piece.indexBuffer.destroy();
+        }
+        this.pieces = [];
+        this.key = null;
+    }
+}
+//# sourceMappingURL=hover-mesh-cache.js.map

package/dist/hover-mesh-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover-mesh-cache.js","sourceRoot":"","sources":["../src/hover-mesh-cache.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAmB/D,OAAO,EAAE,oBAAoB,EAAoD,MAAM,6BAA6B,CAAC;AAErH,MAAM,OAAO,cAAc;IACjB,GAAG,GAAkB,IAAI,CAAC;IAC1B,MAAM,GAAwB,EAAE,CAAC;IAEzC;;;OAGG;IACH,OAAO,CACL,MAAiB,EACjB,EAAU,EACV,UAA8B,EAC9B,MAA6C,EAC7C,OAAoD;QAEpD,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC3C,IAAI,GAAG,KAAK,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5G,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,6CAA6C;IAC7C,OAAO;QACL,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC7B,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;IAClB,CAAC;CACF"}