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

De Wiki Gla
Ir para navegação Ir para pesquisar
m (primeiro passo p add o char transl)
m (char translator1)
Linha 1: Linha 1:
-- Module:Character
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


-- Gera URL pública de arquivo (tenta "Special:" e "Especial:" por compat)
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
-- Carrega o módulo do personagem (Módulo:<Nome>/Modulo/Module)
local function requireCharModule(char)
local function requireCharModule(char)
     char = trim(char or "")
     char = trim(char or "")
Linha 12: Linha 39:
         return nil
         return nil
     end
     end
     local ok, data
     local ok, data
     ok, data = pcall(function()
     ok, data = pcall(function()
Linha 19: Linha 47:
         return data
         return data
     end
     end
     ok, data = pcall(function()
     ok, data = pcall(function()
         return require("Modulo:" .. char)
         return require("Modulo:" .. char)
Linha 25: Linha 54:
         return data
         return data
     end
     end
     ok, data = pcall(function()
     ok, data = pcall(function()
         return require("Module:" .. char)
         return require("Module:" .. char)
Linha 31: Linha 61:
         return data
         return data
     end
     end
     return nil
     return nil
end
end


-- ===== I18N: labels de atributos + "Nível" =====
-- Separa uma sequência de {} (JSONs colados) em uma tabela de chunks
-- Este mapa é injetado em data-i18n-attrs no #skills para o JS consumir.
local function collectJsonObjects(s)
    s = tostring(s or "")
    local out = {}
    for chunk in s:gmatch("%b{}") do
        table.insert(out, chunk)
    end
    return out
end
 
--------------------------------------------------------------------------------
-- I18N: rótulos de atributos + "Nível"
--------------------------------------------------------------------------------
 
local ATTR_I18N = {
local ATTR_I18N = {
     pt = {
     pt = {
         cooldown = "Recarga",
         cooldown = "Recarga",
         energy = "Energia",
         energy = "Energia", -- (não usamos neutro; JS escolhe ganho/custo)
         energy_gain = "Ganho de energia",
         energy_gain = "Ganho de energia",
         energy_cost = "Custo de energia",
         energy_cost = "Custo de energia",
Linha 74: Linha 117:
     }
     }
}
}
-- ===== I18N: labels das abas (Skills/Skins) =====
 
--------------------------------------------------------------------------------
-- I18N: rótulos das abas (Skills/Skins + título da área de Skins)
--------------------------------------------------------------------------------
 
local TAB_I18N = {
local TAB_I18N = {
     pt = {
     pt = {
Linha 98: Linha 145:
}
}


-- ===== skin serializer (mantido) =====
--------------------------------------------------------------------------------
-- Serializer de skin (para {{Skin}})
--------------------------------------------------------------------------------
 
function p.skin(frame)
function p.skin(frame)
     local a = frame.args
     local a = frame.args
Linha 111: Linha 161:
end
end


-- ===== componente principal =====
--------------------------------------------------------------------------------
-- Componente principal
--------------------------------------------------------------------------------
 
function p.generate(frame)
function p.generate(frame)
     local args = frame:getParent().args
     local parent = frame:getParent() or frame
    local args = parent.args or {}
 
     local html = mw.html.create('div')
     local html = mw.html.create('div')
    local box = html:tag('div'):addClass('character-box')


     local function fileURL(name)
     ----------------------------------------------------------------------------
         return tostring(mw.uri.fullUrl('Special:FilePath/' .. (name or '')))
    -- 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


     local nomeChar = args.nome or ""
    ----------------------------------------------------------------------------
    -- Header
    ----------------------------------------------------------------------------
     local header = box:tag('div'):addClass('character-header')
 
    -- topbar (avatar + nome + tags)
    local topbar = header:tag('div'):addClass('character-topbar')
    local nameBox = topbar:tag('div'):addClass('character-name-box')
 
    local avatarImg = trim(args.avatar or "Franky_ts_medal.png")
    nameBox:wikitext(string.format('[[Arquivo:%s|class=topbar-icon|link=|alt=Avatar]]', avatarImg))
 
    local nameGroup = nameBox:tag('div'):addClass('character-name-group')
    nameGroup:tag('div'):addClass('character-name'):wikitext(args.nome or "")


     -- ===== tier / classes (auto-resolve) =====
     -- 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 rawTier = trim(frame:preprocess(args.tier or ""))
     local rawClasse = trim(frame:preprocess(args.classe 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
     if rawTier ~= "" and mw.ustring.lower(rawTier):sub(1, 4) == "tier" then
        local data = requireCharModule(nomeChar) or {}
         rawTier = (charData.tier_i18n and charData.tier_i18n.pt) or charData.tier or rawTier
         rawTier = (data.tier_i18n and data.tier_i18n.pt) or data.tier or rawTier
     end
     end
     if rawClasse ~= "" and mw.ustring.lower(rawClasse):sub(1, 5) == "class" then
     if rawClasse ~= "" and mw.ustring.lower(rawClasse):sub(1, 5) == "class" then
        local data = requireCharModule(nomeChar) or {}
         local arr = (charData.tags_i18n and charData.tags_i18n.pt) or charData.tags
         local arr = (data.tags_i18n and data.tags_i18n.pt) or data.tags
         if type(arr) == "table" then
         if type(arr) == "table" then
             rawClasse = table.concat(arr, " / ")
             rawClasse = table.concat(arr, " / ")
         end
         end
     end
     end
 
    -- Se continuar vazio, puxa do módulo do personagem
     if rawTier == "" or rawClasse == "" then
     if rawTier == "" then
         local data = requireCharModule(nomeChar) or {}
         rawTier = (charData.tier_i18n and charData.tier_i18n.pt) or charData.tier or ""
        if rawTier == "" then
    end
            rawTier = (data.tier_i18n and data.tier_i18n.pt) or data.tier or ""
    if rawClasse == "" then
        end
        local arr = (charData.tags_i18n and charData.tags_i18n.pt) or charData.tags
        if rawClasse == "" then
        if type(arr) == "table" then
            local arr = (data.tags_i18n and data.tags_i18n.pt) or data.tags
            rawClasse = table.concat(arr, " / ")
            if type(arr) == "table" then
        else
                rawClasse = table.concat(arr, " / ")
            rawClasse = arr or ""
            else
                rawClasse = arr or ""
            end
         end
         end
     end
     end


     -- ===== Tier -> classe css =====
     -- Chip de TIER
     local tierRaw = rawTier
     local tierDiv
     local tierKey = mw.ustring.lower(tierRaw or "")
     if rawTier ~= "" then
    local tierMap = {
         tierDiv = classTags:tag('div'):addClass('class-tag tier'):wikitext(rawTier)
         bronze = "tier-bronze",
     end
        bronce = "tier-bronze",
        silver = "tier-silver",
        prata = "tier-silver",
        gold = "tier-gold",
        ouro = "tier-gold",
        diamond = "tier-diamond",
        diamante = "tier-diamond"
     }
    local tierClass = tierMap[tierKey]


     -- ===== raiz =====
     -- Injeta i18n do TIER como data-*
    local box = html:tag('div'):addClass('character-box')
    do
        local tI = charData.tier_i18n or {
            pt = rawTier,
            en = rawTier,
            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


     -- BG via data-attr
     -- Injeta i18n das TAGS em JSON no container
     do
     do
         local raw = frame:preprocess(args.background or "")
         local tagsI = charData.tags_i18n
         raw = (raw or ""):gsub("^%s+", ""):gsub("%s+$", "")
         if type(tagsI) ~= "table" then
        if raw ~= "" then
             tagsI = {
             raw = raw:gsub("^Arquivo:", ""):gsub("^File:", "")
                pt = {},
            local title = mw.title.new('Especial:FilePath/' .. raw)
                en = {},
             local url = title and title:fullUrl() or nil
                es = {},
             if url and url ~= "" then
                pl = {}
                 box:attr('data-bg-file', raw)
             }
                box:attr('data-bg-url', url)
             if type(charData.tags) == "table" then
                 tagsI.pt = charData.tags
             end
             end
         end
         end
        classTags:attr('data-tags-i18n', mw.text.jsonEncode(tagsI))
     end
     end
     local function trim2(s2)
 
        return (s2 or ''):match('^%s*(.-)%s*$')
     -- Render inicial das TAGS (PT)
    end
    local function fileURL2(name)
        if not name or name == '' then
            return nil
        end
        name = name:gsub('^Arquivo:', ''):gsub('^File:', '')
        return mw.title.new('Special:FilePath/' .. name):fullUrl()
    end
     do
     do
         local bgParam = trim2(args.background or '')
         for entry in mw.text.gsplit(rawClasse, '/', true) do
        if bgParam == '' then
             local clean = mw.text.trim(entry or '')
             bgParam = trim2(args.banner or '')
            if clean ~= '' then
        end
                 classTags:tag('div'):addClass('class-tag'):wikitext(clean)
        if bgParam ~= '' then
            local url = fileURL2(bgParam)
            if url then
                 local style = string.format("--character-bg: url('%s'); background-image: url('%s') !important;", url,
                    url)
                local old = box:getAttr('style')
                box:attr('style', old and (old .. ' ' .. style) or style)
                box:attr('data-bg-file', bgParam)
             end
             end
         end
         end
     end
     end


     local bgFile = trim(frame:preprocess(args.background or ""))
     -- Descrição geral (se houver)
    if bgFile ~= "" then
     header:tag('div'):addClass('topbar-description'):wikitext(args.desc or "")
        local bgUrl = fileURL(bgFile)
        local style = string.format("--character-bg: url('%s'); background-image: url('%s');", bgUrl, bgUrl)
        box:attr('style', style)
     end
    if tierClass and tierClass ~= "" then
        box:addClass(tierClass)
    end
 
    -- ===== header / topbar =====
    local header = box:tag('div'):addClass('character-header')
    local topbar = header:tag('div'):addClass('character-topbar')
    local nameBox = topbar:tag('div'):addClass('character-name-box')
 
    local avatarImg = args.avatar or 'Franky_ts_medal.png'
    nameBox:wikitext(string.format('[[Arquivo:%s|class=topbar-icon|link=|alt=Avatar]]', avatarImg))
 
    local nameGroup = nameBox:tag('div'):addClass('character-name-group')
    nameGroup:tag('div'):addClass('character-name'):wikitext(args.nome or '')


     local classTags = nameGroup:tag('div'):addClass('class-tags')
     ----------------------------------------------------------------------------
     if tierRaw and tierRaw ~= "" then
     -- Idioma para tabs (PT padrão + aceita pt-br,en-US,... via |lang=)
        classTags:tag('div'):addClass('class-tag tier'):wikitext(tierRaw)
     ----------------------------------------------------------------------------
    end
    local classeString = rawClasse or ""
    for classe in mw.text.gsplit(classeString, '/', true) do
        local clean = mw.text.trim(classe or '')
        if clean ~= '' then
            classTags:tag('div'):addClass('class-tag'):wikitext(clean)
        end
     end
 
    header:tag('div'):addClass('topbar-description'):wikitext(args.desc or '')
     local rawLang = trim(args.lang or "pt")
     local rawLang = trim(args.lang or "pt")
     rawLang = mw.ustring.lower(rawLang)
     rawLang = mw.ustring.lower(rawLang)
     local base = rawLang:match("^([a-z][a-z])") or rawLang
     local baseLang = rawLang:match("^([a-z][a-z])") or rawLang
     local TAB = TAB_I18N[rawLang] or TAB_I18N[base] or TAB_I18N.pt
     local TAB = TAB_I18N[rawLang] or TAB_I18N[baseLang] or TAB_I18N.pt


    ----------------------------------------------------------------------------
    -- Abas (tabs)
    ----------------------------------------------------------------------------
     local tabs = header:tag('div'):addClass('character-tabs')
     local tabs = header:tag('div'):addClass('character-tabs')
     tabs:tag('div'):addClass('tab-btn active'):attr('data-tab', 'skills'):wikitext(TAB.skills)
     tabs:tag('div'):addClass('tab-btn active'):attr('data-tab', 'skills'):wikitext(TAB.skills)
     tabs:tag('div'):addClass('tab-btn'):attr('data-tab', 'skins'):wikitext(TAB.skins)
     tabs:tag('div'):addClass('tab-btn'):attr('data-tab', 'skins'):wikitext(TAB.skins)


     -- ===== SKILLS =====
     ----------------------------------------------------------------------------
    -- Aba: Skills
    ----------------------------------------------------------------------------
     local skillsTab = box:tag('div'):addClass('tab-content active'):attr('id', 'skills')
     local skillsTab = box:tag('div'):addClass('tab-content active'):attr('id', 'skills')
     local iconBar = skillsTab:tag('div'):addClass('icon-bar')
     local iconBar = skillsTab:tag('div'):addClass('icon-bar')
Linha 261: Linha 313:
     local details = skillsContainer:tag('div'):addClass('skills-details')
     local details = skillsContainer:tag('div'):addClass('skills-details')
     local descBox = details:tag('div'):addClass('desc-box')
     local descBox = details:tag('div'):addClass('desc-box')
    skillsContainer:tag('div'):addClass('video-container'):done()


     -- I18N: injeta o mapa inteiro para o JS usar (botão de idioma)
     -- Injeta i18n de atributos/"Nível" e idioma default (pt por padrão; respeita |lang= se vier)
     skillsTab:attr('data-i18n-attrs', mw.text.jsonEncode(ATTR_I18N))
     skillsTab:attr('data-i18n-attrs', mw.text.jsonEncode(ATTR_I18N))
     if args.lang and trim(args.lang) ~= "" then
     skillsTab:attr('data-i18n-default', baseLang or "pt")
        skillsTab:attr('data-i18n-default', mw.ustring.lower(trim(args.lang)))
    end


     local skillsPacked = args.skills or '' -- sequência de {} gerados por {{Skill}} (via Módulo:Info)
    -- Monta ícones de skill a partir de |skills= (sequência de {} JSON)
     local skillsPacked = args.skills or ""
     local idx = 0
     local idx = 0
     for obj in skillsPacked:gmatch("%b{}") do
     for _, chunk in ipairs(collectJsonObjects(skillsPacked)) do
         local ok, sk = pcall(mw.text.jsonDecode, obj)
         local ok, sk = pcall(mw.text.jsonDecode, chunk)
         if ok and type(sk) == "table" and (sk.name or sk.nome) and (sk.name ~= '' or sk.nome ~= '') then
         if ok and type(sk) == "table" then
             idx = idx + 1
            local name = trim(sk.name or sk.nome or "")
             local name = sk.name or sk.nome or ''
            local icon = trim(sk.icon or "")
             local icon = sk.icon or ''
            local desc = trim(sk.desc or "")
             local desc = sk.desc or ''
             local level = trim(tostring(sk.level or ""))
             local level = tostring(sk.level or '')
             local pve = trim(sk.powerpve or "")
             -- ordem esperada pelo JS: PVE, PVP, Energia, Recarga
            local pvp = trim(sk.powerpvp or "")
            local attrs = table.concat({sk.powerpve or '-', sk.powerpvp or '-', sk.energy or '-', sk.cooldown 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',
                    name):attr('data-desc', desc):attr('data-atr', attrs):attr('data-video',
                    (video ~= "" and fileURL(video) or "")):attr('data-video-preload', 'auto')


            local videoURL = (sk.video and sk.video ~= '') and fileURL(sk.video) or ''
                -- Level (para "Nível X" no JS)
                if level ~= "" and mw.ustring.upper(level) ~= "NIVEL" then
                    iconWrap:attr('data-level', level)
                end


            local iconWrap = iconBar:tag('div'):addClass('skill-icon'):attr('data-index', idx):attr('data-nome', name)
                -- Descrições i18n (quando vierem do Info)
                :attr('data-desc', desc):attr('data-atr', attrs):attr('data-video', videoURL):attr('data-video-preload',
                if type(sk.desc_i18n) == "table" then
                    'auto')
                    iconWrap:attr('data-desc-pt', sk.desc_i18n.pt or ""):attr('data-desc-en', sk.desc_i18n.en or "")
                        :attr('data-desc-es', sk.desc_i18n.es or ""):attr('data-desc-pl', sk.desc_i18n.pl or "")
                elseif desc and desc ~= "" then
                    -- Pelo menos PT
                    iconWrap:attr('data-desc-pt', desc)
                end


            -- aplica data-level quando houver (e não for placeholder)
                -- Imagem do ícone
            if level ~= '' and mw.ustring.upper(level) ~= 'NIVEL' then
                iconWrap:wikitext(string.format('[[Arquivo:%s|class=skill-icon-img|link=]]', icon))
                iconWrap:attr('data-level', level)
 
                -- Slot de descrição indexado (o JS usa para sincronizar)
                descBox:tag('div'):addClass('skill-desc'):attr('data-index', idx)
             end
             end
            iconWrap:wikitext(string.format('[[Arquivo:%s|class=skill-icon-img|link=]]', icon))
            descBox:tag('div'):addClass('skill-desc'):attr('data-index', idx)
         end
         end
     end
     end


     details:done()
     ----------------------------------------------------------------------------
     skillsContainer:tag('div'):addClass('video-container'):done()
     -- Aba: Skins (carrossel)
     skillsTab:done()
     ----------------------------------------------------------------------------
 
    -- ===== SKINS =====
     local skinsTab = box:tag('div'):addClass('tab-content'):attr('id', 'skins')
     local skinsTab = box:tag('div'):addClass('tab-content'):attr('id', 'skins')
     local cardSkins = skinsTab:tag('div'):addClass('card-skins')
     local cardSkins = skinsTab:tag('div'):addClass('card-skins')
Linha 311: Linha 377:
     local carousel = wrapper:tag('div'):addClass('skins-carousel')
     local carousel = wrapper:tag('div'):addClass('skins-carousel')


     local skinsPacked = args.skins or ''
     local skinsPacked = args.skins or ""
     for obj in skinsPacked:gmatch("%b{}") do
     for _, chunk in ipairs(collectJsonObjects(skinsPacked)) do
         local ok, sk = pcall(mw.text.jsonDecode, obj)
         local ok, sk = pcall(mw.text.jsonDecode, chunk)
         if ok and type(sk) == "table" then
         if ok and type(sk) == "table" then
             local bannerFile = sk.background or ''
             local bannerFile = trim(sk.background or "")
             local imageFile = sk.sprite or ''
             local imageFile = trim(sk.sprite or "")
             local tooltipRaw = sk.tooltip or ''
             local tooltipRaw = trim(sk.tooltip or "")
             local tooltipHtml = tooltipRaw:gsub("'''([^']+)'''", "<b>%1</b>"):gsub("\n", "<br>")
             local tooltipHtml = tooltipRaw:gsub("'''([^']+)'''", "<b>%1</b>"):gsub("\n", "<br>")


             local skinCard = carousel:tag('div'):addClass('skin-card'):attr('data-skin-tooltip', tooltipHtml)
             local skinCard = carousel:tag('div'):addClass('skin-card'):attr('data-skin-tooltip', tooltipHtml)


             local yt = (sk.youtube or '')
            -- Spotlight do YouTube (opcional)
             if yt ~= '' then
             local yt = trim(sk.youtube or "")
             if yt ~= "" then
                 skinCard:attr('data-youtube', yt):addClass('is-clickable')
                 skinCard:attr('data-youtube', yt):addClass('is-clickable')
             end
             end


             skinCard:tag('div'):addClass('skin-banner'):wikitext(bannerFile ~= '' and
             skinCard:tag('div'):addClass('skin-banner'):wikitext(bannerFile ~= "" and
                                                                     string.format('[[Arquivo:%s|link=]]', bannerFile) or
                                                                     string.format('[[Arquivo:%s|link=]]', bannerFile) or
                                                                     ''):attr('alt', 'banner')
                                                                     ""):attr('alt', 'banner')


             skinCard:tag('div'):addClass('skin-sprite'):wikitext(imageFile ~= '' and
             skinCard:tag('div'):addClass('skin-sprite'):wikitext(imageFile ~= "" and
                                                                     string.format('[[Arquivo:%s|link=]]', imageFile) or
                                                                     string.format('[[Arquivo:%s|link=]]', imageFile) or
                                                                     ''):attr('alt', 'skin')
                                                                     ""):attr('alt', 'skin')
         end
         end
     end
     end
    wrapper:tag('div'):addClass('skins-arrow right'):wikitext('»')


     wrapper:tag('div'):addClass('skins-arrow right'):wikitext('»')
     ----------------------------------------------------------------------------
    -- Tier -> classe CSS (visual)
    ----------------------------------------------------------------------------
    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
 
    ----------------------------------------------------------------------------
    -- Retorno
    ----------------------------------------------------------------------------
     return tostring(html)
     return tostring(html)
end
end


return p
return p

Edição das 04h15min de 10 de setembro de 2025

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

local p = {}

--------------------------------------------------------------------------------
-- Utils
--------------------------------------------------------------------------------

local function trim(s)
    return (tostring(s or ""):gsub("^%s+", ""):gsub("%s+$", ""))
end

-- Gera URL pública de arquivo (tenta "Special:" e "Especial:" por compat)
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

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

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

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

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

    return nil
end

-- Separa uma sequência de {} (JSONs colados) em uma tabela de chunks
local function collectJsonObjects(s)
    s = tostring(s or "")
    local out = {}
    for chunk in s:gmatch("%b{}") do
        table.insert(out, chunk)
    end
    return out
end

--------------------------------------------------------------------------------
-- I18N: rótulos de atributos + "Nível"
--------------------------------------------------------------------------------

local ATTR_I18N = {
    pt = {
        cooldown = "Recarga",
        energy = "Energia", -- (não usamos neutro; JS escolhe ganho/custo)
        energy_gain = "Ganho de energia",
        energy_cost = "Custo de energia",
        power = "Poder",
        power_pvp = "Poder PvP",
        level = "Nível"
    },
    en = {
        cooldown = "Cooldown",
        energy = "Energy",
        energy_gain = "Energy Gain",
        energy_cost = "Energy Cost",
        power = "Power",
        power_pvp = "PvP Power",
        level = "Level"
    },
    es = {
        cooldown = "Recarga",
        energy = "Energía",
        energy_gain = "Ganancia de energía",
        energy_cost = "Costo de energía",
        power = "Poder",
        power_pvp = "Poder PvP",
        level = "Nivel"
    },
    pl = {
        cooldown = "Czas odnowienia",
        energy = "Energia",
        energy_gain = "Przyrost 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

    ----------------------------------------------------------------------------
    -- Header
    ----------------------------------------------------------------------------
    local header = box:tag('div'):addClass('character-header')

    -- topbar (avatar + nome + tags)
    local topbar = header:tag('div'):addClass('character-topbar')
    local nameBox = topbar:tag('div'):addClass('character-name-box')

    local avatarImg = trim(args.avatar or "Franky_ts_medal.png")
    nameBox:wikitext(string.format('[[Arquivo:%s|class=topbar-icon|link=|alt=Avatar]]', avatarImg))

    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
    if rawClasse ~= "" and mw.ustring.lower(rawClasse):sub(1, 5) == "class" then
        local arr = (charData.tags_i18n and charData.tags_i18n.pt) or charData.tags
        if type(arr) == "table" then
            rawClasse = table.concat(arr, " / ")
        end
    end
    -- Se continuar vazio, puxa do módulo do personagem
    if rawTier == "" then
        rawTier = (charData.tier_i18n and charData.tier_i18n.pt) or charData.tier or ""
    end
    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
    local tierDiv
    if rawTier ~= "" then
        tierDiv = classTags:tag('div'):addClass('class-tag tier'):wikitext(rawTier)
    end

    -- Injeta i18n do TIER como data-*
    do
        local tI = charData.tier_i18n or {
            pt = rawTier,
            en = rawTier,
            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

    -- Injeta i18n das TAGS em JSON no container
    do
        local tagsI = charData.tags_i18n
        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

    -- Render inicial das TAGS (PT)
    do
        for entry in mw.text.gsplit(rawClasse, '/', true) do
            local clean = mw.text.trim(entry or '')
            if clean ~= '' then
                classTags:tag('div'):addClass('class-tag'):wikitext(clean)
            end
        end
    end

    -- Descrição geral (se houver)
    header:tag('div'):addClass('topbar-description'):wikitext(args.desc or "")

    ----------------------------------------------------------------------------
    -- Idioma para tabs (PT padrão + aceita pt-br,en-US,... via |lang=)
    ----------------------------------------------------------------------------
    local rawLang = trim(args.lang or "pt")
    rawLang = mw.ustring.lower(rawLang)
    local baseLang = rawLang:match("^([a-z][a-z])") or rawLang
    local TAB = TAB_I18N[rawLang] or TAB_I18N[baseLang] or TAB_I18N.pt

    ----------------------------------------------------------------------------
    -- Abas (tabs)
    ----------------------------------------------------------------------------
    local tabs = header:tag('div'):addClass('character-tabs')
    tabs:tag('div'):addClass('tab-btn active'):attr('data-tab', 'skills'):wikitext(TAB.skills)
    tabs:tag('div'):addClass('tab-btn'):attr('data-tab', 'skins'):wikitext(TAB.skins)

    ----------------------------------------------------------------------------
    -- Aba: Skills
    ----------------------------------------------------------------------------
    local skillsTab = box:tag('div'):addClass('tab-content active'):attr('id', 'skills')
    local iconBar = skillsTab:tag('div'):addClass('icon-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()

    -- Injeta i18n de atributos/"Nível" e idioma default (pt por padrão; respeita |lang= se vier)
    skillsTab:attr('data-i18n-attrs', mw.text.jsonEncode(ATTR_I18N))
    skillsTab:attr('data-i18n-default', baseLang or "pt")

    -- Monta ícones de skill a partir de |skills= (sequência de {} JSON)
    local skillsPacked = args.skills or ""
    local idx = 0
    for _, chunk in ipairs(collectJsonObjects(skillsPacked)) do
        local ok, sk = pcall(mw.text.jsonDecode, chunk)
        if ok and type(sk) == "table" then
            local name = trim(sk.name or sk.nome or "")
            local icon = trim(sk.icon or "")
            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',
                    name):attr('data-desc', desc):attr('data-atr', attrs):attr('data-video',
                    (video ~= "" and fileURL(video) or "")):attr('data-video-preload', 'auto')

                -- Level (para "Nível X" no JS)
                if level ~= "" and mw.ustring.upper(level) ~= "NIVEL" then
                    iconWrap:attr('data-level', level)
                end

                -- Descrições i18n (quando vierem do Info)
                if type(sk.desc_i18n) == "table" then
                    iconWrap:attr('data-desc-pt', sk.desc_i18n.pt or ""):attr('data-desc-en', sk.desc_i18n.en or "")
                        :attr('data-desc-es', sk.desc_i18n.es or ""):attr('data-desc-pl', sk.desc_i18n.pl or "")
                elseif desc and desc ~= "" then
                    -- Pelo menos PT
                    iconWrap:attr('data-desc-pt', desc)
                end

                -- Imagem do ícone
                iconWrap:wikitext(string.format('[[Arquivo:%s|class=skill-icon-img|link=]]', icon))

                -- Slot de descrição indexado (o JS usa para sincronizar)
                descBox:tag('div'):addClass('skill-desc'):attr('data-index', idx)
            end
        end
    end

    ----------------------------------------------------------------------------
    -- Aba: Skins (carrossel)
    ----------------------------------------------------------------------------
    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
    wrapper:tag('div'):addClass('skins-arrow right'):wikitext('»')

    ----------------------------------------------------------------------------
    -- Tier -> classe CSS (visual)
    ----------------------------------------------------------------------------
    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

    ----------------------------------------------------------------------------
    -- Retorno
    ----------------------------------------------------------------------------
    return tostring(html)
end

return p