@mindexec/cli 0.2.432 → 0.2.433

package/package.json

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

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

@@ -7152,6 +7152,7 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                         'lodCleanup',
                         'lodNodeScan',
                         'lodResidentApply',
+                        'lodLinePatch',
                         'lodImageInstances',
                         'lodPositionPatch',
                         'lodFallbacks',

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

@@ -1736,14 +1736,7 @@
                     atlasContext.fillRect(0, 0, IMAGE_LOD_ATLAS_SIZE, IMAGE_LOD_ATLAS_SIZE);
                 }
                 this.imageAtlasTexture = new THREE.CanvasTexture(this.imageAtlasCanvas);
-                this.imageAtlasTexture.colorSpace = THREE.SRGBColorSpace;
-                this.imageAtlasTexture.minFilter = THREE.LinearFilter;
-                this.imageAtlasTexture.magFilter = THREE.LinearFilter;
-                this.imageAtlasTexture.wrapS = THREE.ClampToEdgeWrapping;
-                this.imageAtlasTexture.wrapT = THREE.ClampToEdgeWrapping;
-                this.imageAtlasTexture.flipY = false;
-                this.imageAtlasTexture.generateMipmaps = false;
-                this.imageAtlasTexture.needsUpdate = true;
+                window.MindMapRenderPlan?.configureImageAtlasTexture?.(this.imageAtlasTexture, THREE);
             }
 
             const nodeVertexShader = `
@@ -1956,6 +1949,7 @@
                 polygonOffsetUnits: -10.0
             });
 
+            const imageAtlasOutputColorChunk = window.MindMapRenderPlan?.getImageAtlasOutputColorChunk?.(THREE) || '';
             const imageLodMaterial = new THREE.ShaderMaterial({
                 uniforms: {
                     uImageAtlas: { value: this.imageAtlasTexture },
@@ -2016,7 +2010,7 @@
                         color = mix(color, borderColor, borderMask * (vSelected > 0.5 ? 0.92 : 0.36));
 
                         gl_FragColor = vec4(color, 1.0);
-                        #include <colorspace_fragment>
+                        ${imageAtlasOutputColorChunk}
                     }
                 `,
                 transparent: false,
@@ -3420,7 +3414,7 @@
         }
 
         hasResidentDirtyWork(camera = this._module?.camera, module = this._module) {
-            return this.getResidentDirtyState(camera, module).dirty === true;
+            return window.MindMapRenderPlan?.hasResidentDirtyWork?.(this, camera, module, getLodBandForCameraZ, buildLodSelectionKey, isAnimatedGifImageModel) === true;
         }
 
         willLodBandChange(camera) {
@@ -4018,17 +4012,10 @@
         }
 
         _clearFullResImageVisuals(nodeObjectsById) {
-            if (!this._fullResImageVisualIds || this._fullResImageVisualIds.size === 0) return;
-
-            for (const nodeId of this._fullResImageVisualIds) {
-                const entry = nodeObjectsById?.get?.(nodeId) || null;
-                if (entry) this._hideImageLodFullVisual(entry);
-            }
-
-            this._fullResImageVisualIds.clear();
+            window.MindMapRenderPlan?.clearFullResImageVisuals?.(this, nodeObjectsById);
         }
 
-        _syncFullResImageVisuals(visibleIds, nodeObjectsById, module, lodBand) {
+        _syncFullResImageVisuals(visibleIds, nodeObjectsById, module, lodBand, selectionKey = '') {
             if (this.isInLODMode !== false || !nodeObjectsById) {
                 this._clearFullResImageVisuals(nodeObjectsById);
                 return;
@@ -4058,7 +4045,10 @@
                 if (!entry) continue;
 
                 if (supportsCss3dNodeModel(entry?.model)) {
-                    this._syncCssImageBodyBridge(entry, module);
+                    if (window.MindMapRenderPlan?.restoreParkedFullResCss?.(
+                        this, entry, module, nodeObjectsById, selectionKey, lodBand, nodeId) !== true) {
+                        this._syncCssImageBodyBridge(entry, module);
+                    }
                     continue;
                 }
 
@@ -4663,6 +4653,7 @@
             }
 
             entry.cssObject = cssObject;
+            window.MindMapRenderPlan?.cachePreparedResidentCss?.(this, entry, module, module.nodeObjectsById);
             return true;
         }
 
@@ -4672,8 +4663,7 @@
                 !Array.isArray(prioritizedVisible) ||
                 !nodeObjectsById ||
                 !module ||
-                this.isLoading ||
-                module.isZooming === true) {
+                this.isLoading) {
                 return;
             }
 
