Mudanças entre as edições de "Módulo:Info"

De Wiki Gla
Ir para navegação Ir para pesquisar
m (fix3 subsskill)
Etiqueta: Revertido
m
Etiqueta: Reversão manual
Linha 1: Linha 1:
-- Módulo:Info — resolve metadados e skills (robusto/corrigido + gambiarra expandTier/expandTags)
local p = {}
local p = {}


--------------------------------------------------------------------------------
-- ===== util =====
-- Utils
--------------------------------------------------------------------------------
 
local function trim(s)
local function trim(s)
     return (tostring(s or ""):gsub("^%s+", ""):gsub("%s+$", ""))
     return (tostring(s or ""):gsub("^%s+", ""):gsub("%s+$", ""))
end
end
 
local function safeArgs(node)
-- Gera URL pública de arquivo (tenta "Special:" e "Especial:" por compat)
     return (node and node.args) or {}
local function fileURL(name)
    name = trim(name or "")
     if name == "" then
        return ""
    end
    name = name:gsub("^Arquivo:", ""):gsub("^File:", "")
    local t1 = mw.title.new("Special:FilePath/" .. name)
    if t1 then
        local u = t1:fullUrl()
        if u and u ~= "" then
            return u
        end
    end
    local t2 = mw.title.new("Especial:FilePath/" .. name)
    if t2 then
        local u = t2:fullUrl()
        if u and u ~= "" then
            return u
        end
    end
    return ""
end
end


-- Carrega o módulo do personagem (Módulo:<Nome>/Modulo/Module)
local function requireCharacterModule(charName)
local function requireCharModule(char)
     charName = trim(charName)
     char = trim(char or "")
     if charName == "" then
     if char == "" then
         return nil
         return nil
     end
     end
    local ok, data


    local ok, data
     ok, data = pcall(function()
     ok, data = pcall(function()
         return require("Módulo:" .. char)
         return require("Módulo:" .. charName)
     end)
     end)
     if ok and type(data) == "table" then
     if ok and type(data) == "table" then
Linha 49: Linha 25:


     ok, data = pcall(function()
     ok, data = pcall(function()
         return require("Modulo:" .. char)
         return require("Modulo:" .. charName)
     end)
     end)
     if ok and type(data) == "table" then
     if ok and type(data) == "table" then
Linha 56: Linha 32:


     ok, data = pcall(function()
     ok, data = pcall(function()
         return require("Module:" .. char)
         return require("Module:" .. charName)
     end)
     end)
     if ok and type(data) == "table" then
     if ok and type(data) == "table" then
Linha 65: Linha 41:
end
end


-- Separa uma sequência de {} (JSONs colados) em uma tabela de chunks
local function resolveCharFromFrames(frame, a)
local function collectJsonObjects(s)
     if a.char and trim(a.char) ~= "" then
     s = tostring(s or "")
        return trim(a.char)
     local out = {}
     end
     for chunk in s:gmatch("%b{}") do
     if a.nome and trim(a.nome) ~= "" then
         table.insert(out, chunk)
         return trim(a.nome)
     end
     end
    return out
end


--------------------------------------------------------------------------------
    local p1 = frame:getParent()
-- I18N: rótulos de atributos + "Nível"
    if p1 then
--------------------------------------------------------------------------------
        local ap1 = safeArgs(p1)
        if ap1.char and trim(ap1.char) ~= "" then
            return trim(ap1.char)
        end
        if ap1.nome and trim(ap1.nome) ~= "" then
            return trim(ap1.nome)
        end


