Modul:Firestone/Hero

Die Dokumentation für dieses Modul kann unter Modul:Firestone/Hero/Doku erstellt werden

-- Modul:Firestone/Hero
local Util = require('Modul:Firestone/Util')
local I18n = require('Modul:Firestone/I18n')

local H = {}
-- eigene Loader-Funktion, die beide Schreibweisen probiert
local function loadHeroData()
    -- 1. kanonisch (englisch)
    local ok1, data1 = pcall(mw.loadData, 'Module:Firestone/Data/Heroes')
    if ok1 and type(data1) == 'table' and next(data1) ~= nil then
        return data1
    end

    -- 2. lokalisiert (deutsch)
    local ok2, data2 = pcall(mw.loadData, 'Modul:Firestone/Data/Heroes')
    if ok2 and type(data2) == 'table' and next(data2) ~= nil then
        return data2
    end

    -- 3. Fallback über dein Util (das ja bei den Karten funktioniert)
    local data3 = Util.loadTable('Modul:Firestone/Data/Heroes')
    if type(data3) == 'table' and next(data3) ~= nil then
        return data3
    end

    -- alles leer → nil zurück
    return nil
end

-- Seite, auf der die Helden liegen
local HEROES = loadHeroData() or {}

-- I18n holen (wie bei dir)
local function getI18n()
    if type(I18n) == "table" and type(I18n.get) == "function" then
        local ok, data = pcall(I18n.get)
        if ok and type(data) == "table" then
            return data
        end
    end
    return I18n or {}
end

-- Skins normalisieren (dein Code)
local function normalizeSkins(skins)
    local list = {}
    if type(skins) ~= "table" then
        return list
    end
    local numeric = {}
    for k,v in pairs(skins) do
        if type(k) == "number" then
            numeric[k] = v
        else
            list[#list+1] = v
        end
    end
    local idx = {}
    for k in pairs(numeric) do
        idx[#idx+1] = k
    end
    table.sort(idx)
    for _,k in ipairs(idx) do
        list[#list+1] = numeric[k]
    end
    return list
end

-- Avatar bauen (dein Tabber-Weg)
local function buildAvatarMarkup(hero, realKey, i18)
    local frame      = mw.getCurrentFrame()
    local skinLabels = ((i18.ui or {}).skins) or {}
    local skins      = normalizeSkins(hero.skins)

    if #skins == 0 then
        return string.format(
            "[[Datei:%s.png|210px|class=avatar-img|link=%s]]",
            realKey, realKey
        )
    end

    local panels = {}

    local heroDisplayName = hero.name or realKey
    panels[#panels+1] =
        heroDisplayName .. "=\n" ..
        string.format("[[Datei:%s.png|210px|class=avatar-img|link=%s]]", realKey, realKey)

    for _,id in ipairs(skins) do
        local idNorm   = Util.norm(id)
        local label    = skinLabels[idNorm] or id
        local filename = string.format("%s_%s.png", realKey, id)
        panels[#panels+1] =
            label .. "=\n" ..
            string.format("[[Datei:%s|210px|class=avatar-img|link=%s]]", filename, realKey)
    end

    local content = table.concat(panels, "\n|-|\n")
    return frame:extensionTag('tabber', content)
end

-- UI: {{Firestone|hero|ui|...}}
function H.ui(frame, args)
    local i18    = getI18n()
    local uiRoot = i18.ui or {}
    local path = {}
    for i = 3, #args do
        path[#path+1] = args[i]
    end
    local val = Util.deepGet(uiRoot, path)
    if type(val) == "string" then
        return mw.text.trim(val)
    end
    return ""
end

-- LISTE: {{Firestone|hero|list}}
function H.list(frame, args)
    local heroes   = HEROES
    local iconSize = args.icon_size or args.size or "32"

    if not next(heroes) then
        return "<div class='error'>[Hero.list] mw.loadData('" .. HEROES .. "') war leer.</div>"
    end

    -- sortierte Namen
    local names = {}
    for name in pairs(heroes) do
        names[#names+1] = name
    end
    table.sort(names)

    local panels = {}
    for _,name in ipairs(names) do
        local ok, card = pcall(function()
            return frame:expandTemplate{
                title = 'Card/Hero',
                args  = {
                    [1]       = name,
                    icon_size = iconSize,
                },
            }
        end)
        if not ok or not card or card == "" then
            card = "<div class='error'>[Hero.list] Karte für „" .. name .. "“ nicht gefunden.</div>"
        end
        panels[#panels+1] = name .. "=\n" .. card
    end

    local content = table.concat(panels, "\n|-|\n")
    return frame:extensionTag('tabber', content)
end

-- normaler Held
function H.handle(frame, args)
    local name = args[2]
    if Util.isEmpty(name) then
        return ""
    end

    local heroes = HEROES
    local realKey = Util.pickKey(heroes, name)
    if not realKey then
        return name
    end

    local hero = heroes[realKey]
    local i18  = getI18n()

    -- nur {{Firestone|hero|Talia}}
    if Util.isEmpty(args[3]) then
        return realKey
    end

    if Util.norm(args[3]) == "avatar" then
        return buildAvatarMarkup(hero, realKey, i18)
    end

    local path, i = {}, 3
    while args[i] do
        path[#path+1] = args[i]
        i = i + 1
    end

    local v     = Util.deepGet(hero, path)
    local last  = path[#path] and tostring(path[#path]) or ""
    local nlast = Util.norm(last)

    if nlast == "unlock_at" then
        return Util.heroUnlockText(v, i18)
    elseif nlast == "awakening_id" then
        return Util.heroAwakeningText(v, i18)
    end

    if v == nil and nlast == "name" then
        return realKey
    end

    v = Util.autotrFrom(i18, last, v)
    if v == nil then
        return ""
    end
    return tostring(v)
end

return H