The Deadlock Wiki - User contributions [en]

Module:Abilities/card

2026-07-31T12:04:47Z

~2026-SlotReloadHex823: Size upgrade descriptions by measuring the rendered text against the box instead of counting bytes of the raw string, fixing punctuation and non-English localisations (with help from vergir-bot LLM)

local lang = require "Module:Lang"
local commonutils = require "Module:Utilities"
local utils = require "Module:Abilities/utils"
local Icon = require"Module:Abilities/icon"
local textfit = require "Module:TextFit"

local p = {}
local data = mw.loadJsonData("Data:AbilityCards.json")

function get_hero_key(hero_name)
if hero_name == nil then return nil end

-- if name starts with "hero_", use it directly as the key
if string.sub(hero_name, 1, 5) == "hero_" then return hero_name end

local resource_lookup = mw.loadJsonData("Data:ResourceLookup.json")
return resource_lookup[hero_name:lower()].key
end

--{{#invoke:Abilities/card|get_ability_card|HERO_NAME|ABILITY_NUM|ADD_LINK|NOTES}}--
-- Args:
-- HERO_NAME (required) - Name of the hero that is found in Data:HeroData.json under "Name"
-- ABILITY_NUM (required) - Selects ability at index 1 to 4
-- ADD_LINK - Add a hyperlink to the title to the associated page
-- NOTES - User note data to include in the footer of the ability card
p.get_ability_card = function(frame)
local hero_name = frame.args[1]
local ability_num = frame.args[2]
local add_link = frame.args[3]
local notes = frame.args[4]

local hero_key = get_hero_key(hero_name)
if (hero_key == nil) then return 'Hero with name' .. hero_name .. 'not found' end

return build_ability_card(hero_key, ability_num, add_link, notes)
end

-- Pulls data from Data:AbilityCards.json to populate Template:Ability card v2
function build_ability_card(hero_key, ability_num, add_link, notes, notes_source_page)
local ability = utils.get_ability_card_data(hero_key, ability_num)
if(ability == nil) then
return 'Ability data not found for hero ' ..hero_key.. ' and num ' .. ability_num
end

local ability_name_localized = lang.get_string(ability.Key)
local name_link = nil
if add_link == 'true' then
name_link = ability_name_localized
end

if notes_source_page ~= nil and notes ~= "" then
-- Notes comes from a /Notes page, and the notes are not blank
-- Confirm the notes source page exists, otherwise, don't display any notes
local title = mw.title.new(notes_source_page)
if not (title and title.exists) then
notes = ""
end
end

local frame = mw.getCurrentFrame()

local info1_desc = get_info_desc(hero_key, ability_num, 1)
local info1_main_boxes = get_main_boxes(hero_key, ability_num, 1)

local info1_alt_boxes = get_alt_boxes(hero_key, ability_num, 1)

if #info1_alt_boxes > 7 then
error(#info1_alt_boxes .. ' alt boxes found, but only 7 are supported. Please update Module:Abilities/card and Template:Ability_card_v2')
end

local info2_desc = get_info_desc(hero_key, ability_num, 2)
local info2_main_boxes = get_main_boxes(hero_key, ability_num, 2)
local info2_alt_boxes = get_alt_boxes(hero_key, ability_num, 2)

if #info2_alt_boxes > 7 then
error(#info2_alt_boxes .. ' alt boxes found, but only 7 are supported. Please update Module:Abilities/card and Template:Ability_card_v2')
end

local info3_desc = get_info_desc(hero_key, ability_num, 3)
local info3_main_boxes = get_main_boxes(hero_key, ability_num, 3)
local info3_alt_boxes = get_alt_boxes(hero_key, ability_num, 3)

if #info3_alt_boxes > 7 then
error(#info3_alt_boxes .. ' alt boxes found, but only 7 are supported. Please update Module:Abilities/card and Template:Ability_card_v2')
end

local upgrades = get_upgrade_boxes(hero_key, ability_num)

return frame:expandTemplate{
title = "Ability_card_v2/Card",
args = {
id = hero_key .. ':' .. ability.Key,
hero_key = hero_key,
ability_num = ability_num,

-- Header info defined in various attributes
name = ability_name_localized,
name_link = name_link,
icon = lang.get_string(ability.Key, 'en') .. '.png',

channel_time = ability.AbilityChannelTime and ability.AbilityChannelTime.Value ~= 9999 and ability.AbilityChannelTime.Value,
channel_time_scale = get_attr_scale(ability.AbilityChannelTime),
channel_time_scale_type = get_attr_scale_type(ability.AbilityChannelTime),
channel_time_scale_multiply = get_attr_scale_multiply(ability.AbilityChannelTime),
radius = ability.Radius and ability.Radius.Value,
radius_scale = get_attr_scale(ability.Radius),
radius_scale_type = get_attr_scale_type(ability.Radius),
radius_scale_multiply = get_attr_scale_multiply(ability.Radius),
range = ability.AbilityCastRange and ability.AbilityCastRange.Value,
range_scale = get_attr_scale(ability.AbilityCastRange),
range_scale_type = get_attr_scale_type(ability.AbilityCastRange),
range_scale_multiply = get_attr_scale_multiply(ability.AbilityCastRange),
duration = ability.AbilityDuration and ability.AbilityDuration.Value,
duration_scale = get_attr_scale(ability.AbilityDuration),
duration_scale_type = get_attr_scale_type(ability.AbilityDuration),
duration_scale_multiply = get_attr_scale_multiply(ability.AbilityDuration),
-- ability_width = format_value_with_prepost(width_key, ability[width_key]),
cooldown =ability.AbilityCooldown and ability.AbilityCooldown.Value,
cooldown_scale = get_attr_scale(ability.AbilityCooldown),
cooldown_scale_type = get_attr_scale_type(ability.AbilityCooldown),
cooldown_scale_multiply = get_attr_scale_multiply(ability.AbilityCooldown),
charge_cooldown = ability.AbilityCooldownBetweenCharge and ability.AbilityCooldownBetweenCharge.Value ~= -1 and ability.AbilityCooldownBetweenCharge.Value,
charge_cooldown_scale = get_attr_scale(ability.AbilityCooldownBetweenCharge),
charge_cooldown_scale_type = get_attr_scale_type(ability.AbilityCooldownBetweenCharge),
charge_cooldown_scale_multiply = get_attr_scale_multiply(ability.AbilityCooldownBetweenCharge),
num_of_charges = ability.AbilityCharges and ability.AbilityCharges.Value or 0,

-- Info section #1 defined in "Info1" attribute
hide_info1 = infobox_is_hidden(ability.Info1) and "true" or "false",
info1_desc = info1_desc,
info1_mainbox1 = info1_main_boxes[1],
info1_mainbox2 = info1_main_boxes[2],
info1_mainbox3 = info1_main_boxes[3],
info1_mainbox4 = info1_main_boxes[4],
info1_mainbox5 = info1_main_boxes[5],
info1_altbox1 = info1_alt_boxes[1],
info1_altbox2 = info1_alt_boxes[2],
info1_altbox3 = info1_alt_boxes[3],
info1_altbox4 = info1_alt_boxes[4],
info1_altbox5 = info1_alt_boxes[5],
info1_altbox6 = info1_alt_boxes[6],
info1_altbox7 = info1_alt_boxes[7],

-- Info section #2 defined in "Info2" attribute
hide_info2 = infobox_is_hidden(ability.Info2) and "true" or "false",
info2_desc = info2_desc,
info2_mainbox1 = info2_main_boxes[1],
info2_mainbox2 = info2_main_boxes[2],
info2_mainbox3 = info2_main_boxes[3],
info2_mainbox4 = info2_main_boxes[4],
info2_mainbox5 = info2_main_boxes[5],
info2_altbox1 = info2_alt_boxes[1],
info2_altbox2 = info2_alt_boxes[2],
info2_altbox3 = info2_alt_boxes[3],
info2_altbox4 = info2_alt_boxes[4],
info2_altbox5 = info2_alt_boxes[5],
info2_altbox6 = info2_alt_boxes[6],
info2_altbox7 = info2_alt_boxes[7],

-- Info section #3 defined in "Info3" attribute
hide_info3 = infobox_is_hidden(ability.Info3) and "true" or "false",
info3_desc = info3_desc,
info3_mainbox1 = info3_main_boxes[1],
info3_mainbox2 = info3_main_boxes[2],
info3_mainbox3 = info3_main_boxes[3],
info3_mainbox4 = info3_main_boxes[4],
info3_mainbox5 = info3_main_boxes[5],
info3_altbox1 = info3_alt_boxes[1],
info3_altbox2 = info3_alt_boxes[2],
info3_altbox3 = info3_alt_boxes[3],
info3_altbox4 = info3_alt_boxes[4],
info3_altbox5 = info3_alt_boxes[5],
info3_altbox6 = info3_alt_boxes[6],
info3_altbox7 = info3_alt_boxes[7],

-- Ability upgrades defined in "Upgrades" attribute
upgrade1 = upgrades[1],
upgrade2 = upgrades[2],
upgrade3 = upgrades[3],

-- User-created ability notes
notes = notes,
notes_source_page = notes_source_page
}
}
end

function infobox_is_hidden(infobox)
if infobox == nil then
return false
end

return infobox.RequiresUpgradeIndex ~= nil
end

-- An attribute may carry either a single scaling or a list of them.
-- Extra entries are stat-category markers (duration, cooldown, range, radius,
-- healing, charges) that always hold a value of 1 and are never displayed, so
-- return the first entry that actually renders a badge.
-- A zero-valued scaling is still returned when nothing else is displayable. The
-- card renders it as an x0 placeholder, and the ability upgrade gadget fills
-- that element in when an upgrade grants real scaling (Doorman's Doorway).
local function pick_scale(attr)
if not attr then
return nil
end

local scale = attr.Scale
if type(scale) ~= 'table' then
return nil
end

-- A single scaling is stored directly as an object
if scale[1] == nil then
return scale
end

local placeholder = nil
for _, entry in ipairs(scale) do
if type(entry) == 'table' and Icon.isDisplayedScale(entry.Type) then
if entry.Value ~= 0 then
return entry
end
placeholder = placeholder or entry
end
end

return placeholder
end

-- Get scaling of attribute, return nil if none is found
function get_attr_scale(attr)
local scale = pick_scale(attr)
if not scale then
return nil
end

if scale.Value == 0 then
return nil
end

return commonutils.round_to_sig_fig(scale.Value, 3)
end

-- Get scaling type of attribute, return nil if none is found
function get_attr_scale_type(attr)
local scale = pick_scale(attr)
if not scale then
return nil
end

if scale.Value == 0 then
return nil
end

return scale.Type
end

-- Check if scaling should be multiplied instead of added
function get_attr_scale_multiply(attr)
local scale = pick_scale(attr)
if not scale then
return nil
end

return scale.Multiply
end

-- Get the description for an ability's info section
--{{#invoke:AbilityData|get_info_desc|HERO_KEY|ABILITY_NUM|INFO_SECTION_INDEX}}--
p.get_info_desc = function(frame)
local hero_key = frame.args[1]
local ability_num = frame.args[2]
local info_section_num = frame.args[3]

local ability = utils.get_ability_card_data(hero_key, ability_num)
if(ability == nil) then return {} end -- return empty table, not string
local info_section = ability['Info'..info_section_num]

-- some abilities have no info sections
if info_section == nil then return '' end

if info_section.DescKey == nil then
return ''
end

return frame:preprocess(lang.get_string(info_section.DescKey))
end

function get_info_desc(hero_key, ability_num, info_section_num)
local ability = utils.get_ability_card_data(hero_key, ability_num)
if(ability == nil) then return "Ability Not Found" end
local info_section = ability['Info'..info_section_num]

-- some abilities have no info sections
if info_section == nil then return '' end

if info_section.DescKey == nil then
return ''
end

local frame = mw.getCurrentFrame()
return frame:preprocess(lang.get_string(info_section.DescKey))
end

function get_main_boxes(hero_key, ability_num, info_section_num)
local ability = utils.get_ability_card_data(hero_key, ability_num)
if(ability == nil) then return "Ability Not Found" end

local info_section = ability['Info'..info_section_num]

-- some abilities have no info sections
if info_section == nil then return '' end

local main = info_section.Main
if main == nil then
return {}
end

local frame = mw.getCurrentFrame()

local props = {}

-- Start with the standard Props array
if main.Props then
for _, prop in ipairs(main.Props) do
table.insert(props, prop)
end
end

local main_boxes = {}
for k, prop in ipairs(props) do -- use ipairs for ordered iteration
local value = prop.Value
local scale = pick_scale(prop)
-- If it scales with melee damage, set the value using the hero's base melee to match in game visuals
if scale and scale.Type == 'melee' then
local hero = get_hero_data(hero_key)
value = prop.Value + hero.LightMeleeDamage * scale.Value
elseif scale and scale.Type == 'heavy_melee' then
local hero = get_hero_data(hero_key)
value = prop.Value + hero.HeavyMeleeDamage * scale.Value
elseif scale and scale.Type == 'weapon_power' then
local hero = get_hero_data(hero_key)
value = hero.Weapon.BulletDamage * hero.Weapon.BulletsPerBurst * (scale.Value + 100) / 100
end

local icon = Icon.getAttrIcon(prop.Type)

local main_box
if prop.StatusEffect then
main_box = frame:expandTemplate{
title = "Ability_card_v2/Card/StatusBox",
args = {
title = prop.Title,
key = prop.Key,
value = value,
status_effect = prop.StatusEffect,
icon = icon and icon.img,
icon_link = icon and icon.link,
icon_color = icon and icon.color,
icon_size = icon and icon.size,
scale_value = scale and commonutils.round_to_sig_fig(scale.Value, 3),
scale_type = scale and scale.Type,
-- allow nil value here as some status effects don't have a value but should not be hidden
hide = value == 0 and "true" or "false",
}
}
else
main_box = frame:expandTemplate{
title = "Ability_card_v2/Card/MainBox",
args = {
title = prop.Title,
key = prop.Key,
value = value,
icon = icon and icon.img,
icon_link = icon and icon.link,
icon_color = icon and icon.color,
icon_size = icon and icon.size,
scale_value = scale and commonutils.round_to_sig_fig(scale.Value, 3),
scale_type = scale and scale.Type,
hide = (value == nil or value == 0) and "true" or "false",
}
}
end
table.insert(main_boxes, main_box)
end

return main_boxes
end

function get_hero_data(hero_key)
local hero_data = mw.loadJsonData("Data:HeroData.json")
local hero = hero_data[hero_key]
if (hero == nil) then return "Hero Not Found" end
return hero
end

function get_alt_boxes(hero_key, ability_num, info_section_num)
local ability = utils.get_ability_card_data(hero_key, ability_num)
if(ability == nil) then return "Ability Not Found" end

local info_section = ability['Info'..info_section_num]

-- some abilities have no info sections
if info_section == nil then return '' end

local props = info_section.Alt
if props == nil then
return ''
end

local frame = mw.getCurrentFrame()

local alt_boxes = {}

for k, prop in ipairs(props) do
-- Some props don't have values, as those come from upgrades
-- For now, we will ignore these and only show data for the base ability
if prop.Value then
local icon = Icon.getAttrIcon(prop.Type)

local value = prop.Value
local scale = pick_scale(prop)

if scale and scale.Type == 'weapon_power' then
local hero = get_hero_data(hero_key)
value = hero.Weapon.BulletDamage * hero.Weapon.BulletsPerBurst * (scale.Value + 100) / 100
end

local alt_box = frame:expandTemplate{
title = "Ability_card_v2/Card/AltBox",
args = {
key = prop.Key,
value = value,
icon = icon and icon.img,
icon_link = icon and icon.link,
icon_color = icon and icon.color,
icon_size = icon and icon.size,
scale_value = scale and commonutils.round_to_sig_fig(scale.Value, 3),
scale_type = scale and scale.Type,
hide = value == 0 and "true" or "false",
}
}
table.insert(alt_boxes, alt_box)
end
end

return alt_boxes
end

local UPGRADE_COST_MAP = {1, 2, 5}

-- Upgrade description sizing. These are design proportions, not copies of any
-- CSS measurement: the browser supplies the box width through the container
-- query on .ac-upgrade-descwrap, so nothing here needs updating if the card's
-- widths, margins or padding change.
local UG_DESC_ASPECT = 0.357 -- max height of the text block, as a multiple of its width
local UG_LINE_HEIGHT = 1.4 -- emitted alongside the size so the two cannot drift
local UG_MAX_CQW = 11.9 -- ceiling, as % of the text width (~16px on a full-width card)
local UG_MIN_CQW = 6.7 -- floor (~9px)

function get_upgrade_boxes(hero_key, ability_num)
local ability = utils.get_ability_card_data(hero_key, ability_num)
if(ability == nil) then return "Ability Not Found" end

local frame = mw.getCurrentFrame()

local upgrades = ability.Upgrades

local upgrade_boxes = {}
for k, upgrade in ipairs(upgrades) do
local description = lang.get_string(upgrade.DescKey)

-- bypass some keys if they are mistakenly left in game files
local IGNORE_DESC_KEYS = {'citadel_ability_hornet_snipe_t3_desc', 'ability_fencer_ultimate_t3_desc'}

-- Generate a description if there is no localized string
if (description == nil or description == '' or commonutils.contains(IGNORE_DESC_KEYS, upgrade.DescKey)) then
description = create_description(upgrade, frame)
else
-- Replace embedded value placeholders with just the base value
-- Pattern: {'Value': X, 'Scale': {...}} -> X
description = description:gsub("{'Value':%s*([%d%.%-]+),%s*'Scale':%s*{[^}]+}}", function(value)
return commonutils.round_to_sig_fig(tonumber(value), 3)
end)
-- Pattern: {'Value': X} -> X
description = description:gsub("{'Value':%s*([%d%.%-]+)}", function(value)
return commonutils.round_to_sig_fig(tonumber(value), 3)
end)
end

-- Expand once, then size from the text the reader actually sees, rather
-- than from a character count of the unexpanded string.
local rendered = frame:preprocess(description)
local cqw = textfit.fit(rendered, {
aspect = UG_DESC_ASPECT,
lineHeight = UG_LINE_HEIGHT,
max = UG_MAX_CQW,
min = UG_MIN_CQW,
})

local upgrade_scale = pick_scale(upgrade)
local upgrade_box = frame:expandTemplate{
title = "Ability_card_v2/Card/UpgradeBox",
args = {
index = k,
cost = UPGRADE_COST_MAP[k],
description = rendered,
scale_value = upgrade_scale and commonutils.round_to_sig_fig(upgrade_scale.Value, 3),
scale_type = upgrade_scale and upgrade_scale.Type,
-- Measured against the box's own width, so the size stays correct
-- when the card renders below its 500px max-width.
fontsize = string.format('%.2fcqw', cqw),
lineheight = UG_LINE_HEIGHT
}
}
table.insert(upgrade_boxes, upgrade_box)
end

return upgrade_boxes
end

function create_description(prop, frame)
local value_lines = {} -- normal stat changes
local scale_lines = {} -- "Increased X scaling" notes
local seen = {}

for k, v in pairs(prop) do
if k == 'DescKey' then
-- skip
elseif type(v) == 'table' then
local has_value = v.Value ~= nil
local has_scale = v.Scale and v.Scale.Value and v.Scale.Value ~= 0

-- Value is 0 and we have a scaling change → scaling note
if has_value and has_scale and v.Value == 0 then
if not seen["scale_" .. k] then
local scale_type = v.Scale.Type
local capitalized = scale_type:sub(1,1):upper() .. scale_type:sub(2)
table.insert(scale_lines, "Increased " .. capitalized .. " scaling")
seen["scale_" .. k] = true
end
-- Only a scaling change, no value → scaling note (future bot correction)
elseif not has_value and has_scale then
if not seen["scale_" .. k] then
local scale_type = v.Scale.Type
local capitalized = scale_type:sub(1,1):upper() .. scale_type:sub(2)
table.insert(scale_lines, "Increased " .. capitalized .. " scaling")
seen["scale_" .. k] = true
end
-- Normal value (0 without scale, or non‑zero with/without scale)
elseif has_value then
local formatted_value = utils.format_value_with_prepost(k, v.Value, frame)
local attr_name = lang.get_string(k .. '_label')
local key = formatted_value .. '|' .. attr_name
if not seen[key] then
table.insert(value_lines, string.format('%s %s', formatted_value, attr_name))
seen[key] = true
end
end
else
-- Plain number/string (e.g. OutgoingDamagePenaltyPercent = -15)
local formatted_value = utils.format_value_with_prepost(k, v, frame)
local attr_name = lang.get_string(k .. '_label')
local key = formatted_value .. '|' .. attr_name
if not seen[key] then
table.insert(value_lines, string.format('%s %s', formatted_value, attr_name))
seen[key] = true
end
end
end

-- Combine: value lines first, then scaling lines
local all_lines = {}
for _, line in ipairs(value_lines) do
table.insert(all_lines, line)
end
for _, line in ipairs(scale_lines) do
table.insert(all_lines, line)
end

return table.concat(all_lines, '<br>')
end

function find_width_key(ability)
for key, value in pairs(ability) do
if type(key) == "string" and key:sub(-5) == "Width" then
return key
end
end
return nil
end

--for use from an ability page (ability pages are WIP), not hero pages
function p.write_ability_card_from_ability_key(frame)
local ability_key = frame.args[1]
if ability_key == nil then return "ability_key '" .. ability_key "' not provided" end

-- Determine the hero and ability number
local found_hero_key
local found_ability_num
for hero_key, card_data in pairs(data) do
if found_hero_key == nil or found_ability_num == nil then
for ability_num, ability_data in pairs(card_data) do
if ability_num ~= "Name" then
if ability_data['Key'] == ability_key then
found_hero_key = hero_key
found_ability_num = ability_num
break
end -- hero_key and ability_num found
end
end
end
end

if found_ability_num == nil or found_hero_key == nil then return "ability_key " .. ability_key .. " is not used by any heroes" end

-- Get notes for this ability
local notes_source_page_name = utils.get_notes_source_page_name(ability_key)
local notes_str = frame:preprocess("{{"..notes_source_page_name.."}}")

-- Create the ability card
return p.get_ability_card_from_key(found_hero_key, found_ability_num, true, notes_str, notes_source_page_name)
end

--from hero key*
--notes parameter will eventually be removed, as notes_source_page would be sufficient or could even be determined from within this function
function p.get_ability_card_from_key(hero_key, ability_num, add_link, notes, notes_source_page)
if type(hero_key) == 'table' and hero_key.args then
local frame = hero_key
hero_key = frame.args[1]
ability_num = frame.args[2]
add_link = frame.args[3]
notes = frame.args[4]
notes_source_page = frame.args[5]
end

local ability = utils.get_ability_card_data(hero_key, ability_num)
if(ability == nil) then
return 'Ability data not found for hero ' ..hero_key.. ' and num ' .. ability_num
end

local ability_name_localized = lang.get_string(ability.Key)
local name_link = nil
if add_link == 'true' then
name_link = ability_name_localized
end

if notes_source_page ~= nil and notes ~= "" then
--Notes comes from a /Notes page, and the notes are not blank
-- Confirm the notes source page exists, otherwise, don't display any notes
local title = mw.title.new(notes_source_page)
if not (title and title.exists) then
notes = ""
end
end

return mw.getCurrentFrame():expandTemplate{
title = "Ability card v2/Card",
args = {
hero_key = hero_key,
ability_num = ability_num,
name = ability_name_localized,
name_link = name_link,
icon = lang.get_string(ability.Key, 'en') .. '.png',
description = mw.getCurrentFrame():preprocess(lang.get_string(ability.DescKey)),
channel_time = ability.AbilityChannelTime and ability.AbilityChannelTime.Value ~= 9999 and ability.AbilityChannelTime.Value,
channel_time_scale = get_attr_scale(ability.AbilityChannelTime),
channel_time_scale_type = get_attr_scale_type(ability.AbilityChannelTime),
channel_time_scale_multiply = get_attr_scale_multiply(ability.AbilityChannelTime),
radius = ability.Radius and ability.Radius.Value,
radius_scale = get_attr_scale(ability.Radius),
radius_scale_type = get_attr_scale_type(ability.Radius),
radius_scale_multiply = get_attr_scale_multiply(ability.Radius),
range = ability.AbilityCastRange and ability.AbilityCastRange.Value,
range_scale = get_attr_scale(ability.AbilityCastRange),
range_scale_type = get_attr_scale_type(ability.AbilityCastRange),
range_scale_multiply = get_attr_scale_multiply(ability.AbilityCastRange),
duration = ability.AbilityDuration and ability.AbilityDuration.Value,
duration_scale = get_attr_scale(ability.AbilityDuration),
duration_scale_type = get_attr_scale_type(ability.AbilityDuration),
duration_scale_multiply = get_attr_scale_multiply(ability.AbilityDuration),
-- ability_width = format_value_with_prepost(width_key, ability[width_key]),
cooldown =ability.AbilityCooldown and ability.AbilityCooldown.Value,
cooldown_scale = get_attr_scale(ability.AbilityCooldown),
cooldown_scale_type = get_attr_scale_type(ability.AbilityCooldown),
cooldown_scale_multiply = get_attr_scale_multiply(ability.AbilityCooldown),
charge_cooldown = ability.AbilityCooldownBetweenCharge and ability.AbilityCooldownBetweenCharge.Value ~= -1 and ability.AbilityCooldownBetweenCharge.Value,
charge_cooldown_scale = get_attr_scale(ability.AbilityCooldownBetweenCharge),
charge_cooldown_scale_type = get_attr_scale_type(ability.AbilityCooldownBetweenCharge),
charge_cooldown_scale_multiply = get_attr_scale_multiply(ability.AbilityCooldownBetweenCharge),
num_of_charges = ability.AbilityCharges and ability.AbilityCharges.Value or 0,
}
}
end

return p

Template:Ability card v2/Card/UpgradeBox

2026-07-31T12:00:16Z

~2026-SlotReloadHex823: Wrap the upgrade description in a container-query box and take the font size from the module instead of a viewport clamp (with help from vergir-bot LLM)

<includeonly>
<div id="ability-upgrade-{{{cost}}}" data-index="{{{index}}}" tabindex=0 class="cdx-button cdx-button--action-progressive ability-upgrade">
<div class="ability-upgrade-header">{{Ap|{{{cost}}}|icon_size=15px}}</div>
<div class="ac-upgrade-descwrap" style="container-type: inline-size;"><div class="ac-upgrade-desc" style="font-size: {{{fontsize|0.9rem}}}; line-height: {{{lineheight|1.4}}};">{{{description}}}</div></div>
<div>{{#if: {{{scale_type|}}}|{{Ability card v2/Card/Scaling|{{{scale_value}}}|scale_type={{{scale_type}}}}}}}</div>
</div></includeonly>
<noinclude>
{{#invoke:Abilities/card|get_ability_card|Wraith|2|false}}

Button functionality is handled by [[MediaWiki:Gadget-ability-upgrades.js]].
</noinclude>

Template:Ability card v2/Card/styles.css

2026-07-31T11:59:49Z

~2026-SlotReloadHex823: Move the upgrade description into a wrapper that owns its padding, so the box width can drive the font size (with help from vergir-bot LLM)

/* TemplateStyles for Template:Ability card v2/Card
All classes here correspond 1-to-1 with inline styles previously in the template.
Overriding any of these classes will affect the rendered card layout/appearance. */

/* Root card container */
.ability-card {
font-size: 0.9rem;
line-height: 1.4;
font-family: 'Retail Demo', 'Open Sans', 'PT Serif', serif;
color: #FFEFD7;
display: flex;
flex-direction: column;
background: #121013;
align-items: center;
width: 100%;
max-width: 500px;
border-radius: 4px;
}

/* Header full-width wrapper */
.ac-header-wrapper {
width: 100%;
}

/* Header inner row: left + right columns */
.ac-header {
display: flex;
flex-direction: row;
justify-content: space-between;
background: #121013;
border-radius: 13px 13px 0 0;
margin: 0 20px;
gap: 10px;
}

/* Left column of header */
.ac-header-left {
display: flex;
flex-direction: column;
}

/* Title row: icon + name */
.ac-title {
font-size: 2rem;
}

/* Icon span (coloured filter to match game palette) */
.ac-icon {
filter: brightness(0) saturate(100%) invert(98%) sepia(19%) saturate(1458%) hue-rotate(301deg) brightness(102%) contrast(109%);
padding-right: 5px;
}

/* Ability name span */
.ac-name {
font-family: 'Valve Occult', 'Retail Demo', 'Open Sans';
font-weight: bold;
}

/* Row of header attribute icons (channel time, range, etc.) */
.ac-header-attrs {
display: flex;
flex-direction: row;
gap: 10px;
}

/* Module can insert invisible p tags that make margins in arbitrary places
Hide them and ensable only when they are actually necessary */
.ability-card p {
display: none;
}
.ability-card .ac-title p {
display: block;
}
.ability-card .ac-mainbox-value p {
display: block;
}
.ability-card .ac-info-alt p {
display: block;
}
.ability-card .ac-headerattr-ss p {
display: block;
}
.ability-card .ac-mainbox-scale p {
display: block;
}

/* Right column of header (charges + cooldown) */
.ac-header-right {
display: flex;
flex-direction: column;
align-items: flex-end;
justify-content: flex-end;
gap: 10px;
}

/* Charges + charge-cooldown row */
.ac-charge-row {
display: flex;
flex-direction: row;
justify-content: flex-end;
margin-bottom: 5px;
gap: 2px;
}

/* Info sections outer wrapper */
.ac-info-outer {
margin: 15px 10px 0 10px;
padding: 3px 0 5px 0;
width: calc(100% - 18px);
box-sizing: border-box;
}

/* Individual info section (shared base) */
.ac-info-section {
display: flex;
flex-direction: column;
align-items: center;
width: 100%;
}

/* Description text inside an info section */
.ac-info-desc {
padding: 0 10px;
}

/* Main stat boxes row */
.ac-info-main {
display: flex;
flex-direction: row;
flex-wrap: wrap;
justify-content: center;
width: calc(97% - 5px);
min-width: 280px;
align-items: flex-end;
}

/* Alt (secondary) stat boxes row */
.ac-info-alt {
display: flex;
flex-direction: row;
flex-wrap: wrap;
justify-content: center;
align-items: center;
background-color: #2A2A2A;
width: calc(97% - 19px);
min-width: 267px;
padding: 0 4px;
column-gap: 15px;
}

/* Upgrades row */
.ac-upgrades {
display: flex;
flex-direction: row;
flex-wrap: wrap;
margin-bottom: 5px;
justify-content: center;
width: calc(97% - 16px);
min-width: 280px;
}

/* Notes outer container */
.ac-notes-wrapper {
align-self: flex-start;
margin: 10px 0 10px 20px;
font-size: 0.8rem;
}

/* Notes heading span */
.ac-notes-title {
font-size: 1.15rem;
}

/* Notes edit link span */
.ac-notes-edit {
font-size: 0.7rem;
}

/* Collapsible notes body */
.ac-notes-body {
align-self: flex-start;
margin: 10px 0 10px 20px;
font-size: 0.8rem;
}

/* -----------------------------------------------------------------------
HeaderAttr sub-template styles
----------------------------------------------------------------------- */

/* Header attribute pill (cast range, cooldown, charges, etc.) */
.ability-headerattr {
background-color: #2C2C2C;
padding: 6px;
white-space: nowrap;
font-size: calc(1em - 2px);
border-radius: 2px;
}

.ability-headerattr > span {
vertical-align: middle;
}

/* Scaling badge: outer relative anchor */
.ac-headerattr-ss {
position: relative;
}

/* Scaling badge: absolute positioned badge */
.ac-headerattr-ss-badge {
position: absolute;
top: -22px;
right: -18px;
}

/* -----------------------------------------------------------------------
MainBox sub-template styles
----------------------------------------------------------------------- */

/* Outer mainbox wrapper */
.ability-mainbox {
display: flex;
flex-direction: column;
flex-grow: 1;
flex-basis: 0;
max-height: 100%;
padding: 8px 0 2px 0;
margin: 2px;
overflow: hidden;
justify-content: flex-end;
}

/* Optional title above the stat (e.g. "On Impact", "Explosion") */
.ac-mainbox-title {
padding-bottom: 2px;
font-size: 0.8rem;
color: #9C9C9C;
font-variant: small-caps;
}

/* Relative anchor for the scale badge */
.ac-mainbox-scale {
position: relative;
}

/* Absolute positioned scale badge */
.ac-mainbox-scale-badge {
position: absolute;
top: -16px;
right: 0;
}

/* Inner stat display box — base styles shared by all variants */
.ac-mainbox-inner {
display: flex;
flex-direction: column;
justify-content: center;
text-align: center;
border-radius: 1px;
height: 60px;
}

/* Default (no scale type) */
.ac-mainbox-inner--default {
background-color: #2A2A2A;
border: 3px solid #2A2A2A;
box-shadow: 0 0 10px #2A2A2A;
}

/* Spirit power scaling */
.ac-mainbox-inner--spirit {
background: radial-gradient(circle, rgba(42,41,43,1) 0%, rgba(59,49,69,1) 100%);
border: 3px solid #583D6F;
box-shadow: 0 0 10px #3d2c4d;
}

/* Power increase (boon) scaling */
.ac-mainbox-inner--boon {
background: radial-gradient(circle, rgba(42,41,43,1) 0%, rgba(61,78,70,1) 100%);
border: 3px solid #48675a;
box-shadow: 0 0 10px #3d2c4d;
}

/* Weapon damage scaling */
.ac-mainbox-inner--weapon {
background: radial-gradient(circle, rgba(36,37,36,1) 0%, rgba(66,55,47,1) 100%);
border: 3px solid #5b412b;
box-shadow: 0 0 10px #3d2c4d;
}

/* Melee damage scaling */
.ac-mainbox-inner--melee {
background: radial-gradient(circle, rgba(36,37,36,1) 0%, rgba(66,55,47,1) 100%);
border: 3px solid #5b412b;
box-shadow: 0 0 10px #3d2c4d;
}

/* Value row (bold icon + number) */
.ac-mainbox-value {
font-family: 'Valve Occult';
font-weight: bold;
margin-top: 4px;
}

.ac-mainbox-value p {
margin: auto 0;
}

/* Bottom label */
.ac-mainbox-label {
font-size: 0.75em;
padding-bottom: 3px;
}

/* -----------------------------------------------------------------------
UpgradeBox sub-template styles
----------------------------------------------------------------------- */

/* Outer upgrade card */
.ability-upgrade {
white-space: normal;
display: flex;
flex-direction: column;
flex-grow: 1;
flex-basis: 0;
justify-content: flex-start;
max-height: 120px;
background-color: #131211;
padding: 0 0 0 0;
margin: 6px;
text-align: center;
box-shadow: 0 0 10px #2A2A2A;
border-radius: 5px;
}

/* Upgrade cost header bar */
.ability-upgrade-header {
width: 100%;
padding: 2px 0 0 2px;
font-family: 'Retail Demo bold';
background-color: #402f4c;
border-radius: 5px 5px 0 0;
}

/* Wrapper around the upgrade description. It owns the padding so that its
content box equals the usable text width exactly: Module:TextFit emits the
font size in cqw measured against this box, which is why no pixel geometry
has to be duplicated in Lua. Do not add padding or borders to
.ac-upgrade-desc, or the emitted sizes will stop matching the real space.
container-type: inline-size is set inline on the element in
Template:Ability card v2/Card/UpgradeBox, because TemplateStyles does not
allow that property here. */
.ac-upgrade-descwrap {
padding: 4px;
margin: auto 0;
}

/* Upgrade description text */
.ac-upgrade-desc {
overflow-wrap: anywhere;
}

/* -----------------------------------------------------------------------
StatusBox sub-template styles
----------------------------------------------------------------------- */

/* Inner stat display box — centered column layout (shared base, all variants) */
.ac-statusbox-inner {
display: flex;
flex-direction: column;
flex-grow: 1;
justify-content: center;
align-items: center;
text-align: center;
border-radius: 1px;
height: 60px;
}

/* Status effect name row (icon + localized name) */
.ac-statusbox-effect {
font-weight: bold;
margin-top: 4px;
}

/* Row containing value + label */
.ac-statusbox-value-row {
display: flex;
flex-direction: row;
align-items: center;
gap: 5px;
font-size: 0.75rem;
padding-bottom: 3px;
}

/* Value div */
.ac-statusbox-value {
font-weight: bold;
}

/* Fallback text when no value is present */
.ac-statusbox-no-value {
font-weight: bold;
font-size: 0.75rem;
color: #B2B2B2;
}

/* -----------------------------------------------------------------------
AltBox sub-template styles
----------------------------------------------------------------------- */

/* Outer altbox container */
.ability-altbox {
display: flex;
flex-direction: row;
flex-grow: 1;
flex-basis: 0;
justify-content: center;
background-color: #2A2A2A;
font-size: 0.85em;
margin: 3px;
text-align: center;
box-shadow: 0 0 10px #2A2A2A;
border-radius: 1px;
white-space: nowrap;
}

/* Inner span wrapping icon + value + label */
.ac-altbox-inner {
white-space: nowrap;
}

/* Bottom label span */
.ac-altbox-label {
font-size: 0.75rem;
white-space: nowrap;
}

/* Unit-of-measure suffix (e.g. "m", "%") */
.ac-altbox-uom {
font-size: 10px;
color: #9C9C9C;
}

/* -----------------------------------------------------------------------
Scaling sub-template styles
----------------------------------------------------------------------- */

.ability-scaling {
font-size: 0.8em;
white-space: nowrap;
}

.ability-scaling-attr {
font-family: 'Valve Pulp', 'Retail Demo', 'PT Serif', 'Palatino';
width: auto;
border-radius: 2px;
padding: 0 2px;
vertical-align: middle;
}

/* Spirit scaling */
.ac-scaling--spirit .ability-scaling-attr {
color: #ce91ff;
}

/* Weapon scaling */
.ac-scaling--weapon .ability-scaling-attr {
color: #ec981a;
}

/* Melee scaling */
.ac-scaling--melee .ability-scaling-attr {
color: #ec981a;
}

/* Boon scaling */
.ac-scaling--boon .ability-scaling-attr {
color: #54e1c5;
}

/* ================================================== */
/* === Gadget Ability Upgrades === */
/* ================================================== */

.hide {
display: none !important;
}

.ability-attr {
transition: text-shadow 0.6s ease;
font-weight: bold;
}

.ability-attr.highlight {
text-shadow:
0 0 6px rgba(255, 250, 0, 0.6),
0 0 12px rgba(255, 250, 0, 0.5),
0 0 24px rgba(255, 250, 0, 0.4);
}

.ability-upgrade {
transition: all 0.1s ease;
cursor: pointer;
}

.ability-upgrade {
transition: all 0.1s ease;
cursor: pointer;
box-shadow: unset !important;
}

.ability-upgrade.hovered {
background-color: #3d2d52a3 !important;
transform: translateY(-2px);
}

.ability-upgrade.selected {
background-color: #503667 !important;
}

.ability-upgrade.selected.hovered {
background-color: #3d2d52a3 !important;
}

.ability-upgrade-header {
transition: background-color 0.1s ease;
}

.ability-upgrade.selected .ability-upgrade-header {
background-color: #11140E !important;
transition: background-color 0.2s ease;
}

.cdx-button {
border:1px solid #2a2a2a
}

Module:TextFit

2026-07-31T11:11:08Z

~2026-SlotReloadHex823: Add shared text-fitting helper: per-glyph advance widths for Retail Demo and Open Sans, with a scale-invariant fitter for sizing text into a box (with help from vergir-bot LLM)

--[==[
Shared text-fitting helper.

Estimates the largest font size at which a string will wrap into a box of a
given width and height, using real per-glyph advance widths rather than a
character count. Used by [[Module:Abilities/card]] to size ability upgrade
descriptions; [[Module:ItemBox]] can migrate onto it.

Widths are in em. Sources, all extracted with fonttools:
Retail Demo regular [[:File:Retaildemo-regular.woff2]] unitsPerEm 1000
Retail Demo bold [[:File:Retaildemo-bold.woff2]] unitsPerEm 1000
Open Sans [[:File:Open_Sans.woff2]] unitsPerEm 2048

Retail Demo is subset to 65 codepoints (space, comma, period, 0-9, A-Z, a-z).
MediaWiki:Common.css declares the card font stack as
'Retail Demo', 'Open Sans', 'PT Serif', serif, so the browser falls back per
character; FALLBACK_WIDTHS holds the Open Sans widths actually used for
punctuation, Cyrillic and accented Latin.
]==]

local p = {}
local ustring = mw.ustring

-- Retail Demo, normal weight
local RD_REGULAR = {
[" "]=0.240, [","]=0.221, ["."]=0.221, ["0"]=0.645, ["1"]=0.268, ["2"]=0.549, ["3"]=0.557, ["4"]=0.601,
["5"]=0.538, ["6"]=0.583, ["7"]=0.487, ["8"]=0.555, ["9"]=0.580, A=0.624, B=0.585, C=0.641,
D=0.696, E=0.554, F=0.525, G=0.695, H=0.703, I=0.237, J=0.268, K=0.626,
L=0.494, M=0.927, N=0.700, O=0.730, P=0.558, Q=0.734, R=0.614, S=0.527,
T=0.550, U=0.679, V=0.624, W=0.939, X=0.665, Y=0.603, Z=0.647, a=0.553,
b=0.587, c=0.530, d=0.588, e=0.551, f=0.394, g=0.544, h=0.600, i=0.238,
j=0.235, k=0.552, l=0.238, m=0.923, n=0.600, o=0.603, p=0.583, q=0.587,
r=0.369, s=0.477, t=0.413, u=0.600, v=0.509, w=0.810, x=0.540, y=0.513,
z=0.554,
[" "]=0.240, -- U+00A0 no-break space
}

-- Retail Demo, bold weight
local RD_BOLD = {
[" "]=0.240, [","]=0.281, ["."]=0.281, ["0"]=0.662, ["1"]=0.312, ["2"]=0.560, ["3"]=0.566, ["4"]=0.612,
["5"]=0.562, ["6"]=0.601, ["7"]=0.520, ["8"]=0.583, ["9"]=0.598, A=0.677, B=0.590, C=0.621,
D=0.693, E=0.552, F=0.530, G=0.686, H=0.702, I=0.276, J=0.301, K=0.637,
L=0.491, M=0.904, N=0.695, O=0.741, P=0.585, Q=0.740, R=0.628, S=0.555,
T=0.555, U=0.694, V=0.668, W=0.913, X=0.667, Y=0.635, Z=0.666, a=0.573,
b=0.608, c=0.473, d=0.604, e=0.570, f=0.382, g=0.558, h=0.608, i=0.269,
j=0.266, k=0.584, l=0.268, m=0.907, n=0.602, o=0.611, p=0.604, q=0.605,
r=0.392, s=0.496, t=0.404, u=0.602, v=0.549, w=0.776, x=0.571, y=0.550,
z=0.561,
[" "]=0.240, -- U+00A0 no-break space
}

-- Open Sans, for the characters Retail Demo does not contain
local FALLBACK_WIDTHS = {
["!"]=0.264, ["\""]=0.398, ["#"]=0.646, ["$"]=0.572, ["%"]=0.827, ["&"]=0.729, ["'"]=0.219, ["("]=0.295,
[")"]=0.295, ["*"]=0.551, ["+"]=0.572, ["-"]=0.322, ["/"]=0.367, [":"]=0.263, [";"]=0.263, ["<"]=0.572,
["="]=0.572, [">"]=0.572, ["?"]=0.432, ["@"]=0.896, ["["]=0.327, ["\\"]=0.367, ["]"]=0.327, ["^"]=0.572,
["_"]=0.438, ["`"]=0.277, ["{"]=0.375, ["|"]=0.549, ["}"]=0.375, ["~"]=0.572, ["¡"]=0.264, ["¢"]=0.572,
["£"]=0.572, ["¤"]=0.572, ["¥"]=0.572, ["¦"]=0.549, ["§"]=0.514, ["¨"]=0.580, ["©"]=0.832, ["ª"]=0.353,
["«"]=0.496, ["¬"]=0.572, [""]=0.322, ["®"]=0.832, ["¯"]=0.500, ["°"]=0.428, ["±"]=0.572, ["²"]=0.348,
["³"]=0.348, ["´"]=0.277, ["µ"]=0.618, ["¶"]=0.655, ["·"]=0.263, ["¸"]=0.222, ["¹"]=0.348, ["º"]=0.374,
["»"]=0.496, ["¼"]=0.740, ["½"]=0.768, ["¾"]=0.778, ["¿"]=0.432, ["À"]=0.632, ["Á"]=0.632, ["Â"]=0.632,
["Ã"]=0.632, ["Ä"]=0.632, ["Å"]=0.632, ["Æ"]=0.868, ["Ç"]=0.630, ["È"]=0.556, ["É"]=0.556, ["Ê"]=0.556,
["Ë"]=0.556, ["Ì"]=0.279, ["Í"]=0.279, ["Î"]=0.279, ["Ï"]=0.279, ["Ð"]=0.726, ["Ñ"]=0.753, ["Ò"]=0.778,
["Ó"]=0.778, ["Ô"]=0.778, ["Õ"]=0.778, ["Ö"]=0.778, ["×"]=0.572, ["Ø"]=0.778, ["Ù"]=0.729, ["Ú"]=0.729,
["Û"]=0.729, ["Ü"]=0.729, ["Ý"]=0.559, ["Þ"]=0.602, ["ß"]=0.623, ["à"]=0.556, ["á"]=0.556, ["â"]=0.556,
["ã"]=0.556, ["ä"]=0.556, ["å"]=0.556, ["æ"]=0.862, ["ç"]=0.479, ["è"]=0.562, ["é"]=0.562, ["ê"]=0.562,
["ë"]=0.562, ["ì"]=0.252, ["í"]=0.252, ["î"]=0.252, ["ï"]=0.252, ["ð"]=0.600, ["ñ"]=0.613, ["ò"]=0.602,
["ó"]=0.602, ["ô"]=0.602, ["õ"]=0.602, ["ö"]=0.602, ["÷"]=0.572, ["ø"]=0.602, ["ù"]=0.613, ["ú"]=0.613,
["û"]=0.613, ["ü"]=0.613, ["ý"]=0.501, ["þ"]=0.612, ["ÿ"]=0.501, ["Ā"]=0.632, ["ā"]=0.556, ["Ă"]=0.632,
["ă"]=0.556, ["Ą"]=0.632, ["ą"]=0.556, ["Ć"]=0.630, ["ć"]=0.479, ["Ĉ"]=0.630, ["ĉ"]=0.479, ["Ċ"]=0.630,
["ċ"]=0.479, ["Č"]=0.630, ["č"]=0.479, ["Ď"]=0.726, ["ď"]=0.612, ["Đ"]=0.726, ["đ"]=0.613, ["Ē"]=0.556,
["ē"]=0.562, ["Ĕ"]=0.556, ["ĕ"]=0.562, ["Ė"]=0.556, ["ė"]=0.562, ["Ę"]=0.556, ["ę"]=0.562, ["Ě"]=0.556,
["ě"]=0.562, ["Ĝ"]=0.727, ["ĝ"]=0.543, ["Ğ"]=0.727, ["ğ"]=0.543, ["Ġ"]=0.727, ["ġ"]=0.543, ["Ģ"]=0.727,
["ģ"]=0.543, ["Ĥ"]=0.737, ["ĥ"]=0.613, ["Ħ"]=0.737, ["ħ"]=0.613, ["Ĩ"]=0.279, ["ĩ"]=0.252, ["Ī"]=0.279,
["ī"]=0.252, ["Ĭ"]=0.279, ["ĭ"]=0.252, ["Į"]=0.279, ["į"]=0.252, ["İ"]=0.279, ["ı"]=0.252, ["Ĳ"]=0.548,
["ĳ"]=0.505, ["Ĵ"]=0.269, ["ĵ"]=0.252, ["Ķ"]=0.612, ["ķ"]=0.525, ["ĸ"]=0.525, ["Ĺ"]=0.522, ["ĺ"]=0.252,
["Ļ"]=0.522, ["ļ"]=0.252, ["Ľ"]=0.522, ["ľ"]=0.252, ["Ŀ"]=0.522, ["ŀ"]=0.261, ["Ł"]=0.522, ["ł"]=0.252,
["Ń"]=0.753, ["ń"]=0.613, ["Ņ"]=0.753, ["ņ"]=0.613, ["Ň"]=0.753, ["ň"]=0.613, ["ŉ"]=0.676, ["Ŋ"]=0.753,
["ŋ"]=0.613, ["Ō"]=0.778, ["ō"]=0.602, ["Ŏ"]=0.778, ["ŏ"]=0.602, ["Ő"]=0.778, ["ő"]=0.602, ["Œ"]=0.925,
["œ"]=0.948, ["Ŕ"]=0.617, ["ŕ"]=0.409, ["Ŗ"]=0.617, ["ŗ"]=0.409, ["Ř"]=0.617, ["ř"]=0.409, ["Ś"]=0.548,
["ś"]=0.477, ["Ŝ"]=0.548, ["ŝ"]=0.477, ["Ş"]=0.548, ["ş"]=0.477, ["Š"]=0.548, ["š"]=0.477, ["Ţ"]=0.551,
["ţ"]=0.356, ["Ť"]=0.551, ["ť"]=0.356, ["Ŧ"]=0.551, ["ŧ"]=0.356, ["Ũ"]=0.729, ["ũ"]=0.613, ["Ū"]=0.729,
["ū"]=0.613, ["Ŭ"]=0.729, ["ŭ"]=0.613, ["Ů"]=0.729, ["ů"]=0.613, ["Ű"]=0.729, ["ű"]=0.613, ["Ų"]=0.729,
["ų"]=0.613, ["Ŵ"]=0.923, ["ŵ"]=0.775, ["Ŷ"]=0.559, ["ŷ"]=0.501, ["Ÿ"]=0.559, ["Ź"]=0.572, ["ź"]=0.469,
["Ż"]=0.572, ["ż"]=0.469, ["Ž"]=0.572, ["ž"]=0.469, ["ſ"]=0.323, ["Ѐ"]=0.556, ["Ё"]=0.556, ["Ђ"]=0.733,
["Ѓ"]=0.520, ["Є"]=0.639, ["Ѕ"]=0.548, ["І"]=0.279, ["Ї"]=0.279, ["Ј"]=0.269, ["Љ"]=0.935, ["Њ"]=0.958,
["Ћ"]=0.733, ["Ќ"]=0.610, ["Ѝ"]=0.760, ["Ў"]=0.618, ["Џ"]=0.728, ["А"]=0.632, ["Б"]=0.612, ["В"]=0.646,
["Г"]=0.520, ["Д"]=0.684, ["Е"]=0.556, ["Ж"]=0.841, ["З"]=0.583, ["И"]=0.760, ["Й"]=0.760, ["К"]=0.610,
["Л"]=0.703, ["М"]=0.899, ["Н"]=0.737, ["О"]=0.778, ["П"]=0.728, ["Р"]=0.602, ["С"]=0.630, ["Т"]=0.551,
["У"]=0.618, ["Ф"]=0.797, ["Х"]=0.578, ["Ц"]=0.737, ["Ч"]=0.693, ["Ш"]=1.032, ["Щ"]=1.037, ["Ъ"]=0.686,
["Ы"]=0.848, ["Ь"]=0.634, ["Э"]=0.630, ["Ю"]=1.048, ["Я"]=0.632, ["а"]=0.556, ["б"]=0.595, ["в"]=0.574,
["г"]=0.431, ["д"]=0.575, ["е"]=0.562, ["ж"]=0.735, ["з"]=0.483, ["и"]=0.636, ["й"]=0.636, ["к"]=0.517,
["л"]=0.572, ["м"]=0.733, ["н"]=0.633, ["о"]=0.602, ["п"]=0.620, ["р"]=0.612, ["с"]=0.479, ["т"]=0.471,
["у"]=0.501, ["ф"]=0.715, ["х"]=0.523, ["ц"]=0.626, ["ч"]=0.607, ["ш"]=0.890, ["щ"]=0.897, ["ъ"]=0.687,
["ы"]=0.768, ["ь"]=0.590, ["э"]=0.494, ["ю"]=0.829, ["я"]=0.554, ["ѐ"]=0.562, ["ё"]=0.562, ["ђ"]=0.613,
["ѓ"]=0.431, ["є"]=0.493, ["ѕ"]=0.477, ["і"]=0.252, ["ї"]=0.252, ["ј"]=0.252, ["љ"]=0.839, ["њ"]=0.889,
["ћ"]=0.613, ["ќ"]=0.517, ["ѝ"]=0.636, ["ў"]=0.501, ["џ"]=0.622, ["–"]=0.500, ["—"]=1.000, ["―"]=1.000,
["‘"]=0.169, ["’"]=0.169, ["‚"]=0.245, ["‛"]=0.169, ["“"]=0.349, ["”"]=0.349, ["…"]=0.778, ["€"]=0.572,
}

-- No bold Open Sans is loaded, so browsers synthesise it, which widens
-- advances slightly. Retail Demo's own measured bold/regular mean is 1.037.
local SYNTH_BOLD = 1.03

-- Characters in neither face (CJK, rare symbols).
local CJK_WIDTH = 2.0
local FALLBACK = 0.55

local VOID_TAGS = { br = true, img = true, hr = true, input = true,
meta = true, link = true, wbr = true }
local BOLD_TAGS = { b = true, strong = true }

local function charWidth(ch, bold)
local w = (bold and RD_BOLD or RD_REGULAR)[ch]
if w then return w end

w = FALLBACK_WIDTHS[ch]
if w then
return bold and w * SYNTH_BOLD or w
end

local cp = ustring.codepoint(ch) or 0
if (cp >= 0x1100 and cp <= 0x115F) or (cp >= 0x2E80 and cp <= 0xA4CF)
or (cp >= 0xAC00 and cp <= 0xD7A3) or (cp >= 0xF900 and cp <= 0xFAFF)
or (cp >= 0xFF00 and cp <= 0xFF60) or (cp >= 0xFFE0 and cp <= 0xFFE6) then
return CJK_WIDTH
end
return FALLBACK
end

local function wordWidth(word)
local total = 0
for _, part in ipairs(word) do
for ch in ustring.gmatch(part.text, ".") do
total = total + charWidth(ch, part.bold)
end
end
return total
end

-- Reduce expanded wikitext/HTML to the text a reader actually sees, keeping
-- track of which runs are bold. Returns a list of lines; each line is a list
-- of words; each word is a list of {text=, bold=} parts.
-- Words break only on real whitespace: NBSP and tag boundaries do not split
-- them, matching how the browser wraps.
function p.parse(src)
src = mw.text.killMarkers(src or "")
src = src:gsub("%[%[[Ff]ile:[^%[%]]*%]%]", "")
src = src:gsub("%[%[[^%[%]|]*|([^%[%]]*)%]%]", "%1")
src = src:gsub("%[%[([^%[%]]*)%]%]", "%1")
-- Quote markup survives frame:preprocess; strip it so it is not measured.
src = src:gsub("'''''", ""):gsub("'''", ""):gsub("''", "")

local lines, line, word, part = {}, {}, {}, nil
local stack = {}

local function boldNow()
for k = #stack, 1, -1 do
if stack[k] then return true end
end
return false
end
local function endWord()
if part then table.insert(word, part); part = nil end
if #word > 0 then table.insert(line, word); word = {} end
end
local function endLine()
endWord()
table.insert(lines, line); line = {}
end
local function push(ch, bold)
if part == nil or part.bold ~= bold then
if part then table.insert(word, part) end
part = { text = ch, bold = bold }
else
part.text = part.text .. ch
end
end

local i, n = 1, #src
while i <= n do
if src:sub(i, i) == "<" then
local j = src:find(">", i, true)
if not j then break end
local tag = src:sub(i + 1, j - 1)
local closing, name = tag:match("^%s*(/?)%s*(%a+)")
if name then
name = name:lower()
if name == "br" then
endLine()
elseif VOID_TAGS[name] then -- no effect on weight
elseif closing == "/" then
table.remove(stack)
elseif not tag:match("/%s*$") then
table.insert(stack, BOLD_TAGS[name] == true
or tag:lower():match("font%-weight%s*:%s*bold") ~= nil
or tag:lower():match("font%-weight%s*:%s*[6-9]00") ~= nil)
end
end
i = j + 1
else
local k = src:find("<", i, true) or (n + 1)
local chunk = mw.text.decode(src:sub(i, k - 1), true)
local bold = boldNow()
for ch in ustring.gmatch(chunk, ".") do
if ch == "\n" then
endLine()
elseif ch == " " or ch == "\t" or ch == "\r" then
endWord()
else
push(ch, bold) -- NBSP falls here: joins, never breaks
end
end
i = k
end
end
endLine()
return lines
end

-- Greedy wrap with the usable width normalised to 1, so `r` is the font size
-- expressed as a fraction of that width. Returns the number of rendered lines.
local function lineCount(lines, r)
local space = charWidth(" ", false) * r
local total = 0
for _, words in ipairs(lines) do
local cur = 0
total = total + 1
for _, word in ipairs(words) do
local ww = wordWidth(word) * r
if cur == 0 then
cur = ww
elseif cur + space + ww <= 1 then
cur = cur + space + ww
else
total = total + 1
cur = ww
end
end
end
return total
end

-- Largest font size at which `text` fits its box, returned as a PERCENTAGE of
-- the box's usable text width. Emit it as a cqw value against a query
-- container whose content box is exactly that width; no pixel geometry is
-- needed here or in the caller.
--
-- Line counting is scale-invariant in width -- every term scales with the font
-- size -- so the ratio is all this needs. Only the height constraint carries a
-- shape, and that is given as an aspect ratio.
--
-- opts:
-- aspect max height of the text block, as a multiple of its width
-- lineHeight line-height multiplier used when rendering
-- max, min ceiling and floor, also as a percentage of the width
-- step search granularity
function p.fit(text, opts)
local aspect = opts.aspect
local lineH = opts.lineHeight or 1.2
local maxPct = opts.max or 100
local minPct = opts.min or 1
local step = opts.step or 0.1

local lines = p.parse(text)

local widest = 0
for _, words in ipairs(lines) do
for _, word in ipairs(words) do
local ww = wordWidth(word)
if ww > widest then widest = ww end
end
end
if widest == 0 then return maxPct end

-- The longest single word must not overflow horizontally
local pct = math.min(100 / widest, maxPct)

-- Then shrink until the wrapped block fits vertically
while pct > minPct and lineCount(lines, pct / 100) * lineH * (pct / 100) > aspect do
pct = pct - step
end

return math.max(pct, minPct)
end

return p