fix: warm bag scanner

Core/CacheWarmer.lua

@@ -0,0 +1,61 @@
+-- Guda CacheWarmer
+-- Pre-warms ItemDetection's tooltip-scan cache and BagScanner's bag-data
+-- cache shortly after PLAYER_LOGIN, in the background, so the FIRST time the
+-- user opens the bag frame they don't pay for ~80 synchronous tooltip scans.
+--
+-- Reuses Utils:QueueWork (Core/Utils.lua) for frame-budgeted background
+-- processing — no new scheduler.
+
+local addon = Guda
+
+local CacheWarmer = {}
+addon.Modules.CacheWarmer = CacheWarmer
+
+-- Walk player bags 0-4 and warm BagScanner per-bag cache. Cheap, runs inline.
+function CacheWarmer:WarmBagScanner()
+    local BagScanner = Guda.Modules.BagScanner
+    if not BagScanner or not BagScanner.ScanBag then return end
+    -- ScanBag populates the per-bag cache used by GetBagData later.
+    for bagID = 0, 4 do
+        local ok = pcall(function() BagScanner:ScanBag(bagID) end)
+        if not ok then break end
+    end
+end
+
+-- Walk player bags 0-4 and queue one ItemDetection:GetItemProperties per
+-- occupied slot. The work queue spreads them across frames within the
+-- existing 100ms-per-frame budget.
+function CacheWarmer:WarmItemDetectionCache()
+    local Utils = Guda.Modules.Utils
+    local ItemDetection = Guda.Modules.ItemDetection
+    if not (Utils and Utils.QueueWork) then return end
+    if not (ItemDetection and ItemDetection.GetItemProperties) then return end
+
+    for bagID = 0, 4 do
+        local numSlots = GetContainerNumSlots(bagID)
+        if numSlots and numSlots > 0 then
+            for slotID = 1, numSlots do
+                local link = GetContainerItemLink(bagID, slotID)
+                if link then
+                    -- Capture upvalues so the closure has stable bag/slot/link.
+                    local b, s, l = bagID, slotID, link
+                    Utils:QueueWork(function()
+                        -- Minimal itemData — GetItemProperties only needs
+                        -- .link to compute the cache key; bagID/slotID feed
+                        -- the tooltip scan.
+                        ItemDetection:GetItemProperties({ link = l }, b, s)
+                    end, "CacheWarmer.itemDetection")
+                end
+            end
+        end
+    end
+end
+
+function CacheWarmer:Initialize()
+    -- Defer ~0.5s so we don't compete with the busy login frame. The user
+    -- typically opens bags several seconds later, so the cache will be hot.
+    Guda_ScheduleTimer(0.5, function()
+        CacheWarmer:WarmBagScanner()
+        CacheWarmer:WarmItemDetectionCache()
+    end)
+end

Core/Main.lua

@@ -92,6 +92,12 @@ function Main:Initialize()
             addon.Modules.ClamOpener:Initialize()
         end
 
+        -- Pre-warm ItemDetection / BagScanner caches in the background so the
+        -- first bag-frame open after login doesn't freeze on tooltip scans.
+        if addon.Modules.CacheWarmer and addon.Modules.CacheWarmer.Initialize then
+            addon.Modules.CacheWarmer:Initialize()
+        end
+
         -- Setup slash commands
         Main:SetupSlashCommands()
 

Guda.toc

@@ -23,6 +23,7 @@ Core\CategoryManager.lua
 Core\Tooltip.lua
 Core\ClamOpener.lua
 Core\AutoLoot.lua
+Core\CacheWarmer.lua
 
 Data\BagScanner.lua
 Data\BankScanner.lua