HookAddonOrVariable: drain pending variable hooks from one pfUI.events listener

api/api.lua

@@ -582,6 +582,49 @@ function pfUI.api.HookAddon(addon, func)
   end)
 end
 
+-- [ HookAddonOrVariable ]
+-- Compatibility shim for pfUI plugins (e.g. pfUI-addonskinner) that still
+-- call the pre-rewrite API. Routes addon names through HookAddon, and keeps
+-- the legacy "or variable" fallback for callers that pass a global name.
+-- Pending variable hooks share one ADDON_LOADED/PLAYER_LOGIN listener on
+-- pfUI.events, which unregisters once every hook has run.
+local variableHooks, variableHandles = {}, nil
+
+local function DrainVariableHooks()
+  local ready = {}
+  for name in pairs(variableHooks) do
+    if _G[name] then table.insert(ready, name) end
+  end
+  -- run after the scan: a hook may queue another and grow the table
+  for _, name in ipairs(ready) do
+    local funcs = variableHooks[name]
+    variableHooks[name] = nil
+    for _, func in ipairs(funcs) do func() end
+  end
+  if variableHandles and not next(variableHooks) then
+    for _, handle in ipairs(variableHandles) do handle:Unregister() end
+    variableHandles = nil
+  end
+end
+
+function pfUI.api.HookAddonOrVariable(addon, func)
+  if C_AddOns.DoesAddOnExist(addon) then
+    return pfUI.api.HookAddon(addon, func)
+  end
+  if IsLoggedIn() and _G[addon] then return func() end
+
+  variableHooks[addon] = variableHooks[addon] or {}
+  table.insert(variableHooks[addon], func)
+
+  if not variableHandles then
+    variableHandles = {
+      pfUI.events:RegisterFrameEventAndCallbackWithHandle("ADDON_LOADED", DrainVariableHooks),
+      pfUI.events:RegisterFrameEventAndCallbackWithHandle("PLAYER_LOGIN", DrainVariableHooks),
+    }
+  end
+end
+_G.HookAddonOrVariable = pfUI.api.HookAddonOrVariable
+
 -- [ Create Gold String ]
 -- Transforms a amount of copper into a fully fledged gold string
 -- 'money'      [int]           the amount of coppy (GetMoney())