Module:ElementTLDFlair

Documentation for this module may be created at Module:ElementTLDFlair/doc

--[[
* Name: ElementTLDFlair
* Author: Mark W. Datysgeld
* Description: Element module that renders visual flair elements for TLD styling based on type, subtype, and IDN status
* Notes: Designed for Blueprint template system integration; builds CSS classes from TLD properties; uses CanonicalForms for subtype mapping; differentiates IDN ccTLDs and gTLDs; styled via CSS pseudo-elements; protected execution with error handling
]]

local p = {}

p.elementName = "tldflair"
local ErrorHandling = require('Module:ErrorHandling')
local CanonicalForms = require('Module:CanonicalForms')

-- Create a badge block for TLD styling
function p.createBlock()
    return function(template, args)
        local errorContext = template._errorContext
        -- Protected execution wrapper
        local function execute(func, ...)
            if errorContext then
                return ErrorHandling.protect(
                    errorContext,
                    "ElementBlock_tldflair",
                    func,
                    "",
                    ...
                )
            else
                local ok, result = pcall(func, ...)
                return ok and result or ""
            end
        end

        return execute(function()
            -- Get TLD type: prefer preprocessor-normalized _type, fall back to raw tld_type
            local tldType = args._type or args.tld_type or ""
            local subtype = args.tld_subtype or ""
            local isIDN   = (args.idn == "true")
            local punycode = args.ascii or ""

            -- Build CSS class list
            local classes = { "tld-flair" }
            
            -- Add subtype class if present
            if subtype ~= "" then
                local _, css = CanonicalForms.normalize(subtype, template.config.mappings.tld_subtype)
                if css then
                    table.insert(classes, css)
                end
            end
            
            -- Add IDN class if applicable
            if isIDN then
                -- Normalize the type if it hasn't been normalized yet
                local normalizedType = tldType
                if tldType ~= "" and tldType ~= "gTLD" and tldType ~= "ccTLD" then
                    normalizedType = select(1, CanonicalForms.normalize(tldType, template.config.mappings.tld_type)) or tldType
                end
                
                local idnClass = (normalizedType == "ccTLD") and "tld-template-idn-cctld" or "tld-template-idn-gtld"
                table.insert(classes, idnClass)
            -- Otherwise, if no subtype, add base type class for non-IDN TLDs
            elseif subtype == "" and tldType ~= "" then
                -- Normalize the type if it hasn't been normalized yet
                local normalizedType = tldType
                if tldType ~= "gTLD" and tldType ~= "ccTLD" then
                    normalizedType = select(1, CanonicalForms.normalize(tldType, template.config.mappings.tld_type)) or tldType
                end
                
                local typeClass = (normalizedType == "ccTLD") and "tld-template-cctld" or "tld-template-gtld"
                table.insert(classes, typeClass)
            end
            
            local classAttr = table.concat(classes, " ")

            -- Determine display text (styled via CSS pseudo-element)
            local display = ""

            -- Render as a table row
local output = {
    "|-",
    '! colspan="2" class="' .. classAttr .. '" | ' .. display
}
            return table.concat(output, "\n")
        end)
    end
end

return p

Top-Level Domain

Internationalized Domain Name

Country code top-level domain. Determined by "ISO 3166-1: Codes for the representation of names of countries and their subdivisions — Part 1: Country codes".

Generic Top-level Domain

Generic Top-level Domain

Country code top-level domain. Determined by "ISO 3166-1: Codes for the representation of names of countries and their subdivisions — Part 1: Country codes".

Top-Level Domain