@mindexec/cli 0.2.479 → 0.2.481

package/electron/main.cjs

@@ -304,6 +304,10 @@ function initializeProductUpdates() {
   });
 }
 
+function getDesktopWindowTitle() {
+  return `MindExec ${app.getVersion()}`;
+}
+
 function createMainWindow() {
   const hiddenSmokeMode = process.env.MINDEXEC_DESKTOP_SMOKE === '1';
   const window = new BrowserWindow({
@@ -314,7 +318,7 @@ function createMainWindow() {
     show: !hiddenSmokeMode,
     autoHideMenuBar: true,
     backgroundColor: '#f8fafc',
-    title: 'MindExec',
+    title: getDesktopWindowTitle(),
     icon: resolveDesktopIconPath(),
     webPreferences: {
       preload: path.join(__dirname, 'preload.cjs'),
@@ -325,6 +329,11 @@ function createMainWindow() {
     }
   });
 
+  window.on('page-title-updated', (event) => {
+    event.preventDefault();
+    window.setTitle(getDesktopWindowTitle());
+  });
+
   window.webContents.setWindowOpenHandler(() => ({
     action: 'allow',
     overrideBrowserWindowOptions: {
@@ -446,6 +455,7 @@ async function launchDesktop() {
       appVersion: app.getVersion(),
       bridgeVersion: status.version || null,
       runtimeMode: 'bundled',
+      windowTitle: window.getTitle(),
       bridgePort: activeBridgePort,
       remoteHubPort: activeRemoteHubPort,
       workspace: activeWorkspace,

package/electron/source-smoke.mjs

@@ -15,7 +15,14 @@ const serverSource = fs.readFileSync(path.join(packageRoot, 'server.js'), 'utf8'
 
 assert.equal(packageJson.build?.appId, 'com.mindexec.desktop', 'Stable desktop appId is required.');
 assert.equal(packageJson.build?.productName, 'MindExec', 'Desktop product name changed unexpectedly.');
-assert.match(mainSource, /title:\s*'MindExec'/, 'The Electron window title must use the MindExec app brand.');
+assert.match(mainSource, /function getDesktopWindowTitle\(\)/,
+  'The Electron window title must derive from one version-aware helper.');
+assert.match(mainSource, /`MindExec \$\{app\.getVersion\(\)\}`/,
+  'The Electron window title must show the packaged app version.');
+assert.match(mainSource, /title:\s*getDesktopWindowTitle\(\)/,
+  'The initial Electron window title must use the version-aware title.');
+assert.match(mainSource, /page-title-updated[\s\S]{0,220}preventDefault\(\)[\s\S]{0,220}setTitle\(getDesktopWindowTitle\(\)\)/,
+  'Blazor page titles must not replace the version-aware desktop title.');
 assert.equal(packageJson.build?.extraMetadata?.main, 'electron/main.cjs', 'Packaged Electron entry point is missing.');
 assert.equal(packageJson.build?.asar, false, 'Bundled runtime executables require an unpacked app directory.');
 assert.ok(packageJson.files?.includes('electron/'), 'The npm package must include the Electron source contract.');

package/electron/windows-package-smoke.mjs

@@ -126,6 +126,8 @@ try {
   assert.equal(result.appVersion, packageJson.version, 'Electron app version does not match the npm package version.');
   assert.equal(result.bridgeVersion, packageJson.version, 'Bundled LocalBridge version does not match Electron.');
   assert.equal(result.runtimeMode, 'bundled', 'Electron did not use its bundled runtime.');
+  assert.equal(result.windowTitle, `MindExec ${packageJson.version}`,
+    'Packaged Electron did not keep the version visible in the title bar.');
   assert.equal(result.bridgePort, bridgePort, 'Packaged shell did not use the requested Bridge port.');
   assert.equal(result.remoteHubPort, remoteHubPort, 'Packaged shell did not use the requested RemoteHub port.');
   assert.equal(path.resolve(result.workspace), path.resolve(workspace), 'Packaged Electron did not restore the saved workspace.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindexec/cli",
-  "version": "0.2.479",
+  "version": "0.2.481",
   "description": "MindExec local runtime and bridge CLI",
   "main": "server.js",
   "type": "module",

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

@@ -5,7 +5,7 @@
     const DEBUG = false;
     const FPS_DEBUG = false;
     const FRAME_PERF_DEBUG = false;
-    const MINDMAP_CORE_BUILD_ID = '20260822-particle-60fps-motion-v872';
+    const MINDMAP_CORE_BUILD_ID = '20260824-css3d-viewport-owner-v873';
     const CanvasPhase = Object.freeze({
         Booting: 'booting',
         BoardFileLoading: 'board-file-loading',
@@ -2325,13 +2325,19 @@
                 isSelected,
                 isOnScreen,
                 isVisibleInFrustum: entry.isVisibleInFrustum !== false,
-                cssVisible: entry.currentType === 'CSS'
-                    && entry.cssObject?.visible !== false
+                cssVisible: !!entry.cssObject && !!wrapperElement
+                    && entry.cssObject.visible !== false
                     && wrapperElement?.style?.display !== 'none',
                 glVisible: entry.glObject ? entry.glObject.visible !== false : false,
                 bodyVisible: entry.bodyMesh ? entry.bodyMesh.visible !== false : false,
-                cssVisibleWithGlRenderableOverlap: entry.currentType === 'CSS'
-                    && entry.cssObject?.visible !== false
+                domVisibleWhileCurrentTypeGl: entry.currentType === 'GL'
+                    && !!entry.cssObject
+                    && !!wrapperElement
+                    && entry.cssObject.visible !== false
+                    && wrapperElement?.style?.display !== 'none',
+                cssVisibleWithGlRenderableOverlap: !!entry.cssObject
+                    && !!wrapperElement
+                    && entry.cssObject.visible !== false
                     && wrapperElement?.style?.display !== 'none'
                     && visibleGlRenderables.length > 0,
                 visibleGlRenderableCount: visibleGlRenderables.length,
@@ -4617,6 +4623,10 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                             // This avoids unnecessary heavy stabilization/LOD work on same-size tab return.
                             if (!sizeUnchanged) {
                                 MindMapInteractions.onResize(this);
+                            } else {
+                                MindMapInteractions.syncViewportMetrics?.(this, {
+                                    reason: 'same-size-route-reentry'
+                                });
                             }
 
                             if (this.lodRenderer) {
@@ -7166,6 +7176,13 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                     shouldUpdateCss3d &&
                     canUseCss3dCameraFastPath !== true;
                 if (shouldRenderCss3dFrame) {
+                    const viewportRepaired = window.MindMapInteractions?.syncViewportBeforeFullCssRender?.(
+                        this,
+                        'main-full-css3d-render'
+                    ) === true;
+                    if (viewportRepaired) {
+                        this.renderer?.render?.(this.scene, this.camera);
+                    }
                     // Fix browser scroll jitter
                     const cssEl = this.cssRenderer.domElement;
                     if (cssEl.scrollTop !== 0 || cssEl.scrollLeft !== 0) {
@@ -7836,7 +7853,8 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                         window.MindMapInteractions.syncViewportMetrics(this, {
                             force,
                             hideDuringResize: false,
-                            scheduleReveal: false
+                            scheduleReveal: false,
+                            reason: 'canvas-show'
                         });
                     }
 
@@ -8119,6 +8137,10 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             const liveNodeCount = Number(this.nodeObjectsById?.size || 0);
 
             try {
+                window.MindMapInteractions?.syncViewportBeforeFullCssRender?.(
+                    this,
+                    'project-thumbnail-capture'
+                );
                 this.camera.updateProjectionMatrix?.();
                 this.camera.updateMatrixWorld?.(true);
                 if (typeof this.updateVisibility === 'function') {

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

@@ -307,11 +307,33 @@ window.MindMapInteractions = (function () {
         return getViewportMetrics(module);
     }
 
+    function getCssRendererViewportSize(module) {
+        const size = module?.cssRenderer?.getSize?.() || null;
+        return {
+            width: Math.max(0, Number(size?.width || 0)),
+            height: Math.max(0, Number(size?.height || 0))
+        };
+    }
+
+    function isCssRendererViewportSizeStale(module, metrics) {
+        if (!module?.cssRenderer || !metrics) {
+            return false;
+        }
+
+        const rendererSize = getCssRendererViewportSize(module);
+        return Math.abs(rendererSize.width - metrics.width) > 1 ||
+            Math.abs(rendererSize.height - metrics.height) > 1;
+    }
+
     function haveViewportMetricsChanged(module, metrics, force = false) {
         if (force) {
             return true;
         }
 
+        if (isCssRendererViewportSizeStale(module, metrics)) {
+            return true;
+        }
+
         const lastWidth = Number(module?._lastViewportWidth || 0);
         const lastHeight = Number(module?._lastViewportHeight || 0);
         const lastLeft = Number(module?._lastViewportLeft || 0);
@@ -387,6 +409,7 @@ window.MindMapInteractions = (function () {
         let frameCount = 0;
         const stabilizeFrames = () => {
             if (module.scene && module.camera) {
+                syncViewportBeforeFullCssRender(module, 'viewport-reveal');
                 module.renderer?.render?.(module.scene, module.camera);
                 module.cssRenderer?.render?.(module.cssScene || module.scene, module.camera);
             }
@@ -422,7 +445,9 @@ window.MindMapInteractions = (function () {
         const {
             force = false,
             hideDuringResize = false,
-            scheduleReveal = false
+            scheduleReveal = false,
+            warmCaches = true,
+            reason = 'viewport-metrics-change'
         } = options;
 
         const metrics = getViewportMetrics(module);
@@ -430,13 +455,16 @@ window.MindMapInteractions = (function () {
             return false;
         }
 
+        const previousCssRendererSize = getCssRendererViewportSize(module);
+        const cssRendererViewportWasStale = isCssRendererViewportSizeStale(module, metrics);
         if (!haveViewportMetricsChanged(module, metrics, force)) {
             return false;
         }
 
         const prevWidth = Number(module._lastViewportWidth || 0);
         const prevHeight = Number(module._lastViewportHeight || 0);
-        const sizeChanged = force || metrics.width !== prevWidth || metrics.height !== prevHeight;
+        const sizeChanged = force || cssRendererViewportWasStale ||
+            metrics.width !== prevWidth || metrics.height !== prevHeight;
 
         storeViewportMetrics(module, metrics);
 
@@ -470,7 +498,19 @@ window.MindMapInteractions = (function () {
             module.targetZ = module.camera.position.z;
         }
 
-        if (sizeChanged && scheduleReveal) {
+        if (cssRendererViewportWasStale) {
+            window.MindCanvasTrace?.emit?.('renderer.viewport.repaired', {
+                reason,
+                previousWidth: previousCssRendererSize.width,
+                previousHeight: previousCssRendererSize.height,
+                width: metrics.width,
+                height: metrics.height
+            });
+        }
+
+        if (warmCaches !== true) {
+            module._forceUpdateFrames = Math.max(Number(module._forceUpdateFrames || 0), 1);
+        } else if (sizeChanged && scheduleReveal) {
             resizeEndTimer = setTimeout(() => {
                 warmViewportCaches(module);
                 revealViewportCanvases(module);
@@ -482,6 +522,15 @@ window.MindMapInteractions = (function () {
         return true;
     }
 
+    function syncViewportBeforeFullCssRender(module, reason = 'full-css3d-render') {
+        return syncViewportMetrics(module, {
+            hideDuringResize: false,
+            scheduleReveal: false,
+            warmCaches: false,
+            reason
+        });
+    }
+
     function syncTextOverlaysNow(module) {
         if (!module) {
             return;
@@ -499,6 +548,7 @@ window.MindMapInteractions = (function () {
 
         if (module.cssRenderer && isCss3dEnabled && shouldRenderCss3dInLod) {
             try {
+                const viewportRepaired = syncViewportBeforeFullCssRender(module, 'immediate-css3d-sync');
                 if (isCss3dTransformSyncEnabled) {
                     window.MindMapCss3DManager?.update?.(module);
                 }
@@ -507,6 +557,9 @@ window.MindMapInteractions = (function () {
                     if (cssEl.scrollTop !== 0) cssEl.scrollTop = 0;
                     if (cssEl.scrollLeft !== 0) cssEl.scrollLeft = 0;
                 }
+                if (viewportRepaired) {
+                    module.renderer?.render?.(module.scene, module.camera);
+                }
                 module.cssRenderer.render(module.cssScene || module.scene, module.camera);
             } catch (error) {
                 console.warn('[MindMapInteractions] Immediate CSS3D sync failed:', error);
@@ -1346,17 +1399,32 @@ window.MindMapInteractions = (function () {
     }
 
     // ▼▼▼ [New] Helper to clean up an in-progress edit node ▼▼▼
-    /**
-     * Checks whether there is a node currently being edited in CSS3D mode.
-     * If found, switches it back to WebGL.
-     * Called when the user clicks the background or presses Escape.
-     */
-    function cleanupCss3dNode(module) {
+    /**
+     * Checks whether there is a node currently being edited in CSS3D mode.
+     * If found, commits it and releases ordinary MID/FAR nodes to resident rendering.
+     * Called when the user clicks the background or presses Escape.
+     */
+    function shouldReleaseCss3dOwnershipToResident(module, entry) {
+        if (!module?.lodRenderer || !entry) {
+            return false;
+        }
+
+        const cameraZ = Number(module.camera?.position?.z || 0);
+        const lodThreshold = Number(
+            window.LODRenderer?.LOD_THRESHOLDS?.MID ??
+            window.LODRenderer?.LOD_THRESHOLD_NEAR ??
+            9000
+        );
+        const isLivePortalCssNode =
+            window.LODRenderer?.isLivePortalCssLodModel?.(entry.model) === true;
+        return cameraZ >= lodThreshold && isLivePortalCssNode !== true;
+    }
+
+    function cleanupCss3dNode(module, preferredNodeId = null) {
         if (!module || !module.nodeObjectsById || !isTextInteractionActive(module)) return;
-
-        // // [Cleanup] 선택된 노드가 있으면 우선 정리 (전체 순회 최소화)
-        const activeId = module.selectedNodeIdJs;
-        const isHighMode = (module.camera?.position?.z || 0) < 5000;
+
+        // Commit the node that owned the interaction before selection state changes.
+        const activeId = preferredNodeId || module.selectedNodeIdJs;
 
         const processCleanup = (nodeId) => {
             const entry = module.nodeObjectsById.get(nodeId);
@@ -1441,22 +1509,13 @@ window.MindMapInteractions = (function () {
                 }
             }
 
-            if (!isHighMode && entry.currentType === 'CSS') {
-                console.log(`[Interactions] Cleaning up CSS3D node ${nodeId} due to background click or Escape key.`);
-                window.MindMapNodes.switchToWebGL(module, nodeId);
-            }
-
-            // ▼▼▼ [FIX] 편집 종료 후 LOD 시스템에 상태 변경 알림 ▼▼▼
-            entry.isCssDirty = true;
+            // ▼▼▼ [FIX] 편집 종료 후 LOD 시스템에 상태 변경 알림 ▼▼▼
+            entry.isCssDirty = true;
 
-            // LOD 모드(MID/FAR)인 경우 CSS3D를 즉시 숨김
-            const cameraZ = module.camera?.position?.z || 0;
-            const lodThreshold = Number(window.LODRenderer?.LOD_THRESHOLDS?.MID ?? window.LODRenderer?.LOD_THRESHOLD_NEAR ?? 12000);
-            const isInLodMode = cameraZ >= lodThreshold;
-
-            if (isInLodMode && module.lodRenderer) {
+            if (shouldReleaseCss3dOwnershipToResident(module, entry)) {
                 // CSS3D 즉시 숨김
                 module.lodRenderer._hideNodeCss3d(entry);
+                module.lodRenderer._hideGlBodyOnly?.(entry);
 
                 // 인스턴스 데이터 재빌드 트리거
                 module.lodRenderer.requestResidentPatch?.('update-node', nodeId);
@@ -1478,8 +1537,8 @@ window.MindMapInteractions = (function () {
             }
         }
 
-        // HIGH 모드에서는 CSS3D 유지, LOW 모드에서는 WebGL 전환 완료
-        module.isEditingNote = false;
+        // Full-res keeps CSS3D ownership; MID/FAR releases it to the resident renderer.
+        module.isEditingNote = false;
     }
     // ▲▲▲ [New] ▲▲▲
 
@@ -3352,19 +3411,6 @@ window.MindMapInteractions = (function () {
         });
         module._embedInteractivityNodeIds = selectedIds;
     }
-    function switchPreviousSelectedNoteToWebGL(module, respectHighMode = true) {
-        if (!module?.selectedNodeIdJs) return;
-        const prevEntry = module.nodeObjectsById?.get(module.selectedNodeIdJs);
-        if (!prevEntry || prevEntry.model.contentType !== 'note') return;
-
-        if (respectHighMode) {
-            const cameraZ = module.camera?.position?.z || 0;
-            if (cameraZ < 5000) return; // HIGH 모드에서는 CSS3D 유지
-        }
-
-        window.MindMapNodes.switchToWebGL(module, module.selectedNodeIdJs);
-    }
-
     function setSingleSelection(module, nodeId, notifyBlazor = true) {
         if (MindMapNodes.applySingleSelection) {
             MindMapNodes.applySingleSelection(module, nodeId, { notifyBlazor, bringToFront: true });
@@ -3500,10 +3546,6 @@ window.MindMapInteractions = (function () {
         }
 
         schedulePrimaryClickAction(module, () => {
-            if (module.selectedNodeIdJs && module.selectedNodeIdJs !== nodeId) {
-                switchPreviousSelectedNoteToWebGL(module, false);
-            }
-
             if (!isMultiSelecting) {
                 window.MindMapNodes?.bringNodeToFront?.(module, nodeId);
             }
@@ -3871,38 +3913,17 @@ window.MindMapInteractions = (function () {
             return;
         }
 
-        // Security: before starting a non-panning interaction, switch any editing (CSS3D) nodes back to WebGL
-        // Only do this for node drag, selection box, background click, etc.
-        // ▼▼▼ [Changed] HIGH 모드(cameraZ < 4000)에서는 CSS3D 유지 ▼▼▼
-        if (module.isEditingNote) {
-            const cameraZ = module.camera?.position?.z || 0;
-            const isHighMode = cameraZ < 5000;
-
-            // ▼▼▼ [Fix] 편집 중인 노드(테두리, 리사이즈 핸들 등) 조작 시 편집 모드 유지 ▼▼▼
-            const targetNode = target.closest?.('[data-node-id]');
-            const clickedId = targetNode?.dataset?.nodeId;
-            const isSelf = (clickedId && clickedId === module.selectedNodeIdJs);
-
-            if (isSelf) {
-                // 편집 모드 유지 (리사이즈 등을 위해)
-            } else {
-                if (!isHighMode) {
-                    // LOW 모드에서만 WebGL로 전환
-                    module.nodeObjectsById.forEach((entry, nodeId) => {
-                        if (entry.currentType === 'CSS') {
-                            console.warn(`[Interactions] Force-switching node ${nodeId} from CSS back to WebGL (LOW mode).`);
-                            window.MindMapNodes.switchToWebGL(module, nodeId);
-                        }
-                    });
-                } else {
-                    console.log(`[Interactions] HIGH mode - keeping CSS3D (cameraZ=${cameraZ.toFixed(0)})`);
-                }
-                module.isEditingNote = false;
-            }
-            // ▲▲▲ [Fix] ▲▲▲
-        }
-        // ▲▲▲ [Changed] ▲▲▲
-        // --- end security switch-back ---
+        // Editing ownership is committed by cleanupCss3dNode(). Selection itself
+        // must not switch a canonical full-res CSS3D node to WebGL.
+        if (module.isEditingNote) {
+            const targetNode = target.closest?.('[data-node-id]');
+            const clickedId = targetNode?.dataset?.nodeId;
+            const isSelf = (clickedId && clickedId === module.selectedNodeIdJs);
+
+            if (!isSelf) {
+                module.isEditingNote = false;
+            }
+        }
 
         // Security: when mouse-down starts, explicitly reset any previous interaction state
         // A prior interaction may not have completed; reset before starting a new one
@@ -4175,10 +4196,7 @@ window.MindMapInteractions = (function () {
                                 nodeEntry.cssObject.element.style.pointerEvents = 'none';
                             }
 
-                            if (module.selectedNodeIdJs) {
-                                switchPreviousSelectedNoteToWebGL(module, true);
-                            }
-                            setSingleSelection(module, clickedNodeId, true);
+                            setSingleSelection(module, clickedNodeId, true);
                         }
                         // ▲▲▲ [Fix] ▲▲▲
                     }
@@ -4610,7 +4628,6 @@ window.MindMapInteractions = (function () {
 
                 // 기존 선택된 노드가 있다면 해제 (단일 선택 모드 전환)
                 if (!isMultiModifier && (module.selectedNodeIdJs || module.multiSelectedNodeIds.size > 0)) {
-                    // switchPreviousSelectedNoteToWebGL(module, true); // clearSelectionState 내부에서 처리되거나 필요 없음
                     clearSelectionState(module, { notifyBlazor: true, hideMenu: true, hideMultiSelect: true });
                 }
 
@@ -5117,11 +5134,10 @@ window.MindMapInteractions = (function () {
 
                 if (shouldRunBackgroundPrimaryClick) {
                     schedulePrimaryClickAction(module, () => {
+                        // Commit/release the interaction owner before clearing the selection id.
+                        cleanupCss3dNode(module, oldSelectedNodeId);
                         clearSelectionState(module, { notifyBlazor: true, hideMenu: true, hideMultiSelect: true });
 
-                        // Use cleanupCss3dNode instead of blurActiveEditable
-                        cleanupCss3dNode(module);
-
                         // Blur global-input-textarea (and other focused inputs)
                         if (document.activeElement && (document.activeElement.tagName === 'TEXTAREA' || document.activeElement.tagName === 'INPUT')) {
                             // Use helper defined in index.html
@@ -5161,19 +5177,6 @@ window.MindMapInteractions = (function () {
                 }
             }
 
-            if (oldSelectedNodeId && module.selectedNodeIdJs !== oldSelectedNodeId) {
-                const prevEntry = module.nodeObjectsById.get(oldSelectedNodeId);
-                if (prevEntry && prevEntry.model.contentType === 'note') {
-                    // ▼▼▼ [Changed] HIGH 모드에서는 WebGL 전환 스킵 ▼▼▼
-                    const cameraZ = module.camera?.position?.z || 0;
-                    const isHighMode = cameraZ < 5000;
-                    if (!isHighMode) {
-                        MindMapNodes.switchToWebGL(module, oldSelectedNodeId);
-                    }
-                    // ▲▲▲ [Changed] ▲▲▲
-                }
-            }
-
         }
         // 4) Stop single-node drag
         else if (module.isDraggingNode && module.draggedNodeObject) {
@@ -5239,10 +5242,6 @@ window.MindMapInteractions = (function () {
                         }
                     } else {
                         schedulePrimaryClickAction(module, () => {
-                            if (module.selectedNodeIdJs && module.selectedNodeIdJs !== clickedNodeId) {
-                                switchPreviousSelectedNoteToWebGL(module, false);
-                            }
-
                             if (isMultiSelecting) {
                                 if (module.multiSelectedNodeIds.has(clickedNodeId)) {
                                     module.multiSelectedNodeIds.delete(clickedNodeId);
@@ -5361,10 +5360,6 @@ window.MindMapInteractions = (function () {
                             }
                         } else {
                             schedulePrimaryClickAction(module, () => {
-                                if (module.selectedNodeIdJs && module.selectedNodeIdJs !== clickedNodeId) {
-                                    switchPreviousSelectedNoteToWebGL(module, false);
-                                }
-
                                 if (isMultiSelecting) {
                                     if (module.multiSelectedNodeIds.has(clickedNodeId)) {
                                         module.multiSelectedNodeIds.delete(clickedNodeId);
@@ -7637,14 +7632,12 @@ window.MindMapInteractions = (function () {
                 // 성능 저하를 유발하는 문제 해결
                 nodeEntry.isCssDirty = true; // CSS3D 콘텐츠 재동기화 필요 표시
 
-                // LOD 모드(MID/FAR)인 경우 CSS3D를 즉시 숨김
-                const cameraZ = module.camera?.position?.z || 0;
-                const lodThreshold = Number(window.LODRenderer?.LOD_THRESHOLDS?.MID ?? window.LODRenderer?.LOD_THRESHOLD_NEAR ?? 12000);
-                const isInLodMode = cameraZ >= lodThreshold;
-
-                if (isInLodMode && module.lodRenderer) {
+                const cameraZ = module.camera?.position?.z || 0;
+
+                if (shouldReleaseCss3dOwnershipToResident(module, nodeEntry)) {
                     // CSS3D 즉시 숨김
                     module.lodRenderer._hideNodeCss3d(nodeEntry);
+                    module.lodRenderer._hideGlBodyOnly?.(nodeEntry);
 
                     // 인스턴스 데이터 재빌드 트리거
                     module.lodRenderer.requestResidentPatch?.('update-node', nodeEntry.model?.id || nodeEntry.model?.Id);
@@ -7844,6 +7837,7 @@ window.MindMapInteractions = (function () {
         },
         onResize: onResize,
         syncViewportMetrics: syncViewportMetrics,
+        syncViewportBeforeFullCssRender: syncViewportBeforeFullCssRender,
         // ▼▼▼ [New] Expose selectNode and startEditingNode ▼▼▼
         selectNodeById: function (module, nodeId, options = {}) {
             const normalizedId = String(nodeId || '').trim();

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

@@ -51,7 +51,7 @@
     // ▲▲▲ [Usage] ▲▲▲
 
     // Procedural line rendering settings
-    const LOD_RENDERER_BUILD_ID = '20260728-resident-cache-v848';
+    const LOD_RENDERER_BUILD_ID = '20260824-css3d-owner-v849';
     const DirtyKind = Object.freeze({
         ResidentFullRebuild: 'resident-full-rebuild',
         ResidentPatch: 'resident-patch',
@@ -10263,6 +10263,8 @@
     window.LODRenderer.LOD_THRESHOLDS = { ...LOD_THRESHOLDS };
     window.LODRenderer.LOD_THRESHOLD_FAR = LOD_THRESHOLD_FAR;
     window.LODRenderer.LOD_THRESHOLD_NEAR = LOD_THRESHOLD_NEAR;
+    window.LODRenderer.supportsCss3dNodeModel = supportsCss3dNodeModel;
+    window.LODRenderer.isLivePortalCssLodModel = isLivePortalCssLodModel;
     window.LODRenderer.DIRTY_KIND = DirtyKind;
     window.LODRenderer.DEBUG_CONSTANTS = {
         build: LOD_RENDERER_BUILD_ID,

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

@@ -105,7 +105,7 @@
 
         const cameraZ = Number(module?.camera?.position?.z ?? module?.targetZ ?? 0);
         const thresholds = window.LODRenderer?.LOD_THRESHOLDS || null;
-        const midThreshold = Number(thresholds?.MID ?? window.LODRenderer?.LOD_THRESHOLD_NEAR ?? 4500);
+        const midThreshold = Number(thresholds?.MID ?? window.LODRenderer?.LOD_THRESHOLD_NEAR ?? 9000);
         if (Number.isFinite(cameraZ) && Number.isFinite(midThreshold) && cameraZ >= midThreshold) {
             return false;
         }
@@ -4329,27 +4329,25 @@
             return;
         }
 
-        // ▼▼▼ [Changed] HIGH 모드(CSS3D 유효 구간)에서는 WebGL로 전환 금지 ▼▼▼
-        const cameraZ = module.camera?.position?.z || 0;
-        const threshold = 4000;
-        if (cameraZ < threshold) {
-            const supportsCss3d = nodeEntry.model.contentType === 'text' ||
-                nodeEntry.model.contentType === 'note' ||
-                nodeEntry.model.contentType === 'memo' ||
-                nodeEntry.model.contentType === 'markdown' ||
-                nodeEntry.model.contentType === 'code' ||
-                nodeEntry.model.contentType === 'csv-table' ||
-                nodeEntry.model.contentType === 'image' ||
-                nodeEntry.model.contentType === 'video' ||
-                nodeEntry.model.contentType === 'embed';
-            if (supportsCss3d) {
-                console.log(`[MindMapNodes] SwitchToWebGL(${nodeId}) SKIPPED (HIGH Mode - Keeping CSS3D).`);
-                return;
-            }
+        const cameraZ = Number(module.camera?.position?.z || 0);
+        const midThreshold = Number(
+            window.LODRenderer?.LOD_THRESHOLDS?.MID ??
+            window.LODRenderer?.LOD_THRESHOLD_NEAR ??
+            9000
+        );
+        const isLivePortalCssNode =
+            window.LODRenderer?.isLivePortalCssLodModel?.(nodeEntry.model) === true;
+
+        // Renderer ownership follows the canonical LOD band, not selection.
+        // NEAR/NORMAL and live portal nodes keep their CSS3D source mounted.
+        if (cameraZ < midThreshold || isLivePortalCssNode) {
+            return;
         }
-        // ▲▲▲ [Changed] ▲▲▲
 
-        if (nodeEntry.currentType === 'GL') {
+        const cssElement = nodeEntry.cssObject?.element || null;
+        const hasVisibleCssOwnership = nodeEntry.cssObject?.visible === true ||
+            (!!nodeEntry.cssObject?.parent && cssElement?.style?.display !== 'none');
+        if (nodeEntry.currentType === 'GL' && !hasVisibleCssOwnership) {
             flushPendingGlRenderOrder(module, nodeEntry);
             log(`[MindMapNodes] SwitchToWebGL(${nodeId}) SKIPPED (Already in GL mode).`);
             return;
@@ -4407,8 +4405,18 @@
 
         const cssPos = nodeEntry.cssObject.position;
         // [Fix] Force Z=0 to eliminate parallax
-        nodeEntry.glObject.position.set(cssPos.x, cssPos.y, 0);
-        if (nodeEntry.glObject) {
+        nodeEntry.glObject?.position?.set?.(cssPos.x, cssPos.y, 0);
+        let ownershipReleased = false;
+        if (module.lodRenderer?._hideNodeCss3d) {
+            module.lodRenderer._hideNodeCss3d(nodeEntry);
+            module.lodRenderer._hideGlBodyOnly?.(nodeEntry);
+            module.lodRenderer.requestVisualRefresh?.('css3d-owner-release');
+            ownershipReleased = true;
+        } else if (nodeEntry.glObject) {
+            nodeEntry.cssObject.visible = false;
+            if (cssElement) {
+                cssElement.style.display = 'none';
+            }
             ensureNodeMeshCache(nodeEntry);
             nodeEntry.glObject.visible = true;
             const body = nodeEntry.bodyMesh;
@@ -4416,12 +4424,31 @@
             if (body) body.visible = true;
             if (tail) tail.visible = true;
             setNodeScrollbarVisibility(nodeEntry, Number(nodeEntry.model?.maxScroll || 0) > 0);
+            ownershipReleased = true;
+        }
+
+        if (!ownershipReleased) {
+            warn(`[MindMapNodes] SwitchToWebGL(${nodeId}) deferred: no resident or WebGL owner is available.`);
+            return;
         }
 
         nodeEntry.currentType = 'GL';
+        module._forceUpdateFrames = Math.max(Number(module._forceUpdateFrames || 0), 1);
         log(`[MindMapNodes]   ✓ Node ${nodeId} is now in WebGL mode`);
 
         await updateNodeContent(module, nodeId, nodeEntry.model.response, nodeEntry.model.width, nodeEntry.model.height);
+
+        const cssDomStillVisible = nodeEntry.cssObject?.visible === true ||
+            (!!nodeEntry.cssObject?.parent && cssElement?.style?.display !== 'none');
+        window.MindCanvasDevGuards?.assert?.(
+            cssDomStillVisible !== true,
+            'renderer-css3d-gl-owner-overlap',
+            {
+                nodeId,
+                cameraZ,
+                currentType: nodeEntry.currentType
+            }
+        );
     }
 
     // ▼▼▼ [New] Update node content type (used for converting text to note) ▼▼▼

package/wwwroot/_framework/blazor.boot.json

@@ -1,7 +1,7 @@
 {
   "mainAssemblyName": "MindExecution.Web",
   "resources": {
-    "hash": "sha256-qpH6Ma5NxLdwrBBJ/L3iPc/2zG1coZJYk6xkFeHu1yM=",
+    "hash": "sha256-mXWbB+r0wD5ixhld4+MKtYH4yPbQ7mRkmT7v8rgb2+E=",
     "fingerprinting": {
       "Google.Protobuf.9h59ukbel7.dll": "Google.Protobuf.dll",
       "Markdig.d1j7v41cl1.dll": "Markdig.dll",
@@ -122,16 +122,16 @@
       "System.brmz7yk5qh.dll": "System.dll",
       "netstandard.b50t77veor.dll": "netstandard.dll",
       "System.Private.CoreLib.wflwsce1yq.dll": "System.Private.CoreLib.dll",
-      "MindExecution.Core.xxsj2s456b.dll": "MindExecution.Core.dll",
-      "MindExecution.Kernel.5jofnc0wrd.dll": "MindExecution.Kernel.dll",
-      "MindExecution.Plugins.Admin.t7m4jnqjg3.dll": "MindExecution.Plugins.Admin.dll",
-      "MindExecution.Plugins.Business.6yjlhhavap.dll": "MindExecution.Plugins.Business.dll",
-      "MindExecution.Plugins.Concept.iikqq5zxu0.dll": "MindExecution.Plugins.Concept.dll",
-      "MindExecution.Plugins.Directory.c5ribyne4m.dll": "MindExecution.Plugins.Directory.dll",
-      "MindExecution.Plugins.PlanMaster.365bbuifr9.dll": "MindExecution.Plugins.PlanMaster.dll",
-      "MindExecution.Plugins.YouTube.ax415cilpk.dll": "MindExecution.Plugins.YouTube.dll",
-      "MindExecution.Shared.21e2nvf86u.dll": "MindExecution.Shared.dll",
-      "MindExecution.Web.ppgm8rey59.dll": "MindExecution.Web.dll",
+      "MindExecution.Core.2r5s0vx16i.dll": "MindExecution.Core.dll",
+      "MindExecution.Kernel.8y4azlvjyi.dll": "MindExecution.Kernel.dll",
+      "MindExecution.Plugins.Admin.dtzk93cn6n.dll": "MindExecution.Plugins.Admin.dll",
+      "MindExecution.Plugins.Business.uyqiv67u0q.dll": "MindExecution.Plugins.Business.dll",
+      "MindExecution.Plugins.Concept.5w50lskzj6.dll": "MindExecution.Plugins.Concept.dll",
+      "MindExecution.Plugins.Directory.a8isl4htud.dll": "MindExecution.Plugins.Directory.dll",
+      "MindExecution.Plugins.PlanMaster.imbm6hfih7.dll": "MindExecution.Plugins.PlanMaster.dll",
+      "MindExecution.Plugins.YouTube.ua03os14kk.dll": "MindExecution.Plugins.YouTube.dll",
+      "MindExecution.Shared.yxk1a55sjz.dll": "MindExecution.Shared.dll",
+      "MindExecution.Web.9bmh8f8s3k.dll": "MindExecution.Web.dll",
       "dotnet.native.566r55w3xu.js": "dotnet.native.js",
       "dotnet.native.x6q5aixc38.wasm": "dotnet.native.wasm",
       "dotnet.js": "dotnet.js",
@@ -276,18 +276,18 @@
       "System.Xml.XDocument.sn51jas17n.dll": "sha256-GNI2kFgFmPTwzuzwUn8gxK+AzGLUWRJFdg9JzIbrybQ=",
       "System.brmz7yk5qh.dll": "sha256-CfM2miyj1KHApFmqMdLYWio3S/jrdON2pW9Xr2nTwlo=",
       "netstandard.b50t77veor.dll": "sha256-//jQGOXjb8ET8WtXgOJrAxLx6E7zDJ5RjRRutwkvmxo=",
-      "MindExecution.Core.xxsj2s456b.dll": "sha256-uzTPf1yvTCunc39ykMPvPEuAIxvNZM4TEJNycxCg6fY=",
-      "MindExecution.Kernel.5jofnc0wrd.dll": "sha256-8VDveBicr2orZisFaztAg5a/nt80HDRS81+S7PT/ROM=",
-      "MindExecution.Plugins.Business.6yjlhhavap.dll": "sha256-Pk1GbR57U59MEbxO8jQQPWs+FMNPKL3oW3SWfxB3PPE=",
-      "MindExecution.Plugins.Concept.iikqq5zxu0.dll": "sha256-phdKuE+I1H+J7wAh0aUNejWKG/P9SqxoCWNw+lafcCo=",
-      "MindExecution.Plugins.PlanMaster.365bbuifr9.dll": "sha256-6/EU8a8T/YU/gGzmKzKk7oa/JDV7aljp1AlCJy+Ow3w=",
-      "MindExecution.Shared.21e2nvf86u.dll": "sha256-hvYai1+mJU08ECi/s5lghcNB6tlamHfO/TqNO9DiI3w=",
-      "MindExecution.Web.ppgm8rey59.dll": "sha256-HbKsqgHbYSJeoiQLgabISECR/bBtMWj8ojjcvR0hMEE="
+      "MindExecution.Core.2r5s0vx16i.dll": "sha256-Hji7EvwLtfgPOiDYgH4DHXZibPhbdWcYiGPG4NjYCWg=",
+      "MindExecution.Kernel.8y4azlvjyi.dll": "sha256-cKFcW5yNWguo2InCvgpimy5t/MhGZ2f5zITqvF99lvg=",
+      "MindExecution.Plugins.Business.uyqiv67u0q.dll": "sha256-BqDkv3XHSL10h0Lda9sJCj4NVrhijSowakl9dgGKCzk=",
+      "MindExecution.Plugins.Concept.5w50lskzj6.dll": "sha256-1UKv7Dxs0goKcQOkSsYBdhbE7Vp5Oy4YpqvXOtzEMHM=",
+      "MindExecution.Plugins.PlanMaster.imbm6hfih7.dll": "sha256-pgGCEAp8dmn511srw7KD/2fctoAJgnHAzcvGWbhoWG4=",
+      "MindExecution.Shared.yxk1a55sjz.dll": "sha256-Ru7/Qulj+40HqtPdqDs5O6dNvshmQ6JngyipwN4/dcs=",
+      "MindExecution.Web.9bmh8f8s3k.dll": "sha256-Na9Tbn6PRhJ3L72qs5aIn+/ahlhtzZIxWc7r8G/vAtk="
     },
     "lazyAssembly": {
-      "MindExecution.Plugins.Admin.t7m4jnqjg3.dll": "sha256-h6eePrT2PjCuijOqL44A0iHxFZ/lBr1Bz8MObEyvems=",
-      "MindExecution.Plugins.Directory.c5ribyne4m.dll": "sha256-EAMxoZl/5UCiM1XasoGXQzYTK0MfPYEjzJe23rXr9M0=",
-      "MindExecution.Plugins.YouTube.ax415cilpk.dll": "sha256-0vtb5+eLPDa8On/YfdvqCoJHPg3Bsxn9m9ejqVHFg2c="
+      "MindExecution.Plugins.Admin.dtzk93cn6n.dll": "sha256-UQfkrWbcBYN30pXQ3RWIZqQwygXIvaBBqc/H6hqiTyE=",
+      "MindExecution.Plugins.Directory.a8isl4htud.dll": "sha256-tp9XZ/Nxysn/xuTsD8lsKyJt++V8GjSkjsXm++ZxhVk=",
+      "MindExecution.Plugins.YouTube.ua03os14kk.dll": "sha256-Rjxv6t01L71frLHXiB3nNEeuVc9CK7OOYtF8UwUyhSI="
     }
   },
   "cacheBootResources": true,

package/wwwroot/index.html

@@ -614,7 +614,7 @@
             }
 
             const base = '_content/MindExecution.Shared/js/';
-            const scriptVersion = '20260823-compact-organic-v2-v984';
+            const scriptVersion = '20260824-css3d-viewport-owner-v985';
             const scriptUrl = (script) => `${base}${script}?v=${scriptVersion}`;
             console.log(`[Script Loader] Shared JS version: ${scriptVersion}`);
             const criticalScripts = [

package/wwwroot/service-worker-assets.js

@@ -1,5 +1,5 @@
 self.assetsManifest = {
-  "version": "/IXWXXqO",
+  "version": "TXjYyM9d",
   "assets": [
     {
       "hash": "sha256-+CSYMcqLNTsq3VnH11jgYyOCCdxvHzL74CBmo4sCmMU=",
@@ -90,7 +90,7 @@ self.assetsManifest = {
       "url": "_content/MindExecution.Shared/js/mind-map-board-render-ownership.js"
     },
     {
-      "hash": "sha256-Zg3spK1Ei6cgOAty49u1YEH2Duy6MgjroPjK4+YulmE=",
+      "hash": "sha256-LRUAnzz0htMlmLIhr3eJ7a3i7pqIj61sTqiAcWJVT6c=",
       "url": "_content/MindExecution.Shared/js/mind-map-core.js"
     },
     {
@@ -126,7 +126,7 @@ self.assetsManifest = {
       "url": "_content/MindExecution.Shared/js/mind-map-image-policy.js"
     },
     {
-      "hash": "sha256-MNC1OM1PiIW3yCLtMScPNDgweZbm5WWwB4e61VefC/s=",
+      "hash": "sha256-uVMRzWHkDDBBe6tm3VjH4cljpWgBZMQbPwLqDUoRCks=",
       "url": "_content/MindExecution.Shared/js/mind-map-interactions.js"
     },
     {
@@ -134,7 +134,7 @@ self.assetsManifest = {
       "url": "_content/MindExecution.Shared/js/mind-map-lod-plan-worker.js"
     },
     {
-      "hash": "sha256-3Yk1Pb4/9wi97b1qDQJpX5E14wkNJfx5IVSNX9pkYww=",
+      "hash": "sha256-2qu9aDwp1HJEuBvzN2H0SrxtTVX1d/2odbeih3fXE1Y=",
       "url": "_content/MindExecution.Shared/js/mind-map-lod-renderer.js"
     },
     {
@@ -158,7 +158,7 @@ self.assetsManifest = {
       "url": "_content/MindExecution.Shared/js/mind-map-node-search-worker.js"
     },
     {
-      "hash": "sha256-PXsPkLP/90ZPO16kreoeNdxcEty52wTtHS1njbDR1tg=",
+      "hash": "sha256-b7RtKlV7JrBOoYFt4TpehEFuE6ydN0GaIpkWDMN3pxQ=",
       "url": "_content/MindExecution.Shared/js/mind-map-nodes.js"
     },
     {
@@ -446,44 +446,44 @@ self.assetsManifest = {
       "url": "_framework/MimeMapping.og9ys58ylm.dll"
     },
     {
-      "hash": "sha256-uzTPf1yvTCunc39ykMPvPEuAIxvNZM4TEJNycxCg6fY=",
-      "url": "_framework/MindExecution.Core.xxsj2s456b.dll"
+      "hash": "sha256-Hji7EvwLtfgPOiDYgH4DHXZibPhbdWcYiGPG4NjYCWg=",
+      "url": "_framework/MindExecution.Core.2r5s0vx16i.dll"
     },
     {
-      "hash": "sha256-8VDveBicr2orZisFaztAg5a/nt80HDRS81+S7PT/ROM=",
-      "url": "_framework/MindExecution.Kernel.5jofnc0wrd.dll"
+      "hash": "sha256-cKFcW5yNWguo2InCvgpimy5t/MhGZ2f5zITqvF99lvg=",
+      "url": "_framework/MindExecution.Kernel.8y4azlvjyi.dll"
     },
     {
-      "hash": "sha256-h6eePrT2PjCuijOqL44A0iHxFZ/lBr1Bz8MObEyvems=",
-      "url": "_framework/MindExecution.Plugins.Admin.t7m4jnqjg3.dll"
+      "hash": "sha256-UQfkrWbcBYN30pXQ3RWIZqQwygXIvaBBqc/H6hqiTyE=",
+      "url": "_framework/MindExecution.Plugins.Admin.dtzk93cn6n.dll"
     },
     {
-      "hash": "sha256-Pk1GbR57U59MEbxO8jQQPWs+FMNPKL3oW3SWfxB3PPE=",
-      "url": "_framework/MindExecution.Plugins.Business.6yjlhhavap.dll"
+      "hash": "sha256-BqDkv3XHSL10h0Lda9sJCj4NVrhijSowakl9dgGKCzk=",
+      "url": "_framework/MindExecution.Plugins.Business.uyqiv67u0q.dll"
     },
     {
-      "hash": "sha256-phdKuE+I1H+J7wAh0aUNejWKG/P9SqxoCWNw+lafcCo=",
-      "url": "_framework/MindExecution.Plugins.Concept.iikqq5zxu0.dll"
+      "hash": "sha256-1UKv7Dxs0goKcQOkSsYBdhbE7Vp5Oy4YpqvXOtzEMHM=",
+      "url": "_framework/MindExecution.Plugins.Concept.5w50lskzj6.dll"
     },
     {
-      "hash": "sha256-EAMxoZl/5UCiM1XasoGXQzYTK0MfPYEjzJe23rXr9M0=",
-      "url": "_framework/MindExecution.Plugins.Directory.c5ribyne4m.dll"
+      "hash": "sha256-tp9XZ/Nxysn/xuTsD8lsKyJt++V8GjSkjsXm++ZxhVk=",
+      "url": "_framework/MindExecution.Plugins.Directory.a8isl4htud.dll"
     },
     {
-      "hash": "sha256-6/EU8a8T/YU/gGzmKzKk7oa/JDV7aljp1AlCJy+Ow3w=",
-      "url": "_framework/MindExecution.Plugins.PlanMaster.365bbuifr9.dll"
+      "hash": "sha256-pgGCEAp8dmn511srw7KD/2fctoAJgnHAzcvGWbhoWG4=",
+      "url": "_framework/MindExecution.Plugins.PlanMaster.imbm6hfih7.dll"
     },
     {
-      "hash": "sha256-0vtb5+eLPDa8On/YfdvqCoJHPg3Bsxn9m9ejqVHFg2c=",
-      "url": "_framework/MindExecution.Plugins.YouTube.ax415cilpk.dll"
+      "hash": "sha256-Rjxv6t01L71frLHXiB3nNEeuVc9CK7OOYtF8UwUyhSI=",
+      "url": "_framework/MindExecution.Plugins.YouTube.ua03os14kk.dll"
     },
     {
-      "hash": "sha256-hvYai1+mJU08ECi/s5lghcNB6tlamHfO/TqNO9DiI3w=",
-      "url": "_framework/MindExecution.Shared.21e2nvf86u.dll"
+      "hash": "sha256-Ru7/Qulj+40HqtPdqDs5O6dNvshmQ6JngyipwN4/dcs=",
+      "url": "_framework/MindExecution.Shared.yxk1a55sjz.dll"
     },
     {
-      "hash": "sha256-HbKsqgHbYSJeoiQLgabISECR/bBtMWj8ojjcvR0hMEE=",
-      "url": "_framework/MindExecution.Web.ppgm8rey59.dll"
+      "hash": "sha256-Na9Tbn6PRhJ3L72qs5aIn+/ahlhtzZIxWc7r8G/vAtk=",
+      "url": "_framework/MindExecution.Web.9bmh8f8s3k.dll"
     },
     {
       "hash": "sha256-IsZJ91/OW+fHzNqIgEc7Y072ns8z9dGritiSyvR9Wgc=",
@@ -802,7 +802,7 @@ self.assetsManifest = {
       "url": "_framework/Websocket.Client.vapounvmnl.dll"
     },
     {
-      "hash": "sha256-QpzbegZyuJEiGjE8Xg733cjveSZK8WQRZ+AC26HqmU0=",
+      "hash": "sha256-WvsgoQTqkn6gicUIMbadHK3hWH9MBshwEhAMOUntDlA=",
       "url": "_framework/blazor.boot.json"
     },
     {
@@ -878,7 +878,7 @@ self.assetsManifest = {
       "url": "icon-512.png"
     },
     {
-      "hash": "sha256-BCsNqsKxlO3eMDAKU195xlCzvYQFYDK+j38r2/AFfA0=",
+      "hash": "sha256-XIPqZA6H2ppZ5Zp3LOjsqPkqGof0dFQG5DGQFMF2Bpg=",
       "url": "index.html"
     },
     {

package/wwwroot/service-worker.js

@@ -1,4 +1,4 @@
-/* Manifest version: /IXWXXqO */
+/* Manifest version: TXjYyM9d */
 // Hosted deployments should prefer the network over stale offline caches.
 // This service worker immediately clears old Blazor offline caches and unregisters itself.