Core.lua

-------------------------------------------------------------------------------
--
-- SmartBuff
-- Originally created by Aeldra (EU-Proudmoore)
-- Classic & Retail versions by Codermik, additional coding by MrWizard & Speedwaystar
--
-- Join Discord: https://discord.gg/R6EkZ94TKK
-- Cast the most important buffs on you, tanks or party/raid members/pets.
--
-- SmartBuff Core
--
-------------------------------------------------------------------------------

local SG = SMARTBUFF_GLOBALS;

SMARTBUFF_DATE          = "120626";

SMARTBUFF_VERSION       = "r69."..SMARTBUFF_DATE;
SMARTBUFF_VERSIONNR     = SMARTBUFF_CLIENTHIGH;
SMARTBUFF_TITLE         = "SmartBuff";
SMARTBUFF_SUBTITLE      = "Supports you in casting buffs";
SMARTBUFF_DESC          = "Cast the most important buffs on you, your tanks, party/raid members/pets";
SMARTBUFF_VERS_TITLE    = SMARTBUFF_TITLE .. " " .. SMARTBUFF_VERSION;
SMARTBUFF_OPTIONS_TITLE = SMARTBUFF_VERS_TITLE.." Classic ";

-- SG.RebuildTemplateList
-- Assembles SMARTBUFF_TEMPLATES from generics + instances + custom (localization sets the three parts).
-- Order matters: generics first, then instances, then custom. Matches Enum.SmartBuffGroup.
-- Returns: nothing
function SG.RebuildTemplateList()
  SMARTBUFF_TEMPLATES = {};
  for _, src in ipairs({SMARTBUFF_TEMPLATES_GENERICS, SMARTBUFF_TEMPLATES_INSTANCES, SMARTBUFF_TEMPLATES_CUSTOM}) do
    if (src) then
      for _, v in ipairs(src) do table.insert(SMARTBUFF_TEMPLATES, v); end
    end
  end
end
SG.RebuildTemplateList();

-- addon name
SG.addonName = SG.addonName or ...

-- Shared addon state (Check/Cast/Options modules use SMARTBUFF_GLOBALS)
if (not SG._coreReady) then
  SG._coreReady = true;
  SG.SmartbuffPrefix = SG.SmartbuffPrefix or "SBC1.0";
  SG.SmartbuffHeader = SG.SmartbuffHeader or "Smartbuff";
  SG.SmartbuffSession = SG.SmartbuffSession or true;
  SG.SmartbuffVerCheck = SG.SmartbuffVerCheck or false;
  SG.SmartbuffRevision = SG.SmartbuffRevision or 68;
  SG.SmartbuffVerNotifyList = SG.SmartbuffVerNotifyList or {};
  SG.GlobalCd = SG.GlobalCd or 1.5;
  SG.maxSkipCoolDown = SG.maxSkipCoolDown or 3;
  SG.maxRaid = SG.maxRaid or 40;
  SG.maxBuffs = SG.maxBuffs or 40;
  SG.maxScrollButtons = SG.maxScrollButtons or 30;
  SG.numBuffs = SG.numBuffs or 0;
  SG.tStartZone = SG.tStartZone or 0;
  SG.tTicker = SG.tTicker or 0;
  SG.tSync = SG.tSync or 0;
  SG.tLastCheck = SG.tLastCheck or 0;
  SG.iLastBuffSetup = SG.iLastBuffSetup or -1;
  SG.iLastGroupSetup = SG.iLastGroupSetup or -99;
  SG.tAutoBuff = SG.tAutoBuff or 0;
  SG.tDebuff = SG.tDebuff or 0;
  SG.iCurrentFont = SG.iCurrentFont or 6;
  SG.iCurrentList = SG.iCurrentList or -1;
  SG.iLastPlayer = SG.iLastPlayer or -1;
  SG.cGroups = SG.cGroups or {};
  SG.cClassGroups = SG.cClassGroups or {};
  SG.cBuffs = SG.cBuffs or {};
  SG.cBuffIndex = SG.cBuffIndex or {};
  SG.cBuffTimer = SG.cBuffTimer or {};
  SG.cBlacklist = SG.cBlacklist or {};
  SG.cUnits = SG.cUnits or {};
  SG.cBuffsCombat = SG.cBuffsCombat or {};
  SG.cSpellRankInfo = SG.cSpellRankInfo or {};
  SG.cAddUnitList = SG.cAddUnitList or {};
  SG.cIgnoreUnitList = SG.cIgnoreUnitList or {};
  SG.cPlayerTrackers = SG.cPlayerTrackers or {};
  SG.cAuraCache = SG.cAuraCache or {};
  SG.cBagIndexByID = SG.cBagIndexByID or {};
  SG.cBagIndexByName = SG.cBagIndexByName or {};
  SG.cBagIndexDirty = true;
  SG.cIgnoreClasses = SG.cIgnoreClasses or {};
  SG.imgSB = SG.imgSB or "Interface\\Icons\\inv_gizmo_goblinboombox_01";
  SG.imgIconOn = SG.imgIconOn or "Interface\\AddOns\\SmartBuff\\Icons\\MiniMapButtonEnabled";
  SG.imgIconOff = SG.imgIconOff or "Interface\\AddOns\\SmartBuff\\Icons\\MiniMapButtonDisabled";
  SG.tracker = SG.tracker or "";
  SG.soundPath = SG.soundPath or "Interface\\AddOns\\SmartBuff\\Sounds\\";
  SG.DebugChatFrame = SG.DebugChatFrame or DEFAULT_CHAT_FRAME;
  SG.SmartbuffCommands = SG.SmartbuffCommands or { "SBCVER", "SBCCMD", "SBCSYC" };
  SG.cOrderGrp = SG.cOrderGrp or {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11};
  SG.cFonts = SG.cFonts or {"NumberFontNormal", "NumberFontNormalLarge", "NumberFontNormalHuge", "GameFontNormal", "GameFontNormalLarge", "GameFontNormalHuge", "ChatFontNormal", "QuestFont", "MailTextFontNormal", "QuestTitleFont"};
  SG.buildInfo = SG.buildInfo or select(4, GetBuildInfo());
  SG.cClasses = SG.cClasses or {"DRUID", "HUNTER", "MAGE", "PALADIN", "PRIEST", "ROGUE", "SHAMAN", "WARLOCK", "WARRIOR", "HPET", "WPET", "TANK", "HEALER", "DAMAGER"};
end

BINDING_HEADER_SMARTBUFF = "SmartBuff";
-- Prevent the header from showing as a bindable "HEADER_SMARTBUFF" under Other (leave unbound)
BINDING_NAME_HEADER_SMARTBUFF = "";
SMARTBUFF_BOOK_TYPE_SPELL = "spell";
local BOOKTYPE_SPELL = SMARTBUFF_BOOK_TYPE_SPELL;

SG.isPrompting = false

SG.IconPaths = {
  ["Pet"]         = "Interface\\Icons\\spell_nature_spiritwolf",
  ["Roles"]       = "Interface\\LFGFrame\\UI-LFG-ICON-PORTRAITROLES",
  ["Classes"]     = "Interface\\WorldStateFrame\\Icons-Classes",
};

SG.Icons = {
  ["WARRIOR"]     = { SG.IconPaths.Classes, 0.00, 0.25, 0.00, 0.25 },
  ["MAGE"]        = { SG.IconPaths.Classes, 0.25, 0.50, 0.00, 0.25 },
  ["ROGUE"]       = { SG.IconPaths.Classes, 0.50, 0.75, 0.00, 0.25 },
  ["DRUID"]       = { SG.IconPaths.Classes, 0.75, 1.00, 0.00, 0.25 },
  ["HUNTER"]      = { SG.IconPaths.Classes, 0.00, 0.25, 0.25, 0.50 },
  ["SHAMAN"]      = { SG.IconPaths.Classes, 0.25, 0.50, 0.25, 0.50 },
  ["PRIEST"]      = { SG.IconPaths.Classes, 0.50, 0.75, 0.25, 0.50 },
  ["WARLOCK"]     = { SG.IconPaths.Classes, 0.75, 1.00, 0.25, 0.50 },
  ["PALADIN"]     = { SG.IconPaths.Classes, 0.00, 0.25, 0.50, 0.75 },
  ["PET"]         = { SG.IconPaths.Pet, 0.08, 0.92, 0.08, 0.92},
  ["HPET"]        = { SG.IconPaths.Pet, 0.08, 0.92, 0.08, 0.92},
  ["WPET"]        = { SG.IconPaths.Pet, 0.08, 0.92, 0.08, 0.92},
  ["TANK"]        = { SG.IconPaths.Roles, 0.0, 19/64, 22/64, 41/64 },
  ["HEALER"]      = { SG.IconPaths.Roles, 20/64, 39/64, 1/64, 20/64 },
  ["DAMAGER"]     = { SG.IconPaths.Roles, 20/64, 39/64, 22/64, 41/64 },
  ["NONE"]        = { SG.IconPaths.Roles, 20/64, 39/64, 22/64, 41/64 },
};

SG.tracker = ""

