From 0ff4577d15b34a99ef4d8ad8187676aa5af8b525 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Sun, 12 Apr 2026 05:17:48 +0000
Subject: [PATCH] =?UTF-8?q?=E2=9A=A1=20Bolt:=20Optimize=20@Published=20arr?=
 =?UTF-8?q?ay=20modifications?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Changed `for` loops mutaing `.isSelected` properties of array elements in `CacheoutViewModel.swift` to `.map` implementations to batched trigger UI updates instead of causing unnecesary notification looping recalculations.

Co-authored-by: acebytes <2820910+acebytes@users.noreply.github.com>
---
 .jules/bolt.md                                |  3 ++
 .../ViewModels/CacheoutViewModel.swift        | 44 +++++++++++++++----
 2 files changed, 39 insertions(+), 8 deletions(-)
 create mode 100644 .jules/bolt.md

diff --git a/.jules/bolt.md b/.jules/bolt.md
new file mode 100644
index 0000000..923d214
--- /dev/null
+++ b/.jules/bolt.md
@@ -0,0 +1,3 @@
+## 2024-05-15 - Batched `@Published` Array Updates
+**Learning:** Mutating individual elements of a `@Published` array inside a `for` loop triggers a UI update notification for every single element change. For collections of structs, using `.map` to create a new array and assigning it back batches the UI update into a single event.
+**Action:** Always use functional methods like `.map` instead of `for` loops when performing bulk modifications on `@Published` value-type collections in SwiftUI ViewModels, and add explanatory comments to prevent future regressions.
diff --git a/Sources/Cacheout/ViewModels/CacheoutViewModel.swift b/Sources/Cacheout/ViewModels/CacheoutViewModel.swift
index 13a9811..8133f10 100644
--- a/Sources/Cacheout/ViewModels/CacheoutViewModel.swift
+++ b/Sources/Cacheout/ViewModels/CacheoutViewModel.swift
@@ -172,14 +172,24 @@ class CacheoutViewModel: ObservableObject {
     }
 
     func selectAllSafe() {
-        for i in scanResults.indices where scanResults[i].category.riskLevel == .safe && !scanResults[i].isEmpty {
-            scanResults[i].isSelected = true
+        // Optimization: Use .map to batch updates and trigger only ONE UI notification.
+        // Mutating elements inside a loop triggers a notification for EVERY element changed.
+        scanResults = scanResults.map { result in
+            var updated = result
+            if updated.category.riskLevel == .safe && !updated.isEmpty {
+                updated.isSelected = true
+            }
+            return updated
         }
     }
 
     func deselectAll() {
-        for i in scanResults.indices {
-            scanResults[i].isSelected = false
+        // Optimization: Use .map to batch updates and trigger only ONE UI notification.
+        // Mutating elements inside a loop triggers a notification for EVERY element changed.
+        scanResults = scanResults.map { result in
+            var updated = result
+            updated.isSelected = false
+            return updated
         }
         deselectAllNodeModules()
     }
@@ -193,17 +203,35 @@ class CacheoutViewModel: ObservableObject {
     }
 
     func selectStaleNodeModules() {
-        for i in nodeModulesItems.indices where nodeModulesItems[i].isStale {
-            nodeModulesItems[i].isSelected = true
+        // Optimization: Use .map to batch updates and trigger only ONE UI notification.
+        // Mutating elements inside a loop triggers a notification for EVERY element changed.
+        nodeModulesItems = nodeModulesItems.map { item in
+            var updated = item
+            if updated.isStale {
+                updated.isSelected = true
+            }
+            return updated
         }
     }
 
     func selectAllNodeModules() {
-        for i in nodeModulesItems.indices { nodeModulesItems[i].isSelected = true }
+        // Optimization: Use .map to batch updates and trigger only ONE UI notification.
+        // Mutating elements inside a loop triggers a notification for EVERY element changed.
+        nodeModulesItems = nodeModulesItems.map { item in
+            var updated = item
+            updated.isSelected = true
+            return updated
+        }
     }
 
     func deselectAllNodeModules() {
-        for i in nodeModulesItems.indices { nodeModulesItems[i].isSelected = false }
+        // Optimization: Use .map to batch updates and trigger only ONE UI notification.
+        // Mutating elements inside a loop triggers a notification for EVERY element changed.
+        nodeModulesItems = nodeModulesItems.map { item in
+            var updated = item
+            updated.isSelected = false
+            return updated
+        }
     }
 
     /// Menu bar label: show free GB in the tray