local ATTR_I18N = {
         local p2 = p1.getParent and p1:getParent()
    pt = {
        if p2 then
        cooldown = "Recarga:",
            local ap2 = safeArgs(p2)
        energy_gain = "Ganho de Energia:",
            if ap2.char and trim(ap2.char) ~= "" then
        energy_cost = "Custo de Energia:",
                return trim(ap2.char)
        power = "Poder:",
            end
        power_pvp = "Poder PvP:",
            if ap2.nome and trim(ap2.nome) ~= "" then
        level = "Nível:"
                 return trim(ap2.nome)
    },
    en = {
        cooldown = "Cooldown:",
        energy_gain = "Energy Gain:",
        energy_cost = "Energy Cost:",
        power = "Power:",
        power_pvp = "PvP Power:",
        level = "Level:"
    },
    es = {
        cooldown = "Enfriamiento:",
        energy_gain = "Ganancia de Energía:",
        energy_cost = "Costo Energético:",
        power = "Poder:",
        power_pvp = "Poder PvP:",
        level = "Nivel:"
    },
    pl = {
        cooldown = "Czas Odnowienia:",
        energy_gain = "Odzyskanle Energii:",
        energy_cost = "Koszt energii:",
        power = "Moc:",
        power_pvp = "Moc PvP:",
        level = "Poziom:"
    }
}
 
--------------------------------------------------------------------------------
-- I18N: rótulos das abas (Skills/Skins + título da área de Skins)
--------------------------------------------------------------------------------
 
local TAB_I18N = {
    pt = {
        skills = "Habilidades",
        skins = "Skins",
        skins_title = "SKINS & SPOTLIGHTS"
    },
    en = {
        skills = "Skills",
        skins = "Skins",
        skins_title = "SKINS & SPOTLIGHTS"
    },
    es = {
        skills = "Habilidades",
        skins = "Aspectos",
         skins_title = "ASPECTOS Y DESTACADOS"
    },
    pl = {
        skills = "Umiejętności",
        skins = "Skórki",
        skins_title = "SKÓRKI I PREZENTACJE"
    }
}
 
--------------------------------------------------------------------------------
-- Serializer de skin (para {{Skin}})
--------------------------------------------------------------------------------
 
function p.skin(frame)
    local a = frame.args
    local obj = {
        sprite = a.sprite or '',
        background = a.background or '',
        tooltip = a.tooltip or '',
        youtube = a.youtube or '',
        source = a.source or ''
    }
    return mw.text.jsonEncode(obj)
end
 
--------------------------------------------------------------------------------
-- Componente principal
--------------------------------------------------------------------------------
 
function p.generate(frame)
    local parent = frame:getParent() or frame
    local args = parent.args or {}
 
    local html = mw.html.create('div')
    local box = html:tag('div'):addClass('character-box')
 
    ----------------------------------------------------------------------------
    -- Background (suporta |background= ou |banner= como fallback)
    ----------------------------------------------------------------------------
    do
        local bgParam = trim(frame:preprocess(args.background or ""))
        if bgParam == "" then
            bgParam = trim(frame:preprocess(args.banner or "")) -- opcional compat
        end
        if bgParam ~= "" then
            box:attr('data-bg-file', bgParam)
            local url = fileURL(bgParam)
            if url and url ~= "" then
                 box:attr('data-bg-url', url)
                -- fallback inline para certos temas
                local style = string.format("--character-bg: url('%s'); background-image: url('%s');", url, url)
                local old = box:getAttr('style')
                box:attr('style', old and (old .. " " .. style) or style)
             end
             end
         end
         end
     end
     end


    ----------------------------------------------------------------------------
     local title = mw.title.getCurrentTitle()
    -- Header
    return title and trim(title.text) or ""
    ----------------------------------------------------------------------------
end
     local header = box:tag('div'):addClass('character-header')


    -- topbar (avatar + nome + tags)
-- paleta para marcadores
     local topbar = header:tag('div'):addClass('character-topbar')
local COLOR = {
     local nameBox = topbar:tag('div'):addClass('character-name-box')
    debuff = "#ff5252",
    atk = "#ffcc00",
    def = "#64b5f6",
    ms = "#43a047",
     hp = "#42a5f5",
     sec = "#ffcc00"
}


    local avatarImg = trim(args.avatar or "Franky_ts_medal.png")
