@ifc-lite/renderer 2.0.1 → 2.2.0

package/dist/scene-appearance-buckets.js

@@ -0,0 +1,164 @@
+/* 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 { AppearanceBatchCohorts } from './appearance-batch-cohorts.js';
+import { BATCH_CONSTANTS } from './constants.js';
+/** Partition shared batches before a draft owns GPU resources. Detached originals
+ * then contain exactly one owner, so another draft can cancel in any order. */
+export class AppearanceBuckets {
+    access;
+    sequence = 0;
+    cohorts;
+    constructor(access, parts) {
+        this.access = access;
+        this.cohorts = new AppearanceBatchCohorts(parts);
+    }
+    create(parts, partIndices) {
+        const key = `appearance#${++this.sequence}`;
+        const batchedMesh = this.access.create(parts, key);
+        return {
+            bucket: {
+                key,
+                meshData: parts,
+                batchedMesh,
+                vertexBytes: parts.reduce((sum, part) => sum +
+                    (part.positions.length / 3) * BATCH_CONSTANTS.BYTES_PER_VERTEX, 0),
+            },
+            partIndices,
+        };
+    }
+    capture(parts) {
+        const grouped = new Map();
+        parts.forEach((part, index) => {
+            const bucket = this.access.reverse().get(part);
+            if (bucket) {
+                if (!bucket.batchedMesh || bucket.batchedMesh.gpuResident === false)
+                    throw new Error('Appearance requires resident finalized geometry');
+                const indices = grouped.get(bucket) ?? [];
+                indices.push(index);
+                grouped.set(bucket, indices);
+            }
+        });
+        const replacements = [];
+        const staged = [];
+        try {
+            for (const [old, indices] of grouped) {
+                this.cohorts.register(old);
+                const selected = new Set(indices.map((index) => parts[index]));
+                const owned = this.create(indices.map((index) => parts[index]), indices);
+                staged.push(owned);
+                const restParts = old.meshData.filter((part) => !selected.has(part));
+                const rest = restParts.length ? this.create(restParts, []) : undefined;
+                if (rest)
+                    staged.push(rest);
+                replacements.push({ old, owned, rest });
+            }
+        }
+        catch (error) {
+            for (const resource of staged)
+                this.release(resource);
+            throw error;
+        }
+        for (const { old, owned, rest } of replacements) {
+            this.cohorts.inherit(old, owned.bucket);
+            if (rest)
+                this.cohorts.inherit(old, rest.bucket);
+        }
+        // All allocations succeeded. Publish complete partitions, then dispose old batches.
+        for (const { old, owned, rest } of replacements) {
+            this.cohorts.detach(old);
+            this.access.buckets.delete(old.key);
+            this.access.changed(old.key);
+            for (const resource of [owned, ...(rest ? [rest] : [])])
+                this.attach(resource, resource.bucket.meshData);
+        }
+        this.access.refresh();
+        for (const { old } of replacements)
+            if (old.batchedMesh)
+                this.dispose(old.batchedMesh);
+        return replacements.map((entry) => entry.owned);
+    }
+    stage(parts, indices) {
+        const groups = new Map();
+        for (const index of indices) {
+            const cohort = this.cohorts.group(parts[index], index);
+            const key = `${parts[index].color.join(',')}#${cohort?.id ?? 'new'}`;
+            const group = groups.get(key) ?? [];
+            group.push(index);
+            groups.set(key, group);
+        }
+        const resources = [];
+        try {
+            for (const group of groups.values()) {
+                const resource = this.create(group.map((index) => parts[index]), group);
+                resources.push(resource);
+                this.cohorts.assign(resource.bucket, this.cohorts.group(parts[group[0]], group[0]));
+            }
+            return resources;
+        }
+        catch (error) {
+            for (const resource of resources)
+                this.release(resource);
+            throw error;
+        }
+    }
+    detach(owner) {
+        for (const [key, bucket] of this.access.buckets) {
+            if (!bucket.meshData.some((part) => part.expressId === owner))
+                continue;
+            if (bucket.meshData.some((part) => part.expressId !== owner))
+                throw new Error('Appearance owner was not isolated');
+            this.cohorts.detach(bucket);
+            this.access.buckets.delete(key);
+            for (const part of bucket.meshData)
+                this.access.reverse().delete(part);
+            this.access.changed(key);
+        }
+    }
+    attach(resource, parts) {
+        resource.bucket.meshData = parts;
+        this.cohorts.attach(resource.bucket);
+        this.access.buckets.set(resource.bucket.key, resource.bucket);
+        for (const part of parts)
+            this.access.reverse().set(part, resource.bucket);
+        this.access.changed(resource.bucket.key);
+    }
+    refresh() {
+        this.access.refresh();
+    }
+    begin(owner) {
+        this.cohorts.begin(owner);
+    }
+    finish(owner) {
+        this.cohorts.finish(owner, (old, parts) => {
+            // Allocation failure leaves every split batch live and pickable.
+            const replacement = this.create(parts, []);
+            for (const bucket of old) {
+                this.access.buckets.delete(bucket.key);
+                this.access.changed(bucket.key);
+            }
+            this.attach(replacement, parts);
+            this.access.refresh();
+            for (const bucket of old)
+                if (bucket.batchedMesh)
+                    this.dispose(bucket.batchedMesh);
+            return replacement.bucket;
+        });
+    }
+    forget(expressId) {
+        this.cohorts.forget(expressId);
+    }
+    dispose(batch) {
+        try {
+            this.access.release(batch);
+        }
+        catch (error) {
+            console.warn('[Appearance] flat resource disposal failed', error);
+        }
+    }
+    release(resource) {
+        if (resource.bucket.batchedMesh)
+            this.dispose(resource.bucket.batchedMesh);
+    }
+}
+//# sourceMappingURL=scene-appearance-buckets.js.map

