Module:Iconbox - Revision history

Ta1ha: bot: documentation pass — editor-facing docs (data descriptions, module comments, template usage, Help rewrite)

2026-06-10T16:04:42Z

bot: documentation pass — editor-facing docs (data descriptions, module comments, template usage, Help rewrite)

← Older revision		Revision as of 16:04, 10 June 2026
Line 1:		Line 1:
	-- Module:Iconbox — entity icon + linked name ~~(Arms of God).~~		-- Module:Iconbox — an entity's small icon + linked name, anywhere.
	~~-- RENDER-TIME DERIVATION: icons live on each entity's own source record~~
	~~-- (rec.icon in Data:<Category>.json); there is no Data:Icons.json~~.
	--		--
	-- ~~Brotato-style category-first signature (documented standard):~~		-- WHAT IT DOES
	-- ~~{{Iconbox\|Weapon\|Cutter}} -> icon~~ + ~~linked~~ name		-- Looks up an entity by category + name (or just name) and renders
	-- ~~{{Iconbox\|Weapon\|Cutter\|icononly}} -> linked~~ icon ~~glyph only~~		-- its icon and a link to its page. Icons come from each entity's own
	-- ~~Category accepts singular or plural~~ (~~Weapon/Weapons, Tag/Tags, .~~..) ~~and~~		-- record (rec.icon in Data:<Category>.json) — there is no separate
	-- ~~makes the~~ lookup ~~single-category + collision-safe (e.g. Upgrade vs~~		-- icon lookup table to maintain.
	~~-- Achievement of the same name)~~.
	--		--
	-- Bare-name fallback (~~cross-~~category ~~Core.find scan~~; first ~~category~~ in		-- HOW TO INVOKE (normally via Template:Iconbox)
	-- ~~registry~~ order wins):		-- Category-first form (preferred — collision-safe):
	-- {{Iconbox\|Cutter}} / {{Iconbox\|Cutter\|icononly}}		-- {{Iconbox\|Weapon\|Cutter}} icon + linked name
			-- {{Iconbox\|Weapon\|Cutter\|icononly}} linked icon glyph only
			-- {{Iconbox\|Blessing\|Sanctified Halo\|size=32}}
			-- Category accepts singular or plural (Weapon/Weapons, Tag/Tags, ...).
			-- Bare-name fallback (scans every category; first match in registry
			-- order wins — beware same-named entities in two categories):
			-- {{Iconbox\|Cutter}} / {{Iconbox\|Cutter\|icononly}}
	--		--
	-- Unknown entity or missing icon degrades to a plain link (never a		-- SOURCE DATA IT READS (via Module:Core)
	-- ~~redlink~~ file); icon-only mode degrades to nothing.		-- Any/all of the ten Data:<Category>.json pages, depending on the call.
			--
			-- EDITING NOTES
			-- Unknown entity or missing icon degrades to a plain page link (never
			-- a broken-file box); icon-only mode degrades to nothing.
	local Core = require('Module:Core')		local Core = require('Module:Core')
	local p = {}		local p = {}

Ta1ha: bot: render-time derivation refactor (phase 1)

2026-06-10T08:29:14Z

bot: render-time derivation refactor (phase 1)

