@pascal-app/viewer 1.0.0-beta.5 → 1.0.1

package/dist/lib/materials.d.ts

@@ -10,12 +10,21 @@ export declare const BLUEPRINT_PALETTE: Record<SurfaceRole, string>;
 export declare const PRESET_PALETTES: Record<ColorPreset, Record<SurfaceRole, string>>;
 export declare function resolveSurfaceColor(role: SurfaceRole, preset: ColorPreset, sceneThemeId?: string): string;
 export declare const glassMaterial: MeshLambertNodeMaterial;
+export declare function getMaterialTextureVersion(): number;
 export declare function resolveTextureRepeat(repeat: unknown, scale: unknown): [number, number];
 export declare function getTextureKey(material?: MaterialSchema): string;
 export declare function applyMaterialPresetToMaterials(materialInput: THREE.Material | THREE.Material[], preset: MaterialPresetPayload | null | undefined): void;
 export declare function createMaterialFromPreset(preset: MaterialPresetPayload, shading?: RenderShading): THREE.Material;
 export declare function createMaterialFromPresetRef(materialPreset?: string, shading?: RenderShading): THREE.Material | null;
 export declare function createMaterial(material?: MaterialSchema, shading?: RenderShading): THREE.Material;
+/**
+ * Cache-signature fragment for a catalog preset ref. Dynamic library
+ * materials (AI-generated `library:mtl_*`) register asynchronously, so a ref
+ * that fails to resolve is NOT static content: tag it so signature-keyed
+ * material caches re-resolve once the library registers instead of pinning
+ * the dangling-ref fallback for the whole session.
+ */
+export declare function materialPresetRefSignature(ref: string): string;
 /**
  * Resolve a MaterialRef ('library:<id>' | 'scene:<id>') to a three.js material.
  * Returns null for an unknown / dangling ref so callers fall back to the
@@ -41,5 +50,8 @@ export declare function DEFAULT_ROOF_MATERIAL(shading?: RenderShading): THREE.Ma
 export declare function DEFAULT_SHELF_MATERIAL(shading?: RenderShading): THREE.Material;
 export declare function DEFAULT_STAIR_MATERIAL(shading?: RenderShading): THREE.Material;
 export declare function disposeMaterial(material: THREE.Material): void;
+type MaterialCacheCleanup = (() => void) | (() => () => void);
+export declare function registerMaterialCacheCleanup(cleanup: MaterialCacheCleanup): () => void;
 export declare function clearMaterialCache(): void;
+export {};
 //# sourceMappingURL=materials.d.ts.map

package/dist/lib/materials.d.ts.map

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

package/dist/lib/materials.js

@@ -1,4 +1,5 @@
 import { getMaterialPresetByRef, parseMaterialRef, resolveMaterial, } from '@pascal-app/core';
+import { addAfterEffect, invalidate } from '@react-three/fiber';
 import * as THREE from 'three';
 import { float, mix, positionViewDirection, transformedNormalView } from 'three/tsl';
 import { MeshLambertNodeMaterial, MeshStandardNodeMaterial } from 'three/webgpu';
@@ -82,6 +83,11 @@ const surfaceRoleMaterialCache = new Map();
 const textureCache = new Map();
 const textureLoadPromises = new Map();
 const textureLoader = new THREE.TextureLoader();
+let materialTextureVersion = 0;
+// Highlight clones can observe late assignments without polling every material.
+export function getMaterialTextureVersion() {
+    return materialTextureVersion;
+}
 // `.ktx2` finish maps transcode through the shared KTX2 loader (support is
 // detected once at viewer init); everything else loads as a normal image.
 function pickTextureLoader(url) {
@@ -276,6 +282,7 @@ function queueTextureAssignment(material, slot, path, props) {
             // and crash in TextureNode.update ("null (reading 'matrix')").
             textureMaterial[slot] = null;
             material.needsUpdate = true;
+            materialTextureVersion++;
         }
         return;
     }
@@ -289,6 +296,7 @@ function queueTextureAssignment(material, slot, path, props) {
     if (cached) {
         textureMaterial[slot] = createAssignedTexture(cached, props, slot);
         material.needsUpdate = true;
+        materialTextureVersion++;
         return;
     }
     // Cold load: clear the slot for the fetch window, and rebuild the node
@@ -298,12 +306,14 @@ function queueTextureAssignment(material, slot, path, props) {
     if (textureMaterial[slot] != null) {
         textureMaterial[slot] = null;
         material.needsUpdate = true;
+        materialTextureVersion++;
     }
     loadPresetTexture(path, props, slot).then((texture) => {
         if (!texture)
             return;
         textureMaterial[slot] = createAssignedTexture(texture, props, slot);
         material.needsUpdate = true;
+        materialTextureVersion++;
     });
 }
 function applyMaterialMapProperties(material, mapProperties) {
@@ -428,6 +438,16 @@ export function createMaterial(material, shading = 'rendered') {
     materialCache.set(cacheKey, threeMaterial);
     return threeMaterial;
 }
+/**
+ * Cache-signature fragment for a catalog preset ref. Dynamic library
+ * materials (AI-generated `library:mtl_*`) register asynchronously, so a ref
+ * that fails to resolve is NOT static content: tag it so signature-keyed
+ * material caches re-resolve once the library registers instead of pinning
+ * the dangling-ref fallback for the whole session.
+ */
+export function materialPresetRefSignature(ref) {
+    return getMaterialPresetByRef(ref) ? ref : `${ref}#unresolved`;
+}
 /**
  * Resolve a MaterialRef ('library:<id>' | 'scene:<id>') to a three.js material.
  * Returns null for an unknown / dangling ref so callers fall back to the
@@ -453,9 +473,10 @@ export function resolveMaterialRef(ref, sceneMaterials, shading = 'rendered') {
 export function resolveSlotDefaultMaterial(slotDefault, shading = 'rendered', roughness = 0.9) {
     if (parseMaterialRef(slotDefault)?.kind === 'library') {
         return (createMaterialFromPresetRef(slotDefault, shading) ??
-            createDefaultMaterial('#ffffff', roughness, shading));
+            cachedDefaultMaterial(`slot-#ffffff-${roughness}`, '#ffffff', roughness, shading));
     }
-    return createDefaultMaterial(slotDefault, roughness, shading);
+    const color = slotDefault.startsWith('#') ? slotDefault.toLowerCase() : slotDefault;
+    return cachedDefaultMaterial(`slot-${color}-${roughness}`, color, roughness, shading);
 }
 export function createDefaultMaterial(color = '#ffffff', roughness = 0.9, shading = 'rendered', side = THREE.FrontSide) {
     const resolvedSide = resolveNodeMaterialSide(side);
@@ -487,9 +508,7 @@ export function createSurfaceRoleMaterial(role, preset, side = THREE.FrontSide,
     // on `glassMaterial` above — the validator rejects the back-face variant
     // for missing MRT outputs and poisons the render context (manifests as
     // "Color target has no corresponding fragment stage output" on scene
-    // open, since the dormer's window-assembly mounts the glazing material
-    // on both gable faces on the first frame). Callers that need both sides
-    // visible (e.g. dormer back gable) must rotate the host mesh 180° so the
+    // open). Callers that need both sides visible must rotate the host mesh 180° so the
     // FrontSide faces the viewer.
     const resolvedSide = role === 'glazing' ? THREE.FrontSide : resolveNodeMaterialSide(side ?? THREE.FrontSide);
     const cacheKey = `${role}-${preset}-${resolvedSide}-${sceneThemeId ?? 'base'}`;
@@ -566,22 +585,38 @@ export function DEFAULT_STAIR_MATERIAL(shading = 'rendered') {
 export function disposeMaterial(material) {
     material.dispose();
 }
+const materialCacheCleanups = new Set();
+export function registerMaterialCacheCleanup(cleanup) {
+    materialCacheCleanups.add(cleanup);
+    return () => {
+        materialCacheCleanups.delete(cleanup);
+    };
+}
 export function clearMaterialCache() {
-    for (const material of materialCache.values()) {
-        material.dispose();
-    }
+    const previous = [
+        ...materialCache.values(),
+        ...defaultMaterialCache.values(),
+        ...surfaceRoleMaterialCache.values(),
+        ...textureCache.values(),
+    ];
     materialCache.clear();
-    for (const material of defaultMaterialCache.values()) {
-        material.dispose();
-    }
     defaultMaterialCache.clear();
-    for (const material of surfaceRoleMaterialCache.values()) {
-        material.dispose();
-    }
     surfaceRoleMaterialCache.clear();
-    for (const texture of textureCache.values()) {
-        texture.dispose();
-    }
     textureCache.clear();
     textureLoadPromises.clear();
+    const disposals = [];
+    for (const cleanup of materialCacheCleanups) {
+        const dispose = cleanup();
+        if (dispose)
+            disposals.push(dispose);
+    }
+    // Consumers must rebuild sources and release batches before the old caches die.
+    const unsubscribe = addAfterEffect(() => {
+        unsubscribe();
+        for (const resource of previous)
+            resource.dispose();
+        for (const dispose of disposals)
+            dispose();
+    });
+    invalidate();
 }

package/dist/lib/merged-outline-node.d.ts

@@ -1,18 +1,15 @@
 /**
  * MergedOutlineNode — a fork of Three.js OutlineNode that processes two object
- * groups (primary = selected, secondary = hovered) in a single pass, sharing the
- * expensive non-selected depth pre-render between both groups.
- *
- * Cost comparison vs two separate OutlineNode instances:
- *   Before: depth_A + mask_A + edge_A×6 + depth_B + mask_B + edge_B×6 = 2 depth passes
- *   After:  depth_AB (shared) + mask_A + edge_A×6 + mask_B + edge_B×6 = 1 depth pass
+ * groups (primary = selected, secondary = hovered), reusing scene depth when
+ * supplied and rendering masks from small private scenes. Callers without scene
+ * depth retain one shared non-selected depth pass for both groups.
  *
  * Additional early-outs:
  *   - Both empty       → skip everything (0 passes)
  *   - Only primary     → skip secondary mask/edge/blur
  *   - Only secondary   → skip primary mask/edge/blur
  */
