Editing Module:AbilityHintsGive feedback

-- Small item icons on ability cards showing how an ability interacts with items (dispellable, reduced, blocked, etc.).
-- Used by Template:AbilitySection. Styles are there too.

local AbilityTable = require("Module:AbilityTable")
local ability_data = mw.loadJsonData("Data:AbilityData.json")

local p = {}

-- Display order. Each entry: { list, file, link, tip }
local CONFIG = {
    { list = "melee",           file = "Melee Charge.png",     link = "https://deadlock.wiki/Melee_Charge",     tip = "Benefits from melee items" },
    { list = "movementbased",   file = "Slowing Hex.png",      link = "https://deadlock.wiki/Slowing_Hex",      tip = "Disabled by Slowing Hex" },
    { list = "debuffresist",    file = "Debuff Reducer.png",   link = "https://deadlock.wiki/Debuff_Reducer",   tip = "Debuff duration reduced by Debuff Resist" },
    { list = "heal",            file = "Healing Booster.png",  link = "https://deadlock.wiki/Healing_Booster",  tip = "Healing amplified by Healing Booster and affected by healing reduction" },
    { list = "reactivebarrier", file = "Reactive Barrier.png", link = "https://deadlock.wiki/Reactive_Barrier", tip = "Triggers Reactive Barrier" },
    { list = "dispelmagic",     file = "Dispel Magic.png",     link = "https://deadlock.wiki/Dispel_Magic",     tip = "Effect can be dispelled" },
    { list = "indomitable",     file = "Indomitable.png",      link = "https://deadlock.wiki/Indomitable",      tip = "Disable prevented by Indomitable" },
    { list = "unstoppable",     file = "Unstoppable.png",      link = "https://deadlock.wiki/Unstoppable",      tip = "Disable prevented by Unstoppable" },
    { list = "platedarmor",     file = "Plated Armor.png",     link = "https://deadlock.wiki/Plated_Armor",     tip = "On-shot effect prevented by Plated Armor" },
    { list = "summons",         file = "Monster Rounds.png",   link = "https://deadlock.wiki/Monster_Rounds",   tip = "Summons affected by Monster Rounds and Heroic Aura" },
}

-- partial: split the icon so the top-left half is grayscale (mirrors the ai-partial box icon).
local function icon_img(file, link, partial)
    if partial then
        return '<span class="ability-hint-icon"><span class="ability-hint-split">'
            .. '[[File:' .. file .. '|24px|link=' .. link .. ']]'
            .. '<span class="ability-hint-split-gray">[[File:' .. file .. '|24px|link=]]</span>'
            .. '</span></span>'
    end
    return '<span class="ability-hint-icon">[[File:' .. file .. '|24px|link=' .. link .. ']]</span>'
end

local function hint_icon(def)
    return '<span class="ability-hint">' .. icon_img(def.file, def.link)
        .. '<span class="ability-hint-tip">' .. def.tip .. ". Click to go to item's page</span></span>"
end

local function manual_icon(m)
    local cls = 'ability-hint'
    local verb = 'Interacts with'
    local partial = false
    if m.state == 'disabled' then
        cls = cls .. ' ability-hint--disabled'
        verb = 'Does not interact with'
    elseif m.state == 'partial' then
        verb = 'Interacts partially with'
        partial = true
    end
    return '<span class="' .. cls .. '">' .. icon_img(m.file, '#' .. m.anchor, partial)
        .. '<span class="ability-hint-tip">' .. verb .. ' ' .. m.title .. '. Click to reveal more info.</span></span>'
end

function p.get_icons(ability_key, ability_num, manual)
    manual = manual or {}

    -- Manual icons indexed by file so an override can take its automatic hint's slot.
    local manual_by_file = {}
    for _, m in ipairs(manual) do
        manual_by_file[mw.ustring.lower(m.file)] = m
    end

    local icons = {}
    local placed = {}

    -- Automatic hints in CONFIG order; an overriding manual icon takes the slot.
    local record = ability_data[ability_key]
    if record ~= nil then
        local num = tonumber(ability_num)
        for _, def in ipairs(CONFIG) do
            if AbilityTable.is_member(def.list, record, num) then
                local key = mw.ustring.lower(def.file)
                local m = manual_by_file[key]
                if m ~= nil then
                    table.insert(icons, manual_icon(m))
                    placed[key] = true
                else
                    table.insert(icons, hint_icon(def))
                end
            end
        end
    end

    -- Remaining manual icons (no automatic slot) in their original order.
    for _, m in ipairs(manual) do
        if not placed[mw.ustring.lower(m.file)] then
            table.insert(icons, manual_icon(m))
        end
    end

    if #icons == 0 then return '' end
    return '<div class="ability-section-hints">' .. table.concat(icons) .. '</div>'
end

return p