@@ -4684,12 +4674,12 @@
                 if (!nodeId || this._css3dPrewarmQueuedIds.has(nodeId)) continue;
 
                 const entry = nodeObjectsById.get(nodeId);
-                if (!entry || entry.cssObject || !supportsCss3dNodeModel(entry.model)) continue;
+                if (!entry || (entry.cssObject && entry.isCssDirty !== true) || !supportsCss3dNodeModel(entry.model)) continue;
                 if (allowPanTextPrewarm && !isTextLikeModel(entry.model)) continue;
                 if (shouldShowAgentConsoleInLodBand(lodBand) && hasAgentConsoleOpenForEntry(entry)) continue;
 
                 this._css3dPrewarmQueuedIds.add(nodeId);
-                this._css3dPrewarmQueue.push({ nodeId, module });
+                this._css3dPrewarmQueue.push({ nodeId, module, nodeObjectsById, entry });
             }
 
             if (this._css3dPrewarmQueue.length > 0 && !this._css3dPrewarmProcessing) {
@@ -4715,6 +4705,7 @@
                     const module = this._module || null;
                     const allowPanTextPrewarm = module?.isPanning === true && module?.isZooming !== true;
                     if ((module?.isPanning === true && !allowPanTextPrewarm) || module?.isZooming === true) {
+                        shouldContinue = this._css3dPrewarmQueue.length > 0;
                         return;
                     }
 
@@ -4740,11 +4731,17 @@
 
                         this._css3dPrewarmQueuedIds.delete(nodeId);
                         const itemModule = item.module || this._module;
+                        if (itemModule !== this._module || item.nodeObjectsById !== itemModule?.nodeObjectsById) continue;
                         const entry = itemModule?.nodeObjectsById?.get(nodeId);
-                        if (!entry || entry.cssObject || !supportsCss3dNodeModel(entry.model)) continue;
+                        if (!entry || entry !== item.entry || (entry.cssObject && entry.isCssDirty !== true) || !supportsCss3dNodeModel(entry.model)) continue;
                         if (allowPanTextPrewarm && !isTextLikeModel(entry.model)) continue;
 
-                        this._ensureHiddenCss3dObject(entry, itemModule);
+                        if (!entry.cssObject && !this._ensureHiddenCss3dObject(entry, itemModule)) continue;
+                        if (entry.isCssDirty === true && window.MindMapCss3DManager?.syncCss3dContent) {
+                            window.MindMapCss3DManager.syncCss3dContent(entry.model, entry.cssObject);
+                            entry.isCssDirty = false;
+                        }
+                        window.MindMapRenderPlan?.cachePreparedResidentCss?.(this, entry, itemModule, item.nodeObjectsById);
                         count++;
                     }
 
@@ -5037,6 +5034,7 @@
             if (!entry || !isCssMediaFallbackModel(entry?.model)) {
                 return false;
             }
