LibCustomIcons.lua

-- SPDX-FileCopyrightText: 2025 m00nyONE
-- SPDX-License-Identifier: Artistic-2.0

--[[ doc.lua begin ]]
--- @class LibCustomIcons
local lib = {
    name = "LibCustomIcons",
    version = "dev",
    author = "@m00nyONE",
}

local lib_name = lib.name
local lib_author = lib.author
local lib_version = lib.version
_G[lib_name] = lib

local EM = EVENT_MANAGER

--- @type table<string, string> Table mapping `@accountname` to "texturePath"
local static = {}
--- @type table<string, table> Table mapping `@accountname` to { "texturePath", sizeX, sizeY, fps }
local animated = {}
--[[ doc.lua end ]]

--- Returns a reference to the internal static table.
--- This is only available during addon initialization, to disallow other addons tampering with the data later.
--- returns table<string, string> The table of custom static icons.
function lib.GetStaticTable()
    return static
end
--- Returns a reference to the internal animated table.
--- This is only available during addon initialization, to disallow other addons tampering with the data later.
--- returns table<string, table> The table of custom animated icons.
function lib.GetAnimatedTable()
    return animated
end

--- Internal function to perform post-load initialization.
local function initialize()
    lib.BuildMenu()
end

--- Register for the EVENT_ADD_ON_LOADED event to initialize the addon properly.
EM:RegisterForEvent(lib_name, EVENT_ADD_ON_LOADED, function(_, name)
    if name ~= lib_name then return end

    initialize()

    EM:UnregisterForEvent(lib_name, EVENT_ADD_ON_LOADED)
end)

--- Opens the in-game mail window with donation fields prefilled for supporting the library.
function lib.Donate()
    SCENE_MANAGER:Show('mailSend')
    zo_callLater(function()
        ZO_MailSendToField:SetText(lib_author)
        ZO_MailSendSubjectField:SetText("Donation for " .. lib_name)
        ZO_MailSendBodyField:SetText("")
        ZO_MailSendBodyField:TakeFocus()
    end, 250)
end

--- Handles slash commands for version output and donation prompt.
--- Usage:
--- - `/lci version` — shows current version
--- - `/lci donate` — opens mail window for donations
local function slashCommands(str)
    if str == "version" then d(lib_version) end
    if str == "donate" then lib.Donate() end
    if str == "integrity" then lib.IntegrityCheck() end
end

--- Register slash commands for interacting with the library.
SLASH_COMMANDS["/LibCustomIcons"] = slashCommands
SLASH_COMMANDS["/lci"] = slashCommands