-- available sounds (39)
SG.Sounds = {
    "igPlayerBind.ogg",
    "Aggro_Enter_Warning_State.ogg",
    "Aggro_Pulled_Aggro.ogg",
    "LFG_DungeonReady.ogg",
    "LFG_Rewards.ogg",
    "FX_SONIC_SPHEREPULSE_01.ogg",
    "EyeOfKilroggDeath.ogg",
    "GM_ChatWarning.ogg",
    "Bloodlust_player_cast_head.ogg",
    "collectfruit.ogg",
    "collectgold.ogg",
    "collectspud.ogg",
    "collectwings.ogg",
    "EnlargeCast.ogg",
    "exitlevelunlocked.ogg",
    "GO_7LF_Lightforged_Barrier_Death.ogg",
    "RTC_80_ARD_Anvil_Strike.ogg",
    "RTC_80_KAG_TransitionFX_In.ogg",
    "SPELL_MK_BREW_DRINK01.ogg",
    "SPELL_ShadowStrike_Cast.ogg",
    "witchflyaway.ogg",
    "gruntling_horn_bb.ogg",
    "WispPissed3.ogg",
    "FluteRun.ogg", 
    "GnomeFemaleMainJump.ogg",
    "ShaysBell.ogg",
	  "UR_Kologarn_Slay02.ogg",
    "UI_PetBattle_Victory02.ogg",
    "PVPWarning.ogg",
    "PVPFlagTakenHordeMono.ogg",
    "YouAreWeak.ogg",
    "PeasantPissed5.ogg",
    "HumanFemaleSigh01.ogg",
    "HumanMaleSigh01.ogg",
    "GnomeMaleLaugh01.ogg",
    "Emote_Whistle_01.ogg",
    "VO_701_IMage_OF_Millhouse_Manastorm_05.ogg",
    "VO_703_Millhouse_Manastorm_29_M.ogg",
    "VO_901_Millificent_Manastorm_193617.ogg",
};

SG.LSM = LibStub:GetLibrary("LibSharedMedia-3.0", true);
SG.SoundList = SG.SoundList or {};

-- Sound list helpers (LibSharedMedia + bundled ogg files)

-- SG_SoundKeyFromFile (local)
-- Builds a LibSharedMedia sound key from a bundled filename.
-- Parameters:
--   file (string)  Sound filename (e.g. "LFG_DungeonReady.ogg")
-- Returns:
--   (string)  LSM key prefixed with "SmartBuff: "
local function SG_SoundKeyFromFile(file)
  return "SmartBuff: " .. (file:gsub("%.ogg$", ""):gsub("%.mp3$", ""));
end