local function colorize(txt)
     nameBox:wikitext(string.format('[[Arquivo:%s|class=topbar-icon|link=|alt=Avatar]]', avatarImg))
     if not txt or txt == "" then
 
        return ""
    local nameGroup = nameBox:tag('div'):addClass('character-name-group')
    nameGroup:tag('div'):addClass('character-name'):wikitext(args.nome or "")
 
    -- Class tags (TIER + TAGS, com i18n injetada)
    local classTags = nameGroup:tag('div'):addClass('class-tags')
 
    -- Resolve Tier/Tags em PT (render inicial)
    local nomeChar = trim(args.nome or "")
    local charData = requireCharModule(nomeChar) or {}
    local rawTier = trim(frame:preprocess(args.tier or ""))
    local rawClasse = trim(frame:preprocess(args.classe or ""))
 
    -- Se vier tokens tipo "tier*", resolve via módulo
    if rawTier ~= "" and mw.ustring.lower(rawTier):sub(1, 4) == "tier" then
        rawTier = (charData.tier_i18n and charData.tier_i18n.pt) or charData.tier or rawTier
     end
     end
     if rawClasse ~= "" and mw.ustring.lower(rawClasse):sub(1, 5) == "class" then
     return (txt:gsub("{{(%a+):([^}]+)}}", function(tag, inner)
         local arr = (charData.tags_i18n and charData.tags_i18n.pt) or charData.tags
         local hex = COLOR[tag]
        if type(arr) == "table" then
        if not hex then
            rawClasse = table.concat(arr, " / ")
            return "{{" .. tag .. ":" .. inner .. "}}"
         end
         end
     end
        return string.format('<span style="color:%s;">%s</span>', hex, inner)
    -- Se continuar vazio, puxa do módulo do personagem
     end))
    if rawTier == "" then
end
        rawTier = (charData.tier_i18n and charData.tier_i18n.pt) or charData.tier or ""
 
    end
-- ===== API =====
    if rawClasse == "" then
        local arr = (charData.tags_i18n and charData.tags_i18n.pt) or charData.tags
        if type(arr) == "table" then
            rawClasse = table.concat(arr, " / ")
        else
            rawClasse = arr or ""
        end
    end


     -- Chip de TIER
function p.getTier(frame)
     local tierDiv
     local a = safeArgs(frame)
     if rawTier ~= "" then
     local char = trim(frame.args[1] or a.nome)
         tierDiv = classTags:tag('div'):addClass('class-tag tier'):wikitext(rawTier)
     if char == "" then
         char = resolveCharFromFrames(frame, a)
     end
     end
    local data = requireCharacterModule(char) or {}
    return trim(data.tier or "")
end


     -- Injeta i18n do TIER como data-*
function p.getTags(frame)
     do
     local a = safeArgs(frame)
        local tI = charData.tier_i18n or {
     local char = trim(frame.args[1] or a.nome)
            pt = rawTier,
    if char == "" then
            en = rawTier,
        char = resolveCharFromFrames(frame, a)
            es = rawTier,
            pl = rawTier
        }
        if tierDiv then
            tierDiv:attr('data-tier-pt', tI.pt or rawTier):attr('data-tier-en', tI.en or tI.pt or rawTier):attr(
                'data-tier-es', tI.es or tI.pt or rawTier):attr('data-tier-pl', tI.pl or tI.pt or rawTier)
        end
     end
     end
 
     local data = requireCharacterModule(char) or {}
    -- Injeta i18n das TAGS em JSON no container
    local tags = data.tags or {}
     do
    if type(tags) ~= "table" then
        local tagsI = charData.tags_i18n
         return ""
        if type(tagsI) ~= "table" then
            tagsI = {
                pt = {},
                en = {},
                es = {},
                pl = {}
            }
            if type(charData.tags) == "table" then
                tagsI.pt = charData.tags
            end
         end
        classTags:attr('data-tags-i18n', mw.text.jsonEncode(tagsI))
     end
     end
    return trim(table.concat(tags, " / "))
end


    -- Render inicial das TAGS (PT)
-- Skill (normal: com M)
     do