← Older revision		Revision as of 08:29, 10 June 2026
Line 1:		Line 1:
	-- Module:Iconbox — entity icon ~~lookup~~ (Arms of God).		-- Module:Iconbox — entity icon + linked name (Arms of God).
	-- ~~Reads~~ Data:Icons.json (~~lowercased display names + slugs -> icon/slug/name~~).		-- RENDER-TIME DERIVATION: icons live on each entity's own source record
	-- {{~~#invoke:~~Iconbox\|~~render~~\|~~<name-or-slug>~~}} -> icon + linked name ~~(default)~~		-- (rec.icon in Data:<Category>.json); there is no Data:Icons.json.
	-- {{~~#invoke:~~Iconbox\|~~render~~\|~~<name-or-slug>~~\|icononly}} -> linked icon only		--
	-- ~~'link' as 2nd arg is a no~~-~~op alias~~ of the ~~default~~; ~~mode=icon ==~~ icononly.		-- Brotato-style category-first signature (documented standard):
	-- Unknown entity or missing icon degrades to ~~text-only~~ (never a redlink file).		-- {{Iconbox\|Weapon\|Cutter}} -> icon + linked name
			-- {{Iconbox\|Weapon\|Cutter\|icononly}} -> linked icon glyph only
			-- Category accepts singular or plural (Weapon/Weapons, Tag/Tags, ...) and
			-- makes the lookup single-category + collision-safe (e.g. Upgrade vs
			-- Achievement of the same name).
			--
			-- Bare-name fallback (cross-category Core.find scan; first category in
			-- registry order wins):
			-- {{Iconbox\|Cutter}} / {{Iconbox\|Cutter\|icononly}}
			--
			-- Unknown entity or missing icon degrades to a plain link (never a
			-- redlink file); icon-only mode degrades to nothing.
			local Core = require('Module:Core')
	local p = {}		local p = {}

	local function ~~lookup~~(~~key~~)		local function trim(s)
	~~if not key~~ or key == '' then return ~~nil~~ end		return (tostring(s or ''):gsub('^%s+', ''):gsub('%s+$', ''))
	~~local ok~~, ~~data = pcall~~(mw.~~loadJsonData, 'Data:Icons.json'~~)		end
	if ~~not ok or type~~(~~data~~) ~= ~~'table'~~ or ~~type~~(~~data~~.~~by_key~~) ~= ~~'table'~~ then
	~~return nil~~		local function findInCategory(cat, key)
			local k = mw.ustring.lower(key)
			local rec = Core.byId(cat)[key]
			if rec then return rec end
			for _, r in ipairs(Core.load(cat)) do
			if (r.name and mw.ustring.lower(r.name) == k)
			or (r.slug and mw.ustring.lower(r.slug) == k) then
			return r
			end
	end		end
	return ~~data.by_key[mw.ustring.lower(key)]~~		return nil
	end		end

	function p.render(frame)		function p.render(frame)
	local ~~key~~ = (frame.args[1] ~~or ''):gsub('^%s+', ''):gsub('%s+$', ''~~)		local a1 = trim(frame.args[1])
	if ~~key~~ == '' then return '' end		if a1 == '' then return '' end
	~~-- positional arg~~ 2 ~~arrives as ''~~ (~~not nil~~) ~~via the template~~'s {{{2\|}}},		local a2 = trim(frame.args[2])
	-- ~~and '' is truthy in Lua — fall through to~~ mode= ~~only when 2 is blank.~~		local a3 = trim(frame.args[3])
	local ~~mode~~ = ~~frame~~.~~args[2] or ''~~
	if mode~~:match(~~'~~^%s*$~~') then mode = frame.args.mode ~~or ''~~ end		local cat = Core.resolveCategory(a1)
	mode = mw.ustring.lower((mode~~:gsub('^%s+', ''):gsub('%s+$', '')~~))		local key, mode, rec
	~~-- default = icon + linked name; only an explicit icon-only flag drops the name~~		if cat and a2 ~= '' then
	local ~~iconlonly~~ = (mode == 'icononly' or mode == 'icon' or mode == 'noname')		-- category-first form: {{Iconbox\|Weapon\|Cutter\|icononly?}}
	~~local withname = not iconlonly~~		key, mode = a2, a3
	local size = frame.args.size or '24'		rec = findInCategory(cat, key)
	~~local rec = lookup(key)~~		else
			-- bare-name form: {{Iconbox\|Cutter\|icononly?}}
			key, mode = a1, a2
			local _, found = Core.find(key)
			rec = found
			end
			if mode == '' then mode = trim(frame.args.mode) end
			mode = mw.ustring.lower(mode)
			local icononly = (mode == 'icononly' or mode == 'icon' or mode == 'noname')
			local size = trim(frame.args.size)
			if size == '' then size = '24' end

	if not rec then		if not rec then
	~~-- unknown key: plain link in named mode, nothing in icon-only mode~~		if icononly then return '' end
	~~if withname then~~ return '[[' .. key .. ']]~~' end~~		return '[[' .. key .. ']]'
	~~return '~~'
	end		end
	local slug = rec.slug or key		local slug = rec.slug or key
	local name = rec.name or key		local name = rec.name or key
	local icon = rec.icon or ''		local icon = rec.icon or ''
	~~-- .wm-tip: Common.js hover popup showing the target page's infobox~~
	~~-- (2026-06-10d). Plain link without JS.~~
	local tip = '<span class="wm-tip" data-tip-title="' .. slug .. '">'		local tip = '<span class="wm-tip" data-tip-title="' .. slug .. '">'
	if icon == '' then		if icon == '' then
	if ~~withname~~ then return tip .. '[[' .. slug .. '\|' .. name .. ']]</span>~~' end~~		if icononly then return '' end
	~~return '~~'		return tip .. '[[' .. slug .. '\|' .. name .. ']]</span>'
	end		end
	local img = '[[File:' .. icon .. '\|' .. size .. 'px\|link=' .. slug		local img = '[[File:' .. icon .. '\|' .. size .. 'px\|link=' .. slug
	.. '\|alt=' .. name .. ']]'		.. '\|alt=' .. name .. ']]'
	if ~~withname~~ then		if icononly then return img end
	return tip .. img .. ' [[' .. slug .. '\|' .. name .. ']]</span>'		return tip .. img .. ' [[' .. slug .. '\|' .. name .. ']]</span>'
	~~end~~
	~~return img~~
	end		end

	return p		return p

Ta1ha: bot: operator iteration 2026-06-10d (hover tooltips / filter chips + DPS sort / damage-type hubs / stat reverse-lookup pages)

2026-06-10T06:08:09Z

bot: operator iteration 2026-06-10d (hover tooltips / filter chips + DPS sort / damage-type hubs / stat reverse-lookup pages)

← Older revision		Revision as of 06:08, 10 June 2026
Line 37:		Line 37:
	local name = rec.name or key		local name = rec.name or key
	local icon = rec.icon or ''		local icon = rec.icon or ''
			-- .wm-tip: Common.js hover popup showing the target page's infobox
			-- (2026-06-10d). Plain link without JS.
			local tip = '<span class="wm-tip" data-tip-title="' .. slug .. '">'
	if icon == '' then		if icon == '' then
	if withname then return '[[' .. slug .. '\|' .. name .. ']]' end		if withname then return tip .. '[[' .. slug .. '\|' .. name .. ']]</span>' end
	return ''		return ''
	end		end
	local img = '[[File:' .. icon .. '\|' .. size .. 'px\|link=' .. slug		local img = '[[File:' .. icon .. '\|' .. size .. 'px\|link=' .. slug
	.. '\|alt=' .. name .. ']]'		.. '\|alt=' .. name .. ']]'
	if withname then return img .. ' [[' .. slug .. '\|' .. name .. ']]' end		if withname then
			return tip .. img .. ' [[' .. slug .. '\|' .. name .. ']]</span>'
			end
	return img		return img
	end		end

	return p		return p

Ta1ha: bot: Iconbox mode= named-arg fix (empty positional arg masked it)

2026-06-10T04:05:03Z

bot: Iconbox mode= named-arg fix (empty positional arg masked it)

← Older revision		Revision as of 04:05, 10 June 2026
Line 19:		Line 19:
	local key = (frame.args[1] or ''):gsub('^%s+', ''):gsub('%s+$', '')		local key = (frame.args[1] or ''):gsub('^%s+', ''):gsub('%s+$', '')
	if key == '' then return '' end		if key == '' then return '' end
	local mode = (frame.args[2] or frame.args.mode or '')		-- positional arg 2 arrives as '' (not nil) via the template's {{{2\|}}},
			-- and '' is truthy in Lua — fall through to mode= only when 2 is blank.
			local mode = frame.args[2] or ''
			if mode:match('^%s*$') then mode = frame.args.mode or '' end
	mode = mw.ustring.lower((mode:gsub('^%s+', ''):gsub('%s+$', '')))		mode = mw.ustring.lower((mode:gsub('^%s+', ''):gsub('%s+$', '')))
	-- default = icon + linked name; only an explicit icon-only flag drops the name		-- default = icon + linked name; only an explicit icon-only flag drops the name

Ta1ha: bot: Iconbox default now icon + linked name; icononly flag added (operator iteration 2026-06-10)

2026-06-10T04:03:38Z

bot: Iconbox default now icon + linked name; icononly flag added (operator iteration 2026-06-10)

← Older revision		Revision as of 04:03, 10 June 2026
Line 1:		Line 1:
	-- Module:Iconbox — entity icon lookup (Arms of God).		-- Module:Iconbox — entity icon lookup (Arms of God).
	-- Reads Data:Icons.json (lowercased display names + slugs -> icon/slug/name).		-- Reads Data:Icons.json (lowercased display names + slugs -> icon/slug/name).
	-- {{#invoke:Iconbox\|render\|<name-or-slug>}} -> linked ~~icon only~~		-- {{#invoke:Iconbox\|render\|<name-or-slug>}} -> icon + linked name (default)
	-- {{#invoke:Iconbox\|render\|<name-or-slug>\|~~link~~}} -> icon ~~+ linked name~~		-- {{#invoke:Iconbox\|render\|<name-or-slug>\|icononly}} -> linked icon only
			-- 'link' as 2nd arg is a no-op alias of the default; mode=icon == icononly.
	-- Unknown entity or missing icon degrades to text-only (never a redlink file).		-- Unknown entity or missing icon degrades to text-only (never a redlink file).
	local p = {}		local p = {}
Line 18:		Line 19:
	local key = (frame.args[1] or ''):gsub('^%s+', ''):gsub('%s+$', '')		local key = (frame.args[1] or ''):gsub('^%s+', ''):gsub('%s+$', '')
	if key == '' then return '' end		if key == '' then return '' end
	local ~~withname~~ = (frame.args[2] or frame.args.~~text~~ or '') ~= ''		local mode = (frame.args[2] or frame.args.mode or '')
			mode = mw.ustring.lower((mode:gsub('^%s+', ''):gsub('%s+$', '')))
			-- default = icon + linked name; only an explicit icon-only flag drops the name
			local iconlonly = (mode == 'icononly' or mode == 'icon' or mode == 'noname')
			local withname = not iconlonly
	local size = frame.args.size or '24'		local size = frame.args.size or '24'
	local rec = lookup(key)		local rec = lookup(key)
	if not rec then		if not rec then
	-- unknown key: plain link in ~~text~~ mode, nothing in icon-only mode		-- unknown key: plain link in named mode, nothing in icon-only mode
	if withname then return '[[' .. key .. ']]' end		if withname then return '[[' .. key .. ']]' end
	return ''		return ''

Ta1ha: bot: operator iteration 2026-06-10

2026-06-10T03:52:04Z

bot: operator iteration 2026-06-10

New page

-- Module:Iconbox — entity icon lookup (Arms of God).
-- Reads Data:Icons.json (lowercased display names + slugs -> icon/slug/name).
-- {{#invoke:Iconbox|render|<name-or-slug>}} -> linked icon only
-- {{#invoke:Iconbox|render|<name-or-slug>|link}} -> icon + linked name
-- Unknown entity or missing icon degrades to text-only (never a redlink file).
local p = {}

local function lookup(key)
if not key or key == '' then return nil end
local ok, data = pcall(mw.loadJsonData, 'Data:Icons.json')
if not ok or type(data) ~= 'table' or type(data.by_key) ~= 'table' then
return nil
end
return data.by_key[mw.ustring.lower(key)]
end

function p.render(frame)
local key = (frame.args[1] or ''):gsub('^%s+', ''):gsub('%s+$', '')
if key == '' then return '' end
local withname = (frame.args[2] or frame.args.text or '') ~= ''
local size = frame.args.size or '24'
local rec = lookup(key)
if not rec then
-- unknown key: plain link in text mode, nothing in icon-only mode
if withname then return '[[' .. key .. ']]' end
return ''
end
local slug = rec.slug or key
local name = rec.name or key
local icon = rec.icon or ''
if icon == '' then
if withname then return '[[' .. slug .. '|' .. name .. ']]' end
return ''
end
local img = '[[File:' .. icon .. '|' .. size .. 'px|link=' .. slug
.. '|alt=' .. name .. ']]'
if withname then return img .. ' [[' .. slug .. '|' .. name .. ']]' end
return img
end

return p