package/dist/scene-appearance-buckets.js.map

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

package/dist/scene-appearance-instances.d.ts

@@ -0,0 +1,42 @@
+import type { MeshData } from '@ifc-lite/geometry';
+import type { AppearanceOwner } from './appearance-preview.js';
+import type { InstanceLease } from './scene-instance-suppression.js';
+export interface InstanceAppearanceRecord {
+    owner: AppearanceOwner;
+    originals: readonly MeshData[];
+    lease: InstanceLease;
+    active: boolean;
+    drafts: number;
+    history: number;
+    /** Canonical model-local replacement while visible flat resources are absent. */
+    flatSources?: readonly MeshData[];
+}
+export interface InstanceAppearanceAccess {
+    has(id: number): boolean;
+    capacity(id: number): {
+        parts: number;
+        vertices: number;
+        corners: number;
+    };
+    pieces(id: number): readonly MeshData[] | undefined;
+    acquire(owner: AppearanceOwner): InstanceLease;
+    remove(id: number): void;
+}
+/** One record per occurrence, shared by every command that can still undo it. */
+export declare class AppearanceInstances {
+    private readonly access;
+    private records;
+    constructor(access: InstanceAppearanceAccess);
+    retainedOwners(keep: (record: InstanceAppearanceRecord) => boolean): Set<number>;
+    forgetExcept(retained: ReadonlySet<number>): void;
+    discardedFlatOwners(retained: ReadonlySet<number>): number[];
+    get(owner: AppearanceOwner): InstanceAppearanceRecord | undefined;
+    capture(owner: AppearanceOwner, originals?: readonly MeshData[]): InstanceAppearanceRecord | undefined;
+    isOriginal(record: InstanceAppearanceRecord, parts: readonly MeshData[]): boolean;
+    activate(record: InstanceAppearanceRecord, original: boolean): void;
+    finish(owner: AppearanceOwner, expected?: InstanceAppearanceRecord): void;
+    retain(owner: AppearanceOwner): () => void;
+    private collect;
+    forget(id?: number): void;
+}
+//# sourceMappingURL=scene-appearance-instances.d.ts.map

package/dist/scene-appearance-instances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-appearance-instances.d.ts","sourceRoot":"","sources":["../src/scene-appearance-instances.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAGrE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,WAAW,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CACnC;AACD,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE,GAAG,SAAS,CAAC;IACpD,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,CAAC;IAC/C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAmBD,iFAAiF;AACjF,qBAAa,mBAAmB;IAElB,OAAO,CAAC,QAAQ,CAAC,MAAM;IADnC,OAAO,CAAC,OAAO,CAA+C;gBACjC,MAAM,EAAE,wBAAwB;IAC7D,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC;IAGhF,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAGjD,mBAAmB,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAG5D,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,wBAAwB,GAAG,SAAS;IAMjE,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,GAAG,wBAAwB,GAAG,SAAS;IA4BtG,UAAU,CAAC,MAAM,EAAE,wBAAwB,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,OAAO;IAQjF,QAAQ,CAAC,MAAM,EAAE,wBAAwB,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAKnE,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,wBAAwB,GAAG,IAAI;IAMzE,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,IAAI;IAY1C,OAAO,CAAC,OAAO;IAOf,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;CAO1B"}

