Cache prepared template regex patterns to avoid redundant disk I/O

Each call to parseText() previously triggered a file_get_contents() +
full regex compilation pass for every template in the directory. Add an
in-memory cache (keyed by file path) on the TemplatesHelper instance so
that subsequent parseText() calls on the same parser reuse the compiled
patterns, cutting redundant I/O and regex compilation to zero.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: aymanrb

src/Helper/TemplatesHelper.php

@@ -21,6 +21,9 @@ class TemplatesHelper
 
     private readonly \FilesystemIterator $directoryIterator;
 
+    /** @var array<string, string> */
+    private array $templateCache = [];
+
     public function __construct(string $templatesDir)
     {
         $this->directoryIterator = $this->createTemplatesDirIterator($templatesDir);
@@ -63,7 +66,7 @@ private function findTemplate(string $text): array
 
             if ($matchPercentage > $maxMatch) {
                 $maxMatch = $matchPercentage;
-                $matchedTemplate = [$fileInfo->getPathname() => $this->prepareTemplate($templateContent)];
+                $matchedTemplate = [$fileInfo->getPathname() => $this->getCachedPreparedTemplate($fileInfo->getPathname(), $templateContent)];
             }
         }
 
@@ -84,14 +87,23 @@ private function getAllValidTemplates(): array
                 continue;
             }
 
-            $templates[$fileInfo->getPathname()] = $this->prepareTemplate($templateContent);
+            $templates[$fileInfo->getPathname()] = $this->getCachedPreparedTemplate($fileInfo->getPathname(), $templateContent);
         }
 
         krsort($templates);
 
         return $templates;
     }
 
+    private function getCachedPreparedTemplate(string $filePath, string $templateContent): string
+    {
+        if (!isset($this->templateCache[$filePath])) {
+            $this->templateCache[$filePath] = $this->prepareTemplate($templateContent);
+        }
+
+        return $this->templateCache[$filePath];
+    }
+
     private function validateVariableNames(string $templateText): void
     {
         preg_match_all('/\{%([^%:]+)(?::[^%]*)?\%\}/', $templateText, $matches);