@mindexec/cli 0.2.218 → 0.2.220

package/wwwroot/_content/MindExecution.Shared/js/mind-map-interactions.js

@@ -4,6 +4,7 @@ window.MindMapInteractions = (function () {
     const CTRL_WHEEL_SCROLL_EDGE_EPSILON = 2;
     const PAN_LIVE_REFRESH_FORCE_FRAMES = 2;
     const MOTION_DOM_FANOUT_DELAY_MS = 180;
+    const MOTION_DOM_FANOUT_ENABLED = false;
     const MOTION_WILL_CHANGE_ENABLE_DELAY_MS = 240;
     const PRIMARY_CLICK_DELAY_MS = 280;
     const BACKGROUND_PRIMARY_CLICK_DELAY_MS = 320;
@@ -25,11 +26,14 @@ window.MindMapInteractions = (function () {
 
     function isBrowserSelectionLocked() {
         const body = document?.body;
+        const css3dWrapper = document?.getElementById?.('css3d-dom-wrapper');
         return browserSelectionLockReasons.size > 0 ||
             body?.classList?.contains?.(BROWSER_SELECTION_LOCK_CLASS) === true ||
             body?.classList?.contains?.('is-node-dragging') === true ||
             body?.classList?.contains?.('is-panning') === true ||
-            body?.classList?.contains?.('is-zooming') === true;
+            body?.classList?.contains?.('is-zooming') === true ||
+            css3dWrapper?.classList?.contains?.('is-panning') === true ||
+            css3dWrapper?.classList?.contains?.('is-zooming') === true;
     }
 
     function handleBrowserSelectStart(event) {
@@ -99,18 +103,24 @@ window.MindMapInteractions = (function () {
         if (!module || typeof document === 'undefined' || !document.body) {
             return;
         }
+        if (MOTION_DOM_FANOUT_ENABLED !== true) {
+            clearZoomMotionChrome(module);
+            return;
+        }
 
         clearModuleTimer(module, '_zoomMotionChromeTimer');
         module._zoomMotionChromeTimer = setTimeout(() => {
             module._zoomMotionChromeTimer = null;
+            const targetElement = module?.cssRenderer?.domElement || document.body;
             if (module.isZooming === true) {
-                document.body.classList.add('is-zooming');
+                targetElement.classList.add('is-zooming');
             }
         }, MOTION_DOM_FANOUT_DELAY_MS);
     }
 
     function clearZoomMotionChrome(module) {
         clearModuleTimer(module, '_zoomMotionChromeTimer');
+        module?.cssRenderer?.domElement?.classList?.remove?.('is-zooming');
         document?.body?.classList?.remove?.('is-zooming');
     }
 
@@ -123,6 +133,10 @@ window.MindMapInteractions = (function () {
         if (!module || !element) {
             return;
         }
+        if (MOTION_DOM_FANOUT_ENABLED !== true) {
+            clearPanMotionChrome(module);
+            return;
+        }
 
         clearModuleTimer(module, '_panMotionChromeTimer');
         module._panMotionChromeTimer = setTimeout(() => {
@@ -144,6 +158,10 @@ window.MindMapInteractions = (function () {
         if (!module || !window.MindMapCss3DManager?.setWillChange) {
             return;
         }
+        if (module.renderDebugFlags?.enableCss3dWillChange !== true) {
+            clearMotionWillChangeEnable(module, { disableIfIdle: true });
+            return;
+        }
 
         clearModuleTimer(module, '_motionWillChangeEnableTimer');
         module._motionWillChangeEnableTimer = setTimeout(() => {
@@ -160,6 +178,7 @@ window.MindMapInteractions = (function () {
         if (options.disableIfIdle === true &&
             module?.isZooming !== true &&
             module?.isPanning !== true &&
+            module?.renderDebugFlags?.enableCss3dWillChange === true &&
             window.MindMapCss3DManager?.setWillChange) {
             window.MindMapCss3DManager.setWillChange(false, module);
         }
@@ -267,10 +286,29 @@ window.MindMapInteractions = (function () {
 
     function getViewportMetrics(module) {
         ensureActiveContainer(module);
-        const width = Math.max(0, Number(module?.container?.clientWidth || 0));
-        const height = Math.max(0, Number(module?.container?.clientHeight || 0));
+        const rect = module?.container?.getBoundingClientRect?.() || null;
+        const width = Math.max(0, Number(rect?.width || module?.container?.clientWidth || 0));
+        const height = Math.max(0, Number(rect?.height || module?.container?.clientHeight || 0));
+        const left = Number(rect?.left || 0);
+        const top = Number(rect?.top || 0);
         const dpr = Math.max(1, Number(window.devicePixelRatio || 1));
-        return { width, height, dpr };
+        return { width, height, left, top, dpr };
+    }
+
+    function getCachedViewportMetrics(module) {
+        const width = Math.max(0, Number(module?._lastViewportWidth || 0));
+        const height = Math.max(0, Number(module?._lastViewportHeight || 0));
+        if (width > 0 && height > 0) {
+            return {
+                width,
+                height,
+                left: Number(module?._lastViewportLeft || 0),
+                top: Number(module?._lastViewportTop || 0),
+                dpr: Math.max(1, Number(module?._lastViewportDpr || window.devicePixelRatio || 1))
+            };
+        }
+
+        return getViewportMetrics(module);
     }
 
     function haveViewportMetricsChanged(module, metrics, force = false) {
@@ -280,9 +318,13 @@ window.MindMapInteractions = (function () {
 
         const lastWidth = Number(module?._lastViewportWidth || 0);
         const lastHeight = Number(module?._lastViewportHeight || 0);
+        const lastLeft = Number(module?._lastViewportLeft || 0);
+        const lastTop = Number(module?._lastViewportTop || 0);
         const lastDpr = Number(module?._lastViewportDpr || 0);
         return Math.abs(metrics.width - lastWidth) > 1 ||
             Math.abs(metrics.height - lastHeight) > 1 ||
+            Math.abs(metrics.left - lastLeft) > 1 ||
+            Math.abs(metrics.top - lastTop) > 1 ||
             Math.abs(metrics.dpr - lastDpr) > 0.02;
     }
 
@@ -293,6 +335,8 @@ window.MindMapInteractions = (function () {
 
         module._lastViewportWidth = metrics.width;
         module._lastViewportHeight = metrics.height;
+        module._lastViewportLeft = metrics.left;
+        module._lastViewportTop = metrics.top;
         module._lastViewportDpr = metrics.dpr;
     }
 
@@ -545,6 +589,17 @@ window.MindMapInteractions = (function () {
             Number(module._panLiveRefreshForceFrames || 0),
             PAN_LIVE_REFRESH_FORCE_FRAMES
         );
+        module._cameraNavigationForceFrames = Math.max(
+            Number(module._cameraNavigationForceFrames || 0),
+            PAN_LIVE_REFRESH_FORCE_FRAMES
+        );
+        wakeCameraNavigationAnimation(module, 'pan-input');
+    }
+
+    function wakeCameraNavigationAnimation(module, reason = 'camera-navigation-input') {
+        if (module && typeof module.requestAnimationWake === 'function') {
+            module.requestAnimationWake(reason);
+        }
     }
 
     function isEditableElement(element) {
@@ -1409,30 +1464,36 @@ window.MindMapInteractions = (function () {
     // ▲▲▲ [New] Scrollbar-drag helper functions ▲▲▲
 
     // ▼▼▼ [New] Centralized Pointer Update Helper ▼▼▼
-    function updatePointer(module, e) {
-        if (!module) return;
-        ensureActiveContainer(module);
-
-        const rect = module.container?.getBoundingClientRect?.() ||
-            module.cssRenderer?.domElement?.getBoundingClientRect?.();
-        if (!rect || rect.width <= 0 || rect.height <= 0) return;
-
-        const x = (e.clientX - rect.left) / rect.width;
-        const y = (e.clientY - rect.top) / rect.height;
-        module.pointer.x = (x * 2) - 1;
-        module.pointer.y = -((y * 2) - 1);
-    }
+    function setPointerFromClientPosition(module, clientX, clientY) {
+        if (!module?.pointer) return false;
+
+        const metrics = getCachedViewportMetrics(module);
+        if (!metrics || metrics.width <= 0 || metrics.height <= 0) {
+            return false;
+        }
+
+        const x = (Number(clientX || 0) - Number(metrics.left || 0)) / metrics.width;
+        const y = (Number(clientY || 0) - Number(metrics.top || 0)) / metrics.height;
+        module.pointer.x = (x * 2) - 1;
+        module.pointer.y = -((y * 2) - 1);
+        return true;
+    }
+
+    function updatePointer(module, e) {
+        if (!module) return;
+        setPointerFromClientPosition(module, e?.clientX, e?.clientY);
+    }
     // ▲▲▲ [New] ▲▲▲
 
     // ▼▼▼ [New] World Point Conversion Helper (Screen creation fix) ▼▼▼
     function getWorldPoint(module, mouseX, mouseY) {
         if (!module.camera || !module.raycaster || !module.plane) return null;
 
-        const rect = module.container?.getBoundingClientRect?.();
-        const width = rect?.width || module.container?.clientWidth || 1;
-        const height = rect?.height || module.container?.clientHeight || 1;
-        const localX = rect ? (mouseX - rect.left) : mouseX;
-        const localY = rect ? (mouseY - rect.top) : mouseY;
+        const metrics = getCachedViewportMetrics(module);
+        const width = Math.max(1, Number(metrics.width || 0));
+        const height = Math.max(1, Number(metrics.height || 0));
+        const localX = Number(mouseX || 0) - Number(metrics.left || 0);
+        const localY = Number(mouseY || 0) - Number(metrics.top || 0);
 
         const vec = new THREE.Vector2(
             (localX / width) * 2 - 1,
@@ -1855,8 +1916,9 @@ window.MindMapInteractions = (function () {
         vec.project(module.camera);
 
         // Convert from NDC (-1 to +1) to screen pixels
-        const x = (vec.x + 1) * module.container.clientWidth / 2;
-        const y = (-vec.y + 1) * module.container.clientHeight / 2;
+        const metrics = getCachedViewportMetrics(module);
+        const x = (vec.x + 1) * Math.max(1, Number(metrics.width || 0)) / 2;
+        const y = (-vec.y + 1) * Math.max(1, Number(metrics.height || 0)) / 2;
 
         return { x, y };
     }
@@ -1868,8 +1930,7 @@ window.MindMapInteractions = (function () {
         if (!module.worldStartPos || !module.lastMouseClientX || !module.lastMouseClientY) return;
 
         // Calculate current world position of mouse cursor
-        module.pointer.x = (module.lastMouseClientX / module.container.clientWidth) * 2 - 1;
-        module.pointer.y = -(module.lastMouseClientY / module.container.clientHeight) * 2 + 1;
+        setPointerFromClientPosition(module, module.lastMouseClientX, module.lastMouseClientY);
         module.raycaster.setFromCamera(module.pointer, module.camera);
 
         const worldEndPos = new THREE.Vector3();
@@ -4763,8 +4824,7 @@ window.MindMapInteractions = (function () {
                 module.lastMouseClientY = e.clientY;
 
                 // Get current mouse world position
-                module.pointer.x = (e.clientX / module.container.clientWidth) * 2 - 1;
-                module.pointer.y = -(e.clientY / module.container.clientHeight) * 2 + 1;
+                setPointerFromClientPosition(module, e.clientX, e.clientY);
                 module.raycaster.setFromCamera(module.pointer, module.camera);
 
                 const worldEndPos = new THREE.Vector3();
@@ -4807,8 +4867,7 @@ window.MindMapInteractions = (function () {
             }
 
             if (module.wasDragged) {
-                module.pointer.x = (e.clientX / module.container.clientWidth) * 2 - 1;
-                module.pointer.y = -(e.clientY / module.container.clientHeight) * 2 + 1;
+                setPointerFromClientPosition(module, e.clientX, e.clientY);
                 module.raycaster.setFromCamera(module.pointer, module.camera);
                 if (module.raycaster.ray.intersectPlane(module.plane, module.intersectPoint)) {
                     const newPos = _tmpDragPos.copy(module.intersectPoint).sub(module.dragOffset);
@@ -4866,8 +4925,7 @@ window.MindMapInteractions = (function () {
 
             if (module.wasDragged) {
                 const t0 = performance.now();
-                module.pointer.x = (e.clientX / module.container.clientWidth) * 2 - 1;
-                module.pointer.y = -(e.clientY / module.container.clientHeight) * 2 + 1;
+                setPointerFromClientPosition(module, e.clientX, e.clientY);
                 module.raycaster.setFromCamera(module.pointer, module.camera);
                 const t1 = performance.now();
 
@@ -5040,8 +5098,7 @@ window.MindMapInteractions = (function () {
                     module.selectionRectElement.style.display = 'none';
                 }
                 if (module.worldStartPos) {
-                    module.pointer.x = (e.clientX / module.container.clientWidth) * 2 - 1;
-                    module.pointer.y = -(e.clientY / module.container.clientHeight) * 2 + 1;
+                    setPointerFromClientPosition(module, e.clientX, e.clientY);
                     module.raycaster.setFromCamera(module.pointer, module.camera);
 
                     const worldEndPos = new THREE.Vector3();
@@ -6173,12 +6230,13 @@ window.MindMapInteractions = (function () {
         const panFactor = TRACKPAD_PAN_SENSITIVITY * module.camera.position.z;
         module.targetX += normalizedDeltaX * panFactor;
         module.targetY -= normalizedDeltaY * panFactor;
-        module._lastPanInputAt = performance.now();
+        const panInputAt = performance.now();
+        module._lastPanInputAt = panInputAt;
         module._forceUpdateFrames = Math.max(module._forceUpdateFrames || 0, 2);
         module._cameraNavigationForceFrames = Math.max(module._cameraNavigationForceFrames || 0, 2);
-        module._deferPassiveOverlayRefresh = false;
-        module._overlayDirty = true;
-        window.MindMapTextOverlayV2?.invalidateView?.(module);
+        module._deferPassiveOverlayRefresh = true;
+        module._cameraNavigationOverlayInputTime = panInputAt;
+        wakeCameraNavigationAnimation(module, 'trackpad-pan-input');
 
         if (module.isSelecting) {
             updateSelectionBox(module);
@@ -6293,8 +6351,13 @@ window.MindMapInteractions = (function () {
         module._zoomFallbackExpired = false;
         // ▲▲▲ [Perf] ▲▲▲
 
-        const mouseX = (clientX / module.container.clientWidth) * 2 - 1;
-        const mouseY = -(clientY / module.container.clientHeight) * 2 + 1;
+        const viewportMetrics = getCachedViewportMetrics(module);
+        const viewportWidth = Math.max(1, Number(viewportMetrics.width || 0));
+        const viewportHeight = Math.max(1, Number(viewportMetrics.height || 0));
+        const localClientX = Number(clientX || 0) - Number(viewportMetrics.left || 0);
+        const localClientY = Number(clientY || 0) - Number(viewportMetrics.top || 0);
+        const mouseX = (localClientX / viewportWidth) * 2 - 1;
+        const mouseY = -(localClientY / viewportHeight) * 2 + 1;
         const vfov = (module.camera.fov * Math.PI) / 180;
         const viewHeight = 2 * Math.tan(vfov / 2) * module.camera.position.z;
         const viewWidth = viewHeight * module.camera.aspect;
@@ -6332,7 +6395,8 @@ window.MindMapInteractions = (function () {
         module.targetY = newY;
         module._forceUpdateFrames = Math.max(Number(module._forceUpdateFrames || 0), 2);
         module._cameraNavigationForceFrames = Math.max(Number(module._cameraNavigationForceFrames || 0), 2);
-        // ▲▲▲ [Changed] ▲▲▲
+        wakeCameraNavigationAnimation(module, 'wheel-zoom-input');
+        // ▲▲▲ [Changed] ▲▲▲
 
         // ▼▼▼ [Perf] 줌 종료 감지 및 CSS3D 업데이트 타이머 ▼▼▼
         // 기존 타이머 취소 (연속 스크롤 감지)
@@ -6574,8 +6638,7 @@ window.MindMapInteractions = (function () {
             }
         }
 
-        module.pointer.x = (e.clientX / module.container.clientWidth) * 2 - 1;
-        module.pointer.y = -(e.clientY / module.container.clientHeight) * 2 + 1;
+        setPointerFromClientPosition(module, e.clientX, e.clientY);
         module.raycaster.setFromCamera(module.pointer, module.camera);
 
         // Optimization: raycast using the spatial grid
@@ -6819,11 +6882,20 @@ window.MindMapInteractions = (function () {
     }
 
 
-    function onHoverMove(module, e) {
-        // Do not change cursor while the user is panning/dragging/resizing/selecting
-        if (module.isPanning || module.isDraggingNode || module.isDraggingMultipleNodes || module.isResizing || module.isSelecting) {
-            return;
-        }
+    function onHoverMove(module, e) {
+        // Do not run hover raycasts or DOM hit checks while the camera is moving.
+        if (
+            module.isPanning ||
+            module.isZooming ||
+            module._cameraMovingThisFrame === true ||
+            module._viewSyncMotionActive === true ||
+            module.isDraggingNode ||
+            module.isDraggingMultipleNodes ||
+            module.isResizing ||
+            module.isSelecting
+        ) {
+            return;
+        }
 
         // Skip hover checks while dragging the scrollbar
         if (module.isScrollbarDragging) {

package/wwwroot/_content/MindExecution.Shared/js/mind-map-lod-renderer.js

@@ -2903,6 +2903,69 @@
                 (this.imageInstanceData?.nodeIds?.length || 0) > 0;
         }
 
+        canUseUltraResidentCameraOnlyFrame(camera = this._module?.camera, module = this._module) {
+            if (FORCE_RESIDENT_INSTANCES_IN_MID_FAR !== true || !camera || !module) {
+                return false;
+            }
+
+            const cameraZ = Number(camera?.position?.z || 0);
+            const lodBand = getLodBandForCameraZ(cameraZ);
+            if (lodBand !== 'MID' && lodBand !== 'FAR') {
+                return false;
+            }
+
+            if (this.isInLODMode !== true ||
+                this._currentLodBand !== lodBand ||
+                this.isLoading === true ||
+                module.isLoading === true ||
+                this._fullResHandoffActive === true ||
+                module.isDraggingNode === true ||
+                module.isDraggingMultipleNodes === true ||
+                module.isResizing === true ||
+                module.isWindowResizing === true ||
+                this.isDragging === true ||
+                this._hasResidentLodInstances() !== true) {
+                return false;
+            }
+
+            const multiSelectedIds = module?.multiSelectedNodeIds || new Set();
+            const selectedNodeId = module?.selectedNodeIdJs || null;
+            const selectionKey = buildLodSelectionKey(multiSelectedIds, selectedNodeId);
+            if (this._lastAppliedLodSelectionKey !== selectionKey) {
+                return false;
+            }
+
+            const dirtyPositionCount = this._dirtyPositionIds?.size || 0;
+            const pendingSelectionCount = this._pendingSelectionRefreshIds?.size || 0;
+            const imageAtlasQueued = this._imageAtlasQueuedIds?.size || 0;
+            const imageAtlasLoading = this._imageAtlasLoadingIds?.size || 0;
+            const imageAtlasReady = this._imageAtlasBatchReadyIds?.size || 0;
+            const lineDetailRestorePending =
+                ENABLE_INSTANCED_TEXT_LINES === true &&
+                this._lineDetailsPatchPending === true &&
+                lodBand === 'MID';
+
+            return !(
+                this._instancesDirty === true ||
+                this._imageInstancesDirty === true ||
+                this._positionsOnlyDirty === true ||
+                this._isNodeArrayDirty === true ||
+                dirtyPositionCount > 0 ||
+                pendingSelectionCount > 0 ||
+                this._imageAtlasRebuildPending === true ||
+                imageAtlasQueued > 0 ||
+                imageAtlasLoading > 0 ||
+                imageAtlasReady > 0 ||
+                this._imageAtlasBatchActive === true ||
+                this._lodCleanupPending === true ||
+                this._postLoadVisualSyncPending === true ||
+                this._residentRebuildPending === true ||
+                this._deferLineRestorePending === true ||
+                lineDetailRestorePending === true ||
+                this._pendingLodVisibilityVersion >= 0
+            );
+        }
+
         _canRunResidentFullRebuild(reason = 'unknown', lodBand = this._currentLodBand) {
             if (FORCE_RESIDENT_INSTANCES_IN_MID_FAR !== true) {
                 return true;
@@ -5607,7 +5670,8 @@
                             console.log(`[LODRenderer] CSS3D hidden synchronously in ${(performance.now() - hideStart).toFixed(1)}ms (${cssIdsToHide.size} active)`);
                         }
 
-                        if (window.MindMapCss3DManager?.setWillChange) {
+                        if (module?.renderDebugFlags?.enableCss3dWillChange === true &&
+                            window.MindMapCss3DManager?.setWillChange) {
                             window.MindMapCss3DManager.setWillChange(false, module);
                         }
                         this._clearResidentLodCleanupIfStable(lodBand);
@@ -5649,7 +5713,8 @@
                             this._nearEntryBoostFrames = this._getAdaptiveNearEntryBoostFrames(nearVisibleIds?.size || 0, module);
                             this._lodCleanupPending = true;
 
-                            if (window.MindMapCss3DManager?.setWillChange) {
+                            if (module?.renderDebugFlags?.enableCss3dWillChange === true &&
+                                window.MindMapCss3DManager?.setWillChange) {
                                 window.MindMapCss3DManager.setWillChange(true, module);
                             }
                             const tModeEnd = performance.now();
@@ -9469,7 +9534,16 @@
                 return false;
             }
 
-            this._setSingleImageInstanceUvRect(normalizedId, slot.uvRect);
+            const didPatchExistingImageRow = this._setSingleImageInstanceUvRect(normalizedId, slot.uvRect);
+            if (!didPatchExistingImageRow) {
+                const imageRow = this._buildResidentImageInstanceRow(entry);
+                if (!imageRow || !this._applyResidentImageInstanceRow(entry, imageRow)) {
+                    return false;
+                }
+            }
+
+            this._lastAppliedImageAtlasSignature = this._buildImageAtlasPatchSignature();
+            this._pendingImageAtlasPatchSignature = '';
             if (this._module) {
                 this._module._forceUpdateFrames = Math.max(this._module._forceUpdateFrames || 0, 2);
             }

package/wwwroot/_content/MindExecution.Shared/js/mind-map-nodes.js

@@ -1098,6 +1098,58 @@
         return texture;
     }
 
+    function getActiveImageStatusTextureRegistry(module) {
+        const owner = module || window.mindMap || null;
+        if (!owner) {
+            return null;
+        }
+
+        if (!(owner._activeImageStatusTextures instanceof Set)) {
+            owner._activeImageStatusTextures = new Set();
+        }
+
+        return owner._activeImageStatusTextures;
+    }
+
+    function registerActiveImageStatusTexture(module, texture, bodyMesh = null) {
+        const statusInfo = texture?.userData?.mindMapImageStatus;
+        if (!statusInfo || statusInfo.state?.isLoading !== true) {
+            return false;
+        }
+
+        const registry = getActiveImageStatusTextureRegistry(module);
+        if (!registry) {
+            return false;
+        }
+
+        statusInfo.bodyMesh = bodyMesh || null;
+        registry.add(texture);
+        return true;
+    }
+
+    function unregisterActiveImageStatusTexture(module, texture) {
+        if (!texture?.userData?.mindMapImageStatus) {
+            return false;
+        }
+
+        const owner = module || window.mindMap || null;
+        const registry = owner?._activeImageStatusTextures;
+        if (registry instanceof Set) {
+            registry.delete(texture);
+        }
+
+        return true;
+    }
+
+    function isActiveImageStatusTexture(texture) {
+        const statusInfo = texture?.userData?.mindMapImageStatus;
+        return !!(
+            statusInfo &&
+            statusInfo.state?.isLoading === true &&
+            statusInfo.ctx
+        );
+    }
+
     function updateAnimatedImageStatusTexture(texture, now = performance.now()) {
         const statusInfo = texture?.userData?.mindMapImageStatus;
         if (!statusInfo || statusInfo.state?.isLoading !== true || !statusInfo.ctx) {
@@ -1127,30 +1179,38 @@
             return;
         }
 
-        if (!module?.nodeObjectsById?.forEach) {
+        const registry = module?._activeImageStatusTextures;
+        if (!(registry instanceof Set) || registry.size === 0) {
             return;
         }
 
-        module.nodeObjectsById.forEach(nodeEntry => {
-            if (nodeEntry?.model?.contentType !== 'image' || nodeEntry?.glObject?.visible === false) {
-                return;
+        for (const texture of registry) {
+            if (!isActiveImageStatusTexture(texture)) {
+                registry.delete(texture);
+                continue;
+            }
+
+            const bodyMesh = texture.userData?.mindMapImageStatus?.bodyMesh || null;
+            if (bodyMesh?.visible === false) {
+                continue;
             }
 
-            const texture = nodeEntry?.bodyMesh?.material?.map;
             updateAnimatedImageStatusTexture(texture, now);
-        });
+        }
     }
 
-    function swapImageBodyTexture(bodyMesh, nextTexture) {
+    function swapImageBodyTexture(bodyMesh, nextTexture, module = null) {
         const material = bodyMesh?.material;
         if (!material || !nextTexture) {
             return;
         }
 
         const previousTexture = material.map;
+        unregisterActiveImageStatusTexture(module, previousTexture);
         material.map = nextTexture;
         material.color?.setHex?.(0xffffff);
         material.needsUpdate = true;
+        registerActiveImageStatusTexture(module, nextTexture, bodyMesh);
         const nodeId = bodyMesh?.userData?.nodeId;
         if (nodeId) {
             window.mindMap?.invalidateImageLodTexture?.(nodeId);
@@ -1161,13 +1221,14 @@
         }
     }
 
-    function clearImageBodyTexture(bodyMesh, colorHex = 0xffffff) {
+    function clearImageBodyTexture(bodyMesh, colorHex = 0xffffff, module = null) {
         const material = bodyMesh?.material;
         if (!material) {
             return;
         }
 
         const previousTexture = material.map;
+        unregisterActiveImageStatusTexture(module, previousTexture);
         material.map = null;
         material.color?.setHex?.(colorHex);
         material.transparent = false;
@@ -1858,7 +1919,7 @@
                 height);
 
             if (fallbackTexture) {
-                swapImageBodyTexture(bodyMesh, fallbackTexture);
+                swapImageBodyTexture(bodyMesh, fallbackTexture, options.module || window.mindMap || null);
             }
         };
 
@@ -1869,7 +1930,7 @@
             bodyMesh.userData.fullImageRetryAfter = 0;
             bodyMesh.userData.failedImageRenderKey = '';
             bodyMesh.userData.failedImageRetryAfter = 0;
-            clearImageBodyTexture(bodyMesh, 0xf8fafc);
+            clearImageBodyTexture(bodyMesh, 0xf8fafc, options.module || window.mindMap || null);
             return;
         }
 
@@ -1961,7 +2022,7 @@
                 bodyMesh.userData.failedImageRenderKey = '';
                 bodyMesh.userData.failedImageRetryAfter = 0;
                 clearFailedImageUrl(cachedImage.url || imageUrl);
-                swapImageBodyTexture(bodyMesh, nextTexture);
+                swapImageBodyTexture(bodyMesh, nextTexture, options.module || window.mindMap || null);
                 applyImageCoverUv(bodyMesh, width, height);
             })
             .catch(() => {
@@ -2501,7 +2562,7 @@
                 module?.isLoading === true ||
                 module?._bulkAddingNodes === true;
             if (nodeModel.contentType === 'image' && !shouldDeferImageBodyTexture) {
-                syncImageNodeBodyTexture(hitBody, node);
+                syncImageNodeBodyTexture(hitBody, node, { module });
             } else if (nodeModel.contentType === 'image') {
                 prewarmImageNodePreviewCache(node, module);
             }
@@ -2850,8 +2911,16 @@
                 entry.glObject.traverse(child => {
                     if (child.geometry) try { child.geometry.dispose(); } catch { }
                     if (child.material) {
-                        if (Array.isArray(child.material)) child.material.forEach(m => { try { m.dispose(); } catch { } });
-                        else try { child.material.dispose(); } catch { }
+                        if (Array.isArray(child.material)) {
+                            child.material.forEach(m => {
+                                unregisterActiveImageStatusTexture(module, m?.map);
+                                try { m.dispose(); } catch { }
+                            });
+                        }
+                        else {
+                            unregisterActiveImageStatusTexture(module, child.material?.map);
+                            try { child.material.dispose(); } catch { }
+                        }
                     }
                 });
             } catch { }

package/wwwroot/_content/MindExecution.Shared/js/mind-map-text-overlay-v2.js

@@ -127,6 +127,10 @@
             isDomOverlayDebugEnabled(module);
     }
 
+    function isPassiveDomOverlayEnabled() {
+        return PASSIVE_DOM_OVERLAY_ENABLED === true;
+    }
+
     function nowMs() {
         if (typeof performance !== 'undefined' && typeof performance.now === 'function') {
             return performance.now();
@@ -4578,6 +4582,7 @@
         syncPassiveViewTransform: syncPassiveViewTransform,
         setPassiveOverlaySuppressed: setPassiveOverlaySuppressed,
         setMotionHint: setMotionHint,
+        isPassiveDomOverlayEnabled: isPassiveDomOverlayEnabled,
         invalidateNode: invalidateNode,
         invalidateView: invalidateView,
         updateNodePlacement: updateNodePlacement,

package/wwwroot/_content/MindExecution.Shared/js/renderers/CSS3DRenderer.js

@@ -40,8 +40,8 @@
         this.setSize = function(width, height){ _width=width; _height=height; _widthHalf=_width/2; _heightHalf=_height/2; domElement.style.width=width+'px'; domElement.style.height=height+'px'; cameraElement.style.width=width+'px'; cameraElement.style.height=height+'px'; };
         function getCameraCSSMatrix(matrix){ var e=matrix.elements; return 'matrix3d('+epsilon(e[0])+','+epsilon(-e[1])+','+epsilon(e[2])+','+epsilon(e[3])+','+epsilon(e[4])+','+epsilon(-e[5])+','+epsilon(e[6])+','+epsilon(e[7])+','+epsilon(e[8])+','+epsilon(-e[9])+','+epsilon(e[10])+','+epsilon(e[11])+','+epsilon(e[12])+','+epsilon(-e[13])+','+epsilon(e[14])+','+epsilon(e[15])+')'; }
         function getObjectCSSMatrix(matrix){ var e=matrix.elements; var m='matrix3d('+epsilon(e[0])+','+epsilon(e[1])+','+epsilon(e[2])+','+epsilon(e[3])+','+epsilon(-e[4])+','+epsilon(-e[5])+','+epsilon(-e[6])+','+epsilon(-e[7])+','+epsilon(e[8])+','+epsilon(e[9])+','+epsilon(e[10])+','+epsilon(e[11])+','+epsilon(e[12])+','+epsilon(e[13])+','+epsilon(e[14])+','+epsilon(e[15])+')'; return m; }
-        function renderObject(object, scene, camera, cameraCSSMatrix){ if (object.isCSS3DObject){ var style=getObjectCSSMatrix(object.matrixWorld); var element=object.element; var cached=cache.objects.get(object); if (cached===undefined || cached.style!==style){ element.style.webkitTransform=element.style.transform=style; cache.objects.set(object, { style }); } element.style.display = object.visible ? '' : 'none'; if (element.parentNode !== cameraElement){ cameraElement.appendChild(element); } } for (var i=0,l=object.children.length;i<l;i++){ renderObject(object.children[i], scene, camera, cameraCSSMatrix); } }
-        function renderCameraOnly(renderer, camera){ var fov=camera.projectionMatrix.elements[5]*_heightHalf; if (cache.camera.fov!==fov){ renderer.domElement.style.webkitPerspective=renderer.domElement.style.perspective=fov+'px'; cache.camera.fov=fov; } if (camera.parent===null) camera.updateMatrixWorld(); var cameraCSSMatrix='translateZ('+fov+'px)'+getCameraCSSMatrix(camera.matrixWorldInverse); var style=cameraCSSMatrix+'translate('+_widthHalf+'px,'+_heightHalf+'px)'; if (cache.camera.style!==style){ cameraElement.style.webkitTransform=cameraElement.style.transform=style; cache.camera.style=style; } return cameraCSSMatrix; }
+        function renderObject(object, scene, camera, cameraCSSMatrix){ if (object.isCSS3DObject){ var style=getObjectCSSMatrix(object.matrixWorld); var display=object.visible ? '' : 'none'; var element=object.element; var cached=cache.objects.get(object); if (cached===undefined || cached.style!==style){ element.style.webkitTransform=element.style.transform=style; } if (cached===undefined || cached.display!==display){ element.style.display=display; } if (cached===undefined || cached.style!==style || cached.display!==display){ cache.objects.set(object, { style, display }); } if (element.parentNode !== cameraElement){ cameraElement.appendChild(element); } } for (var i=0,l=object.children.length;i<l;i++){ renderObject(object.children[i], scene, camera, cameraCSSMatrix); } }
+        function renderCameraOnly(renderer, camera){ var fov=camera.projectionMatrix.elements[5]*_heightHalf; if (cache.camera.fov!==fov){ renderer.domElement.style.webkitPerspective=renderer.domElement.style.perspective=fov+'px'; cache.camera.fov=fov; } if (camera.parent===null && camera.matrixWorldNeedsUpdate===true) camera.updateMatrixWorld(); var cameraCSSMatrix='translateZ('+fov+'px)'+getCameraCSSMatrix(camera.matrixWorldInverse); var style=cameraCSSMatrix+'translate('+_widthHalf+'px,'+_heightHalf+'px)'; if (cache.camera.style!==style){ cameraElement.style.webkitTransform=cameraElement.style.transform=style; cache.camera.style=style; } return cameraCSSMatrix; }
         this.renderCamera = function(camera){ renderCameraOnly(this, camera); };
         this.render = function(scene, camera){ if (scene.autoUpdate===true) scene.updateMatrixWorld(); var cameraCSSMatrix=renderCameraOnly(this, camera); renderObject(scene, scene, camera, cameraCSSMatrix); };
     }