@engjts/nexus 0.1.10 → 0.1.11

package/dist/core/router/radix-tree.d.ts

@@ -13,10 +13,16 @@ export declare class RadixNode {
     handler: Handler | null;
     middlewares: Middleware[];
     children: RadixNode[];
-    type: 'static' | 'param' | 'wildcard';
+    type: 'static' | 'param' | 'regex' | 'pattern' | 'wildcard';
     paramName?: string;
+    regex?: RegExp;
+    patternParams?: string[];
     serializers: Map<number | string, SerializerFunction> | null;
-    constructor(segment: string, fullPath: string);
+    constructor(segment: string, fullPath: string, enableRegex?: boolean);
+    /**
+     * Escape special regex characters in a string
+     */
+    private escapeRegex;
     /**
      * Add a child node
      */
@@ -35,7 +41,8 @@ export declare class RadixNode {
  */
 export declare class RadixTree {
     private root;
-    constructor();
+    private enableRegex;
+    constructor(enableRegex?: boolean);
     /**
      * Insert a route into the tree
      */

package/dist/core/router/radix-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radix-tree.d.ts","sourceRoot":"","sources":["../../../src/core/router/radix-tree.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD;;GAEG;AACH,qBAAa,SAAS;IAElB,OAAO,EAAE,MAAM,CAAC;IAGhB,QAAQ,EAAE,MAAM,CAAC;IAGjB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAQ;IAG/B,WAAW,EAAE,UAAU,EAAE,CAAM;IAG/B,QAAQ,EAAE,SAAS,EAAE,CAAM;IAG3B,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAY;IAGjD,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,WAAW,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,kBAAkB,CAAC,GAAG,IAAI,CAAQ;gBAExD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAc7C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAmB/B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAS5C;;OAEG;IACH,OAAO,CAAC,eAAe;CAO1B;AAED;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,IAAI,CAAY;;IAMxB;;OAEG;IACH,MAAM,CACF,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,WAAW,GAAE,UAAU,EAAO,EAC9B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,kBAAkB,CAAC,GACvD,IAAI;IAuBP;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,WAAW,EAAE,UAAU,EAAE,CAAC;QAC1B,WAAW,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,kBAAkB,CAAC,GAAG,IAAI,CAAC;KAChE,GAAG,IAAI;IAkBR;;OAEG;IACH,OAAO,CAAC,UAAU;IA6ClB;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAM5D;;OAEG;IACH,OAAO,CAAC,aAAa;CASxB"}
+{"version":3,"file":"radix-tree.d.ts","sourceRoot":"","sources":["../../../src/core/router/radix-tree.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAUnD;;GAEG;AACH,qBAAa,SAAS;IAElB,OAAO,EAAE,MAAM,CAAC;IAGhB,QAAQ,EAAE,MAAM,CAAC;IAGjB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAQ;IAG/B,WAAW,EAAE,UAAU,EAAE,CAAM;IAG/B,QAAQ,EAAE,SAAS,EAAE,CAAM;IAQ3B,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAY;IAGvE,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAGzB,WAAW,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,kBAAkB,CAAC,GAAG,IAAI,CAAQ;gBAExD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe;IAqE3E;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAmB/B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAS5C;;OAEG;IACH,OAAO,CAAC,eAAe;CAS1B;AAED;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,WAAW,CAAU;gBAEjB,WAAW,GAAE,OAAe;IAKxC;;OAEG;IACH,MAAM,CACF,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,WAAW,GAAE,UAAU,EAAO,EAC9B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,kBAAkB,CAAC,GACvD,IAAI;IAuBP;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,WAAW,EAAE,UAAU,EAAE,CAAC;QAC1B,WAAW,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,kBAAkB,CAAC,GAAG,IAAI,CAAC;KAChE,GAAG,IAAI;IAkBR;;OAEG;IACH,OAAO,CAAC,UAAU;IAqFlB;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAM5D;;OAEG;IACH,OAAO,CAAC,aAAa;CASxB"}

package/dist/core/router/radix-tree.js

@@ -19,24 +19,86 @@ class RadixNode {
     middlewares = [];
     // Child nodes
     children = [];
-    // Pattern type: 'static', 'param', or 'wildcard'
+    // Pattern type: 'static', 'param', 'regex', 'pattern', or 'wildcard'
+    // - static: exact match like /users
+    // - param: simple param like :id
+    // - regex: param with regex like :id(\d+)
+    // - pattern: inline pattern like category-:slug or file.:ext
+    // - wildcard: catch-all like *
     type = 'static';
-    // Parameter name for param nodes
+    // Parameter name for param/regex nodes
     paramName;
+    // Compiled regex for regex/pattern nodes (compiled once at startup)
+    regex;
+    // Parameter names for pattern type (can have multiple params in one segment)
+    patternParams;
     // Compiled serializers for response (status code → serializer)
     serializers = null;
-    constructor(segment, fullPath) {
+    constructor(segment, fullPath, enableRegex = false) {
         this.segment = segment;
         this.fullPath = fullPath;
         // Detect node type
         if (segment.startsWith(':')) {
-            this.type = 'param';
-            this.paramName = segment.slice(1);
+            // Check for regex pattern: :param(pattern)
+            const regexMatch = enableRegex ? segment.match(/^:([^(]+)\((.+)\)$/) : null;
+            if (regexMatch) {
+                // Regex parameter: :id(\d+)
+                this.type = 'regex';
+                this.paramName = regexMatch[1];
+                this.regex = new RegExp(`^${regexMatch[2]}$`);
+            }
+            else {
+                // Simple parameter: :id
+                this.type = 'param';
+                this.paramName = segment.slice(1);
+            }
         }
         else if (segment === '*' || segment.startsWith('*')) {
             this.type = 'wildcard';
             this.paramName = segment.length > 1 ? segment.slice(1) : 'wildcard';
         }
+        else if (enableRegex && segment.includes(':')) {
+            // Inline pattern like: category-:slug, file.:ext, prefix-:id-suffix
+            this.type = 'pattern';
+            this.patternParams = [];
+            // Parse the segment and build regex
+            // Example: "category-:slug" -> regex: /^category-(.+)$/, params: ['slug']
+            // Example: "file.:ext(jpg|png)" -> regex: /^file\.(jpg|png)$/, params: ['ext']
+            let regexStr = '^';
+            let remaining = segment;
+            while (remaining.length > 0) {
+                // Find next param
+                const paramStart = remaining.indexOf(':');
+                if (paramStart === -1) {
+                    // No more params, add rest as literal
+                    regexStr += this.escapeRegex(remaining);
+                    break;
+                }
+                // Add literal part before param
+                if (paramStart > 0) {
+                    regexStr += this.escapeRegex(remaining.slice(0, paramStart));
+                }
+                remaining = remaining.slice(paramStart + 1);
+                // Parse param name and optional pattern
+                const paramMatch = remaining.match(/^([^(./-]+)(?:\(([^)]+)\))?/);
+                if (paramMatch) {
+                    const paramName = paramMatch[1];
+                    const paramPattern = paramMatch[2] || '.+'; // default: match anything
+                    this.patternParams.push(paramName);
+                    regexStr += `(${paramPattern})`;
+                    // Move past the param (name + optional pattern)
+                    remaining = remaining.slice(paramMatch[0].length);
+                }
+            }
+            regexStr += '$';
+            this.regex = new RegExp(regexStr);
+        }
+    }
+    /**
+     * Escape special regex characters in a string
+     */
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
     }
     /**
      * Add a child node
@@ -74,8 +136,10 @@ class RadixNode {
     getTypePriority(type) {
         switch (type) {
             case 'static': return 0;
-            case 'param': return 1;
-            case 'wildcard': return 2;
+            case 'pattern': return 1; // inline patterns like category-:slug
+            case 'regex': return 2; // regex param like :id(\d+)
+            case 'param': return 3; // simple param like :id
+            case 'wildcard': return 4;
         }
     }
 }
@@ -85,8 +149,10 @@ exports.RadixNode = RadixNode;
  */
 class RadixTree {
     root;
-    constructor() {
-        this.root = new RadixNode('', '/');
+    enableRegex;
+    constructor(enableRegex = false) {
+        this.root = new RadixNode('', '/', enableRegex);
+        this.enableRegex = enableRegex;
     }
     /**
      * Insert a route into the tree
@@ -99,7 +165,7 @@ class RadixTree {
             let child = current.findChild(segment);
             if (!child) {
                 const fullPath = '/' + segments.slice(0, i + 1).join('/');
-                child = new RadixNode(segment, fullPath);
+                child = new RadixNode(segment, fullPath, this.enableRegex);
                 current.addChild(child);
             }
             current = child;
@@ -145,6 +211,48 @@ class RadixTree {
                         return result;
                 }
             }
+            else if (child.type === 'pattern') {
+                // Inline pattern match - test regex and extract multiple params
+                const match = child.regex.exec(segment);
+                if (match) {
+                    // Save old values for backtracking
+                    const oldValues = {};
+                    for (let i = 0; i < child.patternParams.length; i++) {
+                        const paramName = child.patternParams[i];
+                        oldValues[paramName] = params[paramName];
+                        params[paramName] = match[i + 1]; // match[0] is full match
+                    }
+                    const result = this.searchNode(child, segments, index + 1, params);
+                    if (result)
+                        return result;
+                    // Backtrack
+                    for (const paramName of child.patternParams) {
+                        if (oldValues[paramName] === undefined) {
+                            delete params[paramName];
+                        }
+                        else {
+                            params[paramName] = oldValues[paramName];
+                        }
+                    }
+                }
+            }
+            else if (child.type === 'regex') {
+                // Regex match - test pattern and capture value if matches
+                if (child.regex.test(segment)) {
+                    const oldValue = params[child.paramName];
+                    params[child.paramName] = segment;
+                    const result = this.searchNode(child, segments, index + 1, params);
+                    if (result)
+                        return result;
+                    // Backtrack
+                    if (oldValue === undefined) {
+                        delete params[child.paramName];
+                    }
+                    else {
+                        params[child.paramName] = oldValue;
+                    }
+                }
+            }
             else if (child.type === 'param') {
                 // Parameter match - capture value
                 const oldValue = params[child.paramName];

package/dist/core/router/radix-tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"radix-tree.js","sourceRoot":"","sources":["../../../src/core/router/radix-tree.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"radix-tree.js","sourceRoot":"","sources":["../../../src/core/router/radix-tree.ts"],"names":[],"mappings":"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"}

package/dist/core/types.d.ts

@@ -7,6 +7,33 @@ import { ZodSchema } from 'zod';
 import { Application } from './application';
 import { ContextStore, StoreConstructor, RequestStore, RequestStoreConstructor } from './store';
 import { ResponseSchemaConfig, SerializerFunction } from './serializer';
+/**
+ * Template engine interface for render() method
+ */
+export interface TemplateEngine {
+    /** Engine name (e.g., 'handlebars', 'ejs', 'pug') */
+    name: string;
+    /** File extensions this engine handles (e.g., ['.hbs', '.handlebars']) */
+    extensions: string[];
+    /**
+     * Compile and render template with data
+     * @param template - Template string content
+     * @param data - Data to inject
+     * @returns Rendered string
+     */
+    render(template: string, data: Record<string, any>): string | Promise<string>;
+}
+/**
+ * Options for render() method
+ */
+export interface RenderOptions {
+    /** Template engine to use (default: auto-detect from extension or 'simple') */
+    engine?: string;
+    /** Status code for response (default: 200) */
+    status?: number;
+    /** Additional headers */
+    headers?: Record<string, string>;
+}
 /**
  * HTTP methods supported by the framework
  */
@@ -219,6 +246,7 @@ export interface RouteMeta {
     deprecated?: boolean;
     summary?: string;
     example?: string;
+    fileLocation?: string;
 }
 /**
  * Route configuration object
@@ -254,9 +282,19 @@ export type ErrorHandler = (error: Error, ctx: Context) => Response | Promise<Re
 export interface AppConfig {
     contextPoolSize?: number;
     enableJIT?: boolean;
+    /** Enable regex patterns in route params, e.g. /users/:id(\\d+) */
+    enableRegexRoutes?: boolean;
     onError?: ErrorHandler;
     debug?: boolean;
     logRequests?: boolean;
+    /** Enable Handlebars template engine (zero overhead if not used) */
+    handlebars?: boolean;
+    /** Enable EJS template engine (zero overhead if not used) */
+    ejs?: boolean;
+    /** Enable Pug template engine (zero overhead if not used) */
+    pug?: boolean;
+    /** Enable Mustache template engine (zero overhead if not used) */
+    mustache?: boolean;
 }
 /**
  * Plugin interface for extensibility
@@ -355,6 +393,35 @@ export interface RouteBase<TContext = Context> {
  */
 export declare abstract class Route<TContext = Context, TDeps = any> {
     pathName?: string;
+    /**
+     * Template engines registry (static, shared across all routes)
+     * @private
+     */
+    private static templateEngines;
+    /**
+     * Register a custom template engine
+     * @param engine - Template engine implementation
+     *
+     * @example
+     * ```typescript
+     * import Handlebars from 'handlebars';
+     *
+     * Route.registerEngine({
+     *   name: 'handlebars',
+     *   extensions: ['.hbs', '.handlebars'],
+     *   render: (template, data) => {
+     *     const compiled = Handlebars.compile(template);
+     *     return compiled(data);
+     *   }
+     * });
+     * ```
+     */
+    static registerEngine(engine: TemplateEngine): void;
+    /**
+     * Get registered template engine by name or extension
+     * @private
+     */
+    private static getEngine;
     /**
      * The main route handler - REQUIRED!
      * TypeScript will enforce this is implemented.
@@ -394,6 +461,45 @@ export declare abstract class Route<TContext = Context, TDeps = any> {
      * ```
      */
     protected fail(ctx: TContext, status: number, message: string, data?: any): Response;
+    /**
+     * Render a file template with data injection
+     * Supports multiple template engines via plugins or simple placeholder syntax by default
+     * @param filePath - Path to the template file (relative to project root or absolute)
+     * @param data - Data object to inject into template
+     * @param options - Render options (engine, status, headers)
+     * @returns Response object with rendered HTML/text
+     *
+     * @example
+     * ```typescript
+     * // Simple placeholder (default): {{ variableName }}
+     * return this.render('./views/welcome.html', { name: 'John' });
+     *
+     * // With Handlebars (auto-detect from .hbs extension)
+     * return this.render('./views/profile.hbs', { user });
+     *
+     * // Force specific engine
+     * return this.render('./views/page.html', { data }, { engine: 'ejs' });
+     *
+     * // With custom status and headers
+     * return this.render('./views/error.html', { message }, {
+     *   status: 500,
+     *   headers: { 'X-Custom': 'value' }
+     * });
+     * ```
+     */
+    protected render(filePath: string, data?: Record<string, any>, options?: RenderOptions): Promise<Response>;
+    /**
+     * Inject data into template string
+     * Supports {{ variable }} and {{ object.property }} syntax
+     * Automatically JSON.stringify() objects and arrays for use in JavaScript
+     * @private
+     */
+    private injectTemplateData;
+    /**
+     * Get content type from file extension
+     * @private
+     */
+    private getContentTypeFromExtension;
     /**
      * HTTP method(s) this route handles - Optional
      * When using file-based routing, you can also define method handlers (GET, POST, etc.)

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/types.js

@@ -3,6 +3,39 @@
  * Core type definitions for the Nexus Framework
  * Provides type-safe interfaces for requests, responses, middleware, and routing
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Route = void 0;
 exports.isRouteClass = isRouteClass;
@@ -46,6 +79,43 @@ exports.isRouteClass = isRouteClass;
  */
 class Route {
     pathName;
+    /**
+     * Template engines registry (static, shared across all routes)
+     * @private
+     */
+    static templateEngines = new Map();
+    /**
+     * Register a custom template engine
+     * @param engine - Template engine implementation
+     *
+     * @example
+     * ```typescript
+     * import Handlebars from 'handlebars';
+     *
+     * Route.registerEngine({
+     *   name: 'handlebars',
+     *   extensions: ['.hbs', '.handlebars'],
+     *   render: (template, data) => {
+     *     const compiled = Handlebars.compile(template);
+     *     return compiled(data);
+     *   }
+     * });
+     * ```
+     */
+    static registerEngine(engine) {
+        Route.templateEngines.set(engine.name, engine);
+        // Also register by file extensions for auto-detection
+        for (const ext of engine.extensions) {
+            Route.templateEngines.set(ext, engine);
+        }
+    }
+    /**
+     * Get registered template engine by name or extension
+     * @private
+     */
+    static getEngine(nameOrExt) {
+        return Route.templateEngines.get(nameOrExt);
+    }
     // ─────────────────────────────────────────────────────────────────────────
     // Helper Methods for cleaner response handling
     // ─────────────────────────────────────────────────────────────────────────
@@ -85,6 +155,122 @@ class Route {
             .status(status)
             .json({ success: false, message, ...(data !== undefined ? { data } : {}) });
     }
+    /**
+     * Render a file template with data injection
+     * Supports multiple template engines via plugins or simple placeholder syntax by default
+     * @param filePath - Path to the template file (relative to project root or absolute)
+     * @param data - Data object to inject into template
+     * @param options - Render options (engine, status, headers)
+     * @returns Response object with rendered HTML/text
+     *
+     * @example
+     * ```typescript
+     * // Simple placeholder (default): {{ variableName }}
+     * return this.render('./views/welcome.html', { name: 'John' });
+     *
+     * // With Handlebars (auto-detect from .hbs extension)
+     * return this.render('./views/profile.hbs', { user });
+     *
+     * // Force specific engine
+     * return this.render('./views/page.html', { data }, { engine: 'ejs' });
+     *
+     * // With custom status and headers
+     * return this.render('./views/error.html', { message }, {
+     *   status: 500,
+     *   headers: { 'X-Custom': 'value' }
+     * });
+     * ```
+     */
+    async render(filePath, data, options) {
+        const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+        const path = await Promise.resolve().then(() => __importStar(require('path')));
+        // Resolve file path (support both relative and absolute paths)
+        const resolvedPath = path.isAbsolute(filePath)
+            ? filePath
+            : path.resolve(process.cwd(), filePath);
+        // Check if file exists
+        if (!fs.existsSync(resolvedPath)) {
+            throw new Error(`Template file not found: ${filePath}`);
+        }
+        // Read file content
+        let content = fs.readFileSync(resolvedPath, 'utf-8');
+        // Determine which engine to use
+        const ext = path.extname(filePath).toLowerCase();
+        let engine;
+        if (options?.engine) {
+            // Explicit engine specified
+            engine = Route.getEngine(options.engine);
+            if (!engine) {
+                throw new Error(`Template engine '${options.engine}' not registered. ` +
+                    `Register it using Route.registerEngine()`);
+            }
+        }
+        else {
+            // Auto-detect from file extension
+            engine = Route.getEngine(ext);
+        }
+        // Render with appropriate engine
+        if (engine) {
+            // Use registered template engine
+            content = await engine.render(content, data || {});
+        }
+        else if (data && Object.keys(data).length > 0) {
+            // Fallback to simple placeholder engine (default)
+            content = this.injectTemplateData(content, data);
+        }
+        // Determine content type from file extension
+        const contentType = this.getContentTypeFromExtension(ext);
+        // Build response headers
+        const headers = {
+            'Content-Type': contentType,
+            ...(options?.headers || {})
+        };
+        return {
+            statusCode: options?.status || 200,
+            headers,
+            body: content
+        };
+    }
+    /**
+     * Inject data into template string
+     * Supports {{ variable }} and {{ object.property }} syntax
+     * Automatically JSON.stringify() objects and arrays for use in JavaScript
+     * @private
+     */
+    injectTemplateData(template, data) {
+        return template.replace(/\{\{\s*([\w.]+)\s*\}\}/g, (match, key) => {
+            // Support nested properties: user.name, user.email, etc.
+            const value = key.split('.').reduce((obj, prop) => {
+                return obj && obj[prop] !== undefined ? obj[prop] : '';
+            }, data);
+            if (value === undefined || value === null) {
+                return '';
+            }
+            // If value is object or array, JSON.stringify it for JavaScript usage
+            if (typeof value === 'object') {
+                return JSON.stringify(value);
+            }
+            // Primitive values: convert to string
+            return String(value);
+        });
+    }
+    /**
+     * Get content type from file extension
+     * @private
+     */
+    getContentTypeFromExtension(ext) {
+        const mimeTypes = {
+            '.html': 'text/html; charset=utf-8',
+            '.htm': 'text/html; charset=utf-8',
+            '.xml': 'application/xml; charset=utf-8',
+            '.txt': 'text/plain; charset=utf-8',
+            '.css': 'text/css; charset=utf-8',
+            '.js': 'application/javascript; charset=utf-8',
+            '.json': 'application/json; charset=utf-8',
+            '.svg': 'image/svg+xml',
+        };
+        return mimeTypes[ext] || 'text/plain; charset=utf-8';
+    }
     /**
      * HTTP method(s) this route handles - Optional
      * When using file-based routing, you can also define method handlers (GET, POST, etc.)

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAihBH,oCAOC;AApJD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAsB,KAAK;IACvB,QAAQ,CAAU;IAUlB,4EAA4E;IAC5E,+CAA+C;IAC/C,4EAA4E;IAE5E;;;;;;;;;;OAUG;IACO,EAAE,CAAgC,IAAO;QAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACO,IAAI,CAAC,GAAa,EAAE,MAAc,EAAE,OAAe,EAAE,IAAU;QACrE,OAAQ,GAAe,CAAC,QAAQ;aAC3B,MAAM,CAAC,MAAM,CAAC;aACd,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;OAGG;IACH,MAAM,CAA6B;CAyCtC;AAlGD,sBAkGC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,KAAwB;IACjD,OAAO,KAAK,YAAY,KAAK;QACtB,CAAC,OAAQ,KAAe,CAAC,OAAO,KAAK,UAAU;YAC9C,UAAU,IAAI,KAAK;YACnB,CAAC,OAAQ,KAAe,CAAC,QAAQ,KAAK,UAAU;gBAC/C,OAAQ,KAAe,CAAC,OAAO,KAAK,UAAU;gBAC9C,OAAQ,KAAe,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}