function p.skill(frame)
        for entry in mw.text.gsplit(rawClasse, '/', true) do
     local a = safeArgs(frame)
            local clean = mw.text.trim(entry or '')
    local lang = trim((a.lang or (frame:getParent() and frame:getParent().args.lang) or "pt"):lower())
            if clean ~= '' then
    local char = trim(a.char or (frame:getParent() and frame:getParent().args.nome) or "")
                classTags:tag('div'):addClass('class-tag'):wikitext(clean)
    if char == "" then
            end
         char = resolveCharFromFrames(frame, a)
         end
     end
     end
    local data = requireCharacterModule(char) or {}


     -- Descrição geral (se houver)
     local name, desc_i18n = nil, {}
    header:tag('div'):addClass('topbar-description'):wikitext(args.desc or "")


     ----------------------------------------------------------------------------
     if a.M and trim(a.M) ~= "" then
    -- Idioma para tabs (PT padrão + aceita pt-br,en-US,... via |lang=)
        local m = tonumber(a.M) or 0
    ----------------------------------------------------------------------------
        local order = data.order or {}
    local rawLang = trim(args.lang or "pt")
        local key = order[m] or ""
    rawLang = mw.ustring.lower(rawLang)
        local sk = (data.skills or {})[key] or {}
    local baseLang = rawLang:match("^([a-z][a-z])") or rawLang
        name = trim(sk.name or key or "")
    local TAB = TAB_I18N[rawLang] or TAB_I18N[baseLang] or TAB_I18N.pt


    ----------------------------------------------------------------------------
        -- monta tabela de descrições por idioma (já colorizadas)
    -- Abas (tabs)
        if type(sk.desc) == "table" then
    ----------------------------------------------------------------------------
            local langs = {"pt", "en", "es", "pl"}
    local tabs = header:tag('div'):addClass('character-tabs')
            for _, code in ipairs(langs) do
    tabs:tag('div'):addClass('tab-btn active'):attr('data-tab', 'skills'):wikitext(TAB.skills)
                local d = sk.desc[code]
    tabs:tag('div'):addClass('tab-btn'):attr('data-tab', 'skins'):wikitext(TAB.skins)
                if d and trim(d) ~= "" then
 
                     desc_i18n[code] = colorize(d)
    ----------------------------------------------------------------------------
    -- Aba: Skills
    ----------------------------------------------------------------------------
    local skillsTab = box:tag('div'):addClass('tab-content active'):attr('id', 'skills')
    local iconBar = skillsTab:tag('div'):addClass('icon-bar')
    -- subskills bar (vazia, será populada dinamicamente via JS quando necessário)
    skillsTab:tag('div'):addClass('icon-bar subskills-bar')
    local skillsContainer = skillsTab:tag('div'):addClass('skills-container')
    local details = skillsContainer:tag('div'):addClass('skills-details')
    local descBox = details:tag('div'):addClass('desc-box')
    skillsContainer:tag('div'):addClass('video-container'):done()
 
    skillsTab:attr('data-i18n-attrs', mw.text.jsonEncode(ATTR_I18N))
    if args.lang and trim(args.lang) ~= "" then
        skillsTab:attr('data-i18n-default', baseLang)
    end
 
    -- Monta ícones de skill a partir de |skills= (sequência de {} JSON)
    local skillsPacked = args.skills or ""
    local idx = 0
    -- Primeiro: parse chunks e agrupa subskills (type=='sub') com a skill anterior
    local parsed = {}
    local lastSkill = nil
    for _, chunk in ipairs(collectJsonObjects(skillsPacked)) do
        local ok, sk = pcall(mw.text.jsonDecode, chunk)
        if ok and type(sk) == "table" then
            if sk.type and tostring(sk.type):lower() == 'sub' then
                if lastSkill then
                     lastSkill.subs = lastSkill.subs or {}
                    table.insert(lastSkill.subs, sk)
                 end
                 end
            else
                table.insert(parsed, sk)
                lastSkill = sk
             end
             end
        elseif sk.desc and trim(sk.desc) ~= "" then
            desc_i18n["pt"] = colorize(sk.desc) -- fallback: único texto vira pt
         end
         end
     end
     end


     -- Agora itera apenas sobre skills raiz (parsed)
     local function nz(v)
    for _, sk in ipairs(parsed) do
         v = v or ""
        local name = trim(sk.name or sk.nome or sk.n or "")
         return (trim(v) ~= "" and v or nil)
        local icon = trim(sk.icon or "")
    end
        local desc = trim(sk.desc or "")
        local level = trim(tostring(sk.level or ""))
        local pve = trim(sk.powerpve or "")
        local pvp = trim(sk.powerpvp or "")
         local energy = trim(sk.energy or "")
         local cd = trim(sk.cooldown or "")
        local video = trim(sk.video or "")
        if icon ~= "" then
            idx = idx + 1
            local attrs = table.concat({pve ~= "" and pve or "-", pvp ~= "" and pvp or "-",
                                        energy ~= "" and energy or "-", cd ~= "" and cd or "-"}, ", ")


            local iconWrap = iconBar:tag('div'):addClass('skill-icon'):attr('data-index', idx):attr('data-nome',
    local chosen = desc_i18n[lang] or desc_i18n["pt"] or ""
                name):attr('data-desc', desc):attr('data-atr', attrs):attr('data-video',
                (video ~= "" and fileURL(video) or "")):attr('data-video-preload', 'auto')


            -- se houver subskills (tabela), normalizar URLs de icon/video para uso no cliente
    local obj = {
            if type(sk.subs) == "table" then
        icon = (trim(a.icon or "") ~= "" and a.icon or "Nada.png"),
                for _, ss in ipairs(sk.subs) do
        level = (trim(a.level or "") ~= "" and a.level or "NIVEL"),
                    ss.icon_url = fileURL(ss.icon or "")
        energy = nz(a.energy),
                    ss.video = fileURL(ss.video or "")
        powerpve = nz(a.powerpve),
                end
        powerpvp = nz(a.powerpvp),
                iconWrap:attr('data-subs', mw.text.jsonEncode(sk.subs))
        cooldown = nz(a.cooldown),
            elseif type(sk.subs) == "string" and sk.subs ~= "" then
        video = a.video or ""
                -- se veio como string, pode ser um JSON único ou vários JSONs colados ({{Subskill}}{{Subskill}})
    }
                local subsArr = {}
    if name and name ~= "" then
                for _, chunk in ipairs(collectJsonObjects(sk.subs)) do
        obj.name = name
                    local ok2, obj = pcall(mw.text.jsonDecode, chunk)
    end
                    if ok2 and type(obj) == 'table' then
    if chosen ~= "" then
                        -- normaliza URLs
        obj.desc = chosen
                        obj.icon_url = fileURL(obj.icon or "")
    end
                        obj.video = fileURL(obj.video or "")
                        table.insert(subsArr, obj)
                    end
                end
                if #subsArr > 0 then
                    iconWrap:attr('data-subs', mw.text.jsonEncode(subsArr))
                end
            end


            -- Level (para "Nível X" no JS)
    -- inclui as variantes para o Character expor como data-desc-*
            if level ~= "" and mw.ustring.upper(level) ~= "NIVEL" then
    if next(desc_i18n) ~= nil then
                iconWrap:attr('data-level', level)
        obj.desc_i18n = desc_i18n
            end
        obj.descPt = desc_i18n.pt
        obj.descEn = desc_i18n.en
        obj.descEs = desc_i18n.es
        obj.descPl = desc_i18n.pl
    end


            -- Descrições i18n (quando vierem do Info)
    return mw.text.jsonEncode(obj)
            if type(sk.desc_i18n) == "table" then
