ASTTemplateParser 4.0.0

AST Template Parser

A high-performance, security-hardened template parser for .NET Framework 4.8 with HTML-like syntax.

✨ Features

• 🚀 High Performance - 7,000+ renders/second, compiled property accessors
• 🔒 Enterprise Security - XSS, SQL injection, code injection protection
• 🧩 Component System - Reusable components with parameters and slots
• 📐 Layout System - Master layouts with sections
• 🎯 ASP.NET MVC 5 - Full integration with controllers and HtmlHelpers
• 📝 HTML-like Syntax - No @ directives, pure HTML tags

📦 Installation

Install-Package ASTTemplateParser

Or via .NET CLI:

dotnet add package ASTTemplateParser

🚀 Quick Start

using ASTTemplateParser;

var engine = new TemplateEngine();
engine.SetVariable("UserName", "John");
engine.SetVariable("Products", productList);

var template = @"
<Element template=""page"">
    <h1>Welcome, {{UserName}}!</h1>
    <ForEach var=""p"" in=""Products"">
        <p>{{p.Name}} - ${{p.Price}}</p>
    </ForEach>
</Element>";

string html = engine.Render(template);

📖 Syntax Overview

Variables

{{UserName}}
{{Order.Customer.Name}}

Conditionals

<If condition="IsLoggedIn">
    <p>Welcome back!</p>
<ElseIf condition="IsGuest">
    <p>Hello Guest!</p>
<Else>
    <p>Please login</p>
</If>

Loops

<ForEach var="item" in="Items">
    <li>{{item.Name}}</li>
</ForEach>

Components

<Include component="element/button">
    <Param name="text" value="Click Me" />
    <Param name="type" value="primary" />
</Include>

🔧 ASP.NET MVC 5

// Global.asax
MvcIntegration.Initialize();

// Controller
public class HomeController : TemplateController
{
    public ActionResult Index()
    {
        return Template(new { Title = "Home" });
    }
}

// Razor View
@Html.Button("Click", "/action", "primary")
@Html.RenderComponent("block/card", new { title = "Card" })

🔒 Security

• ✅ HTML encoding by default (XSS protection)
• ✅ Expression validation (code injection protection)
• ✅ Path traversal prevention
• ✅ Loop iteration limits (DoS protection)
• ✅ Blocked sensitive properties (Password, Token, etc.)

📊 Performance

📄 License

MIT License - See LICENSE for details.

📚 Documentation

See DOCUMENTATION.md for complete API reference.