-import { type Object3D } from 'three';
+import { Object3D } from 'three';
 import { TempNode } from 'three/webgpu';
 export declare class MergedOutlineNode extends TempNode {
     static get type(): string;
@@ -26,6 +23,7 @@ export declare class MergedOutlineNode extends TempNode {
     secondaryEdgeGlowNode: any;
     downSampleRatio: number;
     updateBeforeType: string;
+    private readonly _sceneDepthNode;
     private readonly _depthRT;
     private readonly _depthTexUniform;
     private readonly _groupA;
@@ -62,6 +60,11 @@ export declare class MergedOutlineNode extends TempNode {
     private readonly _compositeMatB;
     private readonly _cacheA;
     private readonly _cacheB;
+    private readonly _proxiesA;
+    private readonly _proxiesB;
+    private readonly _proxyMaskMaterials;
+    private readonly _maskSceneA;
+    private readonly _maskSceneB;
     private _wroteGroupALastFrame;
     private _wroteGroupBLastFrame;
     private readonly _textureNodeA;
@@ -74,6 +77,8 @@ export declare class MergedOutlineNode extends TempNode {
         primaryEdgeGlow?: any;
         secondaryEdgeGlow?: any;
         downSampleRatio?: number;
+        /** Current depth from pass(scene, camera).getTextureNode('depth'). */
+        sceneDepthNode?: any;
     });
     get primaryVisibleEdge(): any;
     get primaryHiddenEdge(): any;
@@ -81,8 +86,12 @@ export declare class MergedOutlineNode extends TempNode {
     get secondaryHiddenEdge(): any;
     setSize(width: number, height: number): void;
     updateBefore(frame: any): void;
+    private _renderMask;
+    private _syncProxies;
+    private _supportsProxies;
+    private _disposeProxyMaterial;
     private _runEdgePipeline;
-    setup(_builder: any): any;
+    setup(builder: any): any;
     dispose(): void;
     private _buildCache;
 }

package/dist/lib/merged-outline-node.d.ts.map

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

package/dist/lib/merged-outline-node.js

@@ -2,20 +2,17 @@
 // this file is a fork of OutlineNode and is intentionally exempt from strict TS checking.
 /**
  * MergedOutlineNode — a fork of Three.js OutlineNode that processes two object
- * groups (primary = selected, secondary = hovered) in a single pass, sharing the
- * expensive non-selected depth pre-render between both groups.
- *
- * Cost comparison vs two separate OutlineNode instances:
- *   Before: depth_A + mask_A + edge_A×6 + depth_B + mask_B + edge_B×6 = 2 depth passes
- *   After:  depth_AB (shared) + mask_A + edge_A×6 + mask_B + edge_B×6 = 1 depth pass
+ * groups (primary = selected, secondary = hovered), reusing scene depth when
+ * supplied and rendering masks from small private scenes. Callers without scene
+ * depth retain one shared non-selected depth pass for both groups.
  *
  * Additional early-outs:
  *   - Both empty       → skip everything (0 passes)
  *   - Only primary     → skip secondary mask/edge/blur
  *   - Only secondary   → skip primary mask/edge/blur
  */
-import { DepthTexture, FloatType, RenderTarget, Vector2 } from 'three';
-import { color, exp, Fn, float, int, Loop, min, mul, nodeObject, orthographicDepthToViewZ, passTexture, perspectiveDepthToViewZ, positionView, reference, screenUV, texture, textureSize, uniform, uv, vec2, vec3, vec4, } from 'three/tsl';
+import { DepthTexture, FloatType, Mesh, Object3D, RenderTarget, Scene, Sprite, Vector2, } from 'three';
+import { builtin, color, exp, Fn, float, floatBitsToUint, int, Loop, min, mul, nodeObject, orthographicDepthToViewZ, passTexture, perspectiveDepthToViewZ, positionView, reference, screenUV, texture, textureSize, uniform, uv, vec2, vec3, vec4, } from 'three/tsl';
 import { NodeMaterial, NodeUpdateType, QuadMesh, RendererUtils, SpriteNodeMaterial, TempNode, } from 'three/webgpu';
 import { hasDrawableGeometry } from './drawable-geometry';
 const _quadMesh = new QuadMesh();
@@ -27,6 +24,8 @@ let _rendererState; // eslint-disable-line @typescript-eslint/no-explicit-any
 // Helper: render targets for one outline group
 // ---------------------------------------------------------------------------
 function makeGroupTargets(downSampleRatio) {
+    // Preserve the original pixel-center mask coverage. MSAA-resolved masks mix
+    // visible/background samples into hidden edges before edge detection.
     const maskBuffer = new RenderTarget();
     const maskDownSample = new RenderTarget(1, 1, { depthBuffer: false });
     const edgeBuffer1 = new RenderTarget(1, 1, { depthBuffer: false });
@@ -85,6 +84,7 @@ export class MergedOutlineNode extends TempNode {
     secondaryEdgeGlowNode;
     downSampleRatio;
     updateBeforeType;
+    _sceneDepthNode;
     _depthRT;
     _depthTexUniform;
     _groupA;
@@ -121,6 +121,11 @@ export class MergedOutlineNode extends TempNode {
     _compositeMatB;
     _cacheA = new Set();
     _cacheB = new Set();
+    _proxiesA = new Map();
+    _proxiesB = new Map();
+    _proxyMaskMaterials = new WeakMap();
+    _maskSceneA = new Scene();
+    _maskSceneB = new Scene();
     // Tracks whether either group rendered last frame. We use this to decide
     // when it's safe to skip renderer state manipulation entirely — touching
     // the renderer (resetRendererAndSceneState + setRenderTarget + clearColor)
@@ -132,7 +137,12 @@ export class MergedOutlineNode extends TempNode {
     _textureNodeB;
     constructor(scene, camera, params = {}) {
         super('vec4');
-        const { primaryObjects = [], secondaryObjects = [], primaryEdgeThickness = float(1), secondaryEdgeThickness = float(1), primaryEdgeGlow = float(0), secondaryEdgeGlow = float(0), downSampleRatio = 2, } = params;
+        const { primaryObjects = [], secondaryObjects = [], primaryEdgeThickness = float(1), secondaryEdgeThickness = float(1), primaryEdgeGlow = float(0), secondaryEdgeGlow = float(0), downSampleRatio = 2, sceneDepthNode = null, } = params;
+        this._sceneDepthNode = sceneDepthNode;
+        this._maskSceneA.matrixWorldAutoUpdate = false;
+        this._maskSceneB.matrixWorldAutoUpdate = false;
+        this._maskSceneA.name = 'MergedOutline [ Mask A ]';
+        this._maskSceneB.name = 'MergedOutline [ Mask B ]';
         this.scene = scene;
         this.camera = camera;
         this.primaryObjects = primaryObjects;
@@ -233,6 +243,11 @@ export class MergedOutlineNode extends TempNode {
         }
         const { renderer } = frame;
         const { camera, scene } = this;
+        // Update the producer before resetting renderer state, even if this outline
+        // is the first consumer in the graph. NodeFrame deduplicates FRAME updates.
+        if (hasAny && this._sceneDepthNode?.passNode) {
+            frame.updateBeforeNode(this._sceneDepthNode.passNode);
+        }
         _rendererState = RendererUtils.resetRendererAndSceneState(renderer, scene, _rendererState);
         const size = renderer.getDrawingBufferSize(_size);
         this.setSize(size.width, size.height);
@@ -248,6 +263,10 @@ export class MergedOutlineNode extends TempNode {
             renderer.clearColor();
             this._wroteGroupBLastFrame = false;
         }
+        this._buildCache(this.primaryObjects, this._cacheA);
+        this._buildCache(this.secondaryObjects, this._cacheB);
+        const useProxiesA = this._syncProxies(this._cacheA, this._proxiesA, this._maskSceneA);
+        const useProxiesB = this._syncProxies(this._cacheB, this._proxiesB, this._maskSceneB);
         if (!hasAny) {
             RendererUtils.restoreRendererAndSceneState(renderer, scene, _rendererState);
             return;
@@ -255,55 +274,26 @@ export class MergedOutlineNode extends TempNode {
         renderer.setClearColor(0xff_ff_ff, 1);
         this._wroteGroupALastFrame = hasPrimary;
         this._wroteGroupBLastFrame = hasSecondary;
-        if (hasPrimary)
-            this._buildCache(this.primaryObjects, this._cacheA);
-        if (hasSecondary)
-            this._buildCache(this.secondaryObjects, this._cacheB);
         const savedName = scene.name;
-        // ── 1. Shared depth pass: all objects NOT in either group ─────────────────
-        renderer.setRenderTarget(this._depthRT);
-        renderer.setRenderObjectFunction((obj, sc, cam, geo, _mat, grp, lights, clip) => {
-            if (!hasDrawableGeometry(geo))
-                return;
-            const inCache = this._cacheA.has(obj) || this._cacheB.has(obj);
-            if (!inCache) {
-                const m = obj.isSprite ? this._depthSpriteMaterial : this._depthMaterial;
-                renderer.renderObject(obj, sc, cam, geo, m, grp, lights, clip);
-            }
-        });
-        scene.name = 'MergedOutline [ Depth ]';
-        renderer.render(scene, camera);
-        // ── 2a. Primary mask pass ─────────────────────────────────────────────────
-        if (hasPrimary) {
-            renderer.setRenderTarget(this._groupA.maskBuffer);
-            renderer.setRenderObjectFunction((obj, sc, cam, geo, _mat, grp, lights, clip) => {
-                if (!hasDrawableGeometry(geo))
-                    return;
-                if (this._cacheA.has(obj)) {
-                    const m = obj.isSprite ? this._prepareMaskSpriteMatA : this._prepareMaskMatA;
-                    renderer.renderObject(obj, sc, cam, geo, m, grp, lights, clip);
-                }
-            });
-            scene.name = 'MergedOutline [ Mask A ]';
-            renderer.render(scene, camera);
-        }
-        // ── 2b. Secondary mask pass ───────────────────────────────────────────────
-        if (hasSecondary) {
-            renderer.setRenderTarget(this._groupB.maskBuffer);
+        if (!this._sceneDepthNode) {
+            renderer.setRenderTarget(this._depthRT);
             renderer.setRenderObjectFunction((obj, sc, cam, geo, _mat, grp, lights, clip) => {
                 if (!hasDrawableGeometry(geo))
                     return;
-                if (this._cacheB.has(obj)) {
-                    const m = obj.isSprite ? this._prepareMaskSpriteMatB : this._prepareMaskMatB;
+                if (!(this._cacheA.has(obj) || this._cacheB.has(obj))) {
+                    const m = obj.isSprite ? this._depthSpriteMaterial : this._depthMaterial;
                     renderer.renderObject(obj, sc, cam, geo, m, grp, lights, clip);
                 }
             });
-            scene.name = 'MergedOutline [ Mask B ]';
+            scene.name = 'MergedOutline [ Depth ]';
             renderer.render(scene, camera);
         }
+        // The fallback depth render may have updated source matrices since sync.
+        if (hasPrimary)
+            this._renderMask(renderer, 'A', useProxiesA);
+        if (hasSecondary)
+            this._renderMask(renderer, 'B', useProxiesB);
         renderer.setRenderObjectFunction(_rendererState.renderObjectFunction);
-        this._cacheA.clear();
-        this._cacheB.clear();
         scene.name = savedName;
         // ── 3–7. Edge detect + blur + composite per active group ──────────────────
         if (hasPrimary)
@@ -312,6 +302,117 @@ export class MergedOutlineNode extends TempNode {
             this._runEdgePipeline(renderer, 'B');
         RendererUtils.restoreRendererAndSceneState(renderer, scene, _rendererState);
     }
+    _renderMask(renderer, group, useProxies) {
+        const isA = group === 'A';
+        const cache = isA ? this._cacheA : this._cacheB;
+        const proxies = isA ? this._proxiesA : this._proxiesB;
+        const maskScene = isA ? this._maskSceneA : this._maskSceneB;
+        const material = isA ? this._prepareMaskMatA : this._prepareMaskMatB;
+        const spriteMaterial = isA ? this._prepareMaskSpriteMatA : this._prepareMaskSpriteMatB;
+        if (useProxies) {
+            for (const [source, proxy] of proxies)
+                proxy.matrixWorld.copy(source.matrixWorld);
+        }
+        renderer.setRenderTarget((isA ? this._groupA : this._groupB).maskBuffer);
+        // Keep source materials on proxies for material visibility and geometry
+        // groups; substitute only at submission, just like the full-scene path.
+        renderer.setRenderObjectFunction((obj, sc, cam, geo, _mat, grp, lights, clip) => {
+            if (!hasDrawableGeometry(geo))
+                return;
+            if (useProxies || cache.has(obj)) {
+                let maskMaterial = obj.isSprite ? spriteMaterial : material;
+                if (useProxies) {
+                    let ownedMaterial = this._proxyMaskMaterials.get(obj);
+                    if (!ownedMaterial) {
+                        // Disposing this private material releases the proxy's RenderObjects
+                        // without disposing geometry or materials owned by the source scene.
+                        ownedMaterial = maskMaterial.clone();
+                        this._proxyMaskMaterials.set(obj, ownedMaterial);
+                    }
+                    if (ownedMaterial.colorNode !== maskMaterial.colorNode) {
+                        ownedMaterial.colorNode = maskMaterial.colorNode;
+                        ownedMaterial.needsUpdate = true;
+                    }
+                    maskMaterial = ownedMaterial;
+                }
+                renderer.renderObject(obj, sc, cam, geo, maskMaterial, grp, lights, clip);
+            }
+        });
+        renderer.render(useProxies ? maskScene : this.scene, this.camera);
+    }
+    _syncProxies(cache, proxies, scene) {
+        const supported = this._supportsProxies(cache);
+        for (const [source, proxy] of proxies) {
+            if (!supported || !cache.has(source) || !hasDrawableGeometry(source.geometry)) {
+                this._disposeProxyMaterial(proxy);
+                scene.remove(proxy);
+                proxies.delete(source);
+            }
+        }
+        if (!supported)
+            return false;
+        for (const source of cache) {
+            if (!hasDrawableGeometry(source.geometry))
+                continue;
+            let proxy = proxies.get(source);
+            if (!proxy) {
+                proxy = source.isSprite
+                    ? new Sprite(source.material)
+                    : new Mesh(source.geometry, source.material);
+                proxy.matrixAutoUpdate = false;
+                proxy.matrixWorldAutoUpdate = false;
+                proxy.frustumCulled = false;
+                proxies.set(source, proxy);
+                scene.add(proxy);
+            }
+            else if (proxy.geometry !== source.geometry) {
+                // Three's RenderObject.setGeometry does not move its dispose listener.
+                this._disposeProxyMaterial(proxy);
+            }
+            let visible = true;
+            let attached = false;
+            for (let ancestor = source; ancestor; ancestor = ancestor.parent) {
+                if (!ancestor.visible)
+                    visible = false;
+                if (ancestor === this.scene)
+                    attached = true;
+            }
+            proxy.geometry = source.geometry;
+            proxy.material = source.material;
+            proxy.matrixWorld.copy(source.matrixWorld);
+            proxy.layers.mask = source.layers.mask;
+            proxy.visible = visible && attached;
+            proxy.renderOrder = source.renderOrder;
+            proxy.morphTargetInfluences = source.morphTargetInfluences;
+            proxy.morphTargetDictionary = source.morphTargetDictionary;
+            proxy.count = source.count;
+            if (source.isSprite)
+                proxy.center.copy(source.center);
+        }
+        return true;
+    }
+    _supportsProxies(cache) {
+        for (const source of cache) {
+            const prototype = Object.getPrototypeOf(source);
+            if ((prototype !== Mesh.prototype && prototype !== Sprite.prototype) ||
+                source.onBeforeRender !== Object3D.prototype.onBeforeRender ||
+                source.onAfterRender !== Object3D.prototype.onAfterRender) {
+                return false;
+            }
+            for (let ancestor = source; ancestor; ancestor = ancestor.parent) {
+                if (ancestor.isLOD ||
+                    ancestor.isClippingGroup ||
+                    (ancestor.isGroup && ancestor.renderOrder !== 0)) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    _disposeProxyMaterial(proxy) {
+        this._proxyMaskMaterials.get(proxy)?.dispose();
+        this._proxyMaskMaterials.delete(proxy);
+    }
     _runEdgePipeline(renderer, group) {
         const isA = group === 'A';
         const g = isA ? this._groupA : this._groupB;
@@ -350,15 +451,45 @@ export class MergedOutlineNode extends TempNode {
         renderer.setRenderTarget(g.composite);
         _quadMesh.render(renderer);
     }
-    setup(_builder) {
+    setup(builder) {
+        if (this._sceneDepthNode) {
+            builder.getNodeProperties(this).sceneDepthNode = this._sceneDepthNode;
+        }
+        const reversed = builder.renderer.reversedDepthBuffer;
+        const depthTexture = this._sceneDepthNode?.value;
+        const floatDepth = reversed || depthTexture?.type === FloatType;
+        const depthSamples = this._sceneDepthNode && builder.renderer.backend.isWebGPUBackend
+            ? (this._sceneDepthNode.passNode?.options.samples ?? builder.renderer.samples)
+            : 0;
         // ── prepareMask ───────────────────────────────────────────────────────────
         const buildPrepareMask = () => {
-            const depth = this._depthTexUniform.sample(screenUV);
+            let depth = (this._sceneDepthNode ?? this._depthTexUniform).sample(screenUV).r;
+            if (this._sceneDepthNode) {
+                // The symmetric MSAA sample positions average to the pixel center where
+                // the mask rasterizes. Average differences to avoid rounding a sum of
+                // nearly-one depths and consuming the one-ULP allowance below.
+                let depthOffset = float(0);
+                for (let sampleIndex = 1; sampleIndex < depthSamples; sampleIndex++) {
+                    const sampleDepth = this._sceneDepthNode.sample(screenUV).level(sampleIndex).r;
+                    depthOffset = depthOffset.add(sampleDepth.sub(depth));
+                }
+                if (depthSamples > 1)
+                    depth = depth.add(depthOffset.div(depthSamples));
+                // Extract the float exponent for one ULP; a relative epsilon can hide
+                // centimetre-scale occlusion at long distances with conventional depth.
+                const bias = floatDepth
+                    ? float(floatBitsToUint(depth.abs()).shiftRight(23).bitAnd(255).max(1)).sub(150).exp2()
+                    : float(2 ** -24);
+                // Both Three builders expose fragCoord.xy; read rasterized z directly
+                // so view-Z reconstruction cannot consume the small depth allowance.
+                const fragmentDepth = Fn((_, shaderBuilder) => builtin(shaderBuilder.getFragCoord().replace(/\.xy$/, '.z')))();
+                const separation = reversed ? depth.sub(fragmentDepth) : fragmentDepth.sub(depth);
+                return vec3(0.0, separation.greaterThan(bias).select(1, 0), 1.0);
+            }
             const viewZ = this.camera.isPerspectiveCamera
                 ? perspectiveDepthToViewZ(depth, this._cameraNear, this._cameraFar)
                 : orthographicDepthToViewZ(depth, this._cameraNear, this._cameraFar);
-            const depthTest = positionView.z.lessThanEqual(viewZ).select(1, 0);
-            return vec3(0.0, depthTest, 1.0);
+            return vec3(0.0, positionView.z.lessThanEqual(viewZ).select(1, 0), 1.0);
         };
         const maskColorA = buildPrepareMask();
         this._prepareMaskMatA.colorNode = maskColorA;
@@ -445,6 +576,16 @@ export class MergedOutlineNode extends TempNode {
     dispose() {
         this.primaryObjects.length = 0;
         this.secondaryObjects.length = 0;
+        for (const proxy of this._proxiesA.values())
+            this._disposeProxyMaterial(proxy);
+        for (const proxy of this._proxiesB.values())
+            this._disposeProxyMaterial(proxy);
+        this._maskSceneA.clear();
+        this._maskSceneB.clear();
+        this._proxiesA.clear();
+        this._proxiesB.clear();
+        this._cacheA.clear();
+        this._cacheB.clear();
         this._depthRT.dispose();
         this._groupA.dispose();
         this._groupB.dispose();
@@ -466,6 +607,7 @@ export class MergedOutlineNode extends TempNode {
         this._compositeMatB.dispose();
     }
     _buildCache(objects, cache) {
+        cache.clear();
         for (const obj of objects) {
             obj.traverse((child) => {
                 if (child.isMesh || child.isSprite)