end
                iconWrap:attr('data-desc-pt', sk.desc_i18n.pt or ""):attr('data-desc-en', sk.desc_i18n.en or "")
-- Skill (emote: sem M)
                    :attr('data-desc-es', sk.desc_i18n.es or ""):attr('data-desc-pl', sk.desc_i18n.pl or "")
function p.emote(frame)
            elseif desc and desc ~= "" then
    local a = safeArgs(frame)
                -- Pelo menos PT
    local obj = {
                iconWrap:attr('data-desc-pt', desc)
        name = "Emote",
            end
        desc = "",
        icon = (trim(a.icon or "") ~= "" and a.icon or "Nada.png"),
        level = 25,
        video = a.video or "",
        desc_i18n = {
            pt = "",
            en = "",
            es = "",
            pl = ""
        },
        descPt = "",
        descEn = "",
        descEs = "",
        descPl = ""
    }
    return mw.text.jsonEncode(obj)
end


            -- Imagem do ícone
-- expandTier/expandTags mantidos
            iconWrap:wikitext(string.format('[[Arquivo:%s|class=skill-icon-img|link=]]', icon))
function p.expandTier(frame)
    local token = trim(frame.args[1] or "")
    local nome = trim(frame.args[2] or (frame:getParent() and frame:getParent().args.nome) or "")
    if token == "" then
        return ""
    end
    if token:lower():sub(1, 4) ~= "tier" then
        return token
    end
    local char = nome ~= "" and nome or token:match("^tier(.+)$") or ""
    if char == "" then
        local title = mw.title.getCurrentTitle()
        char = title and trim(title.text) or ""
    end
    local data = requireCharacterModule(char) or {}
    local i18n = (data.tier_i18n and data.tier_i18n.pt) or data.tier
    return trim(i18n or "")
