Módulo:Character

De Wiki Gla
Revisão de 03h06min de 10 de setembro de 2025 por Gurren1 (discussão | contribs) (foi adicionado os 3 idiomas (es,en,pl) pro widget de translator)
Ir para navegação Ir para pesquisar

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

---@diagnostic disable: undefined-global
-- Module:Character — render (skills + skins) [auto tier/classes + attrs i18n]
local p = {}

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

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

-- ===== I18N: labels de atributos + "Nível" =====
-- Este mapa é injetado em data-i18n-attrs no #skills para o JS consumir.
local ATTR_I18N = {
    pt = {
        cooldown    = "Recarga",
        energy      = "Energia",
        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",
    },
}

-- ===== skin serializer (mantido) =====
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 args = frame:getParent().args
    local html = mw.html.create('div')

    local function fileURL(name)
        return tostring(mw.uri.fullUrl('Special:FilePath/' .. (name or '')))
    end

    local nomeChar = args.nome or ""

    -- ===== tier / classes (auto-resolve) =====
    local rawTier   = trim(frame:preprocess(args.tier   or ""))
    local rawClasse = trim(frame:preprocess(args.classe or ""))

    if rawTier ~= "" and mw.ustring.lower(rawTier):sub(1, 4) == "tier" then
        local data = requireCharModule(nomeChar) or {}
        rawTier = (data.tier_i18n and data.tier_i18n.pt) or data.tier or rawTier
    end
    if rawClasse ~= "" and mw.ustring.lower(rawClasse):sub(1, 5) == "class" then
        local data = requireCharModule(nomeChar) or {}
        local arr  = (data.tags_i18n and data.tags_i18n.pt) or data.tags
        if type(arr) == "table" then rawClasse = table.concat(arr, " / ") end
    end

    if rawTier == "" or rawClasse == "" then
        local data = requireCharModule(nomeChar) or {}
        if rawTier == "" then
            rawTier = (data.tier_i18n and data.tier_i18n.pt) or data.tier or ""
        end
        if rawClasse == "" then
            local arr = (data.tags_i18n and data.tags_i18n.pt) or data.tags
            if type(arr) == "table" then rawClasse = table.concat(arr, " / ")
            else rawClasse = arr or "" end
        end
    end

    -- ===== Tier -> classe css =====
    local tierRaw = rawTier
    local tierKey = mw.ustring.lower(tierRaw 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[tierKey]

    -- ===== raiz =====
    local box = html:tag('div'):addClass('character-box')

    -- BG via data-attr
    do
        local raw = frame:preprocess(args.background or "")
        raw = (raw or ""):gsub("^%s+", ""):gsub("%s+$", "")
        if raw ~= "" then
            raw = raw:gsub("^Arquivo:", ""):gsub("^File:", "")
            local title = mw.title.new('Especial:FilePath/' .. raw)
            local url = title and title:fullUrl() or nil
            if url and url ~= "" then
                box:attr('data-bg-file', raw)
                box:attr('data-bg-url',  url)
            end
        end
    end
    local function trim2(s2) return (s2 or ''):match('^%s*(.-)%s*$') 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
        local bgParam = trim2(args.background or '')
        if bgParam == '' then bgParam = trim2(args.banner or '') end
        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

    local bgFile = trim(frame:preprocess(args.background or ""))
    if bgFile ~= "" then
        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 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 tabs = header:tag('div'):addClass('character-tabs')
    tabs:tag('div'):addClass('tab-btn active'):attr('data-tab', 'skills'):wikitext('Skills')
    tabs:tag('div'):addClass('tab-btn'):attr('data-tab', 'skins'):wikitext('Skins')

    -- ===== 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')

    -- I18N: injeta o mapa inteiro para o JS usar (botão de idioma)
    skillsTab:attr('data-i18n-attrs', mw.text.jsonEncode(ATTR_I18N))
    -- opcional: idioma padrão vindo da predef (se quiser)
    if args.lang and trim(args.lang) ~= "" then
        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)
    local idx = 0
    for obj in skillsPacked:gmatch("%b{}") do
        local ok, sk = pcall(mw.text.jsonDecode, obj)
        if ok and type(sk) == "table" and (sk.name or sk.nome) and (sk.name ~= '' or sk.nome ~= '') then
            idx = idx + 1
            local name  = sk.name or sk.nome or ''
            local icon  = sk.icon or ''
            local desc  = sk.desc or ''
            local level = tostring(sk.level or '')
            -- ordem esperada pelo JS: PVE, PVP, Energia, Recarga
            local attrs = table.concat({
                sk.powerpve or '-', sk.powerpvp or '-', sk.energy or '-', sk.cooldown or '-'
            }, ", ")

            local videoURL = (sk.video and sk.video ~= '') and fileURL(sk.video) 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', videoURL)
                :attr('data-video-preload', 'auto')

            -- aplica data-level quando houver (e não for placeholder)
            if level ~= '' and mw.ustring.upper(level) ~= 'NIVEL' then
                iconWrap:attr('data-level', level)
            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

    details:done()
    skillsContainer:tag('div'):addClass('video-container'):done()
    skillsTab:done()

    -- ===== SKINS =====
    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('SKINS & SPOTLIGHTS')

    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 obj in skinsPacked:gmatch("%b{}") do
        local ok, sk = pcall(mw.text.jsonDecode, obj)
        if ok and type(sk) == "table" then
            local bannerFile  = sk.background or ''
            local imageFile   = sk.sprite or ''
            local tooltipRaw  = 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)

            local yt = (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('»')
    return tostring(html)
end

return p