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 resource_lookup = mw.loadJsonData("Data:ResourceLookup.json")
local item_data = mw.loadJsonData("Data:ItemData.json")

local p = {}

-- Automatic hints that get shown without corresponding {{AbilityInteraction}}. Powered by Module:AbilityTable
local CONFIG = {
    { list = "melee",            file = "Melee Lifesteal.png",  tip = "Benefits from melee items (e.g. [[Melee Lifesteal]])" },
    { list = "dontbreakstealth", file = "Veil Walker.png",      tip = "Casting does not break stealth from [[Veil Walker]] or [[Shadow Weave]]" },
    { list = "movementbased",    file = "Slowing Hex.png",      tip = "Disabled by [[Slowing Hex]]" },
    { list = "debuffresist",     file = "Debuff Reducer.png",   tip = "Debuff duration reduced by [[Debuff Resist]]" },
    { list = "heal",             file = "Healing Booster.png",  tip = "Healing amplified by [[Healing Booster]] and affected by healing reduction" },
    { list = "healingtempo",     file = "Healing Tempo.png",    tip = "Healing triggers [[Healing Tempo]]'s unique effect" },
    { list = "reactivebarrier",  file = "Reactive Barrier.png", tip = "Triggers [[Reactive Barrier]]" },
    { list = "dispelmagic",      file = "Dispel Magic.png",     tip = "Effect can be [[Dispel Magic|dispelled]]" },
    { list = "indomitable",      file = "Indomitable.png",      tip = "Disable prevented by [[Indomitable]]" },
    { list = "unstoppable",      file = "Unstoppable.png",      tip = "Negative status effects suppressed by [[Unstoppable]]" },
    { list = "platedarmor",      file = "Plated Armor.png",     tip = "On-shot effect prevented by [[Plated Armor]]" },
    { list = "summons",          file = "Monster Rounds.png",   tip = "Summons affected by [[Monster Rounds]] and [[Heroic Aura]]" },
}

-- Display order: item slot (Weapon, then Vitality, then Spirit), then cost, then name.
local function sort_key(file)
    local base = mw.ustring.lower((file:gsub('%.%w+$', '')))
    local entry = resource_lookup[base]
    local item = (entry ~= nil and entry.type == 'item') and item_data[entry.key] or nil
    if item == nil then
        return { 99, math.huge, base }
    end
    local slot = item["Slot"]
    local slot_rank = (slot == "Weapon" and 1) or (slot == "Armor" and 2) or (slot == "Tech" and 3) or 98
    return {
        slot_rank,
        tonumber(item["Cost"]) or math.huge,
        mw.ustring.lower(item["Name"] or base),
    }
end

local function compare(a, b)
    for i = 1, 3 do
        if a.sort[i] ~= b.sort[i] then return a.sort[i] < b.sort[i] end
    end
    return false
end

-- partial: split the icon so the top-left half is grayscale (mirrors the iconbox-partial box icon).
-- An empty link makes the icon non-clickable; automatic hints link from their tooltip text instead.
local function icon_img(file, link, partial)
    link = link or ''
    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)
        .. '<span class="ability-hint-tip">' .. def.tip .. '</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 .. '.<br>Click to reveal more info.</span></span>'
end

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

    local manual_by_file = {}
    for _, m in ipairs(manual) do
        manual_by_file[mw.ustring.lower(m.file)] = m
    end

    local entries = {}
    local placed = {}

    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(entries, { file = m.file, html = manual_icon(m) })
                    placed[key] = true
                else
                    table.insert(entries, { file = def.file, html = hint_icon(def) })
                end
            end
        end
    end

    for _, m in ipairs(manual) do
        if not placed[mw.ustring.lower(m.file)] then
            table.insert(entries, { file = m.file, html = manual_icon(m) })
        end
    end

    if #entries == 0 then return '' end

    for _, e in ipairs(entries) do e.sort = sort_key(e.file) end
    table.sort(entries, compare)

    local icons = {}
    for _, e in ipairs(entries) do table.insert(icons, e.html) end

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

return p
@@ Line 1: / Line 1: @@
 -- 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.
--- label_dict_key names the [[Data:Dictionary]] entry holding the tooltip text. It is
--- resolved at render time rather than here, so the tooltip follows the page language
--- and so no frame is needed while the module is still loading.
-local CONFIG = {
-    { list = "melee",            file = "Melee Lifesteal.png",  label_dict_key = "AbilityHintsMelee" },
-    { list = "dontbreakstealth", file = "Veil Walker.png",      label_dict_key = "AbilityHintsDontBreakStealth" },
-    { list = "movementbased",    file = "Slowing Hex.png",      label_dict_key = "AbilityHintsMovementBased" },
-    { list = "debuffresist",     file = "Debuff Reducer.png",   label_dict_key = "AbilityHintsDebuffResist" },
-    { list = "heal",             file = "Healing Booster.png",  label_dict_key = "AbilityHintsHeal" },
-    { list = "healingtempo",     file = "Healing Tempo.png",    label_dict_key = "AbilityHintsHealingTempo" },
-    { list = "reactivebarrier",  file = "Reactive Barrier.png", label_dict_key = "AbilityHintsReactiveBarrier" },
-    { list = "dispelmagic",      file = "Dispel Magic.png",     label_dict_key = "AbilityHintsDispelMagic" },
-    { list = "indomitable",      file = "Indomitable.png",      label_dict_key = "AbilityHintsIndomitable" },
-    { list = "unstoppable",      file = "Unstoppable.png",      label_dict_key = "AbilityHintsUnstoppable" },
-    { list = "platedarmor",      file = "Plated Armor.png",     label_dict_key = "AbilityHintsPlatedArmor" },
-    { list = "summons",          file = "Monster Rounds.png",   label_dict_key = "AbilityHintsSummons" },
-}
--- Tooltip wording for a manually placed icon, keyed by its iconbox state. Each entry
--- takes the item title as {{{1}}}, so translations can put the object where their
--- grammar wants it rather than always after the verb. The enhanced state has no entry
--- of its own: the glow already marks it, so it falls through to the normal wording.
-local STATE_DICT_KEYS = {
-    normal   = "AbilityHintsInteracts",
-    disabled = "AbilityHintsInteractsNot",
-    partial  = "AbilityHintsInteractsPartial",
-}
 local AbilityTable = require("Module:AbilityTable")