package/dist/scene-appearance-instances.js

@@ -0,0 +1,143 @@
+import { equivalentAppearanceGeometry } from './appearance-uvs.js';
+/** Native provenance is supplied separately. This only checks the live rendered
+ * occurrence still occupies the expected frame within f32 transform rounding. */
+function sameRenderedOccurrence(canonical, rendered) {
+    if (canonical.expressId !== rendered.expressId || canonical.geometryItemId !== rendered.geometryItemId
+        || canonical.indices.length !== rendered.indices.length)
+        return false;
+    for (let corner = 0; corner < canonical.indices.length; corner++) {
+        const a = canonical.indices[corner] * 3, b = rendered.indices[corner] * 3;
+        for (let axis = 0; axis < 3; axis++) {
+            const x = canonical.positions[a + axis] + (canonical.origin?.[axis] ?? 0);
+            const y = rendered.positions[b + axis] + (rendered.origin?.[axis] ?? 0);
+            if (!Number.isFinite(x) || !Number.isFinite(y)
+                || Math.abs(x - y) > 8 * 2 ** -23 * Math.max(1, Math.abs(x), Math.abs(y)))
+                return false;
+        }
+    }
+    return true;
+}
+/** One record per occurrence, shared by every command that can still undo it. */
+export class AppearanceInstances {
+    access;
+    records = new Map();
+    constructor(access) {
+        this.access = access;
+    }
+    retainedOwners(keep) {
+        return new Set([...this.records].filter(([, record]) => record.history > 0 && record.lease.valid && keep(record)).map(([id]) => id));
+    }
+    forgetExcept(retained) {
+        for (const id of this.records.keys())
+            if (!retained.has(id))
+                this.forget(id);
+    }
+    discardedFlatOwners(retained) {
+        return [...this.records].filter(([id, record]) => !retained.has(id) && !record.active && record.lease.valid).map(([id]) => id);
+    }
+    get(owner) {
+        const record = this.records.get(owner.expressId);
+        if (!record)
+            return undefined;
+        if (record.owner.modelIndex !== owner.modelIndex || !record.lease.valid)
+            throw new Error('The original occurrence is no longer available.');
+        return record;
+    }
+    capture(owner, originals) {
+        let record = this.get(owner);
+        if (!record && this.access.has(owner.expressId)) {
+            const capacity = this.access.capacity(owner.expressId);
+            if (!originals || originals.length !== 1 || capacity.parts !== 1
+                || capacity.vertices > 1_000_000 || capacity.corners > 1_500_000) {
+                throw new Error('Instance appearance requires one bounded canonical native source mesh.');
+            }
+            const source = originals[0];
+            if (source.expressId !== owner.expressId || source.modelIndex !== owner.modelIndex
+                || source.appearanceSource?.kind !== 'canonical-item' || source.appearanceSource.indices !== source.indices
+                || source.entityIds || source.localToWorld || source.texture || source.textureRef || source.uvs) {
+                throw new Error('Invalid native occurrence source ownership or provenance.');
+            }
+            const lease = this.access.acquire(owner);
+            try {
+                const rendered = this.access.pieces(owner.expressId);
+                if (rendered?.length !== 1 || !sameRenderedOccurrence(source, rendered[0])) {
+                    throw new Error('The rendered occurrence moved or changed since native preparation.');
+                }
+                record = { owner: Object.freeze({ ...owner }), originals: Object.freeze(originals.map(part => Object.freeze({ ...part }))),
+                    lease, active: true, drafts: 0, history: 0 };
+                this.records.set(owner.expressId, record);
+            }
+            catch (error) {
+                lease.release();
+                throw error;
+            }
+        }
+        else if (originals && !record)
+            throw new Error('The target is no longer a GPU instance.');
+        if (record)
+            record.drafts++;
+        return record;
+    }
+    isOriginal(record, parts) {
+        return parts.length === record.originals.length && parts.every((part, index) => {
+            const original = record.originals[index];
+            return part.geometryItemId === original.geometryItemId && !part.texture && !part.textureRef && !part.uvs
+                && part.color.every((value, axis) => value === original.color[axis])
+                && equivalentAppearanceGeometry(part, original);
+        });
+    }
+    activate(record, original) {
+        this.get(record.owner);
+        record.lease.setSuppressed(!original);
+        record.active = original;
+    }
+    finish(owner, expected) {
+        const record = this.records.get(owner.expressId);
+        if (!record || record.owner.modelIndex !== owner.modelIndex || (expected && record !== expected))
+            return;
+        record.drafts = Math.max(0, record.drafts - 1);
+        this.collect(record);
+    }
+    retain(owner) {
+        const record = this.get(owner);
+        if (!record)
+            return () => { };
+        record.history++;
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            record.history--;
+            try {
+                this.collect(record);
+            }
+            catch (error) {
+                record.history++;
+                throw error;
+            }
+            released = true;
+        };
+    }
+    collect(record) {
+        if (record.drafts || record.history || this.records.get(record.owner.expressId) !== record)
+            return;
+        if (!record.lease.valid) {
+            this.records.delete(record.owner.expressId);
+            return;
+        }
+        if (record.active)
+            record.lease.release();
+        else
+            this.access.remove(record.owner.expressId);
+        this.records.delete(record.owner.expressId);
+    }
+    forget(id) {
+        for (const [key, record] of this.records) {
+            if (id !== undefined && id !== key)
+                continue;
+            record.lease.release();
+            this.records.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=scene-appearance-instances.js.map

package/dist/scene-appearance-instances.js.map

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

package/dist/scene-appearance-preview.d.ts

@@ -0,0 +1,30 @@
+import type { MeshData } from '@ifc-lite/geometry';
+import { type InstanceAppearanceAccess, type InstanceAppearanceRecord } from './scene-appearance-instances.js';
+import type { TexturedMesh } from './scene.js';
+import { AppearancePreviewController } from './appearance-preview.js';
+import { AppearanceBuckets, type AppearanceBucketAccess, type FlatAppearanceResource } from './scene-appearance-buckets.js';
+type Resource = {
+    kind: 'textured';
+    mesh: TexturedMesh;
+} | {
+    kind: 'flat';
+    flat: FlatAppearanceResource;
+} | {
+    kind: 'instance';
+    record: InstanceAppearanceRecord;
+};
+export interface SceneAppearanceAccess {
+    meshes(): TexturedMesh[];
+    data: Map<number, MeshData[]>;
+    instances: InstanceAppearanceAccess;
+    ready(): boolean;
+    buckets: AppearanceBucketAccess;
+    adopt(part: MeshData): MeshData;
+    source(part: MeshData): MeshData;
+    upload(part: MeshData): void;
+    release(mesh: TexturedMesh): void;
+    invalidate(id: number): void;
+}
+export declare function createSceneAppearancePreview(access: SceneAppearanceAccess, buckets?: AppearanceBuckets): AppearancePreviewController<Resource>;
+export {};
+//# sourceMappingURL=scene-appearance-preview.d.ts.map

package/dist/scene-appearance-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-appearance-preview.d.ts","sourceRoot":"","sources":["../src/scene-appearance-preview.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAuB,KAAK,wBAAwB,EAAE,KAAK,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AACpI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAGtE,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AAEvC,KAAK,QAAQ,GACT;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,CAAC;AAC3D,MAAM,WAAW,qBAAqB;IACpC,MAAM,IAAI,YAAY,EAAE,CAAC;IACzB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9B,SAAS,EAAE,wBAAwB,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC;IACjB,OAAO,EAAE,sBAAsB,CAAC;IAChC,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAChC,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACjC,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qBAAqB,EAC7B,OAAO,oBAAmE,GACzE,2BAA2B,CAAC,QAAQ,CAAC,CA0HvC"}

package/dist/scene-appearance-preview.js

@@ -0,0 +1,149 @@
+import { AppearanceInstances } from './scene-appearance-instances.js';
+import { stageAppearanceResources, releaseAppearanceResources, textured } from './scene-appearance-resources.js';
+import { AppearancePreviewController } from './appearance-preview.js';
+import { AppearanceCompanions } from './appearance-companions.js';
+import { equivalentAppearanceGeometry } from './appearance-uvs.js';
+import { AppearanceBuckets, } from './scene-appearance-buckets.js';
+export function createSceneAppearancePreview(access, buckets = new AppearanceBuckets(access.buckets, id => access.data.get(id))) {
+    const instances = new AppearanceInstances(access.instances);
+    const companions = new AppearanceCompanions();
+    const release = (resources) => releaseAppearanceResources(access, buckets, resources.filter(resource => resource.kind !== 'instance'));
+    return new AppearancePreviewController({
+        validate: owner => companions.validate(owner, access.data.get(owner.expressId)),
+        prepareRebuild(geometry, models) {
+            const byOwner = new Map();
+            for (const part of geometry) {
+                const list = byOwner.get(part.expressId) ?? [];
+                list.push(part);
+                byOwner.set(part.expressId, list);
+            }
+            const retained = instances.retainedOwners(record => {
+                if (!models.has(record.owner.modelIndex))
+                    return false;
+                const incoming = byOwner.get(record.owner.expressId) ?? [];
+                if (record.active)
+                    return incoming.length === 0;
+                const current = access.data.get(record.owner.expressId)?.map(part => access.source(part)) ?? record.flatSources;
+                return !!current && current.length === incoming.length && current.every((part, index) => {
+                    const next = incoming[index];
+                    return (next.modelIndex ?? 0) === record.owner.modelIndex && next.geometryItemId === part.geometryItemId
+                        && equivalentAppearanceGeometry(next, part) && next.color.every((value, axis) => value === part.color[axis])
+                        && next.texture === part.texture && next.textureRef === part.textureRef && next.textureBitmap === part.textureBitmap
+                        && next.uvs === part.uvs && next.shadingColor === part.shadingColor;
+                });
+            });
+            for (const id of companions.retained(geometry, models))
+                retained.add(id);
+            return retained;
+        },
+        finishRebuild(retained) { instances.forgetExcept(retained); companions.forgetExcept(retained); buckets.forget(); },
+        discardedForRebuild: retained => instances.discardedFlatOwners(retained),
+        instanced(owner, parts) {
+            const record = instances.get(owner);
+            return !!record && instances.isOriginal(record, parts);
+        },
+        parts(owner) {
+            const record = instances.get(owner);
+            return access.data.get(owner.expressId) ?? (record?.active ? record.originals : companions.get(owner) ? (companions.get(owner).absent ? [] : companions.get(owner).originals) : undefined);
+        },
+        retainSource: owner => {
+            const instance = instances.retain(owner), companion = companions.retain(owner);
+            return () => { instance(); companion(); };
+        },
+        capture(owner, originals, companionOriginals, companionHidden) {
+            if (!access.ready())
+                throw new Error('Appearance requires finalized resident geometry.');
+            if (companionOriginals && (originals || access.instances.has(owner.expressId)))
+                throw new Error('Instanced companions are not supported.');
+            const companion = companionOriginals ? companions.capture(owner, companionOriginals, access.data.get(owner.expressId), part => access.source(part), companionHidden) : undefined;
+            if (companion && (companion.absent || companion.hidden))
+                return { parts: companion.absent ? [] : companion.originals, resources: [], companionOriginals: companion.originals, abandon: () => companions.finish(owner, companion) };
+            const record = instances.capture(owner, originals);
+            if (record?.active)
+                return { parts: record.originals, resources: [{ kind: 'instance', record }],
+                    abandon: () => instances.finish(owner, record) };
+            try {
+                const parts = access.data.get(owner.expressId);
+                const meshes = access
+                    .meshes()
+                    .filter((mesh) => mesh.expressId === owner.expressId);
+                if (!access.ready() ||
+                    !parts?.length ||
+                    (access.instances.has(owner.expressId) && !record) ||
+                    meshes.length !== parts.filter(textured).length ||
+                    parts.some((p) => (p.modelIndex ?? 0) !== owner.modelIndex ||
+                        p.entityIds ||
+                        p.positions.length === 0 ||
+                        p.indices.length === 0 ||
+                        (!textured(p) && !access.buckets.reverse().has(p)))) {
+                    throw new Error('Appearance preview requires finalized, resident, non-instanced geometry');
+                }
+                const resources = meshes.map((mesh) => ({
+                    kind: 'textured',
+                    mesh,
+                }));
+                resources.push(...buckets
+                    .capture(parts)
+                    .map((flat) => ({ kind: 'flat', flat })));
+                buckets.begin(owner);
+                return { parts: companion?.originals ?? parts, resources, companionOriginals: companion?.originals, abandon: () => { buckets.finish(owner); instances.finish(owner, record); companions.finish(owner, companion); } };
+            }
+            catch (error) {
+                instances.finish(owner, record);
+                companions.finish(owner, companion);
+                throw error;
+            }
+        },
+        stage(parts) {
+            if (!parts.length || companions.get({ expressId: parts[0].expressId, modelIndex: parts[0].modelIndex ?? 0 })?.hidden)
+                return [];
+            const record = instances.get({ expressId: parts[0].expressId, modelIndex: parts[0].modelIndex ?? 0 });
+            if (record && instances.isOriginal(record, parts))
+                return [{ kind: 'instance', record }];
+            return stageAppearanceResources(access, buckets, parts);
+        },
+        install(owner, parts, resources) {
+            const meshes = access.meshes();
+            const installed = parts.map((part) => access.adopt({ ...part }));
+            // Allocate all wrapper lists before touching live scene state.
+            const flatParts = resources.map((resource) => resource.kind === 'flat'
+                ? resource.flat.partIndices.map((index) => installed[index])
+                : undefined);
+            const original = resources.find(resource => resource.kind === 'instance');
+            const record = instances.get(owner);
+            const sources = record && !original ? Object.freeze(installed.map(part => Object.freeze({ ...access.source(part) }))) : undefined;
+            if (record)
+                instances.activate(record, !!original);
+            buckets.detach(owner.expressId);
+            for (let i = meshes.length - 1; i >= 0; i--) {
+                if (meshes[i].expressId === owner.expressId)
+                    meshes.splice(i, 1);
+            }
+            resources.forEach((resource, index) => {
+                if (resource.kind === 'textured')
+                    meshes.push(resource.mesh);
+                else if (resource.kind === 'flat')
+                    buckets.attach(resource.flat, flatParts[index]);
+            });
+            buckets.refresh();
+            if (original || companions.get(owner)?.hidden)
+                access.data.delete(owner.expressId);
+            else
+                access.data.set(owner.expressId, installed);
+            if (record)
+                record.flatSources = sources;
+            companions.install(owner, parts);
+            access.invalidate(owner.expressId);
+        },
+        finished(owner) { try {
+            buckets.finish(owner);
+        }
+        finally {
+            instances.finish(owner);
+            companions.finish(owner);
+        } },
+        forget(id) { instances.forget(id); companions.forget(id); buckets.forget(id); },
+        release,
+    });
+}
+//# sourceMappingURL=scene-appearance-preview.js.map

package/dist/scene-appearance-preview.js.map

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

package/dist/scene-appearance-resources.d.ts

@@ -0,0 +1,16 @@
+import type { MeshData } from '@ifc-lite/geometry';
+import type { TexturedMesh } from './scene.js';
+import type { SceneAppearanceAccess } from './scene-appearance-preview.js';
+import type { AppearanceBuckets, FlatAppearanceResource } from './scene-appearance-buckets.js';
+export type AppearanceResource = {
+    kind: 'textured';
+    mesh: TexturedMesh;
+} | {
+    kind: 'flat';
+    flat: FlatAppearanceResource;
+};
+export declare const textured: (part: MeshData) => boolean;
+export declare function releaseAppearanceResources(access: SceneAppearanceAccess, buckets: AppearanceBuckets, resources: readonly AppearanceResource[]): void;
+/** Allocate every colour bucket and texture, retaining no live scene membership. */
+export declare function stageAppearanceResources(access: SceneAppearanceAccess, buckets: AppearanceBuckets, parts: readonly MeshData[]): AppearanceResource[];
+//# sourceMappingURL=scene-appearance-resources.d.ts.map

package/dist/scene-appearance-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-appearance-resources.d.ts","sourceRoot":"","sources":["../src/scene-appearance-resources.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE/F,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,CAAC;AACnD,eAAO,MAAM,QAAQ,GAAI,MAAM,QAAQ,YACoC,CAAC;AAC5E,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,iBAAiB,EAClG,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI,CAOhD;AACD,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,iBAAiB,EAChG,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,kBAAkB,EAAE,CAoBlD"}