@mindexec/cli 0.2.450 → 0.2.452

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindexec/cli",
-  "version": "0.2.450",
+  "version": "0.2.452",
   "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 = '20260727-fixed-phase-grid-spotlight-v857';
+    const MINDMAP_CORE_BUILD_ID = '20260727-world-grid-spotlight-v859';
     const CanvasPhase = Object.freeze({
         Booting: 'booting',
         BoardFileLoading: 'board-file-loading',
@@ -105,14 +105,17 @@
     const CAMERA_MOTION_GRID_FALLBACK_ENABLED = false;
     const LOCAL_SNAP_GRID_RADIUS_PX = 500;
     const LOCAL_SNAP_GRID_DIAMETER_PX = LOCAL_SNAP_GRID_RADIUS_PX * 2;
+    const LOCAL_SNAP_GRID_FADE_PX = 100;
+    const LOCAL_SNAP_GRID_SOLID_RADIUS_PX = LOCAL_SNAP_GRID_RADIUS_PX - LOCAL_SNAP_GRID_FADE_PX;
     const LOCAL_SNAP_GRID_MIN_STEP_PX = 8;
     const LOCAL_SNAP_GRID_MAX_STEP_PX = 56;
-    const LOCAL_SNAP_GRID_STEP_BUCKET_PX = 2;
     const LOCAL_SNAP_GRID_OPACITY_BUCKET = 0.04;
     const LOCAL_SNAP_GRID_DEFAULT_STEP_PX = 24;
     const LOCAL_SNAP_GRID_DEFAULT_MAJOR_STEP_PX = 240;
     const LOCAL_SNAP_GRID_DEFAULT_OPACITY = 0.42;
     const LOCAL_SNAP_GRID_TILE_OVERSCAN_PX = LOCAL_SNAP_GRID_MAX_STEP_PX * 10;
+    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;
@@ -3233,6 +3236,10 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             this._lastLocalSnapGridTransformKey = '';
             this._lastLocalSnapGridOpacity = '';
             this._lastLocalSnapGridPatternPeriodPx = LOCAL_SNAP_GRID_DEFAULT_MAJOR_STEP_PX;
+            this._lastLocalSnapGridWorldStep = Math.max(1, Number(this.GRID_SIZE || 10));
+            this._lastLocalSnapGridWorldPeriod = this._lastLocalSnapGridWorldStep * 10;
+            this._localSnapGridRasterPeriodPx = LOCAL_SNAP_GRID_DEFAULT_MAJOR_STEP_PX;
+            this._lastLocalSnapGridBackgroundSizeKey = '';
             this._localSnapGridTileCanvas = null;
             this._localSnapGridPointerRevision = 0;
             this._lastLocalSnapGridPositionRevision = -1;
@@ -3473,6 +3480,7 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             layer.style.backgroundRepeat = 'repeat';
             layer.style.contain = 'paint';
             layer.style.willChange = 'transform';
+            layer.style.transformOrigin = '0 0';
             layer.style.transform = 'translate3d(0, 0, 0)';
             layer.style.transition = 'none';
 
@@ -3484,6 +3492,10 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             this._lastLocalSnapGridPositionRevision = -1;
             this._lastLocalSnapGridOpacity = '';
             this._lastLocalSnapGridPatternPeriodPx = LOCAL_SNAP_GRID_DEFAULT_MAJOR_STEP_PX;
+            this._lastLocalSnapGridWorldStep = Math.max(1, Number(this.GRID_SIZE || 10));
+            this._lastLocalSnapGridWorldPeriod = this._lastLocalSnapGridWorldStep * 10;
+            this._localSnapGridRasterPeriodPx = LOCAL_SNAP_GRID_DEFAULT_MAJOR_STEP_PX;
+            this._lastLocalSnapGridBackgroundSizeKey = '';
             this._localSnapGridStyleDeferredForZoom = false;
             return layer;
         }
@@ -3511,10 +3523,15 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             spotlight.style.opacity = '0';
             spotlight.style.borderRadius = '50%';
             spotlight.style.overflow = 'hidden';
-            spotlight.style.background = 'radial-gradient(circle, rgba(255,255,255,0.34) 0%, rgba(219,234,254,0.14) 52%, rgba(219,234,254,0) 78%)';
-            const spotlightMask = 'radial-gradient(circle at center, #000 0%, rgba(0,0,0,0.96) 36%, rgba(0,0,0,0.62) 58%, rgba(0,0,0,0.16) 78%, transparent 100%)';
+            spotlight.style.background = 'transparent';
+            const spotlightMask =
+                `radial-gradient(circle at 50% 50%, #fff 0px, #fff ${LOCAL_SNAP_GRID_SOLID_RADIUS_PX}px, transparent ${LOCAL_SNAP_GRID_RADIUS_PX}px)`;
             spotlight.style.maskImage = spotlightMask;
             spotlight.style.webkitMaskImage = spotlightMask;
+            spotlight.style.maskRepeat = 'no-repeat';
+            spotlight.style.webkitMaskRepeat = 'no-repeat';
+            spotlight.style.maskSize = '100% 100%';
+            spotlight.style.webkitMaskSize = '100% 100%';
             spotlight.style.contain = 'strict';
             spotlight.style.willChange = 'transform';
             spotlight.style.transform = 'translate3d(0, 0, 0)';
@@ -3544,35 +3561,86 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                 : height / 2;
             const spotlightLeft = Math.round(centerX - LOCAL_SNAP_GRID_RADIUS_PX);
             const spotlightTop = Math.round(centerY - LOCAL_SNAP_GRID_RADIUS_PX);
-            const patternPeriod = Math.max(
+            const camera = this.camera;
+            const cameraZ = Math.max(1, Number(camera?.position?.z || 1));
+            const vfov = (Number(camera?.fov || 45) * Math.PI) / 180;
+            const viewHeight = 2 * Math.tan(vfov / 2) * cameraZ;
+            const pxPerWorld = height / Math.max(1, viewHeight);
+            const gridProjection = this._resolveLocalSnapGridWorldStep(pxPerWorld);
+            const patternPeriod = Math.max(1, gridProjection.majorStepPx);
+            const cameraX = Number(camera?.position?.x || 0);
+            const cameraY = Number(camera?.position?.y || 0);
+            const worldOriginX = (width / 2) - (cameraX * pxPerWorld);
+            const worldOriginY = (height / 2) + (cameraY * pxPerWorld);
+            this._lastLocalSnapGridWorldStep = gridProjection.worldStep;
+            this._lastLocalSnapGridWorldPeriod = gridProjection.worldStep * 10;
+            this._lastLocalSnapGridPatternPeriodPx = patternPeriod;
+            let rasterPeriod = Math.max(
                 1,
-                Math.round(Number(this._lastLocalSnapGridPatternPeriodPx || LOCAL_SNAP_GRID_DEFAULT_MAJOR_STEP_PX))
+                Number(this._localSnapGridRasterPeriodPx || patternPeriod)
             );
+            let compositorScale = patternPeriod / rasterPeriod;
+            if (this._localSnapGridLayer &&
+                (
+                    compositorScale < LOCAL_SNAP_GRID_COMPOSITOR_SCALE_MIN ||
+                    compositorScale > LOCAL_SNAP_GRID_COMPOSITOR_SCALE_MAX
+                )) {
+                rasterPeriod = patternPeriod;
+                compositorScale = 1;
+                this._localSnapGridRasterPeriodPx = rasterPeriod;
+                const rebasedBackgroundSizeKey = rasterPeriod.toFixed(3);
+                this._lastLocalSnapGridBackgroundSizeKey = rebasedBackgroundSizeKey;
+                this._localSnapGridLayer.style.backgroundSize =
+                    `${rebasedBackgroundSizeKey}px ${rebasedBackgroundSizeKey}px`;
+            }
             const positiveModulo = (value, size) => ((value % size) + size) % size;
-            const gridPhaseX = Math.round(positiveModulo(
-                LOCAL_SNAP_GRID_TILE_OVERSCAN_PX - spotlightLeft,
+            const gridPhaseX = positiveModulo(
+                LOCAL_SNAP_GRID_TILE_OVERSCAN_PX + worldOriginX - spotlightLeft,
                 patternPeriod
-            ));
-            const gridPhaseY = Math.round(positiveModulo(
-                LOCAL_SNAP_GRID_TILE_OVERSCAN_PX - spotlightTop,
+            );
+            const gridPhaseY = positiveModulo(
+                LOCAL_SNAP_GRID_TILE_OVERSCAN_PX + worldOriginY - spotlightTop,
                 patternPeriod
-            ));
+            );
             if (DEBUG) {
-                const fixedPhaseX = positiveModulo(
-                    spotlightLeft - LOCAL_SNAP_GRID_TILE_OVERSCAN_PX + gridPhaseX,
+                const worldPhaseErrorX = positiveModulo(
+                    spotlightLeft - LOCAL_SNAP_GRID_TILE_OVERSCAN_PX + gridPhaseX - worldOriginX,
                     patternPeriod
                 );
-                const fixedPhaseY = positiveModulo(
-                    spotlightTop - LOCAL_SNAP_GRID_TILE_OVERSCAN_PX + gridPhaseY,
+                const worldPhaseErrorY = positiveModulo(
+                    spotlightTop - LOCAL_SNAP_GRID_TILE_OVERSCAN_PX + gridPhaseY - worldOriginY,
                     patternPeriod
                 );
+                const normalizedWorldPhaseErrorX = Math.min(
+                    worldPhaseErrorX,
+                    patternPeriod - worldPhaseErrorX
+                );
+                const normalizedWorldPhaseErrorY = Math.min(
+                    worldPhaseErrorY,
+                    patternPeriod - worldPhaseErrorY
+                );
                 window.MindCanvasDevGuards?.assert?.(
-                    fixedPhaseX === 0 && fixedPhaseY === 0,
-                    'local-snap-grid-phase-drift',
-                    { spotlightLeft, spotlightTop, gridPhaseX, gridPhaseY, patternPeriod }
+                    normalizedWorldPhaseErrorX <= 0.001 && normalizedWorldPhaseErrorY <= 0.001,
+                    'local-snap-grid-world-phase-drift',
+                    {
+                        spotlightLeft,
+                        spotlightTop,
+                        worldOriginX,
+                        worldOriginY,
+                        gridPhaseX,
+                        gridPhaseY,
+                        patternPeriod,
+                        worldStep: gridProjection.worldStep,
+                        worldPhaseErrorX: normalizedWorldPhaseErrorX,
+                        worldPhaseErrorY: normalizedWorldPhaseErrorY
+                    }
                 );
             }
-            const transformKey = `${spotlightLeft}|${spotlightTop}|${patternPeriod}|${gridPhaseX}|${gridPhaseY}`;
+            const gridPhaseXValue = gridPhaseX.toFixed(3);
+            const gridPhaseYValue = gridPhaseY.toFixed(3);
+            const compositorScaleValue = compositorScale.toFixed(6);
+            const transformKey =
+                `${spotlightLeft}|${spotlightTop}|${patternPeriod.toFixed(3)}|${gridPhaseXValue}|${gridPhaseYValue}|${compositorScaleValue}`;
             if (transformKey === this._lastLocalSnapGridTransformKey) {
                 return false;
             }
@@ -3580,11 +3648,39 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             spotlight.style.transform = `translate3d(${spotlightLeft}px, ${spotlightTop}px, 0)`;
             if (this._localSnapGridLayer) {
                 this._localSnapGridLayer.style.transform =
-                    `translate3d(${gridPhaseX}px, ${gridPhaseY}px, 0)`;
+                    `translate3d(${gridPhaseXValue}px, ${gridPhaseYValue}px, 0) scale(${compositorScaleValue})`;
             }
             return true;
         }
 
+        _resolveLocalSnapGridWorldStep(pxPerWorld) {
+            const safePxPerWorld = Math.max(Number.EPSILON, Number(pxPerWorld) || Number.EPSILON);
+            const baseWorldStep = Math.max(Number.EPSILON, Number(this.GRID_SIZE || 10));
+            let worldStep = Math.max(
+                Number.EPSILON,
+                Number(this._lastLocalSnapGridWorldStep || baseWorldStep)
+            );
+            let smallStepPx = worldStep * safePxPerWorld;
+            let guard = 0;
+
+            while (smallStepPx < LOCAL_SNAP_GRID_MIN_STEP_PX && guard < 24) {
+                worldStep *= 2;
+                smallStepPx *= 2;
+                guard += 1;
+            }
+            while (smallStepPx > LOCAL_SNAP_GRID_MAX_STEP_PX && guard < 48) {
+                worldStep /= 2;
+                smallStepPx /= 2;
+                guard += 1;
+            }
+
+            return {
+                worldStep,
+                smallStepPx,
+                majorStepPx: smallStepPx * 10
+            };
+        }
+
         _getLocalSnapGridStyleKind() {
             const themeName = String(this.currentThemeName || '').trim();
             return themeName === 'SpatialGrid2D' ? 'dot' : 'line';
@@ -3688,12 +3784,18 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                 Math.round(safeMajorStep * 100),
                 Math.round(safeOpacity * 100)
             ].join('|');
+            const backgroundSizeKey = safeMajorStep.toFixed(3);
 
             if (localGridKey === this._lastLocalSnapGridKey) {
+                this._localSnapGridRasterPeriodPx = safeMajorStep;
+                if (backgroundSizeKey !== this._lastLocalSnapGridBackgroundSizeKey) {
+                    this._lastLocalSnapGridBackgroundSizeKey = backgroundSizeKey;
+                    layer.style.backgroundSize = `${backgroundSizeKey}px ${backgroundSizeKey}px`;
+                    this._lastLocalSnapGridTransformKey = '';
+                }
                 return false;
             }
 
-            this._lastLocalSnapGridKey = localGridKey;
             const opacityValue = safeOpacity.toFixed(3);
             this._lastLocalSnapGridOpacity = opacityValue;
             const tileCanvas = this._localSnapGridTileCanvas || document.createElement('canvas');
@@ -3707,10 +3809,13 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             if (!Number.isFinite(tileSize) || tileSize <= 0) {
                 return false;
             }
-            this._lastLocalSnapGridPatternPeriodPx = tileSize;
+            this._lastLocalSnapGridKey = localGridKey;
+            this._lastLocalSnapGridPatternPeriodPx = safeMajorStep;
+            this._localSnapGridRasterPeriodPx = safeMajorStep;
             this._lastLocalSnapGridTransformKey = '';
             layer.style.backgroundImage = `url("${tileCanvas.toDataURL('image/png')}")`;
-            layer.style.backgroundSize = `${tileSize}px ${tileSize}px`;
+            this._lastLocalSnapGridBackgroundSizeKey = backgroundSizeKey;
+            layer.style.backgroundSize = `${backgroundSizeKey}px ${backgroundSizeKey}px`;
             if (layer.style.opacity !== opacityValue) {
                 layer.style.opacity = opacityValue;
             }
@@ -3831,19 +3936,11 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
             const vfov = (Number(camera.fov || 45) * Math.PI) / 180;
             const viewHeight = 2 * Math.tan(vfov / 2) * cameraZ;
             const pxPerWorld = height / Math.max(1, viewHeight);
-            const worldGrid = Math.max(1, Number(this.GRID_SIZE || 10));
-            const rawSmallStepPx = Math.max(
-                LOCAL_SNAP_GRID_MIN_STEP_PX,
-                Math.min(LOCAL_SNAP_GRID_MAX_STEP_PX, worldGrid * pxPerWorld)
-            );
-            const smallStepPx = Math.max(
-                LOCAL_SNAP_GRID_MIN_STEP_PX,
-                Math.min(
-                    LOCAL_SNAP_GRID_MAX_STEP_PX,
-                    Math.round(rawSmallStepPx / LOCAL_SNAP_GRID_STEP_BUCKET_PX) * LOCAL_SNAP_GRID_STEP_BUCKET_PX
-                )
-            );
-            const majorStepPx = smallStepPx * 10;
+            const gridProjection = this._resolveLocalSnapGridWorldStep(pxPerWorld);
+            const smallStepPx = gridProjection.smallStepPx;
+            const majorStepPx = gridProjection.majorStepPx;
+            this._lastLocalSnapGridWorldStep = gridProjection.worldStep;
+            this._lastLocalSnapGridWorldPeriod = gridProjection.worldStep * 10;
             const styleKind = this._getLocalSnapGridStyleKind();
             const rawOpacity = Math.max(0.24, Math.min(0.54, cameraZ <= 1800 ? 0.48 : 0.48 - ((cameraZ - 1800) / 36000)));
             const opacity = Math.max(
@@ -7845,6 +7942,10 @@ ${summaryLines.map(line => `<div>${escapeNodeFrameDebugHtml(line)}</div>`).join(
                 this._lastLocalSnapGridKey = '';
                 this._lastLocalSnapGridTransformKey = '';
                 this._lastLocalSnapGridPatternPeriodPx = LOCAL_SNAP_GRID_DEFAULT_MAJOR_STEP_PX;
+                this._lastLocalSnapGridWorldStep = Math.max(1, Number(this.GRID_SIZE || 10));
+                this._lastLocalSnapGridWorldPeriod = this._lastLocalSnapGridWorldStep * 10;
+                this._localSnapGridRasterPeriodPx = LOCAL_SNAP_GRID_DEFAULT_MAJOR_STEP_PX;
+                this._lastLocalSnapGridBackgroundSizeKey = '';
             }
             if (this._localSnapGridSpotlightLayer) {
                 this._localSnapGridSpotlightLayer.remove();

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

@@ -245,6 +245,7 @@ window.MindMapInteractions = (function () {
                 boundOnMouseUp: onMouseUp.bind(null, module),
                 boundOnResizeHandleCapture: onResizeHandleCapture.bind(null, module),
                 boundOnHoverMove: onHoverMove.bind(null, module),
+                boundOnLocalSnapGridPointerMove: e => updateLocalSnapGridPointer(module, e?.clientX, e?.clientY),
                 boundOnKeyDown: onKeyDown.bind(null, module),
                 boundOnKeyUp: onKeyUp.bind(null, module),
                 boundOnWindowBlur: clearPhysicalWheelModifierState.bind(null, module),
@@ -7747,6 +7748,7 @@ window.MindMapInteractions = (function () {
                 moduleInstance.container.addEventListener('gesturechange', handlers.boundOnGestureChange, { passive: false });
                 moduleInstance.container.addEventListener('gestureend', handlers.boundOnGestureEnd, { passive: false });
             }
+            window.addEventListener('pointermove', handlers.boundOnLocalSnapGridPointerMove, { passive: true, capture: true });
             window.addEventListener('resize', handlers.boundOnResize);
             window.addEventListener('orientationchange', handlers.boundOnViewportMetricsChange);
             if (window.visualViewport) {
@@ -7821,6 +7823,7 @@ window.MindMapInteractions = (function () {
                 moduleInstance.container.removeEventListener('gesturechange', handlers.boundOnGestureChange);
                 moduleInstance.container.removeEventListener('gestureend', handlers.boundOnGestureEnd);
             }
+            window.removeEventListener('pointermove', handlers.boundOnLocalSnapGridPointerMove, true);
             window.removeEventListener('resize', handlers.boundOnResize);
             window.removeEventListener('orientationchange', handlers.boundOnViewportMetricsChange);
             if (window.visualViewport) {

package/wwwroot/index.html

@@ -579,7 +579,7 @@
             }
 
             const base = '_content/MindExecution.Shared/js/';
-            const scriptVersion = '20260727-fixed-phase-grid-v950';
+            const scriptVersion = '20260727-world-grid-spotlight-v953';
             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":  "ILA9KwLq",
+    "version":  "gjgWz+5A",
     "assets":  [
                    {
                        "hash":  "sha256-+CSYMcqLNTsq3VnH11jgYyOCCdxvHzL74CBmo4sCmMU=",
@@ -78,7 +78,7 @@
                        "url":  "_content/MindExecution.Shared/js/marked.min.js"
                    },
                    {
-                       "hash":  "sha256-lPc30WYtXer88DsvAY5tCILPz0xFdfM0l3P+Ccw4wS8=",
+                       "hash":  "sha256-BLrKOjNbUa/5P4vblFrB7DrePPcBot3rJ2r8BIZqI6M=",
                        "url":  "_content/MindExecution.Shared/js/mind-map-core.js"
                    },
                    {
@@ -110,7 +110,7 @@
                        "url":  "_content/MindExecution.Shared/js/mind-map-glow-shader.js"
                    },
                    {
-                       "hash":  "sha256-gyHNM8wV2/nOJXh4raQFoWqfMh5mgd7xomr7BRf+UbQ=",
+                       "hash":  "sha256-wPZrXIRdM4Q6OME4+cmEMyZKC+gqlU9gGdGiHnSF7wk=",
                        "url":  "_content/MindExecution.Shared/js/mind-map-interactions.js"
                    },
                    {
@@ -846,7 +846,7 @@
                        "url":  "icon-512.png"
                    },
                    {
-                       "hash":  "sha256-c2AIozfD07OWnpUIWdjEbUqRQ1OhNnipQpYAVd7zwC0=",
+                       "hash":  "sha256-HUMUqSLlQJIObQIW4BYzraGd+AuERZQXXywV+UU22+4=",
                        "url":  "index.html"
                    },
                    {

package/wwwroot/service-worker.js

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