Module:T-Process

Documentation for this module may be created at Module:T-Process/doc

--Module:T-Process
-- Renders the "Process" template for governance processes and initiatives, making use of ICANNWiki's "Template Blueprint Framework"

local p = {}

-- ========== Required modules ==========
local Blueprint = require('Module:LuaTemplateBlueprint')
local ConfigRepository = require('Module:ConfigRepository')
local ErrorHandling = require('Module:ErrorHandling')
local LinkParser = require('Module:LinkParser')

-- Blueprint default: Module-level cache for lazy-loaded modules
local moduleCache = {}

-- Blueprint default: Lazy module loader
local function lazyRequire(moduleName)
    return function()
        if not moduleCache[moduleName] then
            moduleCache[moduleName] = require(moduleName)
        end
        return moduleCache[moduleName]
    end
end

-- Blueprint default: Modules to lazy load
    -- local getTemplateHelpers = lazyRequire('')

-- ========== Helper Functions ==========
-- Blueprint default: Create error context for the module
local errorContext = ErrorHandling.createContext("T-Process")

-- ================================================================================

-- IMPORTANT! TEMPLATE BLUEPRINT FRAMEWORK INSTRUCTIONS
-- CONTROL OF TEMPLATE FEATURES: THIS LIST SPECIFIES IN AN EXPLICIT MANNER WHAT FEATURES ARE TO BE CALLED/RENDERED BY THE TEMPLATE.
local template = Blueprint.registerTemplate('Process', {
    features = {
        title = true,
        logo = true,
        fields = true,
        socialMedia = true,
        semanticProperties = true,
        categories = true,
        errorReporting = true
    }
})

-- Initialize the standard configuration
Blueprint.initializeConfig(template)

-- ================================================================================

-- ========== Preprocessors ==========
-- Basic preprocessors
Blueprint.addPreprocessor(template, 'setPageIdField')
Blueprint.addPreprocessor(template, 'deriveRegionFromCountry')

-- Helper function to extract plain text from wiki links for semantic properties
local TemplateHelpers = require('Module:TemplateHelpers')
local function extractSemanticValue(fieldValue, fieldName)
    return TemplateHelpers.extractSemanticValue(fieldValue, fieldName, errorContext)
end

-- Get the SemanticCategoryHelpers module
local SemanticCategoryHelpers = require('Module:SemanticCategoryHelpers')

-- Register a property provider using the new helper function
Blueprint.registerPropertyProvider(
    template, 
    SemanticCategoryHelpers.createCombinedPropertyProvider(
        {"process", "has_previous", "has_next"}, -- Fields to combine
        require('Module:ConfigRepository').semanticProperties.process_connection, -- Property to set
        function(value, fieldName) -- Extractor function
            -- Extract plain text from wiki links
            local plainText = extractSemanticValue(value, fieldName)
            
            -- For a Page property, we need to ensure it's a valid page reference
            -- If the value doesn't already have wiki link syntax, add it
            if plainText and plainText ~= "" and not plainText:match("^%[%[.+%]%]$") then
                -- Format as a page reference
                return plainText -- Return plain text for SMW to handle properly
            end
            
            return plainText
        end,
        {propertyType = "Page"} -- Specify that this is a Page type property
    )
)

-- Add a debug property provider to see what values are being passed to SMW
Blueprint.registerPropertyProvider(template, function(template, args)
    local debugProperties = {}
    
    -- Add debug info as HTML comments
    local debugInfo = {}
    table.insert(debugInfo, "<!-- Process Template Debug Info -->")
    table.insert(debugInfo, "<!-- process: " .. tostring(args.process or "") .. " -->")
    table.insert(debugInfo, "<!-- has_previous: " .. tostring(args.has_previous or "") .. " -->")
    table.insert(debugInfo, "<!-- has_next: " .. tostring(args.has_next or "") .. " -->")
    
    -- Return empty properties but with debug output
    return debugProperties, table.concat(debugInfo, "\n")
end)

-- ========== Main Render Function ==========
-- Blueprint default: Main render function
function p.render(frame)
    return ErrorHandling.protect(
        errorContext,
        "render",
        function()
            return template.render(frame)
        end,
        ErrorHandling.getMessage("TEMPLATE_RENDER_ERROR"),
        frame
    )
end

return p