end


            -- Slot de descrição indexado (o JS usa para sincronizar)
function p.expandTags(frame)
            descBox:tag('div'):addClass('skill-desc'):attr('data-index', idx)
    local token = trim(frame.args[1] or "")
         end
    local nome = trim(frame.args[2] or (frame:getParent() and frame:getParent().args.nome) or "")
    if token == "" then
        return ""
    end
    if token:lower():sub(1, 5) ~= "class" then
         return token
     end
     end
 
     local char = nome ~= "" and nome or token:match("^class(.+)$") or ""
    ----------------------------------------------------------------------------
    if char == "" then
    -- Aba: Skins (carrossel)
        local title = mw.title.getCurrentTitle()
    ----------------------------------------------------------------------------
        char = title and trim(title.text) or ""
     local skinsTab = box:tag('div'):addClass('tab-content'):attr('id', 'skins')
    local cardSkins = skinsTab:tag('div'):addClass('card-skins')
    cardSkins:tag('span'):addClass('card-skins-title'):wikitext(TAB.skins_title)
 
    local wrapper = cardSkins:tag('div'):addClass('skins-carousel-wrapper')
    wrapper:tag('div'):addClass('skins-arrow left'):wikitext('«')
    local carousel = wrapper:tag('div'):addClass('skins-carousel')
 
    local skinsPacked = args.skins or ""
    for _, chunk in ipairs(collectJsonObjects(skinsPacked)) do
        local ok, sk = pcall(mw.text.jsonDecode, chunk)
        if ok and type(sk) == "table" then
            local bannerFile = trim(sk.background or "")
            local imageFile = trim(sk.sprite or "")
            local tooltipRaw = trim(sk.tooltip or "")
            local tooltipHtml = tooltipRaw:gsub("'''([^']+)'''", "<b>%1</b>"):gsub("\n", "<br>")
 
            local skinCard = carousel:tag('div'):addClass('skin-card'):attr('data-skin-tooltip', tooltipHtml)
 
            -- Spotlight do YouTube (opcional)
            local yt = trim(sk.youtube or "")
            if yt ~= "" then
                skinCard:attr('data-youtube', yt):addClass('is-clickable')
            end
 
            skinCard:tag('div'):addClass('skin-banner'):wikitext(bannerFile ~= "" and
                                                                    string.format('[[Arquivo:%s|link=]]', bannerFile) or
                                                                    ""):attr('alt', 'banner')
 
            skinCard:tag('div'):addClass('skin-sprite'):wikitext(imageFile ~= "" and
                                                                    string.format('[[Arquivo:%s|link=]]', imageFile) or
                                                                    ""):attr('alt', 'skin')
        end
     end
     end
     wrapper:tag('div'):addClass('skins-arrow right'):wikitext('»')
     local data = requireCharacterModule(char) or {}
 
     local arr = (data.tags_i18n and data.tags_i18n.pt) or data.tags
     ----------------------------------------------------------------------------
     if type(arr) == "table" then
    -- Tier -> classe CSS (visual)
        return table.concat(arr, " / ")
     ----------------------------------------------------------------------------
    do
        local key = mw.ustring.lower(rawTier or "")
        local tierMap = {
            bronze = "tier-bronze",
            bronce = "tier-bronze",
            silver = "tier-silver",
            prata = "tier-silver",
            gold = "tier-gold",
            ouro = "tier-gold",
            diamond = "tier-diamond",
            diamante = "tier-diamond"
        }
        local tierClass = tierMap[key]
        if tierClass and tierClass ~= "" then
            box:addClass(tierClass)
        end
     end
     end
 
     return trim(arr or "")
    ----------------------------------------------------------------------------
    -- Retorno
    ----------------------------------------------------------------------------
     return tostring(html)
