Refactor View Engine into modular pipeline with typed AST, directives, scoped runtime, and secure rendering

README.md

@@ -90,14 +90,22 @@ src/Core/View/
 ├── Compiler.php               # Compila templates
 ├── Parser.php                 # Parser da AST
 ├── Lexer.php                  # Tokenizador
-├── Renderer.php               # Renderizador
+├── Renderer.php               # Renderização via include (sem eval)
 ├── Environment.php            # Configuração
-├── Nodes/                     # AST Nodes
-├── Directives/                # Processadores de tags
-├── Filters/                   # Filtros
+├── TemplateResolver.php       # Resolução segura de caminhos
+├── Abstract/                  # Bases abstratas (Node/Directive/Filter/Middleware)
+├── Nodes/                     # AST nodes compiláveis
+├── Directives/                # Registry + directives padrão
+├── Filters/                   # Filtros por domínio + registry
+├── Scope/                     # Scope e pilha de variáveis
+├── Layout/                    # Herança de templates e blocos
+├── Cache/                     # Cache key + file watcher
+├── Escape/                    # Escape context-aware (HTML/JS/CSS/URI)
+├── Middleware/                # Pipeline de middlewares
+├── Validation/                # Validação de sintaxe/template
+├── Debug/                     # Source/runtime debugging helpers
 ├── Components/                # Sistema de componentes
-├── Cache/                     # Cache
-└── Exceptions/                # Exceções
+└── Exceptions/                # Hierarquia de exceções
 ```
 
 ## Contribuindo

src/Core/View/Abstract/AbstractDirective.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Beobles\Core\View\Abstract;
+
+abstract class AbstractDirective
+{
+    abstract public function getName(): string;
+
+    /** @return array<string, mixed> */
+    abstract public function parseAttributes(string $attributes): array;
+}

src/Core/View/Abstract/AbstractFilter.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Beobles\Core\View\Abstract;
+
+abstract class AbstractFilter
+{
+    abstract public function getName(): string;
+
+    public function __invoke(mixed $value, mixed ...$args): mixed
+    {
+        return $this->apply($value, ...$args);
+    }
+
+    abstract public function apply(mixed $value, mixed ...$args): mixed;
+}

src/Core/View/Abstract/AbstractMiddleware.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace Beobles\Core\View\Abstract;
+
+abstract class AbstractMiddleware
+{
+    /**
+     * @param callable(array<string, mixed>): string $next
+     * @param array<string, mixed> $context
+     */
+    abstract public function handle(array $context, callable $next): string;
+}

src/Core/View/Abstract/AbstractNode.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace Beobles\Core\View\Abstract;
+
+use Beobles\Core\View\Compiler;
+use Beobles\Core\View\Nodes\NodeInterface;
+
+abstract class AbstractNode implements NodeInterface
+{
+    protected int $line;
+    protected int $column;
+    protected array $metadata;
+
+    public function __construct(int $line = 1, int $column = 1, array $metadata = [])
+    {
+        $this->line = $line;
+        $this->column = $column;
+        $this->metadata = $metadata;
+    }
+
+    abstract public function compile(Compiler $compiler): string;
+
+    public function accept(callable $visitor)
+    {
+        return $visitor($this);
+    }
+
+    public function getLine(): int
+    {
+        return $this->line;
+    }
+
+    public function getColumn(): int
+    {
+        return $this->column;
+    }
+
+    public function getMetadata(): array
+    {
+        return $this->metadata;
+    }
+}

src/Core/View/Cache/CacheKey.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Beobles\Core\View\Cache;
+
+class CacheKey
+{
+    /** @param array<int, string> $dependencies */
+    public function forTemplate(string $path, array $dependencies = []): string
+    {
+        $signature = $path;
+        foreach ($dependencies as $dep) {
+            $signature .= '|' . $dep;
+            if (is_file($dep)) {
+                $signature .= ':' . (string) filemtime($dep);
+            }
+        }
+
+        return 'template_' . md5($signature);
+    }
+}

src/Core/View/Cache/FileWatcher.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Beobles\Core\View\Cache;
+
+class FileWatcher
+{
+    /** @var array<string, int|false> */
+    private array $mtimes = [];
+
+    /** @param array<int, string> $paths */
+    public function hasChanged(array $paths): bool
+    {
+        $changed = false;
+
+        foreach ($paths as $path) {
+            $mtime = is_file($path) ? filemtime($path) : false;
+            if (!array_key_exists($path, $this->mtimes) || $this->mtimes[$path] !== $mtime) {
+                $changed = true;
+                $this->mtimes[$path] = $mtime;
+            }
+        }
+
+        return $changed;
+    }
+}