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 ElementNavigation = require('Module:Elements/ElementNavigation')

-- 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

-- Lazy load modules that might not be needed immediately
local getTemplateHelpers = lazyRequire('Module:TemplateHelpers')

-- ========== 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,
        navigation = true, -- Navigation feature for previous/next processes
        socialMedia = true,
        
        -- Semantic features
        semanticProperties = true,
        categories = true,
        
        -- Error handling
        errorReporting = true
    },
    
    -- Add navigation to block sequence (after fields, before socialMedia)
    blockSequence = {
        'title',
        'logo',
        'fields',
        'navigation',  -- Navigation block
        'socialMedia',
        'semanticProperties',
        'categories',
        'errors'
    }
})

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

-- Register navigation block
template._blocks = template._blocks or {}
template._blocks.navigation = {
    feature = 'navigation',
    render = ElementNavigation.createBlock()
}

-- Add navigation configuration
template.config.navigation = {
    autoDetect = false,  -- Disable automatic detection - navigation is always editor-specified
    prevField = "has_previous",
    nextField = "has_next",
    prevLabel = "← Previous Process",
    nextLabel = "Next Process →"
}

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

-- ========== Preprocessors ==========
-- Standard preprocessors - use built-in ones first
Blueprint.addPreprocessor(template, 'setPageIdField')
Blueprint.addPreprocessor(template, 'deriveRegionFromCountry')

-- Preprocessor for semantic property extraction
Blueprint.addPreprocessor(template, function(template, args)
    local TemplateHelpers = getTemplateHelpers()
    
    -- Extract plain text from wiki links for has_previous and has_next
    args._semanticPrecededBy = TemplateHelpers.extractSemanticValue(args.has_previous, "Preceded By", errorContext)
    args._semanticSucceededBy = TemplateHelpers.extractSemanticValue(args.has_next, "Succeeded By", errorContext)
    
    return args
end)

-- Configure semantic properties to use extracted values
template.config.semantics = template.config.semantics or {}
template.config.semantics.properties = template.config.semantics.properties or {}
template.config.semantics.properties["Preceded by process"] = "_semanticPrecededBy"
template.config.semantics.properties["Succeeded by process"] = "_semanticSucceededBy"

-- ========== 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