@mindexec/cli 0.2.453 → 0.2.455

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 = '20260728-world-grid-spotlight-v860';
+    const MINDMAP_CORE_BUILD_ID = '20260728-camera-render-policy-v865';
     const CanvasPhase = Object.freeze({
         Booting: 'booting',
         BoardFileLoading: 'board-file-loading',
@@ -87,6 +87,7 @@
     const CURSOR_DOM_BLINK_DURATION_MS = 1000;
     const RENDER_DEBUG_METRICS_CACHE_MS = 250;
     const ANIMATION_IDLE_LOW_FPS_DELAY_MS = 500;
+    const WHEEL_ZOOM_BURST_QUIET_FRAME_LIMIT = 12;
     const HOME_CAMERA_NORMAL_MID_Z = 8250;
     const HOME_DENSE_CLUSTER_MIN_CELL_SIZE = 1200;
     const HOME_DENSE_CLUSTER_MAX_CELL_SIZE = 3600;
@@ -117,7 +118,6 @@
     const LOCAL_SNAP_GRID_COMPOSITOR_SCALE_MIN = 0.8;
     const LOCAL_SNAP_GRID_COMPOSITOR_SCALE_MAX = 1.5;
     const CAMERA_STATIONARY_INTERACTION_FRAME_DELAY_MS = 48;
-    const CAMERA_ZOOM_END_DELAY_MS = 150;
     const CAMERA_MOTION_GLOBAL_STYLE_CLASS_ENABLED = false;
     const CAMERA_DENSE_GLOBAL_STYLE_CLASS_ENABLED = false;
     const PIPELINE_PROFILE_SECTION_KEYS = Object.freeze([
@@ -543,6 +543,15 @@
         );
     }
 
+    function hasActiveTextOverlaySurface(module) {
+        return !!(
+            hasPassiveOverlaySelectionSurface(module) === true ||
+            String(module?._textOverlayV2State?.editing?.nodeId || '').trim() ||
+            String(module?._editingOverlayState?.nodeId || '').trim() ||
+            module?.isEditingNote === true
+        );
+    }
+
     function hasPassiveOverlayMotionWork(module) {
         if (PASSIVE_DOM_OVERLAY_RUNTIME_ENABLED !== true) {
             return false;
@@ -1492,7 +1501,10 @@
             overlayLayoutChanged: moduleInstance._overlayDebugLayoutChanged === true,
             overlayContentChanged: moduleInstance._overlayDebugContentChanged === true,
             overlayForceRefresh: moduleInstance._overlayDebugForceRefresh === true,
-            cameraMotionFastPathStatus: moduleInstance._lastImmediateCameraFeedbackStatus || null,
+            wheelCanonicalFrame: {
+                consumeCount: Number(moduleInstance._wheelCanonicalConsumeCount || 0),
+                lastInputToFrameLatencyMs: Number(moduleInstance._lastWheelInputToFrameLatencyMs || 0)
+            },
             metricsSnapshotMs: Number(metricsSnapshotMs.toFixed(2)),
             metricsSnapshotCached: false,
             metricsSnapshotAgeMs: 0,
@@ -3083,6 +3095,8 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             this._panSmoothingActive = false;
             this._resetPanLerpDeltaOnNextFrame = false;
             this._currentDpr = null;
+            this._deferredDprTimer = null;
+            this._lastInteractiveDprAt = 0;
             this._lastViewportWidth = 0;
             this._lastViewportHeight = 0;
             this._lastViewportDpr = 0;
@@ -3200,6 +3214,8 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             this._nodeFrameDebugLayer = null;
             this._nodeFrameDebugSnapshot = null;
             this._wasZoomingLastFrame = false;
+            this._wheelZoomBurstActive = false;
+            this._wheelZoomBurstQuietFrames = 0;
             this._wasPanningLastFrame = false;
             this._wasCameraMovingLastFrame = false;
             this._wasResizingLastFrame = false;
@@ -3207,11 +3223,8 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             this._ctrlWheelScrollInputTime = 0;
             this._ctrlWheelScrollLastDeltaY = 0;
             this._cameraNavigationOverlayInputTime = 0;
-            this._lastImmediateCameraFeedbackStatus = null;
-            this._immediateCameraFeedbackCount = 0;
-            this._immediateCameraFeedbackCss3dCount = 0;
-            this._immediateCameraFeedbackWebglCount = 0;
-            this._immediateCameraFeedbackEdgeCount = 0;
+            this._wheelCanonicalConsumeCount = 0;
+            this._lastWheelInputToFrameLatencyMs = 0;
             // Match background-themes.js 'XYGrid' size1.
             this.GRID_SIZE = 10;
             // ?�▲??[Changed] ?�▲??
@@ -4310,156 +4323,6 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             }
         }
 
-        applyImmediateCameraNavigationFeedback(reason = 'camera-navigation-input', options = {}) {
-            const immediateOptions = options && typeof options === 'object' ? options : {};
-            const shouldRenderImmediateCss3d = immediateOptions.renderCss3d !== false;
-            const shouldRenderImmediateWebgl = immediateOptions.renderWebgl !== false;
-            const shouldSyncImmediateMotionGrid = immediateOptions.syncMotionGrid !== false;
-            const shouldSyncImmediateLocalSnapGrid = immediateOptions.syncLocalSnapGrid !== false;
-            const shouldSyncImmediateAutomationEdges = immediateOptions.syncAutomationEdges !== false;
-            const now = typeof performance !== 'undefined' && typeof performance.now === 'function'
-                ? performance.now()
-                : Date.now();
-            const status = {
-                used: false,
-                reason: String(reason || 'camera-navigation-input'),
-                css3dCamera: false,
-                automationEdges: false,
-                motionGrid: false,
-                localSnapGrid: false,
-                webgl: false,
-                skippedReason: '',
-                webglSkippedReason: '',
-                options: {
-                    renderCss3d: shouldRenderImmediateCss3d,
-                    renderWebgl: shouldRenderImmediateWebgl,
-                    syncMotionGrid: shouldSyncImmediateMotionGrid,
-                    syncLocalSnapGrid: shouldSyncImmediateLocalSnapGrid,
-                    syncAutomationEdges: shouldSyncImmediateAutomationEdges
-                },
-                count: Number(this._immediateCameraFeedbackCount || 0),
-                updatedAt: now
-            };
-
-            const finish = (skippedReason = '') => {
-                status.skippedReason = skippedReason;
-                this._lastImmediateCameraFeedbackStatus = status;
-                return status.used === true;
-            };
-
-            if (!this.camera || this._animationLoopExecuting === true || this.isLoading === true) {
-                return finish('runtime-busy');
-            }
-
-            const nextX = Number(this.targetX ?? this.camera.position.x);
-            const nextY = Number(this.targetY ?? this.camera.position.y);
-            const nextZ = Number(this.targetZ ?? this.camera.position.z);
-            if (!Number.isFinite(nextX) || !Number.isFinite(nextY) || !Number.isFinite(nextZ)) {
-                return finish('invalid-target');
-            }
-
-            const currentX = Number(this.camera.position.x || 0);
-            const currentY = Number(this.camera.position.y || 0);
-            const currentZ = Number(this.camera.position.z || 0);
-            if (Math.abs(nextX - currentX) < 0.001 &&
-                Math.abs(nextY - currentY) < 0.001 &&
-                Math.abs(nextZ - currentZ) < 0.001) {
-                return finish('unchanged');
-            }
-
-            this.camera.position.set(nextX, nextY, nextZ);
-            this.camera.updateMatrixWorld(true);
-            this._viewStatePersistAfterMotion = true;
-            this._cameraMovingThisFrame = true;
-            this._immediateCameraFeedbackCount = Number(this._immediateCameraFeedbackCount || 0) + 1;
-            status.used = true;
-            status.count = this._immediateCameraFeedbackCount;
-
-            const flags = this.renderDebugFlags || getRenderDebugFlagsSnapshot();
-            const isCss3dEnabled = flags.enableCss3d !== false;
-            const hasFocusedTextOverlay = !!(
-                String(this._textOverlayV2State?.selectionNodeId || '').trim() ||
-                String(this._selectableTextOverlayNodeId || '').trim()
-            );
-            const hasEditingOverlay = !!(
-                String(this._textOverlayV2State?.editing?.nodeId || '').trim() ||
-                String(this._editingOverlayState?.nodeId || '').trim() ||
-                this.isEditingNote === true
-            );
-            const isNodeInteracting = !!(
-                this.isDraggingNode ||
-                this.isDraggingMultipleNodes ||
-                this.isResizing ||
-                this.isScrollbarDragging ||
-                this.isSelecting
-            );
-            const hasCss3dDirtyTransforms = !!(
-                this._cssParentRepairNeeded === true ||
-                this._css3dVisualChangedThisFrame === true ||
-                this._css3dVisualChangedSinceLastRender === true ||
-                (this._cssTransformDirtyIds?.size || 0) > 0
-            );
-            const canRenderCss3dCamera = !!(
-                shouldRenderImmediateCss3d === true &&
-                this.cssRenderer &&
-                typeof this.cssRenderer.renderCamera === 'function' &&
-                isCss3dEnabled === true &&
-                this.lodRenderer?.isInLODMode !== true &&
-                !isNodeInteracting &&
-                !hasFocusedTextOverlay &&
-                !hasEditingOverlay &&
-                !hasCss3dDirtyTransforms &&
-                this.isWindowResizing !== true
-            );
-
-            if (canRenderCss3dCamera === true) {
-                this.cssRenderer.renderCamera(this.camera, true);
-                this._immediateCameraFeedbackCss3dCount = Number(this._immediateCameraFeedbackCss3dCount || 0) + 1;
-                status.css3dCamera = true;
-                status.css3dCount = this._immediateCameraFeedbackCss3dCount;
-            }
-
-            const canRenderWebglCamera = !!(
-                shouldRenderImmediateWebgl === true &&
-                this.renderer &&
-                this.scene &&
-                flags.enableWebglRender !== false &&
-                this.isLoading !== true &&
-                (this.lodRenderer?.isInLODMode === true || status.css3dCamera !== true)
-            );
-            if (canRenderWebglCamera === true) {
-                try {
-                    this.renderer.render(this.scene, this.camera);
-                    status.webgl = true;
-                    this._immediateCameraFeedbackWebglCount = Number(this._immediateCameraFeedbackWebglCount || 0) + 1;
-                    status.webglCount = this._immediateCameraFeedbackWebglCount;
-                } catch (err) {
-                    status.webglError = err?.message || String(err || 'unknown');
-                }
-            } else if (shouldRenderImmediateWebgl !== true) {
-                status.webglSkippedReason = 'feedback-option';
-            }
-
-            if (shouldSyncImmediateMotionGrid === true &&
-                this._shouldTouchMotionGridLayerForCameraNavigation?.() === true) {
-                status.motionGrid = this._syncMotionGridLayerForCameraNavigation?.() === true;
-            }
-
-            if (shouldSyncImmediateLocalSnapGrid === true) {
-                status.localSnapGrid = syncLocalSnapGridForCameraNavigation(this, true) === true;
-            }
-
-            if (shouldSyncImmediateAutomationEdges === true &&
-                syncBusinessAutomationEdgesForCameraNavigation(this, true, false) === true) {
-                this._immediateCameraFeedbackEdgeCount = Number(this._immediateCameraFeedbackEdgeCount || 0) + 1;
-                status.automationEdges = true;
-                status.edgeCount = this._immediateCameraFeedbackEdgeCount;
-            }
-
-            this._lastImmediateCameraFeedbackStatus = status;
-            return true;
-        }
-
         getCurrentBoardId() {
             return window.mindMap?.activeBoardId || _currentBoardId || null;
         }
@@ -5067,20 +4930,40 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             return Math.min(devicePixelRatio, interactive ? 1.25 : 2.0);
         }
 
-        _scheduleDeferredRendererPixelRatioApply(delayMs = 260) {
+        _scheduleDeferredRendererPixelRatioApply(delayMs = 260, waitMs = delayMs) {
             if (this._deferredDprTimer) {
-                clearTimeout(this._deferredDprTimer);
+                return;
             }
 
             this._deferredDprTimer = setTimeout(() => {
                 this._deferredDprTimer = null;
-                if (this.isZooming || this.isPanning || this._panSmoothingActive || this.isDraggingNode || this.isDraggingMultipleNodes || this.isResizing || this.isWindowResizing) {
-                    this._scheduleDeferredRendererPixelRatioApply(delayMs);
+                const now = performance.now();
+                const isInteractionActive =
+                    window.MindMapRenderPlan?.isRendererDprInteractionActive?.(this) === true;
+                if (isInteractionActive) {
+                    this._lastInteractiveDprAt = now;
+                }
+                const elapsedSinceInteraction = Math.max(
+                    0,
+                    now - Number(this._lastInteractiveDprAt || now)
+                );
+                if (isInteractionActive || elapsedSinceInteraction < delayMs) {
+                    this._scheduleDeferredRendererPixelRatioApply(
+                        delayMs,
+                        Math.max(16, delayMs - elapsedSinceInteraction)
+                    );
                     return;
                 }
 
+                this._lastInteractiveDprAt = 0;
+                const previousDpr = this._currentDpr;
                 this._applyRendererPixelRatio(false);
-            }, delayMs);
+                if (this._currentDpr !== previousDpr) {
+                    // setSize() changes the drawing buffer. Own one canonical
+                    // post-restore render even when the animation loop was parked.
+                    this._forceUpdateFrames = Math.max(this._forceUpdateFrames || 0, 1);
+                }
+            }, waitMs);
         }
 
         _applyRendererPixelRatio(interactive = false) {
@@ -5090,13 +4973,20 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
 
             const desiredDpr = this._getDesiredPixelRatio(interactive);
             if (interactive) {
-                // Drop DPR immediately while panning/zooming; restore it only after motion settles.
+                // Keep one low-DPR drawing buffer for the whole navigation burst.
+                // The single timer uses the last active frame timestamp, so it
+                // neither churns timers nor restores between physical-wheel gaps.
+                this._lastInteractiveDprAt = performance.now();
                 if (!this._deferredDprTimer) {
                     this._scheduleDeferredRendererPixelRatioApply();
                 }
                 if (this._currentDpr !== null && this._currentDpr <= desiredDpr + 0.001) {
                     return;
                 }
+            } else if (this._deferredDprTimer &&
+                this._currentDpr !== null &&
+                this._currentDpr <= this._getDesiredPixelRatio(true) + 0.001) {
+                return;
             }
 
             if (this._currentDpr === desiredDpr) {
@@ -5966,7 +5856,7 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             }
 
             this._animationLoopRunning = true;
-            const loop = async () => {
+            const loop = () => {
                 if (this._animationLoopRunning !== true) {
                     return;
                 }
@@ -6045,14 +5935,31 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                     }
                     : () => { };
 
-                const lastImmediateCameraFeedbackAtFrameStart = this._lastImmediateCameraFeedbackStatus || null;
-                const lastImmediateCameraFeedbackAgeAtFrameStart =
-                    frameStart - Number(lastImmediateCameraFeedbackAtFrameStart?.updatedAt || 0);
-                const hasFreshImmediateCameraFeedbackAtFrameStart = !!(
-                    lastImmediateCameraFeedbackAtFrameStart?.used === true &&
-                    lastImmediateCameraFeedbackAgeAtFrameStart >= 0 &&
-                    lastImmediateCameraFeedbackAgeAtFrameStart <= 120
-                );
+                const consumedWheelZoomThisFrame =
+                    window.MindMapInteractions?.consumePendingWheelZoom?.(this, frameStart) === true;
+                const wheelZoomBurstStartedThisFrame =
+                    consumedWheelZoomThisFrame === true &&
+                    this._wheelZoomBurstActive !== true;
+                let wheelZoomBurstSettledThisFrame = false;
+                if (consumedWheelZoomThisFrame === true) {
+                    this._wheelZoomBurstActive = true;
+                    this._wheelZoomBurstQuietFrames = 0;
+                } else if (this._wheelZoomBurstActive === true) {
+                    this._wheelZoomBurstQuietFrames =
+                        Math.max(0, Number(this._wheelZoomBurstQuietFrames || 0)) + 1;
+                    const shouldSettleWheelZoomBurst =
+                        isIdleCadenceFrame === true ||
+                        (
+                            this.useAnimation60Fps === true &&
+                            this._wheelZoomBurstQuietFrames >= WHEEL_ZOOM_BURST_QUIET_FRAME_LIMIT
+                        );
+                    if (shouldSettleWheelZoomBurst === true) {
+                        this._wheelZoomBurstActive = false;
+                        this._wheelZoomBurstQuietFrames = 0;
+                        wheelZoomBurstSettledThisFrame = true;
+                    }
+                }
+                _profileSection('wheelInput');
 
                 // 1. Camera Movement Interpolation
                 // ----------------------------------------------------------------
@@ -6105,7 +6012,6 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                 const deltaMove = this.camera.position.distanceToSquared(this._tmpOldCamPos);
                 const didCameraPositionChange = deltaMove > 0.0001;
                 const isCameraMoving = didCameraPositionChange ||
-                    hasFreshImmediateCameraFeedbackAtFrameStart ||
                     (isPanSmoothingActive && remainingPanDistance > panSnapWorldThreshold);
                 if (isCameraMoving) {
                     this._viewStatePersistAfterMotion = true;
@@ -6128,16 +6034,14 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                 if (typeof this.prevIsCameraMoving === 'undefined') this.prevIsCameraMoving = false;
                 const wasZoomingLastFrame = this._wasZoomingLastFrame === true;
 
-                // ?�▼??[Fix] �?종료 쿨다??- ???�력 ???�정 ?�간 ?��??�▼??
-                // _zoomInputTime?� interactions.js?�서 ???�력 ???�정??
-                const zoomNow = frameStart;
-                const lastZoomInput = this._zoomInputTime || 0;
-                const timeSinceLastInput = zoomNow - lastZoomInput;
-
-                if (this.isZooming && !isCameraMoving && timeSinceLastInput > CAMERA_ZOOM_END_DELAY_MS) {
+                // Keep the input frame in zoom mode, then end on the first
+                // canonical frame that consumes no additional wheel input.
+                if (this.isZooming &&
+                    !isCameraMoving &&
+                    consumedWheelZoomThisFrame !== true) {
                     this.isZooming = false;
                     if (FRAME_PERF_DEBUG) {
-                        console.log(`[Perf] Zoom ended (${timeSinceLastInput.toFixed(0)}ms since last input)`);
+                        console.log('[Perf] Zoom ended on the first no-input canonical frame');
                     }
                     const moduleRef = this;
                     const scheduleWillChangeOff = (typeof requestIdleCallback === 'function')
@@ -6201,11 +6105,18 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                 const panEndedThisFrame = wasPanningLastFrame && !this.isPanning;
                 const cameraEndedThisFrame = wasCameraMovingLastFrame && !isCameraMoving;
                 const resizeEndedThisFrame = wasResizingLastFrame && !this.isResizing;
+                const shouldDeferHeavyFullResZoomFinalize = !!(
+                    zoomEndedThisFrame === true &&
+                    this._wheelZoomBurstActive === true &&
+                    wheelZoomBurstSettledThisFrame !== true &&
+                    this.lodRenderer?.isInLODMode !== true
+                );
                 this._wasZoomingLastFrame = this.isZooming === true;
                 this._wasPanningLastFrame = this.isPanning === true;
                 this._wasCameraMovingLastFrame = isCameraMoving === true;
                 this._wasResizingLastFrame = this.isResizing === true;
                 const shouldFinalizeMotionThisFrame =
+                    wheelZoomBurstSettledThisFrame ||
                     zoomEndedThisFrame ||
                     cameraEndedThisFrame ||
                     resizeEndedThisFrame ||
@@ -6213,21 +6124,18 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                 if (shouldFinalizeMotionThisFrame) {
                     this._lastMotionEndAt = frameStart;
                     if (zoomEndedThisFrame === true) {
-                        const shouldReconcileLocalSnapGridAfterZoom = !!(
-                            this._isLocalSnapGridThemeEnabled?.() === true &&
-                            (
-                                this._localSnapGridStyleDeferredForZoom === true ||
-                                this._localSnapGridPointerWakeDeferredForZoom === true
-                            )
-                        );
+                        // The compositor transform already keeps the grid in the
+                        // canonical world coordinate system. Preserve that exact
+                        // pose here and let the existing idle cadence refresh the
+                        // crisp raster once, so physical-wheel notches cannot
+                        // trigger canvas.toDataURL() on every no-input frame.
                         this._localSnapGridPointerWakeDeferredForZoom = false;
-                        if (shouldReconcileLocalSnapGridAfterZoom === true) {
-                            this._syncLocalSnapGridLayer(true);
-                        }
                     }
                     if (cameraEndedThisFrame) {
                         this._cameraNavigationOverlayInputTime = 0;
-                        this._overlayDirty = true;
+                        if (hasActiveTextOverlaySurface(this) === true) {
+                            this._overlayDirty = true;
+                        }
                     }
 
                     if (this.lodRenderer?.hasPendingLineDetailRestore?.(this.camera, this) === true) {
@@ -6243,12 +6151,25 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                         window.MindMapTextOverlayV2?.invalidateView?.(this);
                     }
 
-                    if (wasLodMotionFrozenLastFrame ||
+                    const hasHeavyMotionReconcilePending = !!(
+                        wasLodMotionFrozenLastFrame ||
                         wasViewStateMotionFrozenLastFrame ||
                         this._fullResVisibilityReconcilePending === true ||
                         activeRenderDebugFlags.freezeVisibilityDuringMotion === true ||
-                        activeRenderDebugFlags.freezeLodDuringMotion === true) {
-                        this._forceUpdateFrames = Math.max(this._forceUpdateFrames || 0, 2);
+                        activeRenderDebugFlags.freezeLodDuringMotion === true
+                    );
+                    if (hasHeavyMotionReconcilePending === true &&
+                        shouldDeferHeavyFullResZoomFinalize !== true) {
+                        const heavyMotionReconcileForceFrames =
+                            wheelZoomBurstSettledThisFrame === true &&
+                            this._fullResVisibilityReconcilePending === true &&
+                            this.lodRenderer?.isInLODMode !== true
+                                ? 1
+                                : 2;
+                        this._forceUpdateFrames = Math.max(
+                            this._forceUpdateFrames || 0,
+                            heavyMotionReconcileForceFrames
+                        );
                         this._overlayDirty = true;
                         window.MindMapTextOverlayV2?.invalidateView?.(this);
                     }
@@ -6303,16 +6224,10 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                 const isNodeInteracting = this.isDraggingNode || this.isDraggingMultipleNodes || this.isResizing;
                 const isBoardLoading = this.isLoading === true;
                 const forceUpdateFrames = Math.max(0, Number(this._forceUpdateFrames || 0));
-                const panLiveRefreshForceFrames = Math.max(0, Number(this._panLiveRefreshForceFrames || 0));
                 const hasForcedUpdate = forceUpdateFrames > 0;
-                // Camera navigation wake frames keep the render loop awake; they should not disable motion throttles.
-                const hasOnlyCameraNavigationForcedUpdate =
-                    hasForcedUpdate &&
-                    panLiveRefreshForceFrames >= forceUpdateFrames &&
-                    (this.isPanning === true || this.isZooming === true || isCameraMoving === true);
-                const hasNonCameraForcedUpdate =
-                    hasForcedUpdate &&
-                    hasOnlyCameraNavigationForcedUpdate !== true;
+                // Camera navigation wakes the loop directly. Any remaining forced
+                // frame is semantic work and must stay visible to the planner.
+                const hasNonCameraForcedUpdate = hasForcedUpdate;
                 const hasNonCameraNavigationForcedUpdate = hasNonCameraForcedUpdate;
                 const isLodModeActive = this.lodRenderer?.isInLODMode === true;
                 const residentDirty = isResidentMidFarLodFrame &&
@@ -6383,9 +6298,6 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                     idleUpdateDue);
                 if (hasForcedUpdate) {
                     this._forceUpdateFrames = Math.max(0, forceUpdateFrames - 1);
-                    if (panLiveRefreshForceFrames > 0) {
-                        this._panLiveRefreshForceFrames = Math.max(0, panLiveRefreshForceFrames - 1);
-                    }
                 }
                 if (isLodPanVisibilityRefreshDue) {
                     this._lastLodPanVisibilityRefreshAt = frameStart;
@@ -6553,8 +6465,7 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                     this.isZooming !== true;
                 const fullResZoomStartedThisFrame =
                     isFullResMode === true &&
-                    this.isZooming === true &&
-                    wasZoomingLastFrame !== true;
+                    wheelZoomBurstStartedThisFrame === true;
                 const shouldThrottleFullResVisibilityCullingDuringPan =
                     isFullResMode === true &&
                     isVisibilityCullingEnabled &&
@@ -6686,8 +6597,13 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                     this._preserveVisibleSetThisFrame = true;
                 }
                 // ?�▲??[Perf] ?�▲??                _profileSection('pipelineVisibilityPlan');
+                const isCameraNavigationActive =
+                    window.MindMapRenderPlan?.isRendererDprInteractionActive?.(this, {
+                        isCameraMoving
+                    }) === true;
                 const shouldUseInteractiveDpr =
                     isNodeInteracting === true ||
+                    isCameraNavigationActive ||
                     this.isWindowResizing === true;
                 this._applyRendererPixelRatio(shouldUseInteractiveDpr);
                 _profileSection('pipelinePixelRatio');
@@ -7095,12 +7011,48 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                 // 7. Render
                 // ----------------------------------------------------------------
                 _profileSection('css3dSync');
+                const canUseCss3dCameraFastPath = !!(
+                    this.cssRenderer &&
+                    typeof this.cssRenderer.renderCamera === 'function' &&
+                    isCss3dEnabled &&
+                    (!isInLodMode || shouldRenderCss3dInLod) &&
+                    shouldUpdateCss3d &&
+                    (this.isPanning === true || this.isZooming === true || isCameraMoving === true) &&
+                    isCameraMoving === true &&
+                    !isNodeInteracting &&
+                    !hasNonCameraNavigationForcedUpdate &&
+                    !hasPendingNearCssWarmup &&
+                    !hasMotionBlockingOverlayFocus &&
+                    !hasPendingCss3dParentRepair &&
+                    this._css3dVisualChangedThisFrame !== true &&
+                    this._css3dVisualChangedSinceLastRender !== true &&
+                    shouldSyncCss3dTransforms !== true &&
+                    lodVisualEpochChangedThisFrame !== true &&
+                    this.isWindowResizing !== true
+                );
                 const shouldUseAnimationCadenceForWebglFrame =
                     isCameraNavigationOnlyInteractiveFrame === true
                         ? false
                         : shouldUseAnimation60Fps === true;
+                const cameraOnlyWebglBlockerMask =
+                    window.MindMapRenderPlan?.getCameraOnlyWebglBlockerMask?.(this, {
+                        canUseCss3dCameraFastPath,
+                        isCameraNavigationOnlyInteractiveFrame,
+                        isWebglRenderEnabled,
+                        isBoardLoading,
+                        isInLodMode,
+                        hasNonCameraNavigationForcedUpdate,
+                        themeAnimatedThisFrame
+                    }) ?? 1;
+                const canSkipWebglForCameraOnly = cameraOnlyWebglBlockerMask === 0;
+                const cameraOnlyWebglSkipBlockers = shouldCaptureFramePerf
+                    ? window.MindMapRenderPlan?.getCameraOnlyWebglBlockerNames?.(
+                        cameraOnlyWebglBlockerMask
+                    ) || []
+                    : null;
                 const shouldRenderWebglFrame =
                     isWebglRenderEnabled &&
+                    canSkipWebglForCameraOnly !== true &&
                     (
                         isBoardLoading === true ||
                         shouldUpdate === true ||
@@ -7108,8 +7060,10 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                         shouldUseAnimationCadenceForWebglFrame === true ||
                         themeAnimatedThisFrame === true
                     );
-                const webglRenderReason = shouldCaptureFramePerf && shouldRenderWebglFrame
+                const webglRenderReason = shouldCaptureFramePerf
                     ? (
+                        canSkipWebglForCameraOnly === true ? 'camera-only-css3d-skip' :
+                            shouldRenderWebglFrame !== true ? '' :
                         isBoardLoading === true ? 'board-loading' :
                             shouldUpdate === true ? 'update' :
                                 isInteractiveFrame === true ? 'interactive-frame' :
@@ -7150,7 +7104,10 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                         triangles: 0,
                         points: 0,
                         lines: 0,
-                        skipped: true
+                        skipped: true,
+                        skipReason: canSkipWebglForCameraOnly === true
+                            ? 'camera-only-css3d-skip'
+                            : 'no-render-work'
                     };
                 } else if (isBoardLoading) {
                     this._lastWebglRenderInfo = { calls: 0, triangles: 0, points: 0, lines: 0 };
@@ -7164,12 +7121,17 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                 const localSnapGridPointerRevision = Math.max(0, Number(this._localSnapGridPointerRevision || 0));
                 const hasPendingLocalSnapGridPointerMove =
                     Number(this._lastLocalSnapGridPositionRevision ?? -1) !== localSnapGridPointerRevision;
+                const shouldDeferLocalSnapGridRasterUntilBurstSettle = !!(
+                    this._localSnapGridStyleDeferredForZoom === true &&
+                    wheelZoomBurstSettledThisFrame !== true
+                );
                 const shouldUseLocalSnapGridPositionOnly = !!(
                     this._localSnapGridLayer?.isConnected &&
                     this._lastLocalSnapGridKey &&
                     (
                         isCameraNavigationOnlyInteractiveFrame === true ||
-                        hasPendingLocalSnapGridPointerMove === true
+                        hasPendingLocalSnapGridPointerMove === true ||
+                        shouldDeferLocalSnapGridRasterUntilBurstSettle === true
                     )
                 );
                 syncLocalSnapGridForCameraNavigation(this, shouldUseLocalSnapGridPositionOnly === true);
@@ -7183,37 +7145,15 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
 
                 _profileSection('webglRender');
                 // ?�▼??[FIX] LOD 모드(MID/FAR)?�서??CSS3D ?�더???�출 건너?�기 ?�▼??                // CSS3D가 모두 display:none?�어???�더?��? 813�?객체�??�회?�면???�간 ?�비
-                const lastImmediateCameraFeedback = lastImmediateCameraFeedbackAtFrameStart;
-                const lastImmediateCameraFeedbackAgeMs = lastImmediateCameraFeedbackAgeAtFrameStart;
-                const hasFreshImmediateCameraFeedback = hasFreshImmediateCameraFeedbackAtFrameStart;
-                const canUseCss3dCameraFastPath = !!(
-                    this.cssRenderer &&
-                    typeof this.cssRenderer.renderCamera === 'function' &&
-                    isCss3dEnabled &&
-                    !isInLodMode &&
-                    shouldUpdateCss3d &&
-                    (this.isPanning === true || this.isZooming === true || isCameraMoving === true) &&
-                    (isCameraMoving === true || hasFreshImmediateCameraFeedback === true) &&
-                    !isNodeInteracting &&
-                    !hasNonCameraNavigationForcedUpdate &&
-                    !hasPendingNearCssWarmup &&
-                    !hasMotionBlockingOverlayFocus &&
-                    !hasPendingCss3dParentRepair &&
-                    this._css3dVisualChangedThisFrame !== true &&
-                    this._css3dVisualChangedSinceLastRender !== true &&
-                    shouldSyncCss3dTransforms !== true &&
-                    lodVisualEpochChangedThisFrame !== true &&
-                    this.isWindowResizing !== true
-                );
                 const css3dCameraFastPathBlockers = shouldCaptureFramePerf
                     ? [
                         !this.cssRenderer ? 'no-css-renderer' : '',
                         this.cssRenderer && typeof this.cssRenderer.renderCamera !== 'function' ? 'no-render-camera' : '',
                         isCss3dEnabled !== true ? 'css3d-disabled' : '',
-                        isInLodMode === true ? 'lod-mode' : '',
+                        (isInLodMode === true && shouldRenderCss3dInLod !== true) ? 'lod-css3d-not-due' : '',
                         shouldUpdateCss3d !== true ? 'css3d-not-due' : '',
                         (this.isPanning === true || this.isZooming === true || isCameraMoving === true) ? '' : 'not-camera-motion',
-                        (isCameraMoving === true || hasFreshImmediateCameraFeedback === true) ? '' : 'no-fresh-camera-motion',
+                        isCameraMoving === true ? '' : 'camera-pose-unchanged',
                         isNodeInteracting === true ? 'node-interacting' : '',
                         hasNonCameraNavigationForcedUpdate === true ? 'non-camera-forced-update' : '',
                         hasPendingNearCssWarmup === true ? 'pending-near-css-warmup' : '',
@@ -7251,7 +7191,6 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                     this.cssRenderer.renderCamera(this.camera, true);
                 }
                 _profileSection('css3dCamera');
-                // ?�▲??[FIX] ?�▲??                _profileSection('css3dRender');
 
                 const hasBusinessAutomationConnectionDraft =
                     this._businessAutomationConnectionDraftActive === true;
@@ -7312,7 +7251,12 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                 } else if (this._businessAutomationEdgesDeferredForMotion === true &&
                     hasBusinessAutomationEdgeLayer &&
                     window.MindMapCss3DManager?.renderBusinessAutomationEdges &&
-                    (panEndedThisFrame === true || zoomEndedThisFrame === true || cameraEndedThisFrame === true)) {
+                    (
+                        wheelZoomBurstSettledThisFrame === true ||
+                        panEndedThisFrame === true ||
+                        resizeEndedThisFrame === true ||
+                        (cameraEndedThisFrame === true && zoomEndedThisFrame !== true)
+                    )) {
                     window.MindMapCss3DManager.renderBusinessAutomationEdges(this);
                     this._businessAutomationEdgesDeferredForMotion = false;
                 }
@@ -7474,18 +7418,25 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                         visibilityStableSkip: canSkipVisibilityCullingForStableFrame === true,
                         visibilitySkipReason: visibilityCullingSkipReason || this._lastVisibilityCullingSkipReason || '',
                         incrementalPanVisibility: isIncrementalPanVisibilityFrame === true,
-                        freshImmediateCameraFeedback: hasFreshImmediateCameraFeedback === true,
+                        consumedWheelZoom: consumedWheelZoomThisFrame === true,
+                        wheelZoomBurstStarted: wheelZoomBurstStartedThisFrame === true,
+                        wheelZoomBurstActive: this._wheelZoomBurstActive === true,
+                        wheelZoomBurstSettled: wheelZoomBurstSettledThisFrame === true,
+                        wheelInputToFrameLatencyMs: Number(this._lastWheelInputToFrameLatencyMs || 0),
                         cameraNavigationForceFrames: Number(this._forceUpdateFrames || 0),
-                        panLiveRefreshForceFrames: Number(this._panLiveRefreshForceFrames || 0),
                         shouldSyncCss3dTransforms: shouldSyncCss3dTransforms === true,
                         shouldRenderCss3d: shouldRenderCss3dFrame === true,
                         usedCss3dCameraFastPath: canUseCss3dCameraFastPath === true,
                         css3dCameraFastPathBlockers,
-                        immediateCameraFeedback: this._lastImmediateCameraFeedbackStatus || null,
                         shouldSyncTextOverlays: shouldSyncTextOverlays === true,
                         usedPassiveOverlayCameraFastPath: usedPassiveOverlayCameraFastPath === true,
                         passiveOverlaySuppressed: isPassiveOverlaySuppressed === true,
+                        rendererPixelRatio: Number(this._currentDpr || 0),
+                        rendererDprInteractive: shouldUseInteractiveDpr === true,
+                        rendererDprRestorePending: !!this._deferredDprTimer,
                         webglRenderReason,
+                        webglCameraOnlySkipped: canSkipWebglForCameraOnly === true,
+                        webglCameraOnlySkipBlockers: cameraOnlyWebglSkipBlockers,
                         webgl: this._lastWebglRenderInfo || null,
                         sections: sectionTimes
                     };
@@ -7563,10 +7514,18 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                     this._lastFramePerfProfile = null;
                 }
 
+                const isFullResVisibilityReconcileDeferredForWheelBurst = !!(
+                    this._fullResVisibilityReconcilePending === true &&
+                    this._wheelZoomBurstActive === true &&
+                    wheelZoomBurstSettledThisFrame !== true
+                );
                 const hasPendingAnimationWakeWork =
                     Number(this._forceUpdateFrames || 0) > 0 ||
                     this._forceThemeAnimationFrame === true ||
-                    this._fullResVisibilityReconcilePending === true ||
+                    (
+                        this._fullResVisibilityReconcilePending === true &&
+                        isFullResVisibilityReconcileDeferredForWheelBurst !== true
+                    ) ||
                     hasPendingNearCssWarmup === true ||
                     residentDirtyRequiresUpdate === true ||
                     residentBandChanging === true ||
@@ -7587,7 +7546,9 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                     textOverlaySync: shouldSyncTextOverlays === true,
                     forceUpdate: Number(this._forceUpdateFrames || 0) > 0,
                     forceThemeAnimation: this._forceThemeAnimationFrame === true,
-                    fullResVisibilityReconcile: this._fullResVisibilityReconcilePending === true,
+                    fullResVisibilityReconcile:
+                        this._fullResVisibilityReconcilePending === true &&
+                        isFullResVisibilityReconcileDeferredForWheelBurst !== true,
                     pendingNearCssWarmup: hasPendingNearCssWarmup === true,
                     residentDirtyRequiresUpdate: residentDirtyRequiresUpdate === true,
                     residentBandChanging: residentBandChanging === true,
@@ -7961,6 +7922,11 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                 clearTimeout(this._viewStatePersistTimer);
                 this._viewStatePersistTimer = null;
             }
+            if (this._deferredDprTimer) {
+                clearTimeout(this._deferredDprTimer);
+                this._deferredDprTimer = null;
+            }
+            this._lastInteractiveDprAt = 0;
             this._viewStatePersistNeedsFreshSnapshot = false;
             this._viewStatePersistAfterMotion = false;