+            if (window.MindMapRenderPlan?.reuseActiveCssMediaFallback?.(this,entry,module)) return true;
 
             if (!entry.cssObject?.element && !this._ensureHiddenCss3dObject(entry, module)) {
                 return false;
@@ -5153,6 +5151,12 @@
             const isNodeSelected = nodeId
                 ? isNodeSelectedForLod(nodeId, multiSelectedIds, selectedNodeId)
                 : false;
+            const hasInteractiveOwner = module?.draggedNodeId === nodeId || this._getCurrentHoveredNodeId(module) === nodeId;
+            if (contentType === 'image' && !isAnimatedGifImageModel(entry.model) &&
+                this._hasActiveImageLodInstance(nodeId) && !isNodeSelected && !hasInteractiveOwner) {
+                this._hideCssMediaLodFallback(entry, { forceMediaGlFallback: true });
+                return false;
+            }
             const shouldKeep = contentType === 'image'
                 ? (entry.isVisibleInFrustum === true || isNodeSelected === true)
                 : entry.isVisibleInFrustum === true;
@@ -5172,7 +5176,7 @@
 
             const allowImageCssFallbacks = this._shouldUseCssImageFallbackInResidentLod(module, lodBand);
 
-            for (const nodeId of Array.from(this._lodImageCssFallbackNodeIds)) {
+            for (const nodeId of window.MindMapRenderPlan?.fallbackBatch?.(this, this._lodImageCssFallbackNodeIds) || []) {
                 const entry = nodeObjectsById.get(nodeId) || null;
                 if (!entry || !isCssMediaFallbackModel(entry.model)) {
                     this._lodImageCssFallbackNodeIds.delete(nodeId);
@@ -5311,39 +5315,7 @@
         }
 
         hasPendingNearCssWarmup(module) {
-            if (this.isInLODMode !== false) {
-                return false;
-            }
-
-            if (this._css3dProcessing || this._css3dQueuedMap.size > 0 || this._hasCss3dQueueItems()) {
-                return true;
-            }
-
-            if (this._nearEntryBoostFrames > 0) {
-                return true;
-            }
-
-            const moduleRef = module || this._module || null;
-            const visibleIds = this._getNearVisibleIds(moduleRef);
-            const nodeObjectsById = moduleRef?.nodeObjectsById || null;
-            if (!visibleIds || !nodeObjectsById || visibleIds.size === 0) {
-                return false;
-            }
-
-            for (const nodeId of visibleIds) {
-                if (this._nearCssVisibleIds.has(nodeId)) {
-                    continue;
-                }
-
-                const entry = nodeObjectsById.get(nodeId);
-                if (!entry?.glObject || !supportsCss3dNodeModel(entry.model)) {
-                    continue;
-                }
-
-                return true;
-            }
-
-            return false;
+            return window.MindMapRenderPlan?.hasPendingNearCssWarmup?.(this, module, buildLodSelectionKey, isCss3dRendererEnabled, supportsCss3dNodeModel) === true;
         }
 
 
@@ -5668,40 +5640,8 @@
             return { warmMax, queueMax, perIdle, budgetMs };
         }
 
-        _getAdaptiveNearEntryBoostFrames(visibleCount = 0, module = this._module) {
-            const avgFrameTime = Number(module?._avgFrameTime || 16);
-            const fps = Number(module?._currentFps || 60);
-            let frames = 12;
-
-            if (visibleCount >= 72) {
-                frames = 16;
-            }
-            if (visibleCount >= 144) {
-                frames = 20;
-            }
-            if (visibleCount >= 240) {
-                frames = 24;
-            }
-
-            if (avgFrameTime > 22 || fps < 42) {
-                frames = Math.max(10, frames - 4);
-            }
-
-            return frames;
-        }
-
-        _getAdaptiveNearCssActivationConfig(visibleCount = 0, module = this._module, isNearBoostFrame = false) {
-            const visibleBudget = Number.isFinite(Number(visibleCount))
-                ? Math.max(1, Math.ceil(Number(visibleCount)))
-                : Number.MAX_SAFE_INTEGER;
-
-            // NEAR/NORMAL is the readable full-res CSS3D path. Splitting activation
-            // across frames makes some nodes move or reveal later than others, which
-            // is visually worse than a bounded one-tick activation cost.
-            return {
-                maxPerFrame: visibleBudget,
-                budgetMs: Number.MAX_SAFE_INTEGER
-            };
+        _getAdaptiveNearCssActivationConfig(visibleCount = 0) {
+            return { maxPerFrame: Math.max(1, Math.ceil(Number(visibleCount) || 1)), budgetMs: Number.MAX_SAFE_INTEGER };
         }
 
         updateLOD(camera, nodeObjectsById, module) {
@@ -5857,10 +5797,11 @@
                 }
 
                 if (modeChanged) {
-                    const tModeStart = performance.now(); // ▼ [Timing]
+                    const transitionPlan = window.MindMapRenderPlan;
+                    transitionPlan?.beginResidentCssTransition?.(
+                        this, module, nodeObjectsById, previousLodBand, lodBand, lodSelectionKey);
                     this.isInLODMode = shouldUseLOD;
                     this._updateMeshVisibility(); // Use helper to respect loading state
-                    console.log(`[LODRenderer] Mode switched to: ${shouldUseLOD ? 'LOD' : 'FULL-RES'} (Band=${lodBand}, Z=${cameraZ.toFixed(0)})`);
 
                     if (this.isInLODMode) {
                         this._lodVisualEpoch++;
@@ -5870,11 +5811,12 @@
                     if (shouldUseLOD) {
                         this._finishFullResHandoff('enter-lod');
                         this._clearFullResImageVisuals(nodeObjectsById);
+                        if ((this.imageInstanceData?.nodeIds?.length || 0) > 0) {
+                            perfTime('lodImageInstances', () => this._applyImageInstanceData());
+                        }
                         this._fullResMotionHiddenGlIds.clear();
                         this._currentLodBand = lodBand;
-                        if (lodBand === 'MID') {
-                            this._markLineDetailsDirty();
-                        }
+                        transitionPlan?.ensureResidentLineDetails?.(this, lodBand);
                         if (this.instancedHaloMesh) this.instancedHaloMesh.visible = shouldShowInstancedHaloInLodBand(lodBand);
                     this.instancedMesh.visible = true;
                     if (this.isLoading) {
@@ -5895,6 +5837,7 @@
                             cssIdsToHide.add(nodeId);
                         }
                         const currentNodeMap = this._module?.nodeObjectsById;
+                        const activeCssOwnerId = module?.draggedNodeId || this._getCurrentHoveredNodeId(module);
                         for (const nodeId of this._activeFullResCssNodeIds) cssIdsToHide.add(nodeId);
                         this._clearCss3dQueue();
                         this._clearCss3dPrewarmQueue();
@@ -5909,7 +5852,6 @@
                         this._primeWarmCss3dCache(prioritizedWarm, currentNodeMap, lodBand);
                         this._queueCss3dPrewarm(prioritizedWarm, currentNodeMap, module, lodBand);
                         if (currentNodeMap && cssIdsToHide.size > 0) {
-                            const hideStart = performance.now();
                             perfTime('lodCleanup', () => {
                                 for (const nodeId of cssIdsToHide) {
                                     const entry = currentNodeMap.get(nodeId);
@@ -5919,15 +5861,18 @@
                                     const isTextLike = isTextLikeModel(model);
                                     const shouldKeepConsoleProxy = false;
                                     if (!isLivePortalCss && isTextLike) {
-                                        if (entry.cssObject) {
-                                            entry.cssObject.visible = false;
-                                            entry.cssObject.element?.style?.setProperty?.('display', 'none', 'important');
-                                        }
-                                        entry.currentType = 'GL';
+                                        transitionPlan?.parkFullResCss?.(
+                                            this, entry, module, currentNodeMap, lodSelectionKey, 'text');
                                         if (entry.glObject) this._hideTextLodFullVisual(entry);
                                         this._setGlowVisibility(entry, false);
                                         continue;
                                     }
+                                    const contentType = getNodeContentType(model);
+                                    const isNodeSelected = isNodeSelectedForLod(nodeId, multiSelectedIds, selectedNodeId);
+                                    if (!isLivePortalCss && contentType === 'image' &&
+                                        transitionPlan?.parkReadyResidentImage?.(
+                                            this, entry, module, currentNodeMap, lodSelectionKey, nodeId,
+                                            isAnimatedGifImageModel(model), isNodeSelected, activeCssOwnerId === nodeId)) continue;
                                     const element = entry.cssObject?.element || null;
                                     if (!isLivePortalCss && isCssMediaFallbackModel(model) &&
                                         entry.cssObject?.visible === true && element && element.style.display !== 'none') {
@@ -5956,9 +5901,7 @@
                                         entry.currentType = 'GL';
                                     }
 
-                                    const contentType = getNodeContentType(model);
                                     const isImage = isImageLodProxyModel(model);
-                                    const isNodeSelected = isNodeSelectedForLod(nodeId, multiSelectedIds, selectedNodeId);
                                     if (!isLivePortalCss && isTextLike && entry.glObject) {
                                         this._hideTextLodFullVisual(entry);
                                     } else if (isImage) {
@@ -5979,7 +5922,6 @@
                                     module._css3dVisualChangedSinceLastRender = true;
                                 }
                             });
-                            console.log(`[LODRenderer] CSS3D hidden synchronously in ${(performance.now() - hideStart).toFixed(1)}ms (${cssIdsToHide.size} active)`);
                         }
 
                         if (module?.renderDebugFlags?.enableCss3dWillChange === true &&
@@ -6020,7 +5962,7 @@
                             this._lastNearCssNoWorkKey = '';
                             const nearVisibleIds = this._getNearVisibleIds(module);
                             this._clearWarmCss3dCache(this._module?.nodeObjectsById, nearVisibleIds);
-                            this._nearEntryBoostFrames = this._getAdaptiveNearEntryBoostFrames(nearVisibleIds?.size || 0, module);
+                            this._nearEntryBoostFrames = 0;
                             this._lodCleanupPending = true;
 
                             if (module?.renderDebugFlags?.enableCss3dWillChange === true &&
@@ -6095,7 +6037,7 @@
                     }
 
                     perfTime('fullResImages', () => {
-                        this._syncFullResImageVisuals(visibleIds, nodeObjectsById, module, lodBand);
+                        this._syncFullResImageVisuals(visibleIds, nodeObjectsById, module, lodBand, lodSelectionKey);
                     });
 
                     const prioritizedVisible = this._getNearVisiblePriority(visibleIds, nodeObjectsById, camera);
@@ -6229,9 +6171,13 @@
                             // visible CSS3D surface in-place so the expanded NORMAL
                             // band cannot show a blank low-detail shell while a
                             // deferred queue waits for motion/cooldown.
-                            this._showNodeCss3d(entry, module);
+                            if (renderPlan?.restoreParkedFullResCss?.(
+                                this, entry, module, nodeObjectsById, lodSelectionKey, lodBand, nodeId) !== true) {
+                                this._showNodeCss3d(entry, module);
+                            }
                             processedCount++;
                         }
+                        renderPlan?.completeFullResTransition?.(this, allowedCssIds.size);
                     });
 
                     perfTime('fullResHandoff', () => {
@@ -6394,6 +6340,10 @@
                     });
                 }
 
+                const committedResidentTextCount = window.MindMapRenderPlan?.syncCommittedResidentTextCount?.(
+                    this, hasResidentLodInstances, FORCE_RESIDENT_INSTANCES_IN_MID_FAR === true) ?? -1;
+                if (committedResidentTextCount >= 0) totalTextLikeCount = committedResidentTextCount;
+
                 const nextVisibleSubsetMode = shouldUseLOD && this._shouldUseVisibleSubsetLod(totalTextLikeCount, lodBand);
                 if (this._lodUsesVisibleSubset !== nextVisibleSubsetMode) {
                     this._lodUsesVisibleSubset = nextVisibleSubsetMode;
@@ -6419,9 +6369,7 @@
                         } else if (lodBand === 'MID') {
                             this._setInstancedBaseColor(0xffffff);
                             this._setInstancedDefaultBorderColor(0xd1d5db);
-                            if (previousResidentBand === 'FAR') {
-                                this._markLineDetailsDirty();
-                            }
+                            if (previousResidentBand === 'FAR') window.MindMapRenderPlan?.ensureResidentLineDetails?.(this, lodBand);
                         }
                     }
                     const shouldSyncTemplateCss3d =
@@ -6884,7 +6832,7 @@
             this._cachedImageNodeCount = imageNodeIds.length;
         }
 
-        _updateImageInstanceData(nodeObjectsById) {
+        _updateImageInstanceData(nodeObjectsById, prepareOnly = false) {
             const imagePositions = [];
             const imageSizes = [];
             const imageSelections = [];
@@ -6911,13 +6859,13 @@
 
                 if (contentType === 'image' &&
                     this._shouldUseCssImageFallbackInResidentLod(this._module, this._currentLodBand)) {
-                    this._hideImageLodFullVisual(entry);
+                    if (!prepareOnly) this._hideImageLodFullVisual(entry);
                     return;
                 }
 
                 const obj = entry.glObject || entry.cssObject;
                 if (!obj) {
-                    this._hideImageLodFullVisual(entry);
+                    if (!prepareOnly) this._hideImageLodFullVisual(entry);
                     return;
                 }
 
@@ -6928,7 +6876,7 @@
                     entry.isVisibleInFrustum === true ||
                     isNodeSelected === true;
                 if (!shouldKeepImageInstance) {
-                    this._hideImageLodFullVisual(entry);
+                    if (!prepareOnly) this._hideImageLodFullVisual(entry);
                     return;
                 }
 
@@ -6943,7 +6891,7 @@
                     if (!isRetryDeferred && isLoadPending) {
                         imageBatchPendingIds.add(nodeId);
                     }
-                    if (contentType === 'image') {
+                    if (!prepareOnly && contentType === 'image') {
                         this._syncImageLodTransitionVisual(
                             entry,
                             this._currentLodBand || 'MID',
@@ -6951,7 +6899,7 @@
                             this._module,
                             interactionState
                         );
-                    } else {
+                    } else if (!prepareOnly) {
                         this._syncCssMediaLodFallback(entry, this._module);
                     }
                     return;
@@ -6967,10 +6915,10 @@
                 imageUvRects.push(uvRect[0], uvRect[1], uvRect[2], uvRect[3]);
                 imageNodeIds.push(nodeId);
                 this._imageNodeIdToIndex.set(nodeId, imageNodeIds.length - 1);
-                if (contentType !== 'image') {
+                if (!prepareOnly && contentType !== 'image') {
                     this._hideCssMediaLodFallback(entry);
                 }
-                this._hideImageLodFullVisual(entry);
+                if (!prepareOnly) this._hideImageLodFullVisual(entry);
             });
 
             if (imageBatchPendingIds.size > 0) {
@@ -7135,35 +7083,7 @@
         }
 
         _hasAnimatedGifCssFallbackCandidates(module = this._module) {
-            const nodeObjectsById = module?.nodeObjectsById || this._module?.nodeObjectsById || null;
-            if (!nodeObjectsById) {
-                return false;
-            }
-
-            const candidateIds = [];
-            const pushId = (value) => {
-                const id = String(value || '').trim();
-                if (id) candidateIds.push(id);
-            };
-
-            module?._visibleIds?.forEach?.(pushId);
-            module?._prevVisibleIds?.forEach?.(pushId);
-            pushId(module?.selectedNodeIdJs);
-            module?.multiSelectedNodeIds?.forEach?.(pushId);
-            this._lodImageCssFallbackNodeIds?.forEach?.(pushId);
-
-            const seenIds = new Set();
-            for (const nodeId of candidateIds) {
-                if (seenIds.has(nodeId)) continue;
-                seenIds.add(nodeId);
-
-                const entry = nodeObjectsById.get(nodeId) || null;
-                if (isAnimatedGifImageModel(entry?.model)) {
-                    return true;
-                }
-            }
-
-            return false;
+            return window.MindMapRenderPlan?.hasAnimatedGifCssFallbackCandidates?.(this, module, isAnimatedGifImageModel) === true;
         }
 
         _shouldPreserveCssMediaFallbackForInteraction(entry, module = this._module) {