Module:T-LibraryInterview

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

--Module:T-LibraryInterview
-- Renders the Internet & Digital Governance Library template for Interviews, 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')

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

-- ========== Helper Functions ==========
-- Create error context for the module
local errorContext = ErrorHandling.createContext("T-LibraryInterview")

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

-- 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. EXTENSIVE TESTING WAS PERFORMED SO THAT THIS CAN BE TOGGLED AT ANY TIME WITH A TRUE/FALSE BOOLEAN CHOICE FROM THIS MODULE, AS IT CAN BE DONE IN ANY OTHER MODULE USING ICANNWIKI'S THE TEMPLATE BLUEPRINT FRAMEWORK
local template = Blueprint.registerTemplate('LibraryInterview', {
    features = {
        -- Core rendering features
        title = true,
        fields = true,
        
        -- Semantic features
        semanticProperties = true,
        categories = true,
        
        -- Error handling
        errorReporting = true
    }
})

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

-- Get property mappings from ConfigRepository for tooltips
local propertyMappings = ConfigRepository.templates.LibraryInterview.semantics.properties

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

-- ========== Preprocessors ==========
-- The ID field is handled by the 'setPageIdField' preprocessor
Blueprint.addPreprocessor(template, 'setPageIdField')

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


-- Configure semantic properties and transforms for interviewer and interviewee
template.config.semantics = template.config.semantics or {}
template.config.semantics.properties = template.config.semantics.properties or {}
template.config.semantics.properties["Has interviewee"] = "Interviewee"
template.config.semantics.properties["Has interviewer"] = "Interviewer"
template.config.semantics.transforms = template.config.semantics.transforms or {}
template.config.semantics.transforms["Has interviewee"] = function(value)
    return extractSemanticValue(value, "Interviewee")
end
template.config.semantics.transforms["Has interviewer"] = function(value)
    return extractSemanticValue(value, "Interviewer")
end

template.config.semantics.transforms["Has person"] = function(value)
    return extractSemanticValue(value, "Person")
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