-- SG.RebuildSoundList
-- Refreshes SG.SoundList from LSM or falls back to bundled sound keys.
-- Parameters: none
-- Returns: nothing
function SG.RebuildSoundList()
  if (SG.LSM) then
    SG.SoundList = SG.LSM:List("sound") or {};
    local filtered = {};
    for _, key in ipairs(SG.SoundList) do
      if (key ~= "None") then
        filtered[#filtered + 1] = key;
      end
    end
    SG.SoundList = filtered;
  else
    SG.SoundList = {};
    for i, file in ipairs(SG.Sounds) do
      SG.SoundList[i] = SG_SoundKeyFromFile(file);
    end
  end
end

-- SG.InitSharedMediaSounds
-- Registers bundled sounds with LibSharedMedia and hooks list refresh callbacks.
-- Parameters: none
-- Returns: nothing
function SG.InitSharedMediaSounds()
  if (SG._lsmSoundsReady) then
    SG.RebuildSoundList();
    return;
  end
  SG._lsmSoundsReady = true;

  if (SG.LSM) then
    for _, file in ipairs(SG.Sounds) do
      local key = SG_SoundKeyFromFile(file);
      if (not SG.LSM:IsValid("sound", key)) then
        SG.LSM:Register(SG.LSM.MediaType.SOUND, key, SG.soundPath .. file);
      end
    end
    SG.LSM.RegisterCallback(SG, "LibSharedMedia_Registered", function(_, mediatype)
      if (mediatype == "sound") then
        SG.RebuildSoundList();
        if (SmartBuffOptionsFrame_ddSounds and SmartBuffOptionsFrame and SmartBuffOptionsFrame:IsVisible()) then
          SMARTBUFF_UpdateSoundDropdown();
        end
      end
    end);
  end

  SG.RebuildSoundList();
end

-- SG.GetSoundDisplayName
-- Returns the display label for a sound list index.
-- Parameters:
--   index (number)  Index into SG.SoundList
-- Returns:
--   (string)  Sound key or fallback string
function SG.GetSoundDisplayName(index)
  if (SG.SoundList and SG.SoundList[index]) then
    return SG.SoundList[index];
  end
  return tostring(index or "?");
end

-- SG.ResolveSoundIndex
-- Resolves the active splash sound index from saved key, legacy index, or default.
-- Parameters: none
-- Returns:
--   (number)  Index into SG.SoundList
function SG.ResolveSoundIndex()
  SG.RebuildSoundList();
  local list = SG.SoundList;
  local count = list and #list or 0;
  if (count == 0) then
    return (SG.O and SG.O.AutoSoundSelection) or 1;
  end

  if (SG.O and SG.O.AutoSoundKey) then
    for i, key in ipairs(list) do
      if (key == SG.O.AutoSoundKey) then
        return i;
      end
    end
  end

  local legacyIdx = SG.O and SG.O.AutoSoundSelection;
  if (type(legacyIdx) == "number" and SG.Sounds[legacyIdx]) then
    local legacyFile = SG.Sounds[legacyIdx]:lower();
    if (SG.LSM) then
      for i, key in ipairs(list) do
        local path = SG.LSM:Fetch("sound", key);
        if (type(path) == "string" and path:lower():find(legacyFile, 1, true)) then
          return i;
        end
      end
    end
    if (legacyIdx >= 1 and legacyIdx <= count) then
      return legacyIdx;
    end
  end

  for i, key in ipairs(list) do
    if (key:find("LFG_DungeonReady", 1, true)) then
      return i;
    end
  end
  return 1;
end

-- SG.SetSoundSelection
-- Saves splash sound choice by list index and LSM key.
-- Parameters:
--   index (number)  Sound list index (clamped to valid range)
-- Returns: nothing
function SG.SetSoundSelection(index)
  if (not SG.O) then return; end
  SG.RebuildSoundList();
  local count = SG.SoundList and #SG.SoundList or 0;
  if (count < 1) then return; end
  if (index < 1) then index = 1; end
  if (index > count) then index = count; end
  SG.O.AutoSoundSelection = index;
  SG.O.AutoSoundKey = SG.SoundList[index];
end

-- SG.PlaySplashSoundMedia
-- Plays a sound by file path or numeric sound kit ID.
-- Parameters:
--   media (string|number)  File path or PlaySound kit ID
-- Returns: nothing
function SG.PlaySplashSoundMedia(media)
  if (not media) then return; end
  if (type(media) == "number") then
    PlaySound(media);
  else
    PlaySoundFile(media);
  end
end

-- SG.PlaySplashSound
-- Plays the configured splash reminder sound.
-- Parameters: none
-- Returns: nothing
function SG.PlaySplashSound()
  if (not SG.O) then return; end
  local idx = SG.ResolveSoundIndex();
  local key = SG.SoundList and SG.SoundList[idx];
  if (key and SG.LSM) then
    SG.PlaySplashSoundMedia(SG.LSM:Fetch("sound", key));
    return;
  end
  if (SG.Sounds and SG.O.AutoSoundSelection and SG.Sounds[SG.O.AutoSoundSelection]) then
    PlaySoundFile(SG.soundPath .. SG.Sounds[SG.O.AutoSoundSelection]);
  end
end

-- Skip-over-buffing splash helpers

-- SG.GetSkipSplashDelay
-- Returns splash duration used between skip-over-buff transitions.
-- Parameters: none
-- Returns:
--   (number)  Seconds (SplashDuration option, default 2)
function SG.GetSkipSplashDelay()
  local d = SG.O and SG.O.SplashDuration;
  if (not d or d <= 0) then return 2; end
  return d;
end

-- SG.ShouldSkipBuff
-- Returns true when a buff has reached its skip-over reminder limit.
-- Parameters:
--   buffnS (string)  Buff short name
-- Returns:
--   (boolean)
function SG.ShouldSkipBuff(buffnS)
  if (not SG.O or not SG.O.SkipOverBuffing or not buffnS) then return false; end
  local limit = SG.O.SkipSplashLimit;
  if (not limit or limit <= 0) then return false; end
  if (not SG.O.SkipSplashCounts) then return false; end
  return (SG.O.SkipSplashCounts[buffnS] or 0) >= limit;
end

-- SG.RequestSkipSplashRecheck
-- Schedules the next auto check after splash duration (skip transition).
-- Parameters: none
-- Returns: nothing
function SG.RequestSkipSplashRecheck()
  SG.tSkipSplashRecheck = GetTime() + SG.GetSkipSplashDelay();
end

-- SG.ResetSkipSplashCycle
-- Clears all per-buff skip-over splash counters.
-- Parameters: none
-- Returns: nothing
function SG.ResetSkipSplashCycle()
  if (SG.O and SG.O.SkipSplashCounts) then
    wipe(SG.O.SkipSplashCounts);
  end
end

-- SG.IncrementSkipSplashCount
-- Increments splash reminder count for a buff; schedules transition at limit.
-- Parameters:
--   buffnS (string)  Buff short name
-- Returns: nothing
function SG.IncrementSkipSplashCount(buffnS)
  if (not SG.O or not buffnS) then return; end
  if (not SG.O.SkipSplashCounts) then SG.O.SkipSplashCounts = { }; end
  SG.O.SkipSplashCounts[buffnS] = (SG.O.SkipSplashCounts[buffnS] or 0) + 1;
  SG.NoteSkipSplashAction();
  local limit = SG.O.SkipSplashLimit or 3;
  if (SG.O.SkipOverBuffing and SG.O.SkipSplashCounts[buffnS] >= limit) then
    SG.RequestSkipSplashRecheck();
  end
end

-- SG.ClearSkipSplashCount
-- Clears skip-over counter when a buff is applied or no longer missing.
-- Parameters:
--   buffnS (string)  Buff short name
-- Returns: nothing
function SG.ClearSkipSplashCount(buffnS)
  if (not SG.O or not SG.O.SkipSplashCounts or not buffnS) then return; end
  SG.O.SkipSplashCounts[buffnS] = nil;
end

-- SG.BeginSkipSplashPass
-- Starts tracking a skip-over pass for player unit checks.
-- Parameters:
--   unit (string)  Unit token being checked
-- Returns: nothing
function SG.BeginSkipSplashPass(unit)
  if (unit == "player" and SG.O and SG.O.SkipOverBuffing) then
    SG.skipSplashPass = { hadSkippedMissing = false, hadAction = false };
  else
    SG.skipSplashPass = nil;
  end
end

-- SG.NoteSkipSplashSkipped
-- Marks that a buff was skipped during the current skip-over pass.
-- Parameters: none
-- Returns: nothing
function SG.NoteSkipSplashSkipped()
  if (SG.skipSplashPass) then
    SG.skipSplashPass.hadSkippedMissing = true;
  end
end

-- SG.NoteSkipSplashAction
-- Marks that a splash or cast action occurred during the skip-over pass.
-- Parameters: none
-- Returns: nothing
function SG.NoteSkipSplashAction()
  if (SG.skipSplashPass) then
    SG.skipSplashPass.hadAction = true;
  end
end

-- SG.CancelSkipSplashPass
-- Cancels skip-over pass tracking (e.g. after showing a splash).
-- Parameters: none
-- Returns: nothing
function SG.CancelSkipSplashPass()
  SG.skipSplashPass = nil;
end

-- SG.FinishSkipSplashPass
-- Ends a skip-over pass; resets cycle when only skips occurred with no action.
-- Parameters: none
-- Returns: nothing
function SG.FinishSkipSplashPass()
  local pass = SG.skipSplashPass;
  SG.skipSplashPass = nil;
  if (not pass or not SG.O or not SG.O.SkipOverBuffing) then return; end
  if (pass.hadAction) then return; end
  if (not pass.hadSkippedMissing) then return; end
  SG.ResetSkipSplashCycle();
  SG.RequestSkipSplashRecheck();
end

-- upvalues
local UnitCastingInfo = _G.UnitCastingInfo or _G.CastingInfo
local UnitChannelInfo = _G.UnitChannelInfo or _G.ChannelInfo
local GetNumSpecGroups = _G.GetNumTalentGroups or function(...) return 1 end
local GetActiveTalentGroup = _G.GetActiveTalentGroup or function() return 1 end
local IsActiveBattlefieldArena = _G.IsActiveBattlefieldArena or function(...) return false end
local HasLFGRestrictions = _G.HasLFGRestrictions or function() return false end
local LE_PARTY_CATEGORY_INSTANCE = _G.LE_PARTY_CATEGORY_INSTANCE
local CancelUnitBuff = _G.CancelUnitBuff

-- CancelPlayerBuffByName (local)
-- Cancels a helpful buff on the player by matching localized name (hunter anti-daze).
-- Parameters:
--   buffName (string)  Localized buff name from GetSpellInfo
-- Returns:
--   (boolean)  True when a matching buff was cancelled
local function CancelPlayerBuffByName(buffName)
  if (not buffName or not CancelUnitBuff) then
    return false;
  end
  for i = 1, 40 do
    local name = UnitBuff("player", i);
    if (not name) then
      break;
    end
    if (name == buffName) then
      CancelUnitBuff("player", i);
      return true;
    end
  end
  return false;
end

-- Popup to reset everything
StaticPopupDialogs["SMARTBUFF_DATA_PURGE"] = {
  text = SMARTBUFF_OFT_PURGE_DATA,
  button1 = SMARTBUFF_OFT_YES,
  button2 = SMARTBUFF_OFT_NO,
  OnAccept = function() SMARTBUFF_ResetAll() end,
  timeout = 0,
  whileDead = 1,
  hideOnEscape = 1
}

-- Popup to reloadui
StaticPopupDialogs["SMARTBUFF_GUI_RELOAD"] = {
  text = SMARTBUFF_OFT_REQ_RELOAD,
  button1 = SMARTBUFF_OFT_OKAY,
  OnAccept = function() ReloadUI() end,
  timeout = 0,
  whileDead = 1,
  hideOnEscape = 1
}

-- Utility helpers

-- SG.Round
-- Rounds a number to the given decimal places.
-- Parameters:
--   num (number)  Value to round
--   idp (number)  Decimal places (default 0)
-- Returns:
--   (number)  Rounded value
function SG.Round(num, idp)
  SG.r_mult = 10^(idp or 0);
  return math.floor(num * SG.r_mult + 0.5) / SG.r_mult;
end

-- SG.BCC
-- Builds a WoW chat color code from normalized RGB values.
-- Parameters:
--   r, g, b (number)  Color components 0–1
-- Returns:
--   (string)  "|cffRRGGBB" color prefix
function SG.BCC(r, g, b)
  return string.format("|cff%02x%02x%02x", (r*255), (g*255), (b*255));
end

SG.BL = SG.BCC(0, 0, 1);
SG.BLD = SG.BCC(0, 0, 0.7);
SG.BLL = SG.BCC(0.5, 0.8, 1);
SG.GR = SG.BCC(0, 1, 0);
SG.GRD = SG.BCC(0, 0.7, 0);
SG.GRL = SG.BCC(0.6, 1, 0.6);
SG.RD = SG.BCC(1, 0, 0);
SG.RDD = SG.BCC(0.7, 0, 0);
SG.RDL = SG.BCC(1, 0.3, 0.3);
SG.YL = SG.BCC(1, 1, 0);
SG.YLD = SG.BCC(0.7, 0.7, 0);
SG.YLL = SG.BCC(1, 1, 0.5);
SG.OR = SG.BCC(1, 0.7, 0);
SG.ORD = SG.BCC(0.7, 0.5, 0);
SG.ORL = SG.BCC(1, 0.6, 0.3);
SG.WH = SG.BCC(1, 1, 1);
SG.CY = SG.BCC(0.5, 1, 1);

-- SG.treorder
-- Moves an element within an array table by offset n positions.
-- Parameters:
--   t (table)   Array table
--   i (number)  Source index
--   n (number)  Offset (+/- positions)
-- Returns: nothing
function SG.treorder(t, i, n)
  if (t and type(t) == "table" and t[i]) then
    local s = t[i];
    tremove(t, i);
    if (i + n < 1) then
      tinsert(t, 1, s);
    elseif (i + n > #t) then
      tinsert(t, s);
    else
      tinsert(t, i + n, s);
    end
  end
end

-- SG.tfind
-- Finds a value in a table and returns its key/index.
-- Parameters:
--   t (table)       Table to search
--   s (any)         Value to find
-- Returns:
--   (any|false)  Key/index when found, else false
function SG.tfind(t, s)
  if (t and type(t) == "table" and s) then
    for k, v in pairs(t) do
      if (v and v == s) then
        return k;
      end
    end
  end
  return false;
end

-- SG.tcontains
-- Returns true if array table t contains value s.
-- Parameters:
--   t (table)  Array table
--   s (any)    Value to find
-- Returns:
--   (boolean)
function SG.tcontains(t, s)
  if (t and type(t) == "table" and s) then 
    for _, v in ipairs(t) do
      if (v == s) then
        return true;
      end
    end
  end
  return false;
end

-- SG.ChkS
-- Returns text or empty string when nil (safe string for debug output).
-- Parameters:
--   text (string|nil)
-- Returns:
--   (string)
function SG.ChkS(text)
  if (text == nil) then
    text = "";
  end
  return text;
end

-- SG.IsVisibleToPlayer
-- Returns true when a frame is fully visible on screen.
-- Parameters:
--   self (Frame)  Frame to test
-- Returns:
--   (boolean)
function SG.IsVisibleToPlayer(self)
  if (not self) then return false; end
  local w, h = UIParent:GetWidth(), UIParent:GetHeight();
  local x, y = self:GetLeft(), UIParent:GetHeight() - self:GetTop();
  if (x >= 0 and x < (w - self:GetWidth()) and y >= 0 and y < (h - self:GetHeight())) then
    return true;
  end
  return false;
end

-- SG.CS
-- Returns current talent spec/group index (cached in SG.currentSpec).
-- Parameters: none
-- Returns:
--   (number)  Spec index (default 1)
function SG.CS()
  if (SG.currentSpec == nil) then
    SG.currentSpec = GetActiveTalentGroup()
  end
  if (SG.currentSpec == nil) then
    SG.currentSpec = 1;
  end
  return SG.currentSpec;
end

-- SG.CT
-- Returns current buff template name (cached in SG.currentTemplate).
-- Parameters: none
-- Returns:
--   (string)  Template name from SMARTBUFF_TEMPLATES
function SG.CT()
  if (SG.currentTemplate ~= nil) then
    return SG.currentTemplate;
  end
  if (SG.O and SG.O.LastTemplate and SMARTBUFF_TEMPLATES) then
    for _, tname in ipairs(SMARTBUFF_TEMPLATES) do
      if (tname == SG.O.LastTemplate) then
        SG.currentTemplate = SG.O.LastTemplate;
        return SG.currentTemplate;
      end
    end
  end
  if (SMARTBUFF_TEMPLATES and SMARTBUFF_TEMPLATES[1]) then
    SG.currentTemplate = SMARTBUFF_TEMPLATES[1];
    return SG.currentTemplate;
  end
  SG.currentTemplate = SG.smartBuffTemplateForGroupKey("Solo");
  return SG.currentTemplate;
end

-- SG.smartBuffTemplateForGroupKey
-- Maps Enum.SmartBuffGroup key to template name.
-- Parameters:
--   key (string)  e.g. "Solo", "Party", "Raid"
-- Returns:
--   (string|nil)  Template name
function SG.smartBuffTemplateForGroupKey(key)
  if (not SMARTBUFF_TEMPLATES or not Enum or not Enum.SmartBuffGroup or not key) then
    return nil;
  end
  local idx = Enum.SmartBuffGroup[key];
  if (not idx) then
    return nil;
  end
  return SMARTBUFF_TEMPLATES[idx];
end

-- SG.IsLFGGroup
-- True when the player is in a dungeon-finder (LFG) party.
-- Returns:
--   (boolean)
function SG.IsLFGGroup()
  if (HasLFGRestrictions()) then
    return true;
  end
  if (LE_PARTY_CATEGORY_INSTANCE and IsInGroup(LE_PARTY_CATEGORY_INSTANCE)) then
    return true;
  end
  return false;
end

-- SG.buffsTemplateTable
-- Returns saved buff settings table for a template on current spec.
-- Parameters:
--   templateName (string|nil)  Template name; defaults to SG.CT()
-- Returns:
--   (table|nil)  Per-buff settings for the template
function SG.buffsTemplateTable(templateName)
  if (not SG.B) then return nil; end
  local spec = SG.B[SG.CS()];
  if (not spec) then return nil; end
  templateName = templateName or SG.CT();
  if (not templateName) then return nil; end
  return spec[templateName];
end

-- templateHasEnabledBuffs (local)
-- Returns true if any buff in the template has EnableS or EnableG set.
-- Parameters:
--   templateName (string)  Template name
-- Returns:
--   (boolean)
local function templateHasEnabledBuffs(templateName)
  local t = SG.buffsTemplateTable(templateName);
  if (not t or type(t) ~= "table") then return false; end
  for k, v in pairs(t) do
    if (type(v) == "table" and (v.EnableS or v.EnableG)) then return true; end
  end
  return false;
end

-- SG.maybeCopyTemplateOnFirstSwitch
-- Copies buff settings from one template to another on first auto-switch (RetainTemplate).
-- Parameters:
--   fromT (string)  Source template name
--   toT   (string)  Destination template name
-- Returns: nothing
function SG.maybeCopyTemplateOnFirstSwitch(fromT, toT)
  if (not SG.buffsTemplateTable(fromT)) then return; end
  if (not SG.O or not SG.O.RetainTemplate) then return; end
  if (not templateHasEnabledBuffs(fromT)) then return; end
  if (SG.buffsTemplateTable(toT) and templateHasEnabledBuffs(toT)) then return; end

  local src = SG.buffsTemplateTable(fromT);
  local spec = SG.B[SG.CS()];
  if (not spec) then return; end
  spec[toT] = spec[toT] or {};
  local dst = spec[toT];

  for k, v in pairs(src) do
    if (type(v) == "table") then
      dst[k] = {};
      for k2, v2 in pairs(v) do
        if (type(v2) == "table") then
          local copy = {};
          for a, b in pairs(v2) do copy[a] = b; end
          dst[k][k2] = copy;
        else
          dst[k][k2] = v2;
        end
      end
    else
      dst[k] = v;
    end
  end
end

-- SG.GetBuffSettings
-- Returns per-buff settings for current spec and template.
-- Parameters:
--   buff (string)  Buff short name
-- Returns:
--   (table|nil)  Buff settings table
function SG.GetBuffSettings(buff)
  if (SG.B and buff) then
    return SG.B[SG.CS()][SG.CT()][buff];
  end
  return nil;
end

-- SG.InitBuffSettings
-- Creates or upgrades per-buff settings defaults for the current template.
-- Parameters:
--   cBI   (table)    Buff definition entry from SG.cBuffs
--   reset (boolean)  When true, wipes and reinitializes settings
-- Returns: nothing
function SG.InitBuffSettings(cBI, reset)
  local buff = cBI.BuffS;
  local cBuff = SG.GetBuffSettings(buff);
  if (cBuff == nil) then
    SG.B[SG.CS()][SG.CT()][buff] = { };
    cBuff = SG.B[SG.CS()][SG.CT()][buff];
    reset = true;
  end

  if (reset) then
    wipe(cBuff);
    cBuff.EnableS = false;
    cBuff.EnableG = false;
    cBuff.SelfOnly = false;
    cBuff.SelfNot = false;
    cBuff.CIn = false;
    cBuff.COut = true;
    cBuff.MH = true; -- default to checked
    cBuff.OH = false;
    cBuff.RH = false;
    cBuff.Reminder = true;
    cBuff.RBTime = 0;
    cBuff.ManaLimit = 0;
    if (cBI.Type == SMARTBUFF_CONST_GROUP or cBI.Type == SMARTBUFF_CONST_ITEMGROUP) then
      for n in pairs(SG.cClasses) do
        if (cBI.Type == SMARTBUFF_CONST_GROUP and not SG.tcontains(SG.cIgnoreClasses, n) and not string.find(cBI.Params, SG.cClasses[n])) then
          cBuff[SG.cClasses[n]] = true;
        else
          cBuff[SG.cClasses[n]] = false;
        end
      end
    end
  end

  -- Upgrades
  if (cBuff.RBTime == nil) then cBuff.Reminder = true; cBuff.RBTime = 0; end -- to 1.10g
  if (cBuff.ManaLimit == nil) then cBuff.ManaLimit = 0; end -- to 1.12b
  if (cBuff.SelfNot == nil) then cBuff.SelfNot = false; end -- to 2.0i
  if (cBuff.AddList == nil) then cBuff.AddList = { }; end -- to 2.1a
  if (cBuff.IgnoreList == nil) then cBuff.IgnoreList = { }; end -- to 2.1a
  if (cBuff.RH == nil) then cBuff.RH = false; end -- to 4.0b

end

-- SG.InitBuffOrder
-- Syncs SG.B[spec].Order with available class buffs (add/remove entries).
-- Parameters:
--   reset (boolean)  When true, clears order before rebuild
-- Returns: nothing
function SG.InitBuffOrder(reset)
  if not SG.B then SG.B = {} end
  if not SG.B[SG.CS()] then SG.B[SG.CS()] = {} end
  if not SG.B[SG.CS()].Order then SG.B[SG.CS()].Order = {} end
  local b;
  local i;
  local ord = SG.B[SG.CS()].Order;

  if (reset) then
    wipe(ord);
  end

  -- Remove no longer existing buffs in the order list
  for k, v in pairs(ord) do
    if (v and SG.cBuffIndex[v] == nil) then
      SMARTBUFF_AddMsgD("Remove from buff order: "..v);
      tremove(ord, k);
    end
  end

  i = 1;
  while (SG.cBuffs[i] and SG.cBuffs[i].BuffS) do
    b = false;
    for _, v in pairs(ord) do
      if (v and v == SG.cBuffs[i].BuffS) then
        b = true;
        break;
      end
    end
    -- buff not found add it to order list
    if (not b) then
      tinsert(ord, SG.cBuffs[i].BuffS);
      SMARTBUFF_AddMsgD("Add to buff order: "..SG.cBuffs[i].BuffS);
    end
    i = i + 1;
  end
end

-- SG.IsMinLevel
-- Returns true when player level meets minimum requirement.
-- Parameters:
--   minLevel (number|nil)  Required level; nil always passes
-- Returns:
--   (boolean)
function SG.IsMinLevel(minLevel)
  if (not minLevel) then
    return true;
  end
  if (minLevel > UnitLevel("player")) then
    return false;
  end
  return true;
end

-- SG.IsPlayerInGuild
-- Returns whether the player is in a guild.
-- Parameters: none
-- Returns:
--   (boolean)
function SG.IsPlayerInGuild()
    return IsInGuild() -- and GetGuildInfo("player")
end

-- SG.IsTalentSkilled
-- Checks whether a talent tab entry matches name and has points spent.
-- Parameters:
--   t    (number)  Talent tab index
--   i    (number)  Talent index within tab
--   name (string)  Expected talent name
-- Returns:
--   (boolean)  True if matching talent has points
--   (number)   Points spent in that talent
function SG.IsTalentSkilled(t, i, name)
  local _, tName, _, _, tAvailable = GetTalentInfo(t, i);
  if (tName) then
    SG.isTTreeLoaded = true;
    SMARTBUFF_AddMsgD("Talent: "..tName..", Points = "..tAvailable);
    if (name and name == tName and tAvailable > 0) then
      SMARTBUFF_AddMsgD("Debuff talent found: "..name..", Points = "..tAvailable);
      return true, tAvailable;
    end
  else
    SMARTBUFF_AddMsgD("Talent tree not available!");
    SG.isTTreeLoaded = false;
  end
  return false, 0;
end

-- SMARTBUFF_OnLoad
-- Registers events, slash commands, and initializes spell IDs and sounds.
-- Parameters:
--   self (Frame)  SmartBuff main event frame
-- Returns: nothing
function SMARTBUFF_OnLoad(self)
  self:RegisterEvent("ADDON_LOADED");
  self:RegisterEvent("PLAYER_LOGIN");
  self:RegisterEvent("PLAYER_ENTERING_WORLD");
  self:RegisterEvent("UNIT_NAME_UPDATE");
  self:RegisterEvent("PLAYER_REGEN_ENABLED");
  self:RegisterEvent("PLAYER_REGEN_DISABLED");
  self:RegisterEvent("PLAYER_STARTED_MOVING");
  self:RegisterEvent("PLAYER_STOPPED_MOVING");
  self:RegisterEvent("PLAYER_TALENT_UPDATE");
  self:RegisterEvent("SPELLS_CHANGED");
  self:RegisterEvent("ACTIONBAR_HIDEGRID");
  self:RegisterEvent("UNIT_AURA");
  self:RegisterEvent("CHAT_MSG_ADDON");
  self:RegisterEvent("CHAT_MSG_CHANNEL");
  self:RegisterEvent("UPDATE_MOUSEOVER_UNIT");
  self:RegisterEvent("UNIT_SPELLCAST_FAILED");
  self:RegisterEvent("UNIT_SPELLCAST_SUCCEEDED");
  self:RegisterEvent("MINIMAP_UPDATE_TRACKING")
  self:RegisterEvent("BAG_UPDATE");

  --auto template events
  self:RegisterEvent("ZONE_CHANGED_NEW_AREA")
  self:RegisterEvent("GROUP_ROSTER_UPDATE")
  self:RegisterEvent("UPDATE_BINDINGS");  -- keybindings saved; re-apply SmartBuff Action override so key works without /reload
  
  --One of them allows SmartBuff to be closed with the Escape key
  tinsert(UISpecialFrames, "SmartBuffOptionsFrame");
  UIPanelWindows["SmartBuffOptionsFrame"] = nil;

  SlashCmdList["SMARTBUFF"] = SMARTBUFF_command;
  SLASH_SMARTBUFF1 = "/sbo";
  SLASH_SMARTBUFF2 = "/sbuff";
  SLASH_SMARTBUFF3 = "/smartbuff";
  SLASH_SMARTBUFF4 = "/sb";

  SlashCmdList["SMARTBUFFMENU"] = SMARTBUFF_OptionsFrame_Toggle;
  SLASH_SMARTBUFFMENU1 = "/sbm";

  SlashCmdList["SmartReloadUI"] = function(msg) ReloadUI(); end;
  SLASH_SmartReloadUI1 = "/rui";

  SMARTBUFF_InitSpellIDs();
  SG.InitSharedMediaSounds();

end

-- SMARTBUFF_OnEvent
-- Central event dispatcher: combat, auras, roster, bags, addon messages, init.
-- Parameters:
--   self  (Frame)   Event frame
--   event (string)  WoW event name
--   ...             Event arguments
-- Returns: nothing
function SMARTBUFF_OnEvent(self, event, ...)
  local arg1, arg2, arg3, arg4, arg5 = ...;

  -- As soon as keybindings are saved (e.g. user set SmartBuff Action key and clicked Okay), re-apply overrides
  if (event == "UPDATE_BINDINGS") then
    if (SG.isInit and SG.O and not InCombatLockdown()) then
      SMARTBUFF_RebindKeys();
    end
    return;
  end

  if ((event == "UNIT_NAME_UPDATE" and arg1 == "player") or event == "PLAYER_ENTERING_WORLD") then
    if SG.IsPlayerInGuild() and event == "PLAYER_ENTERING_WORLD" then
		C_ChatInfo.SendAddonMessage(SG.SmartbuffPrefix, SG.SmartbuffHeader.."?"..SG.SmartbuffCommands[1].."?"..SG.SmartbuffRevision.."?"..SMARTBUFF_VERSION, "GUILD")
	end
	SG.isPlayer = true;
    if  (event == "PLAYER_ENTERING_WORLD" and SG.isInit and SG.O.Toggle) then
      SG.isSetZone = true;
      SG.tStartZone = GetTime();
    end

  elseif event == "MINIMAP_UPDATE_TRACKING" then
      if not GetTrackingTexture() then
        -- we dont have a SG.tracker so force a reset.
        SG.tracker = "";
	  end

  elseif (event == "ADDON_LOADED" and arg1 == SG.addonName) then
    SG.isLoaded = true;
  end

  -- PLAYER_LOGIN
  if event == "PLAYER_LOGIN" then
	local prefixResult = C_ChatInfo.RegisterAddonMessagePrefix(SG.SmartbuffPrefix)
  end

    -- CHAT_MSG_ADDON
  if event == "CHAT_MSG_ADDON" then
    local pktHeader, pktCmd, pktData1, pktData2
	if arg1 == SG.SmartbuffPrefix then
		if arg2 then
            pktHeader, pktCmd, pktData1, pktData2 = strsplit("?", arg2, 4)
            if pktHeader == SG.SmartbuffHeader then
                if pktCmd == SG.SmartbuffCommands[1] then  -- version packet
				    pktData1 = tonumber(pktData1)
                    if pktData1 > SG.SmartbuffRevision and SG.SmartbuffSession then
                        DEFAULT_CHAT_FRAME:AddMessage(SMARTBUFF_MSG_NEWVER1..SMARTBUFF_VERSION..SMARTBUFF_MSG_NEWVER2..pktData1..SMARTBUFF_MSG_NEWVER3)
					    SG.SmartbuffSession = false
					end
                    if SG.SmartbuffVerCheck then
					    if arg5 and arg5 ~= UnitName("player") then
						    DEFAULT_CHAT_FRAME:AddMessage("|cff00e0ffSmartbuff Versions: |cffFFFF00"..arg5.."|cffffffff has "..pktData2.." installed.") 
						end
					end
                elseif pktCmd == SG.SmartbuffCommands[2] then  -- command packet   (future feature)
                elseif pktCmd == SG.SmartbuffCommands[3] then  -- sync packet      (future feature)
                else
                    SMARTBUFF_AddMsgD("Warning: Received an unknown command packet to the addon.");
				end
            else
			    SMARTBUFF_AddMsgD("Warning: Not a valid packet header sent to the addon.");
            end 
		end
	end
  end

  if (event == "SMARTBUFF_UPDATE" and SG.isLoaded and SG.isPlayer and not SG.isInit and not InCombatLockdown()) then
    SMARTBUFF_Options_Init(self);
  end

  if (not SG.isInit or SG.O == nil) then
    return;
  end;

  if (event == "PLAYER_REGEN_DISABLED") then
    SMARTBUFF_Ticker(true);
    if (SG.O.Toggle) then
      if (SG.O.InCombat) then
        for spell, data in pairs(SG.cBuffsCombat) do
          if (data and data.Unit and data.ActionType) then
            if (data.Type == SMARTBUFF_CONST_SELF or data.Type == SMARTBUFF_CONST_FORCESELF or data.Type == SMARTBUFF_CONST_STANCE or data.Type == SMARTBUFF_CONST_ITEM) then
              SmartBuff_KeyButton:SetAttribute("unit", nil);
            else
              SmartBuff_KeyButton:SetAttribute("unit", data.Unit);
            end
            SmartBuff_KeyButton:SetAttribute("type", data.ActionType);
            SmartBuff_KeyButton:SetAttribute("spell", spell);
            SmartBuff_KeyButton:SetAttribute("item", nil);
            SmartBuff_KeyButton:SetAttribute("target-slot", nil);
            SmartBuff_KeyButton:SetAttribute("target-item", nil);
            SmartBuff_KeyButton:SetAttribute("macrotext", nil);
            SmartBuff_KeyButton:SetAttribute("action", nil);
            SMARTBUFF_AddMsgD("Enter Combat, set button: " .. spell .. " on " .. data.Unit .. ", " .. data.ActionType);
            break;
          end
        end
      end
      SMARTBUFF_SyncBuffTimers();
      SMARTBUFF_Check(1, true);
      if SMARTBUFF_IsFishingPoleEquiped() and SG.O.WarnCombatFishingRod then   -- i'll add an option to turn this off later
	    -- warn the player he/she is in combat with a fishing pole equipped.
        DEFAULT_CHAT_FRAME:AddMessage("|cffff0000Smartbuff Warning: |cffff6060"..SMARTBUFF_OFT_FRODWARN)
        PlaySound(12197);
	  end
    end

  elseif (event == "PLAYER_REGEN_ENABLED") then
    SMARTBUFF_Ticker(true);
    if (SG.O.Toggle) then
      if (SG.O.InCombat) then
        SmartBuff_KeyButton:SetAttribute("type", nil);
        SmartBuff_KeyButton:SetAttribute("unit", nil);
        SmartBuff_KeyButton:SetAttribute("spell", nil);
      end
      SMARTBUFF_SyncBuffTimers();
      SMARTBUFF_Check(1, true);
    end

  elseif (event == "PLAYER_STARTED_MOVING") then
	SG.isPlayerMoving = true;

  elseif (event == "PLAYER_STOPPED_MOVING") then
	SG.isPlayerMoving = false;

  elseif (event == "PLAYER_TALENT_UPDATE") then
    if(SmartBuffOptionsFrame:IsVisible()) then
      SmartBuffOptionsFrame:Hide();
    end
    if (SG.currentSpec ~= GetActiveTalentGroup()) then
      SG.currentSpec = GetActiveTalentGroup();
      if (SG.B[SG.currentSpec] == nil) then
        SG.B[SG.currentSpec] = { };
      end
      SMARTBUFF_AddMsg(format(SMARTBUFF_MSG_SPECCHANGED, tostring(SG.currentSpec)), true);
      SG.isSetBuffs = true;
    end

  elseif (event == "SPELLS_CHANGED" or event == "ACTIONBAR_HIDEGRID") then
    SG.isSetBuffs = true;
  end

  if (not SG.O.Toggle) then
    return;
  end;

  if (event == "UNIT_AURA") then
    SG.SMARTBUFF_InvalidateAuraCache(arg1);
    if (UnitAffectingCombat("player") and (arg1 == "player" or string.find(arg1, "^party") or string.find(arg1, "^raid"))) then
      SG.isSyncReq = true;
    end
    -- Cancel hunter Cheetah/Pack on the player when self or group is dazed.
    if (SG.sPlayerClass == "HUNTER" and SG.O.AntiDaze and (arg1 == "player" or string.find(arg1, "^party") or string.find(arg1, "^raid") or string.find(arg1, "pet"))) then
      local _, _, stuntex = GetSpellInfo(1604); -- Dazed debuff icon
      if (stuntex and SMARTBUFF_IsDebuffTexture(arg1, stuntex)) then
        local toCancel = nil;
        if (SMARTBUFF_CheckBuff("player", SMARTBUFF_AOTC)) then
          toCancel = SMARTBUFF_AOTC;
        elseif (SMARTBUFF_CheckBuff("player", SMARTBUFF_AOTP)) then
          toCancel = SMARTBUFF_AOTP;
        end
        if (toCancel and (not SG.tAntiDaze or GetTime() > SG.tAntiDaze + 1)) then
          SG.tAntiDaze = GetTime();
          if (CancelPlayerBuffByName(toCancel)) then
            if (SG.O.ToggleAutoSplash and not SmartBuffOptionsFrame:IsVisible()) then
              SmartBuffSplashFrame:Clear();
              SmartBuffSplashFrame:SetTimeVisible(1);
              SmartBuffSplashFrame:AddMessage("!!! CANCEL "..toCancel.." !!!", SG.O.ColSplashFont.r, SG.O.ColSplashFont.g, SG.O.ColSplashFont.b, 1.0);
            end
            if (SG.O.ToggleAutoChat) then
              SMARTBUFF_AddMsgWarn("!!! CANCEL "..toCancel.." !!!", true);
            end
          end
        end
      end
    end
  end

  if (event == "UI_ERROR_MESSAGE") then
    SMARTBUFF_AddMsgD(string.format("Error message: %s",arg1));
  end

  if (event == "UNIT_SPELLCAST_FAILED") then
    SG.currentUnit = arg1;
    SMARTBUFF_AddMsgD(string.format("Spell failed: %s",arg1));
    if (SG.currentUnit and (string.find(SG.currentUnit, "party") or string.find(SG.currentUnit, "raid") or (SG.currentUnit == "target" and SG.O.Debug))) then
      if (UnitName(SG.currentUnit) ~= SG.sPlayerName and SG.O.BlacklistTimer > 0) then
        SG.cBlacklist[SG.currentUnit] = GetTime();
        if (SG.currentUnit and UnitName(SG.currentUnit)) then
        end
      end
    end
    SG.currentUnit = nil;

  elseif (event == "UNIT_SPELLCAST_SUCCEEDED") then
    if (arg1 and arg1 == "player") then
      local unit = nil;
      local spell = nil;
      local target = nil;
      if (arg1 and arg2) then
        if (not arg3) then arg3 = ""; end
        if (not arg4) then arg4 = ""; end
        SMARTBUFF_AddMsgD("Spellcast succeeded: target " .. arg1 .. ", spellID " .. arg3 .. " (" ..GetSpellInfo(arg3) .. "), " .. arg4)
        if (string.find(arg1, "party") or string.find(arg1, "raid")) then
          spell = arg2;
        end
      end
      if (SG.currentUnit and SG.currentSpell and SG.currentUnit ~= "target") then
        unit = SG.currentUnit;
        spell = SG.currentSpell;
      end
      if (unit) then
        local name = UnitName(unit);
        if (SG.cBuffTimer[unit] == nil) then
          SG.cBuffTimer[unit] = { };
        end
          SG.cBuffTimer[unit][spell] = GetTime();
        if (name ~= nil) then
          SMARTBUFF_AddMsg(name .. ": " .. spell .. " " .. SMARTBUFF_MSG_BUFFED);
          SG.ClearSkipSplashCount(spell);
          SG.currentUnit = nil;
          SG.currentSpell = nil;
        end
      elseif (SG.currentSpell) then
        SG.ClearSkipSplashCount(SG.currentSpell);
        SG.currentSpell = nil;
        SG.currentUnit = nil;
      end
      if (SG.isClearSplash) then
        SG.isClearSplash = false;
        SMARTBUFF_Splash_Clear();
      end
    end
  end

  if event == "ZONE_CHANGED_NEW_AREA" or event == "GROUP_ROSTER_UPDATE" then
    SMARTBUFF_SetTemplate()
  end

  if (event == "BAG_UPDATE") then
    SG.cBagIndexDirty = true;
  elseif (event == "PLAYER_ENTERING_WORLD" and SG.isInit) then
    SMARTBUFF_RebuildBagIndex();
    if (not SG._itemListReady) then
      SMARTBUFF_InitItemList();
      if (SG._itemListReady) then
        SMARTBUFF_SetBuffs();
      end
    end
  end

end

-- SMARTBUFF_OnUpdate
-- Throttled OnUpdate: triggers init, ticker, and auto buff checks (~5 Hz).
-- Parameters:
--   self    (Frame)  Event frame
--   elapsed (number) Seconds since last update
-- Returns: nothing
function SMARTBUFF_OnUpdate(self, elapsed)
  if not self.Elapsed then
    self.Elapsed = 0.2
  end
  self.Elapsed = self.Elapsed - elapsed
  if self.Elapsed > 0 then
    return
  end
  self.Elapsed = 0.2
  if (not SG.isInit) then
    if (SG.isLoaded and GetTime() > SG.tAutoBuff + 0.5) then
      SG.tAutoBuff = GetTime();
      local specID = GetActiveTalentGroup()
      if (specID) then
        SMARTBUFF_OnEvent(self, "SMARTBUFF_UPDATE");
      end
    end
  else
    SMARTBUFF_Ticker();
    SMARTBUFF_Check(1);
  end
end

-- SMARTBUFF_Ticker
-- Periodic timer sync and forced check when auras change.
-- Parameters:
--   force (boolean)  Run immediately regardless of 1s interval
-- Returns: nothing
function SMARTBUFF_Ticker(force)
  if (force or GetTime() > SG.tTicker + 1) then
    SG.tTicker = GetTime();
    if (SG.isSyncReq or SG.tTicker > SG.tSync + 10) then
      SMARTBUFF_SyncBuffTimers();
    end
    if (SG.isAuraChanged) then
      SG.isAuraChanged = false;
      SMARTBUFF_Check(1, true);
    end
  end  
end

-- Chat message helpers

-- SMARTBUFF_AddMsg
-- Prints a normal SmartBuff message to chat (yellow-light).
-- Parameters:
--   msg   (string)   Message text
--   force (boolean)  Show even when normal messages are disabled
-- Returns: nothing
function SMARTBUFF_AddMsg(msg, force)
  if (DEFAULT_CHAT_FRAME and (force or not SG.O.ToggleMsgNormal)) then
    DEFAULT_CHAT_FRAME:AddMessage(SG.YLL .. msg .. "|r");
  end
end

-- SMARTBUFF_AddMsgErr
-- Prints an error message to chat (red).
-- Parameters:
--   msg   (string)   Message text
--   force (boolean)  Show even when error messages are disabled
-- Returns: nothing
function SMARTBUFF_AddMsgErr(msg, force)
  if (DEFAULT_CHAT_FRAME and (force or not SG.O.ToggleMsgError)) then
    DEFAULT_CHAT_FRAME:AddMessage(SG.RDL .. SMARTBUFF_TITLE .. ": " .. msg .. "|r");
  end
end

-- SMARTBUFF_AddMsgWarn
-- Prints a warning message to chat or Parrot (cyan).
-- Parameters:
--   msg   (string)   Message text
--   force (boolean)  Show even when warning messages are disabled
-- Returns: nothing
function SMARTBUFF_AddMsgWarn(msg, force)
  if (DEFAULT_CHAT_FRAME and (force or not SG.O.ToggleMsgWarning)) then
    if (SG.isParrot) then
      Parrot:ShowMessage(SG.CY .. msg .. "|r");
    else
      DEFAULT_CHAT_FRAME:AddMessage(SG.CY .. msg .. "|r");
    end
  end
end

-- SMARTBUFF_AddMsgD
-- Prints a debug message when Debug option is enabled.
-- Parameters:
--   msg (string)  Message text
--   r, g, b (number)  Optional RGB 0–1 (defaults 0.5, 0.8, 1)
-- Returns: nothing
function SMARTBUFF_AddMsgD(msg, r, g, b)
  if (r == nil) then r = 0.5; end
  if (g == nil) then g = 0.8; end
  if (b == nil) then b = 1; end
  if (SG.DebugChatFrame and SG.O and SG.O.Debug) then
    SG.DebugChatFrame:AddMessage(msg, r, g, b);
  end
end

-- Derived from template structure: indices 1-N = GENERICS (order must match localization TEMPLATES_GENERICS).
-- Instances and custom templates use templateLookup; no enum entries needed.
Enum.SmartBuffGroup = {};
for i, key in ipairs({"Solo", "Party", "LFG", "Raid", "Battleground", "Arena"}) do
  Enum.SmartBuffGroup[key] = i;
end

-- Template and unit roster setup

local GatherDisableAnnounce = true

-- SMARTBUFF_SetTemplate
-- Auto-selects buff template from zone/group and rebuilds unit lists.
-- Parameters:
--   force (boolean)  Allow update during combat or with options open
-- Returns: nothing
function SMARTBUFF_SetTemplate(force)
  if (not force and InCombatLockdown()) then return end
  if (not force and SmartBuffOptionsFrame:IsVisible()) then return end

  if (SG.currentTemplate == nil) then
    SG.currentTemplate = SG.smartBuffTemplateForGroupKey("Solo") or (SMARTBUFF_TEMPLATES and SMARTBUFF_TEMPLATES[1]);
  end

  local newTemplate = SG.currentTemplate;
  local switchReason = nil;
  local isRaidInstanceTemplate = false;

  if SG.O.AutoSwitchTemplate then
    local instName, instanceType, _, _, _, _, _, _, _, LfgDungeonID = GetInstanceInfo();
    local templateLookup = Enum.MakeEnumFromTable(SMARTBUFF_TEMPLATES);

    if instanceType == "party" then
      if (SG.IsLFGGroup() or (LfgDungeonID and LfgDungeonID > 0)) then
        newTemplate = SG.smartBuffTemplateForGroupKey("LFG");
        switchReason = "LFG";
      else
        newTemplate = SG.smartBuffTemplateForGroupKey("Party");
        switchReason = "party";
      end
    elseif instanceType == "raid" then
      if SG.O.AutoSwitchTemplateInst then
        local templateIdx = templateLookup[instName] or templateLookup[GetRealZoneText()];
        if templateIdx and SMARTBUFF_TEMPLATES[templateIdx] then
          newTemplate = SMARTBUFF_TEMPLATES[templateIdx];
          isRaidInstanceTemplate = true;
          switchReason = "instance";
        end
      end
      if (not isRaidInstanceTemplate) then
        newTemplate = SG.smartBuffTemplateForGroupKey("Raid");
        switchReason = switchReason or "raid";
      end
    elseif instanceType == "pvp" then
      newTemplate = SG.smartBuffTemplateForGroupKey("Battleground") or SG.smartBuffTemplateForGroupKey("Solo");
      switchReason = "battleground";
    elseif instanceType == "arena" then
      newTemplate = SG.smartBuffTemplateForGroupKey("Arena") or SG.smartBuffTemplateForGroupKey("Solo");
      switchReason = "arena";
    end

    if (not switchReason and SG.O.AutoSwitchTemplateInst) then
      local templateIdx = templateLookup[instName] or templateLookup[GetRealZoneText()];
      if templateIdx and SMARTBUFF_TEMPLATES[templateIdx] then
        newTemplate = SMARTBUFF_TEMPLATES[templateIdx];
        isRaidInstanceTemplate = true;
        switchReason = "instance";
      end
    end

    if (not switchReason) then
      if instanceType and instanceType ~= "none" then
        if IsInRaid() then
          newTemplate = SG.smartBuffTemplateForGroupKey("Raid");
          switchReason = "raid";
        elseif IsInGroup() then
          if (SG.IsLFGGroup()) then
            newTemplate = SG.smartBuffTemplateForGroupKey("LFG");
            switchReason = "LFG";
          else
            newTemplate = SG.smartBuffTemplateForGroupKey("Party");
            switchReason = "party";
          end
        else
          newTemplate = SG.smartBuffTemplateForGroupKey("Solo");
          switchReason = "unknown instance";
        end
      else
        if IsInRaid() then
          newTemplate = SG.smartBuffTemplateForGroupKey("Raid");
          switchReason = "raid";
        elseif IsInGroup() then
          if (SG.IsLFGGroup()) then
            newTemplate = SG.smartBuffTemplateForGroupKey("LFG");
            switchReason = "LFG";
          else
            newTemplate = SG.smartBuffTemplateForGroupKey("Party");
            switchReason = "party";
          end
        else
          newTemplate = SG.smartBuffTemplateForGroupKey("Solo");
          switchReason = "solo";
        end
      end
    end
  end

  if SG.currentTemplate ~= newTemplate then
    SG.maybeCopyTemplateOnFirstSwitch(SG.currentTemplate, newTemplate);
    SMARTBUFF_AddMsgD("Current tmpl: " .. (SG.currentTemplate or "nil") .. " - new tmpl: " .. (newTemplate or "nil"));
    SMARTBUFF_AddMsg(SMARTBUFF_TITLE .. ": " .. SMARTBUFF_OFT_AUTOSWITCHTMP .. " (" .. (switchReason or "instance") .. ") " .. SG.currentTemplate .. " -> " .. newTemplate);
  end

  SG.currentTemplate = newTemplate;

  SMARTBUFF_SetBuffs();
  wipe(SG.cBlacklist);
  wipe(SG.cBuffTimer);
  wipe(SG.cUnits);
  wipe(SG.cGroups);
  SG.cClassGroups = nil;
  wipe(SG.cAddUnitList);
  wipe(SG.cIgnoreUnitList);

  local isArenaOrBG = (SG.currentTemplate == SG.smartBuffTemplateForGroupKey("Arena")) or (SG.currentTemplate == SG.smartBuffTemplateForGroupKey("Battleground"));

  -- Raid Setup, including smart instance templates
  if (SG.currentTemplate == SG.smartBuffTemplateForGroupKey("Raid") or isRaidInstanceTemplate) or (isArenaOrBG and IsInRaid()) then
    SG.cClassGroups = { };
    local name, server, rank, subgroup, level, class, classeng, zone, online, isDead;
    local sRUnit = nil;
    local j = 1;
    local b = false;
    local psg;
    local dash;
    -- do we have a fishing rod equipped and entered a raid?
    if SMARTBUFF_IsFishingPoleEquiped() and SG.O.WarnGroupFishingRod then
      -- warn the player he/she has a fishing pole equipped.
      DEFAULT_CHAT_FRAME:AddMessage("|cffff0000Smartbuff Warning: |cffff6060"..SMARTBUFF_OFT_FRINSWARN)
      PlaySound(12197);
    end
    for n = 1, SG.maxRaid, 1 do
      name, rank, subgroup, level, class, classeng, zone, online, isDead = GetRaidRosterInfo(n);
      if (name) then
        server = nil;
        dash = string.find(name, "-", 1, true);
        if (dash and dash > 0) then
          server = string.sub(name, dash + 1);
          name   = string.sub(name, 1, dash - 1);
          SMARTBUFF_AddMsgD(name .. ", " .. server);
        end
        sRUnit = "raid"..n;

        SMARTBUFF_AddUnitToClass("raid", n);
        SmartBuff_AddToUnitList(1, sRUnit, subgroup);
        SmartBuff_AddToUnitList(2, sRUnit, subgroup);

        if (name == SG.sPlayerName and not server) then
          psg = subgroup;
        end

        if (SG.O.ToggleGrp[subgroup]) then
          if (name == UnitName(sRUnit)) then
            if (SG.cGroups[subgroup] == nil) then
              SG.cGroups[subgroup] = { };
            end
            if (name == SG.sPlayerName and not server) then b = true; end
            SG.cGroups[subgroup][j] = sRUnit;
            j = j + 1;
            -- Add raid pet so it is included in the buff loop (hunter/warlock/mage pets)
            local petUnit = "raidpet"..n;
            if (UnitExists(petUnit) and (classeng == "HUNTER" or classeng == "WARLOCK" or classeng == "MAGE")) then
              SG.cGroups[subgroup][j] = petUnit;
              j = j + 1;
            end
          end
        end
      end
    end --end for

    local curTm = SG.buffsTemplateTable(SG.currentTemplate);
    if (not b or (curTm and curTm.SelfFirst)) then
      SMARTBUFF_AddSoloSetup();
    end

    SMARTBUFF_AddMsgD("Raid Unit-Setup finished");

  -- Party / LFG setup (or Battleground/Arena when in party)
  elseif (SG.currentTemplate == SG.smartBuffTemplateForGroupKey("Party"))
      or (SG.currentTemplate == SG.smartBuffTemplateForGroupKey("LFG"))
      or (isArenaOrBG and IsInGroup()) then
    SG.cClassGroups = { };
    -- do we have a fishing rod equipped and entered a party?
    if SMARTBUFF_IsFishingPoleEquiped() and SG.O.WarnGroupFishingRod then
      -- warn the player he/she is in combat with a fishing pole equipped.
      DEFAULT_CHAT_FRAME:AddMessage("|cffff0000Smartbuff Warning: |cffff6060"..SMARTBUFF_OFT_FRINSWARN)
      PlaySound(12197);
    end
    local curTm = SG.buffsTemplateTable(SG.currentTemplate);
    if (curTm and curTm.SelfFirst) then
      SMARTBUFF_AddSoloSetup();
    end
    SG.cGroups[1] = { };
    SG.cGroups[1][0] = "player";
    SMARTBUFF_AddUnitToClass("player", 0);
    for j = 1, 4, 1 do
      SG.cGroups[1][j] = "party"..j;
      SMARTBUFF_AddUnitToClass("party", j);
      SmartBuff_AddToUnitList(1, "party"..j, 1);
      SmartBuff_AddToUnitList(2, "party"..j, 1);
    end
    -- Add party pets so they are included in the buff loop (Mark of the Wild, Fortitude, etc.)
    local pj = 5;
    for j = 1, 4 do
      local petUnit = "partypet"..j;
      if (UnitExists("party"..j) and UnitExists(petUnit)) then
        local _, oc = UnitClass("party"..j);
        if (oc == "HUNTER" or oc == "WARLOCK" or oc == "MAGE") then
          SG.cGroups[1][pj] = petUnit;
          pj = pj + 1;
        end
      end
    end
    SMARTBUFF_AddMsgD("Party Unit-Setup finished");
  -- Solo Setup
  else
    SMARTBUFF_AddSoloSetup();
    SMARTBUFF_AddMsgD("Solo Unit-Setup finished");
  end
  --collectgarbage();
end

-- SMARTBUFF_AddUnitToClass
-- Registers a unit in SG.cUnits and SG.cClassGroups (including pet aliases).
-- Parameters:
--   unit (string)  Unit prefix ("player", "party", "raid")
--   i    (number)  Unit index
-- Returns: nothing
function SMARTBUFF_AddUnitToClass(unit, i)
  local u = unit;
  local up = "pet";
  if (unit ~= "player") then
    u = unit..i;
    up = unit.."pet"..i;
  end
  if (UnitExists(u)) then
    if (not SG.cUnits[1]) then
      SG.cUnits[1] = { };
    end
    SG.cUnits[1][i] = u;
    local _, uc = UnitClass(u);
    if (uc and not SG.cClassGroups[uc]) then
      SG.cClassGroups[uc] = { };
    end
    if (uc) then
      SG.cClassGroups[uc][i] = u;
    end
    SMARTBUFF_AddMsgD("Unit added: " .. UnitName(u) .. ", " .. u);
    if (uc and uc == "HUNTER") then
      if (not SG.cClassGroups["HPET"]) then
        SG.cClassGroups["HPET"] = { };
      end
      SG.cClassGroups["HPET"][i] = up;
    elseif (uc and (uc == "WARLOCK" or uc == "MAGE")) then
      if (not SG.cClassGroups["WPET"]) then
        SG.cClassGroups["WPET"] = { };
      end
      SG.cClassGroups["WPET"][i] = up;
    end
  end
end

-- SMARTBUFF_AddSoloSetup
-- Builds solo player (and pet) unit tables for group index 0.
-- Parameters: none
-- Returns: nothing
function SMARTBUFF_AddSoloSetup()
  SG.cGroups[0] = { };
  SG.cGroups[0][0] = "player";
  SG.cUnits[0] = { };
  SG.cUnits[0][0] = "player";
  if (SG.sPlayerClass == "HUNTER" or SG.sPlayerClass == "WARLOCK" or SG.sPlayerClass == "MAGE") then SG.cGroups[0][1] = "pet"; end
  local curTm = SG.buffsTemplateTable(SG.currentTemplate);
  if (curTm and curTm.SelfFirst) then
    if (not SG.cClassGroups) then
      SG.cClassGroups = { };
    end
    SG.cClassGroups[0] = { };
    SG.cClassGroups[0][0] = "player";
  end
end

-- SMARTBUFF_GetSpellID
-- Looks up spell ID and spellbook index by spell name.
-- Parameters:
--   spellname (string)  Spell name (case-insensitive)
-- Returns:
--   (number|nil)  Spell ID
--   (number|nil)  Spellbook index
function SMARTBUFF_GetSpellID(spellname)
  local i, id = 1, nil;
  local spellN, spellId, skillType;
  if (spellname) then
    spellname = string.lower(spellname);
  else
    return nil;
  end
  while GetSpellBookItemName(i, BOOKTYPE_SPELL) do
    spellN = GetSpellBookItemName(i, BOOKTYPE_SPELL);
    skillType, spellId = GetSpellBookItemInfo(i, BOOKTYPE_SPELL);
    if (skillType == "FLYOUT") then
      for j = 1, GetNumFlyouts() do
        local fid = GetFlyoutID(j);
        local name, description, numSlots, isKnown = GetFlyoutInfo(fid)
        if (isKnown) then
          for s = 1, numSlots do
		        local flySpellID, overrideSpellID, isKnown, spellN, slotSpecID = GetFlyoutSlotInfo(fid, s);
		        if (isKnown and string.lower(spellN) == spellname) then
		          return flySpellID;
		        end
		      end
		    end
		  end
    end
    if (spellN ~= nil and string.lower(spellN) == spellname) then
      id = spellId;
      break;
    end
    i = i + 1;
  end
  if (id) then
    if (IsPassiveSpell(id) or skillType == "FUTURESPELL" or not IsSpellKnown(id)) then
      id = nil;
      i = nil;
    end
  end
  return id, i;
end

-- SMARTBUFF_SetBuffs
-- Rebuilds SG.cBuffs from class lists and initializes order/combat buffs.
-- Parameters: none
-- Returns: nothing
function SMARTBUFF_SetBuffs()
  if (SG.B == nil) then return; end

  local n = 1;
  local buff = nil;
  local ct = SG.currentTemplate;

  if (SG.B[SG.CS()] == nil) then
    SG.B[SG.CS()] = { };
  end

  SMARTBUFF_InitItemList();
  SMARTBUFF_InitSpellList();

  if (SG.B[SG.CS()][ct] == nil) then
    SG.B[SG.CS()][ct] = { };
    SG.B[SG.CS()][ct].SelfFirst = false;
  end

  wipe(SG.cBuffs);
  wipe(SG.cBuffIndex);
  SG.numBuffs = 0;

  for _, buff in pairs(SMARTBUFF_BUFFLIST) do
    n = SMARTBUFF_SetBuff(buff, n, true);
  end

  for _, buff in pairs(SMARTBUFF_WEAPON) do
    n = SMARTBUFF_SetBuff(buff, n);
  end

  for _, buff in pairs(SMARTBUFF_RACIAL) do
    n = SMARTBUFF_SetBuff(buff, n);
  end

  for _, buff in pairs(SMARTBUFF_TRACKING) do
    n = SMARTBUFF_SetBuff(buff, n);
  end

  for _, buff in pairs(SMARTBUFF_POTION) do
    n = SMARTBUFF_SetBuff(buff, n);
  end

  for _, buff in pairs(SMARTBUFF_SCROLL) do
    n = SMARTBUFF_SetBuff(buff, n);
  end

  for _, buff in pairs(SMARTBUFF_FOOD) do
    n = SMARTBUFF_SetBuff(buff, n);
  end

  wipe(SG.cBuffsCombat);
  SMARTBUFF_SetInCombatBuffs();

  SG.InitBuffOrder(false);

  SG.numBuffs = n - 1;
  SG.isSetBuffs = false;
end

-- SMARTBUFF_SetBuff
-- Adds one buff definition to SG.cBuffs if known/available to the player.
-- Parameters:
--   buff (table)     Buff row from SMARTBUFF_BUFFLIST etc.
--   i    (number)    Target index in SG.cBuffs
--   ia   (boolean)   When true, skip bag count check for itemgroup items
-- Returns:
--   (number)  Next free index in SG.cBuffs
function SMARTBUFF_SetBuff(buff, i, ia)
  if (buff == nil or buff[1] == nil) then return i; end
  SG.cBuffs[i] = nil;
  SG.cBuffs[i] = { };
  SG.cBuffs[i].BuffS = buff[1];
  SG.cBuffs[i].DurationS = ceil(buff[2] * 60);
  SG.cBuffs[i].Type = buff[3];
  SG.cBuffs[i].CanCharge = false;

  if (SMARTBUFF_IsSpell(SG.cBuffs[i].Type)) then
    SG.cBuffs[i].IDS, SG.cBuffs[i].BookID = SMARTBUFF_GetSpellID(SG.cBuffs[i].BuffS);
  end

  if (SG.cBuffs[i].IDS == nil and not(SMARTBUFF_IsItem(SG.cBuffs[i].Type) or SG.cBuffs[i].Type == SMARTBUFF_CONST_TRACK or (SG.cBuffs[i].Type == SMARTBUFF_CONST_GATHERING))) then
    SG.cBuffs[i] = nil;
    return i;
  end

  if (buff[4] ~= nil) then SG.cBuffs[i].LevelsS = buff[4] else SG.cBuffs[i].LevelsS = nil end
  if (buff[5] ~= nil) then SG.cBuffs[i].Params = buff[5] else SG.cBuffs[i].Params = SG.NIL end
  SG.cBuffs[i].Links = buff[6];
  SG.cBuffs[i].Chain = buff[7];

  if (SG.cBuffs[i].IDS ~= nil) then
    SG.cBuffs[i].IconS = GetSpellTexture(SG.cBuffs[i].BuffS);
  else

    if (SG.cBuffs[i].Type == SMARTBUFF_CONST_GATHERING) then	
        local b = false;
        for key, spellId in ipairs(SBClassicGatherers) do
		    spellName = GetSpellInfo(spellId)
            if spellName ~= nil then
		        if IsPlayerSpell(spellId) and spellName == SG.cBuffs[i].BuffS then
		            b = true;	
			        SG.cBuffs[i].IDS = spellId;
			        SG.cBuffs[i].IconS = GetSpellTexture(spellId);
		        end
            end
	    end	
      if (not b) then
        SG.cBuffs[i] = nil;
        return i;
      end

    elseif (SG.cBuffs[i].Type == SMARTBUFF_CONST_TRACK) then
      local b = false;
      for n = 1, C_Minimap.GetNumTrackingTypes() do
	      local trackN, trackT, trackA, trackC = C_Minimap.GetTrackingInfo(n);
	      if (trackN ~= nil) then
	        if (trackN == SG.cBuffs[i].BuffS) then
	          b = true;
	          SG.cBuffs[i].IDS = nil;
	          SG.cBuffs[i].IconS = trackT;
	        end
	      end
      end
      if (not b) then
        SG.cBuffs[i] = nil;
        return i;
      end

    elseif (ia or SG.cBuffs[i].Type == SMARTBUFF_CONST_ITEMGROUP) then
      local _, _, _, _, minLevel, _, _, _, _, texture = GetItemInfo(SG.cBuffs[i].BuffS);
      if (not SG.IsMinLevel(minLevel)) then
        SG.cBuffs[i] = nil;
        return i;
      end
      SG.cBuffs[i].IconS = texture;
    else
      local _, _, _, _, minLevel = GetItemInfo(SG.cBuffs[i].BuffS);
      if (not SG.IsMinLevel(minLevel)) then
        SG.cBuffs[i] = nil;
        return i;
      end
      local _, _, count, texture = SMARTBUFF_FindItem(SG.cBuffs[i].BuffS, SG.cBuffs[i].Chain);

      if count then
	      if (count <= 0) then
            SG.cBuffs[i] = nil;
            return i;
          end
      else
        SG.cBuffs[i] = nil;
        return i;
      end
      SG.cBuffs[i].IconS = texture;
    end
  end

  SMARTBUFF_AddMsgD("Add "..buff[1]);

  SG.cBuffs[i].BuffG = nil; --buff[6]; -- Disabled for Cataclysm
  SG.cBuffs[i].IDG = nil; --SMARTBUFF_GetSpellID(SG.cBuffs[i].BuffG);
  if (SG.cBuffs[i].IDG ~= nil) then
    SG.cBuffs[i].IconG = GetSpellTexture(SG.cBuffs[i].BuffG);
  else
    SG.cBuffs[i].IconG = nil;
  end
  SG.cBuffIndex[SG.cBuffs[i].BuffS] = i;
  if (SG.cBuffs[i].IDG ~= nil) then
    SG.cBuffIndex[SG.cBuffs[i].BuffG] = i;
  end
  SG.InitBuffSettings(SG.cBuffs[i]);

  return i + 1;
end

-- SMARTBUFF_SetInCombatBuffs
-- Populates SG.cBuffsCombat for enabled in-combat self-buffs on the action button.
-- Parameters: none
-- Returns: nothing
function SMARTBUFF_SetInCombatBuffs()
  local ct = SG.currentTemplate;
  if (ct == nil or SG.B[SG.CS()] == nil or SG.B[SG.CS()][ct] == nil) then
    return;
  end
  for name, data in pairs(SG.B[SG.CS()][ct]) do
    if (type(data) == "table" and SG.cBuffIndex[name] and (SG.B[SG.CS()][ct][name].EnableS or SG.B[SG.CS()][ct][name].EnableG) and SG.B[SG.CS()][ct][name].CIn) then
      if (SG.cBuffsCombat[name]) then
        wipe(SG.cBuffsCombat[name]);
      else
        SG.cBuffsCombat[name] = { };
      end
      SG.cBuffsCombat[name].Unit = "player";
      SG.cBuffsCombat[name].Type = SG.cBuffs[SG.cBuffIndex[name]].Type;
      SG.cBuffsCombat[name].ActionType = "spell";
      SMARTBUFF_AddMsgD("Set combat spell: " .. name);
      --break;
    end
  end
end

-- SMARTBUFF_IsTalentFrameVisible
-- Returns true when the talent UI frame is open.
-- Parameters: none
-- Returns:
--   (boolean)
function SMARTBUFF_IsTalentFrameVisible()
  return PlayerTalentFrame and PlayerTalentFrame:IsVisible();
end