Function processFileContent

buildScripts/util/astTemplateProcessor.mjs:149–210

(fileContent, filePath)

 * code and a flag indicating if any changes were made.
 */
export function processFileContent(fileContent, filePath) {
    // Optimization: a quick regex check is much faster than parsing every file.
    if (!regexHtml.test(fileContent)) {
        return { content: fileContent, hasChanges: false };
    }

    try {
        const ast = acorn.parse(fileContent, {ecmaVersion: 'latest', sourceType: 'module'});
        addParentLinks(ast, null);

        let hasChanges = false;

        postOrderWalk(ast, (node) => {
            if (node.type === 'TaggedTemplateExpression' && node.tag.type === 'Identifier' && node.tag.name === 'html') {
                hasChanges = true;

                // As a quality-of-life feature, if a template is the return value of a method
                // named `render`, we automatically rename the method to `createVdom`.
                let current = node;
                while (current.parent) {
                    const parent = current.parent;
                    if ((parent.type === 'MethodDefinition' || parent.type === 'Property') && parent.key.name === 'render') {
                        parent.key.name = 'createVdom';
                        break;
                    }
                    current = parent;
                }

                const templateLiteral = node.quasi;
                const strings = templateLiteral.quasis.map(q => q.value.cooked);
                const expressionCodeStrings = templateLiteral.expressions.map(exprNode => generate(exprNode));

                const vdom = processHtmlTemplateLiteral(strings, expressionCodeStrings);
                const vdomAst = jsonToAst(vdom);

                const parent = node.parent;
                for (const key in parent) {
                    if (parent[key] === node) {
                        parent[key] = vdomAst;
                        return;
                    }
                    if (Array.isArray(parent[key])) {
                        const index = parent[key].indexOf(node);
                        if (index > -1) {
                            parent[key][index] = vdomAst;
                            return;
                        }
                    }
                }
            }
        });

        return {
            content: hasChanges ? generate(ast) : fileContent,
            hasChanges
        };
    } catch (e) {
        console.error(`Error processing HTML template in: ${filePath}`);