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 ErrorHandling = require('Module:ErrorHandling')
local ConfigRepository = require('Module:ConfigRepository')
local LinkParser = require('Module:LinkParser')
local TemplateHelpers = require('Module:TemplateHelpers')
local SemanticAnnotations = require('Module:SemanticAnnotations')
local SemanticCategoryHelpers = require('Module:SemanticCategoryHelpers')

-- ========== Helper Functions ==========
-- 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 = {
        -- Core rendering features
        title = true,
        logo = true,
        fields = true,
        socialMedia = true,
        
        -- Semantic features
        semanticProperties = true,
        categories = true,
        
        -- Error handling
        errorReporting = true
    }
})

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

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

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

-- Add a preprocessor to sanitize args for semantic properties
-- This follows the same pattern as the Event template
Blueprint.addPreprocessor(template, function(template, args)
    -- Create a sanitized version of args for semantic properties
    args._sanitizedArgs = {}
    
    -- Copy and sanitize all values
    for k, v in pairs(args) do
        if type(v) == "string" and v ~= "" then
            args._sanitizedArgs[k] = TemplateHelpers.sanitizeUserInput(v)
        else
            args._sanitizedArgs[k] = v
        end
    end
    
    -- Add special handling for has_previous and has_next
    if args.has_previous and args.has_previous ~= "" then
        -- Extract the page name from wiki links if present
        args._sanitizedArgs.has_previous_process = TemplateHelpers.extractSemanticValue(
            args.has_previous, "Preceded By", errorContext)
    end
    
    if args.has_next and args.has_next ~= "" then
        -- Extract the page name from wiki links if present
        args._sanitizedArgs.has_next_process = TemplateHelpers.extractSemanticValue(
            args.has_next, "Succeeded By", errorContext)
    end
    
    return args
end)

-- Override the semanticProperties block to use our sanitized args
-- This is similar to how the Event template handles semantic properties
Blueprint.registerPropertyProvider(template, function(template, args)
    -- Get the sanitized args
    local sanitizedArgs = args._sanitizedArgs or args
    
    -- Get the config
    local Config = template.config
    
    -- Set basic properties using the transformation functions from Config
    local properties = {}
    local semanticOutput = ""
    
    -- Use the standard SemanticAnnotations module
    local propertiesSuccess, propertiesResult = pcall(function()
        return SemanticAnnotations.setSemanticProperties(
            sanitizedArgs, 
            Config.semantics.properties, 
            {transform = Config.semantics.transforms}
        )
    end)
    
    if propertiesSuccess then
        semanticOutput = propertiesResult
    else
        -- Log error but continue
        semanticOutput = "<!-- Error setting semantic properties -->"
    end
    
    -- Handle special case for has_previous and has_next
    if sanitizedArgs.has_previous_process and sanitizedArgs.has_previous_process ~= "" then
        -- Add as a separate property
        local processConnectionProperty = require('Module:ConfigRepository').semanticProperties.process_connection
        semanticOutput = semanticOutput .. '\n<div style="display:none;">\n'
        semanticOutput = semanticOutput .. '  {{#set: ' .. processConnectionProperty .. '=' .. sanitizedArgs.has_previous_process .. ' }}\n'
        semanticOutput = semanticOutput .. '</div>'
    end
    
    if sanitizedArgs.has_next_process and sanitizedArgs.has_next_process ~= "" then
        -- Add as a separate property
        local processConnectionProperty = require('Module:ConfigRepository').semanticProperties.process_connection
        semanticOutput = semanticOutput .. '\n<div style="display:none;">\n'
        semanticOutput = semanticOutput .. '  {{#set: ' .. processConnectionProperty .. '=' .. sanitizedArgs.has_next_process .. ' }}\n'
        semanticOutput = semanticOutput .. '</div>'
    end
    
    -- Return empty properties but with semantic output
    return properties, semanticOutput
end)

-- ========== Main Render Function ==========
-- Main render function which delegates to the template's render method
function p.render(frame)
    return ErrorHandling.protect(
        errorContext,
        "render",
        function()
            return template.render(frame)
        end,
        ErrorHandling.getMessage("TEMPLATE_RENDER_ERROR"),
        frame
    )
end

return p