end
end


return p
return p

Edição das 02h59min de 14 de setembro de 2025

A documentação para este módulo pode ser criada em Módulo:Info/doc

-- Módulo:Info — resolve metadados e skills (robusto/corrigido + gambiarra expandTier/expandTags)
local p = {}

-- ===== util =====
local function trim(s)
    return (tostring(s or ""):gsub("^%s+", ""):gsub("%s+$", ""))
end
local function safeArgs(node)
    return (node and node.args) or {}
end

local function requireCharacterModule(charName)
    charName = trim(charName)
    if charName == "" then
        return nil
    end
    local ok, data

    ok, data = pcall(function()
        return require("Módulo:" .. charName)
    end)
    if ok and type(data) == "table" then
        return data
    end

    ok, data = pcall(function()
        return require("Modulo:" .. charName)
    end)
    if ok and type(data) == "table" then
        return data
    end

    ok, data = pcall(function()
        return require("Module:" .. charName)
    end)
    if ok and type(data) == "table" then
        return data
    end

    return nil
end

local function resolveCharFromFrames(frame, a)
    if a.char and trim(a.char) ~= "" then
        return trim(a.char)
    end
    if a.nome and trim(a.nome) ~= "" then
        return trim(a.nome)
    end

    local p1 = frame:getParent()
    if p1 then
        local ap1 = safeArgs(p1)
        if ap1.char and trim(ap1.char) ~= "" then
            return trim(ap1.char)
        end
        if ap1.nome and trim(ap1.nome) ~= "" then
            return trim(ap1.nome)
        end

        local p2 = p1.getParent and p1:getParent()
        if p2 then
            local ap2 = safeArgs(p2)
            if ap2.char and trim(ap2.char) ~= "" then
                return trim(ap2.char)
            end
            if ap2.nome and trim(ap2.nome) ~= "" then
                return trim(ap2.nome)
            end
        end
    end

    local title = mw.title.getCurrentTitle()
    return title and trim(title.text) or ""
end

-- paleta para marcadores
local COLOR = {
    debuff = "#ff5252",
    atk = "#ffcc00",
    def = "#64b5f6",
    ms = "#43a047",
    hp = "#42a5f5",
    sec = "#ffcc00"
}

local function colorize(txt)
    if not txt or txt == "" then
        return ""
    end
    return (txt:gsub("{{(%a+):([^}]+)}}", function(tag, inner)
        local hex = COLOR[tag]
        if not hex then
            return "{{" .. tag .. ":" .. inner .. "}}"
        end
        return string.format('<span style="color:%s;">%s</span>', hex, inner)
    end))
end

-- ===== API =====

function p.getTier(frame)
    local a = safeArgs(frame)
    local char = trim(frame.args[1] or a.nome)
    if char == "" then
        char = resolveCharFromFrames(frame, a)
    end
    local data = requireCharacterModule(char) or {}
    return trim(data.tier or "")
end

function p.getTags(frame)
    local a = safeArgs(frame)
    local char = trim(frame.args[1] or a.nome)
    if char == "" then
        char = resolveCharFromFrames(frame, a)
    end
    local data = requireCharacterModule(char) or {}
    local tags = data.tags or {}
    if type(tags) ~= "table" then
        return ""
    end
    return trim(table.concat(tags, " / "))
end