-local dictionary = require("Module:Dictionary")
+local ability_data = mw.loadJsonData("Data:AbilityData.json")
 local resource_lookup = mw.loadJsonData("Data:ResourceLookup.json")
 local item_data = mw.loadJsonData("Data:ItemData.json")
@@ Line 37: / Line 9: @@
 local p = {}
--- Display order: item type (Weapon => Vitality => Spirit), then cost, then name.
+-- Automatic hints that get shown without corresponding {{AbilityInteraction}}. Powered by Module:AbilityTable
+local CONFIG = {
+    { list = "melee",            file = "Melee Lifesteal.png",  tip = "Benefits from melee items (e.g. [[Melee Lifesteal]])" },
+    { list = "dontbreakstealth", file = "Veil Walker.png",      tip = "Casting does not break stealth from [[Veil Walker]] or [[Shadow Weave]]" },
+    { list = "movementbased",    file = "Slowing Hex.png",      tip = "Disabled by [[Slowing Hex]]" },
+    { list = "debuffresist",     file = "Debuff Reducer.png",   tip = "Debuff duration reduced by [[Debuff Resist]]" },
+    { list = "heal",             file = "Healing Booster.png",  tip = "Healing amplified by [[Healing Booster]] and affected by healing reduction" },
+    { list = "healingtempo",     file = "Healing Tempo.png",    tip = "Healing triggers [[Healing Tempo]]'s unique effect" },
+    { list = "reactivebarrier",  file = "Reactive Barrier.png", tip = "Triggers [[Reactive Barrier]]" },
+    { list = "dispelmagic",      file = "Dispel Magic.png",     tip = "Effect can be [[Dispel Magic|dispelled]]" },
+    { list = "indomitable",      file = "Indomitable.png",      tip = "Disable prevented by [[Indomitable]]" },
+    { list = "unstoppable",      file = "Unstoppable.png",      tip = "Negative status effects suppressed by [[Unstoppable]]" },
+    { list = "platedarmor",      file = "Plated Armor.png",     tip = "On-shot effect prevented by [[Plated Armor]]" },
+    { list = "summons",          file = "Monster Rounds.png",   tip = "Summons affected by [[Monster Rounds]] and [[Heroic Aura]]" },
+}
+-- Display order: item slot (Weapon, then Vitality, then Spirit), then cost, then name.
 local function sort_key(file)
      local base = mw.ustring.lower((file:gsub('%.%w+$', '')))
@@ Line 76: / Line 64: @@
 local function hint_icon(def)
      return '<span class="ability-hint">' .. icon_img(def.file)
-         .. '<span class="ability-hint-tip">' .. dictionary.translate(def.label_dict_key) .. '</span></span>'
+         .. '<span class="ability-hint-tip">' .. def.tip .. '</span></span>'
 end
 local function manual_icon(m)
      local cls = 'ability-hint'
-     local dict_key = STATE_DICT_KEYS.normal
+     local verb = 'Interacts with'
      local partial = false
      if m.state == 'disabled' then
          cls = cls .. ' ability-hint--disabled'
-         dict_key = STATE_DICT_KEYS.disabled
+         verb = 'Does not interact with'
      elseif m.state == 'partial' then
-         dict_key = STATE_DICT_KEYS.partial
+         verb = 'Interacts partially with'
          partial = true
-    elseif m.state == 'enhanced' then
-        cls = cls .. ' ability-hint--enhanced'
      end
-    local tip = dictionary.translate(dict_key, nil, nil, { m.title })
-        .. '<br>' .. dictionary.translate('AbilityHintsClickReveal')
      return '<span class="' .. cls .. '">' .. icon_img(m.file, '#' .. m.anchor, partial)
-         .. '<span class="ability-hint-tip">' .. tip .. '</span></span>'
+         .. '<span class="ability-hint-tip">' .. verb .. ' ' .. m.title .. '.<br>Click to reveal more info.</span></span>'
 end
@@ Line 109: / Line 93: @@
      local placed = {}
-     local num = tonumber(ability_num)
+     local record = ability_data[ability_key]
-    for _, def in ipairs(CONFIG) do
+    if record ~= nil then
-        if AbilityTable.is_member(def.list, ability_key, num) then
+        local num = tonumber(ability_num)
-            local key = mw.ustring.lower(def.file)
+        for _, def in ipairs(CONFIG) do
-            local m = manual_by_file[key]
+            if AbilityTable.is_member(def.list, record, num) then
-            if m ~= nil then
+                local key = mw.ustring.lower(def.file)
-                table.insert(entries, { file = m.file, html = manual_icon(m) })
+                local m = manual_by_file[key]
-                placed[key] = true
+                if m ~= nil then
-            else
+                    table.insert(entries, { file = m.file, html = manual_icon(m) })
-                table.insert(entries, { file = def.file, html = hint_icon(def) })
+                    placed[key] = true
+                else
+                    table.insert(entries, { file = def.file, html = hint_icon(def) })
+                end
              end
          end