@buley/hexgrid-3d 3.5.0 → 3.5.1

package/dist/components/HexGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HexGrid.d.ts","sourceRoot":"","sources":["../../src/components/HexGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAA;AAYhF,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAI/C,YAAY,EAAE,KAAK,EAAE,CAAA;AAWrB,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IAEvC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;IACrB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAGhB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IACzC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAEnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAA;IAC9C,mBAAmB,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,IAAI,CAAA;IAC5G,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,0BAA0B,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACpD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,KAAK,CAAA;IACZ,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAoLD,eAAO,MAAM,OAAO,GAAI,CAAC,GAAG,OAAO,EAAE,iMAalC,YAAY,CAAC,CAAC,CAAC,4CAwtIjB,CAAA;AAk7DD,eAAe,OAAO,CAAC"}
+{"version":3,"file":"HexGrid.d.ts","sourceRoot":"","sources":["../../src/components/HexGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAA;AAYhF,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAI/C,YAAY,EAAE,KAAK,EAAE,CAAA;AAWrB,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IAEvC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;IACrB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAGhB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IACzC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAEnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAA;IAC9C,mBAAmB,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,IAAI,CAAA;IAC5G,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,0BAA0B,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACpD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,KAAK,CAAA;IACZ,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAoLD,eAAO,MAAM,OAAO,GAAI,CAAC,GAAG,OAAO,EAAE,iMAalC,YAAY,CAAC,CAAC,CAAC,4CA4xIjB,CAAA;AAk7DD,eAAe,OAAO,CAAC"}

package/dist/components/HexGrid.js

@@ -152,6 +152,7 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
     // Stream control refs to coordinate long-running UI streaming from worker
     const streamTokenRef = useRef(0);
     const streamActiveRef = useRef(false);
+    const streamTouchesOccupancyRef = useRef(false);
     // Reactive state for telemetry overlay (mirrors streamActiveRef)
     const [streamingActive, setStreamingActive] = useState(false);
     // How many tiles remain to stream in the current streaming run
@@ -1253,6 +1254,8 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
             dlog('HexGrid: Grid dimensions changed, reinitializing infections', { old: prevGridKeyRef.current, new: gridKey });
             const isSpherical = gridMetadataRef.current?.isSpherical ?? false;
             const initState = initializeInfectionSystem(hexPositions, photos, effectiveHexRadius, workerDebugRef.current?.spawnClusterMax ?? 8, logger, isSpherical);
+            blankNeighborCountGenerationRef.current = -1;
+            blankNeighborCountRef.current = new Map();
             setInfectionState(initState);
             infectionStateRef.current = initState;
             // Post to worker immediately (use sendEvolve helper so generation is logged)
@@ -1857,6 +1860,16 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
     const tileAlphaRef = useRef(new Map());
     // Per-tile arrival pulse timestamps (ms) to show a brief highlight when a tile appears/updates
     const tilePulseRef = useRef(new Map());
+    // Worker-precomputed neighbor blank counts (index -> blank-neighbor count)
+    const blankNeighborCountRef = useRef(new Map());
+    const blankNeighborCountGenerationRef = useRef(-1);
+    // Fallback cache for local blank-neighbor computation when worker data is unavailable/mismatched
+    const localBlankNeighborCacheRef = useRef({
+        infectionMap: null,
+        positions: null,
+        hexRadius: -1,
+        counts: new Map()
+    });
     // Runtime telemetry: frame timing buffer for FPS/ms overlay
     const frameTimesRef = useRef([]);
     const lastFrameTimeRef = useRef(performance.now());
@@ -2064,8 +2077,9 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
     const lastDrawTimeRef = useRef(0);
     const lastDrawGenRef = useRef(0);
     const cameraDirtyRef = useRef(true);
-    // Minimum ms between draws when idle (30fps)
-    const minFrameMs = 1000 / 30;
+    // Draw cadence: 30fps when actively animating, lower cadence while static.
+    const activeFrameMs = 1000 / 30;
+    const idleFrameMs = 250;
     // Helper to get effective batchPerFrame (transient override if present)
     const getEffectiveBatch = () => {
         const base = Math.max(0, Math.floor(workerDebugRef.current?.batchPerFrame ?? 0));
@@ -2249,6 +2263,8 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
                 lastEvolutionTime: infectionStateRef.current.lastEvolutionTime,
                 generation: infectionStateRef.current.generation
             };
+            blankNeighborCountGenerationRef.current = -1;
+            blankNeighborCountRef.current = new Map();
             setInfectionState(filteredState);
             infectionStateRef.current = filteredState;
             if (workerRef.current) {
@@ -2276,6 +2292,8 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
             // Use the live spawnClusterMax from workerDebug when available so photo reloads honor debug tuning
             const isSpherical = gridMetadataRef.current?.isSpherical ?? false;
             const initState = initializeInfectionSystem(hexPositions, photos, effectiveHexRadius, workerDebugRef.current?.spawnClusterMax ?? 8, logger, isSpherical);
+            blankNeighborCountGenerationRef.current = -1;
+            blankNeighborCountRef.current = new Map();
             setInfectionState(initState);
             infectionStateRef.current = initState;
             if (workerRef.current) {
@@ -2407,6 +2425,20 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
                 dlog('Processing evolved state with', data.infections.length, 'gossip entries');
                 // Convert back from array to Map
                 const newInfectionsMap = new Map(data.infections);
+                if (Array.isArray(data.blankNeighborCounts)) {
+                    try {
+                        blankNeighborCountRef.current = new Map(data.blankNeighborCounts);
+                        blankNeighborCountGenerationRef.current = typeof data.generation === 'number' ? data.generation : -1;
+                    }
+                    catch (err) {
+                        // ignore malformed worker payload
+                    }
+                }
+                else {
+                    // Fallback to local computation when worker payload doesn't include counts.
+                    blankNeighborCountGenerationRef.current = -1;
+                    blankNeighborCountRef.current = new Map();
+                }
                 // Capture tile centers for debug visualization if available
                 if (data.tileCenters && Array.isArray(data.tileCenters)) {
                     try {
@@ -2476,6 +2508,7 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
                 });
                 // If no changes, just replace state
                 if (changes.length === 0) {
+                    streamTouchesOccupancyRef.current = false;
                     setInfectionState({
                         infections: newInfectionsMap,
                         availableIndices: data.availableIndices,
@@ -2493,6 +2526,7 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
                 // Start streaming changes; cancel any previous streamer.
                 streamTokenRef.current += 1;
                 const token = streamTokenRef.current;
+                streamTouchesOccupancyRef.current = changes.some((ch) => ch.type !== 'update');
                 // Mark streaming active so other code (animation loop) can avoid posting new evolves
                 streamActiveRef.current = true;
                 try {
@@ -2519,6 +2553,7 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
                             // stop if cancelled
                             if (streamTokenRef.current !== token) {
                                 streamActiveRef.current = false;
+                                streamTouchesOccupancyRef.current = false;
                                 try {
                                     setStreamingActive(false);
                                 }
@@ -2566,6 +2601,7 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
                             }
                             else {
                                 streamActiveRef.current = false;
+                                streamTouchesOccupancyRef.current = false;
                                 try {
                                     setStreamingActive(false);
                                 }
@@ -2597,6 +2633,10 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
                                 streamActiveRef.current = false;
                             }
                             catch (e) { }
+                            try {
+                                streamTouchesOccupancyRef.current = false;
+                            }
+                            catch (e) { }
                             try {
                                 setStreamingActive(false);
                             }
@@ -2656,6 +2696,7 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
                         }
                         finally {
                             streamActiveRef.current = false;
+                            streamTouchesOccupancyRef.current = false;
                             try {
                                 setStreamingActive(false);
                             }
@@ -2686,25 +2727,54 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
         // Clear canvas
         ctx.fillStyle = '#001122';
         ctx.fillRect(0, 0, screenWidth, screenHeight);
-        // Precompute which infected hexagons are adjacent to a blank (uninfected) hex
-        const infectedIndices = Array.from(infectionState.infections.keys());
-        const infectedSet = new Set(infectedIndices);
-        const blankNeighborCount = new Map();
-        for (const idx of infectedIndices) {
-            // Guard: ensure the index is valid before processing
-            if (idx < 0 || idx >= hexPositions.length)
-                continue;
-            const isSpherical = gridMetadataRef.current?.isSpherical ?? false;
-            const neighbors = getNeighbors(idx, hexPositions, drawnHexRadius, isSpherical);
-            let count = 0;
-            for (const n of neighbors) {
-                if (!infectedSet.has(n))
-                    count++;
+        const infections = infectionState.infections;
+        const dbg = workerDebugRef.current;
+        const projectedPositions = projectedPositionsRef.current;
+        const pulseMap = tilePulseRef.current;
+        const prevAlphaMap = tileAlphaRef.current;
+        const smooth = Math.max(0, Math.min(1, dbg?.translucencySmoothing ?? 0.08));
+        const scratchEnabled = !!dbg?.scratchEnabled;
+        const sheenIntensity = dbg?.sheenIntensity ?? 0.12;
+        const sheenEnabled = !!dbg?.sheenEnabled;
+        const seamInset = dbg?.clusterUvInset ?? 0.0;
+        const isSpherical = gridMetadataRef.current?.isSpherical ?? false;
+        const computeLocalBlankNeighborCounts = () => {
+            const cache = localBlankNeighborCacheRef.current;
+            if (cache.infectionMap === infections &&
+                cache.positions === hexPositions &&
+                cache.hexRadius === drawnHexRadius) {
+                return cache.counts;
+            }
+            const infectedIndices = Array.from(infections.keys());
+            const infectedSet = new Set(infectedIndices);
+            const computed = new Map();
+            for (const idx of infectedIndices) {
+                if (idx < 0 || idx >= hexPositions.length)
+                    continue;
+                const neighbors = getNeighbors(idx, hexPositions, drawnHexRadius, isSpherical);
+                let count = 0;
+                for (const n of neighbors) {
+                    if (!infectedSet.has(n))
+                        count++;
+                }
+                computed.set(idx, count);
             }
-            blankNeighborCount.set(idx, count);
-        }
+            localBlankNeighborCacheRef.current = {
+                infectionMap: infections,
+                positions: hexPositions,
+                hexRadius: drawnHexRadius,
+                counts: computed
+            };
+            return computed;
+        };
+        const canUseWorkerBlankCounts = blankNeighborCountRef.current.size > 0 &&
+            blankNeighborCountGenerationRef.current === infectionState.generation &&
+            !(streamActiveRef.current && streamTouchesOccupancyRef.current);
+        const blankNeighborCount = canUseWorkerBlankCounts
+            ? blankNeighborCountRef.current
+            : computeLocalBlankNeighborCounts();
         // compute sheen progress using configured speed
-        const sheenSpeed = Math.max(0.1, workerDebugRef.current?.sheenSpeed || 10);
+        const sheenSpeed = Math.max(0.1, dbg?.sheenSpeed || 10);
         const now = performance.now();
         const sheenProgress = ((now / 1000) % sheenSpeed) / sheenSpeed;
         // Draw hexagons (with alpha smoothing)
@@ -2742,39 +2812,30 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
         }
         for (let index = 0; index < hexPositions.length; index++) {
             const position = hexPositions[index];
-            // Validate index bounds first
-            if (index < 0 || index >= hexPositions.length)
-                continue;
-            const infection = infectionState.infections.get(index);
-            // CRITICAL GUARD: Skip drawing if this is an uninfected cell with no valid position data
-            // This prevents "ghost" hexagons from appearing in the background
-            if (!infection && !position)
+            if (!position)
                 continue;
+            const infection = infections.get(index);
             const blankCount = infection ? (blankNeighborCount.get(index) || 0) : 0;
             // target alpha based on blank count
             const targetAlpha = infection ? (1.0 - Math.min(blankCount, 6) * 0.066) : 1.0;
-            const prevAlphaMap = tileAlphaRef.current;
             const prev = prevAlphaMap.get(index) ?? targetAlpha;
-            const smooth = Math.max(0, Math.min(1, workerDebugRef.current?.translucencySmoothing ?? 0.08));
             const smoothed = prev + (targetAlpha - prev) * smooth;
             prevAlphaMap.set(index, smoothed);
-            const scratchEnabled = !!workerDebugRef.current?.scratchEnabled;
-            const sheenIntensity = workerDebugRef.current?.sheenIntensity ?? 0.12;
             // Compute pulse progress for this tile
-            const pulseInfo = tilePulseRef.current.get(index);
+            const pulseInfo = pulseMap.get(index);
             let pulseProgress = 0;
             if (pulseInfo) {
-                const elapsed = performance.now() - pulseInfo.start;
+                const elapsed = now - pulseInfo.start;
                 pulseProgress = Math.max(0, Math.min(1, elapsed / pulseInfo.duration));
                 if (pulseProgress >= 1)
-                    tilePulseRef.current.delete(index);
+                    pulseMap.delete(index);
             }
             // Use projected position and scale for drawing
-            const proj = projectedPositionsRef.current[index] || [position[0], position[1], 1, 0, 0];
-            const projX = proj[0];
-            const projY = proj[1];
-            const projScale = proj[2];
-            const projAngle = proj[3] || 0;
+            const proj = projectedPositions[index];
+            const projX = proj ? proj[0] : position[0];
+            const projY = proj ? proj[1] : position[1];
+            const projScale = proj ? proj[2] : 1;
+            const projAngle = proj ? (proj[3] || 0) : 0;
             // proj[4] is z-depth (not needed for drawing, only for click detection)
             // Selective culling: when low-res mode is active, always draw infected tiles but
             // sample uninfected/background tiles to reduce draw count while preserving layout.
@@ -2789,17 +2850,15 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
                 }
             }
             // Draw primary - use drawnHexRadius to account for spacing
-            const sheenEnabled = !!workerDebugRef.current?.sheenEnabled;
-            drawHexagon(ctx, [projX, projY, 0], drawnHexRadius * projScale, infection, textures, index, blankCount, smoothed, sheenProgress, sheenIntensity, sheenEnabled, scratchEnabled, scratchCanvasRef.current, workerDebugRef.current?.clusterUvInset ?? 0.0, pulseProgress, false, false, projAngle);
+            drawHexagon(ctx, [projX, projY, 0], drawnHexRadius * projScale, infection, textures, index, blankCount, smoothed, sheenProgress, sheenIntensity, sheenEnabled, scratchEnabled, scratchCanvasRef.current, seamInset, pulseProgress, false, false, projAngle);
             // Optionally draw antipodal copy (opposite side of sphere).
             // Use the same projection helper as hit-tests so angles/positions match exactly.
-            if (workerDebug.renderBothSides) {
+            if (dbg?.renderBothSides) {
                 try {
                     const anti = mapAndProject(hexPositions[index], true);
                     const antiScale = anti.scale || 1;
                     const antiAngle = anti.angle || 0;
-                    const sheenEnabledAnti = !!workerDebugRef.current?.sheenEnabled;
-                    drawHexagon(ctx, [anti.x, anti.y, 0], drawnHexRadius * antiScale, infection, textures, index, blankCount, smoothed, sheenProgress, sheenIntensity, sheenEnabledAnti, scratchEnabled, scratchCanvasRef.current, workerDebugRef.current?.clusterUvInset ?? 0.0, pulseProgress, false, true, antiAngle);
+                    drawHexagon(ctx, [anti.x, anti.y, 0], drawnHexRadius * antiScale, infection, textures, index, blankCount, smoothed, sheenProgress, sheenIntensity, sheenEnabled, scratchEnabled, scratchCanvasRef.current, seamInset, pulseProgress, false, true, antiAngle);
                 }
                 catch (err) {
                     // Skip drawing antipodal hex if projection fails
@@ -2815,10 +2874,11 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
         try {
             if (workerDebugRef.current?.debugLogs) {
                 // Sample a few random infected hexes to check
+                const infectedIndices = Array.from(infections.keys());
                 const sampleSize = Math.min(5, infectedIndices.length);
                 for (let s = 0; s < sampleSize; s++) {
                     const idx = infectedIndices[Math.floor(Math.random() * infectedIndices.length)];
-                    const infection = infectionState.infections.get(idx);
+                    const infection = infections.get(idx);
                     if (!infection)
                         continue;
                     const texture = textures.get(infection.photo.id);
@@ -2828,7 +2888,7 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
                     const isSpherical = gridMetadataRef.current?.isSpherical ?? false;
                     const neighbors = getNeighbors(idx, hexPositions, drawnHexRadius, isSpherical);
                     for (const nIdx of neighbors) {
-                        const nInf = infectionState.infections.get(nIdx);
+                        const nInf = infections.get(nIdx);
                         // Only check neighbors with the same photo (adjacent tiles of same image)
                         if (!nInf || nInf.photo.id !== infection.photo.id)
                             continue;
@@ -3015,7 +3075,9 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
             // If camera changed recently or infections changed (generation advanced), draw immediately
             const gen = infectionState.generation;
             const genChanged = gen !== lastDrawGenRef.current;
-            if (cameraDirtyRef.current || genChanged || timeSinceLast >= minFrameMs) {
+            const hasVisualAnimation = !!workerDebugRef.current?.sheenEnabled || tilePulseRef.current.size > 0 || streamActiveRef.current;
+            const targetFrameMs = hasVisualAnimation ? activeFrameMs : idleFrameMs;
+            if (cameraDirtyRef.current || genChanged || timeSinceLast >= targetFrameMs) {
                 draw();
                 lastDrawTimeRef.current = now;
                 lastDrawGenRef.current = gen;
@@ -3112,6 +3174,8 @@ export const HexGrid = ({ items, photos: photosProp, onItemClick, onHexClick, sp
             logger.error('spawnClusterAt: Invalid center index', centerIndex);
             return;
         }
+        blankNeighborCountGenerationRef.current = -1;
+        blankNeighborCountRef.current = new Map();
         setInfectionState(prevState => {
             const newInfections = new Map(prevState.infections);
             const newAvailableIndices = [...prevState.availableIndices];

package/dist/workers/hexgrid-worker.worker.js

@@ -153,6 +153,24 @@ function getNeighborsCached(index, positions, hexRadius) {
 function calculateUvBoundsFromGridPosition(gridCol, gridRow, tilesX, tilesY) {
     return _calculateUvBoundsFromGridPosition(gridCol, gridRow, tilesX, tilesY);
 }
+function buildBlankNeighborCounts(infections, positions, hexRadius) {
+    if (!infections || infections.size === 0)
+        return [];
+    const infectedSet = new Set(infections.keys());
+    const out = [];
+    for (const idx of infectedSet) {
+        if (idx < 0 || idx >= positions.length)
+            continue;
+        const neighbors = getNeighborsCached(idx, positions, hexRadius);
+        let blankCount = 0;
+        for (const n of neighbors) {
+            if (!infectedSet.has(n))
+                blankCount++;
+        }
+        out.push([idx, blankCount]);
+    }
+    return out;
+}
 function findConnectedComponents(indices, positions, hexRadius) {
     // Immediate synchronous check - if this doesn't log, the function isn't being called or is blocked
     const startMarker = performance.now();
@@ -1854,6 +1872,7 @@ self.onmessage = function (ev) {
                     availableIndices: res.availableIndices,
                     lastEvolutionTime: res.lastEvolutionTime,
                     generation: res.generation,
+                    blankNeighborCounts: buildBlankNeighborCounts(res.infections, positions, hexRadius),
                 };
                 if (res.tileCenters && res.tileCenters.length > 0) {
                     payload.tileCenters = res.tileCenters;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buley/hexgrid-3d",
-  "version": "3.5.0",
+  "version": "3.5.1",
   "description": "3D hexagonal grid visualization component for React",
   "type": "module",
   "main": "./dist/index.js",