-- Skill (normal: com M)
function p.skill(frame)
    local a = safeArgs(frame)
    local lang = trim((a.lang or (frame:getParent() and frame:getParent().args.lang) or "pt"):lower())
    local char = trim(a.char or (frame:getParent() and frame:getParent().args.nome) or "")
    if char == "" then
        char = resolveCharFromFrames(frame, a)
    end
    local data = requireCharacterModule(char) or {}

    local name, desc_i18n = nil, {}

    if a.M and trim(a.M) ~= "" then
        local m = tonumber(a.M) or 0
        local order = data.order or {}
        local key = order[m] or ""
        local sk = (data.skills or {})[key] or {}
        name = trim(sk.name or key or "")

        -- monta tabela de descrições por idioma (já colorizadas)
        if type(sk.desc) == "table" then
            local langs = {"pt", "en", "es", "pl"}
            for _, code in ipairs(langs) do
                local d = sk.desc[code]
                if d and trim(d) ~= "" then
                    desc_i18n[code] = colorize(d)
                end
            end
        elseif sk.desc and trim(sk.desc) ~= "" then
            desc_i18n["pt"] = colorize(sk.desc) -- fallback: único texto vira pt
        end
    end

    local function nz(v)
        v = v or ""
        return (trim(v) ~= "" and v or nil)
    end

    local chosen = desc_i18n[lang] or desc_i18n["pt"] or ""

    local obj = {
        icon = (trim(a.icon or "") ~= "" and a.icon or "Nada.png"),
        level = (trim(a.level or "") ~= "" and a.level or "NIVEL"),
        energy = nz(a.energy),
        powerpve = nz(a.powerpve),
        powerpvp = nz(a.powerpvp),
        cooldown = nz(a.cooldown),
        video = a.video or ""
    }
    if name and name ~= "" then
        obj.name = name
    end
    if chosen ~= "" then
        obj.desc = chosen
    end

    -- inclui as variantes para o Character expor como data-desc-*
    if next(desc_i18n) ~= nil then
        obj.desc_i18n = desc_i18n
        obj.descPt = desc_i18n.pt
        obj.descEn = desc_i18n.en
        obj.descEs = desc_i18n.es
        obj.descPl = desc_i18n.pl
    end

    return mw.text.jsonEncode(obj)
end
-- Skill (emote: sem M)
function p.emote(frame)
    local a = safeArgs(frame)
    local obj = {
        name = "Emote",
        desc = "",
        icon = (trim(a.icon or "") ~= "" and a.icon or "Nada.png"),
        level = 25,
        video = a.video or "",
        desc_i18n = {
            pt = "",
            en = "",
            es = "",
            pl = ""
        },
        descPt = "",
        descEn = "",
        descEs = "",
        descPl = ""
    }
    return mw.text.jsonEncode(obj)
end

-- expandTier/expandTags mantidos
function p.expandTier(frame)
    local token = trim(frame.args[1] or "")
    local nome = trim(frame.args[2] or (frame:getParent() and frame:getParent().args.nome) or "")
    if token == "" then
        return ""
    end
    if token:lower():sub(1, 4) ~= "tier" then
        return token
    end
    local char = nome ~= "" and nome or token:match("^tier(.+)$") or ""
    if char == "" then
        local title = mw.title.getCurrentTitle()
        char = title and trim(title.text) or ""
    end
    local data = requireCharacterModule(char) or {}
    local i18n = (data.tier_i18n and data.tier_i18n.pt) or data.tier
    return trim(i18n or "")
end

function p.expandTags(frame)
    local token = trim(frame.args[1] or "")
    local nome = trim(frame.args[2] or (frame:getParent() and frame:getParent().args.nome) or "")
    if token == "" then
        return ""
    end
    if token:lower():sub(1, 5) ~= "class" then
        return token
    end
    local char = nome ~= "" and nome or token:match("^class(.+)$") or ""
    if char == "" then
        local title = mw.title.getCurrentTitle()
        char = title and trim(title.text) or ""
    end
    local data = requireCharacterModule(char) or {}
    local arr = (data.tags_i18n and data.tags_i18n.pt) or data.tags
    if type(arr) == "table" then
        return table.concat(arr, " / ")
    end
    return trim(arr or "")
end

return p