Improve template exceptions with original source mapping across extends

README.md

@@ -30,12 +30,13 @@
 <?php
 require_once 'autoload.php';
 
-use Beobles\Core\View\Engine;
+use Core\View\Engine;
 
 $engine = new Engine([
     'templates_dir' => __DIR__ . '/templates',
     'cache_dir' => __DIR__ . '/cache',
-    'auto_escape' => true
+    'auto_escape' => true,
+    'debug' => true, // false em produção para mensagens seguras
 ]);
 
 echo $engine->render('home.html', [
@@ -82,6 +83,13 @@ import { UserCard } from "@components/UserCard";
 
 Veja [SYNTAX.md](./SYNTAX.md) para documentação completa da sintaxe.
 
+## Modo Debug e Produção
+
+- `debug: true` (padrão): mantém mensagens detalhadas para facilitar desenvolvimento.
+- `debug: false` ou `environment: 'production'`: retorna mensagens seguras e genéricas para produção.
+- Erros de sintaxe compilada geram `SyntaxException` com contexto interno (arquivo, linha, coluna e snippet), preservado no encadeamento da exceção.
+- Em templates com `extends`, as exceções de léxico/parser apontam o arquivo original (ex.: `layouts/base.html`) com linha e coluna exatas.
+
 ## Estrutura do Projeto
 
 ```

SYNTAX.md

@@ -151,7 +151,7 @@ Com índice:
 Com chave e valor (arrays associativos):
 
 ```html
-<Foreach items={{ config }} as="key,value">
+<Foreach items={{ config }} as="value,key">
   <div>{{ key }}: {{ value }}</div>
 </Foreach>
 ```

autoload.php

@@ -6,7 +6,7 @@
  */
 
 spl_autoload_register(function ($class) {
-    $prefix = 'Beobles\\Core\\View\\';
+    $prefix = 'Core\\View\\';
     $baseDir = __DIR__ . '/src/Core/View/';
 
     if (strpos($class, $prefix) !== 0) {

examples/index.php

@@ -2,14 +2,15 @@
 
 require_once __DIR__ . '/../autoload.php';
 
-use Beobles\Core\View\Engine;
+use Core\View\Engine;
 
 // Criar engine
 $engine = new Engine([
     'templates_dir' => __DIR__ . '/templates',
     'cache_dir' => __DIR__ . '/../cache',
     'auto_escape' => true,
-    'cache_enabled' => true
+    'cache_enabled' => true,
+    'debug' => true
 ]);
 
 // Dados para o template

src/Core/View/Cache/CacheInterface.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Beobles\Core\View\Cache;
+namespace Core\View\Cache;
 
 /**
  * Interface para adaptadores de cache

src/Core/View/Cache/CacheManager.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Beobles\Core\View\Cache;
+namespace Core\View\Cache;
 
 /**
  * Gerenciador de cache

src/Core/View/Cache/FileCacheAdapter.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Beobles\Core\View\Cache;
+namespace Core\View\Cache;
 
 /**
  * Adaptador de cache em arquivo

src/Core/View/Compilation/CompilationContext.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace Core\View\Compilation;
+
+/**
+ * Buffer de compilação passado a cada Node durante a compilação.
+ *
+ * Centraliza:
+ *   - A escrita de código PHP em um buffer de string
+ *   - A delegação para o ExpressionCompiler (expressões e filtros)
+ *
+ * Assim cada Node pode chamar $ctx->expr() ou $ctx->exprChain() e depois
+ * $ctx->writeLine() sem precisar conhecer os detalhes de compilação.
+ */
+class CompilationContext
+{
+    private string $buffer = '';
+    private ExpressionCompiler $expressionCompiler;
+
+    public function __construct(ExpressionCompiler $expressionCompiler)
+    {
+        $this->expressionCompiler = $expressionCompiler;
+    }
+
+    // -----------------------------------------------------------------------
+    // Buffer de escrita
+    // -----------------------------------------------------------------------
+
+    public function write(string $code): void
+    {
+        $this->buffer .= $code;
+    }
+
+    public function writeLine(string $code = ''): void
+    {
+        $this->buffer .= $code . "\n";
+    }
+
+    public function getCode(): string
+    {
+        return $this->buffer;
+    }
+
+    // -----------------------------------------------------------------------
+    // Delegação para ExpressionCompiler
+    // -----------------------------------------------------------------------
+
+    /**
+     * Compila uma expressão simples (sem filtros) para PHP.
+     */
+    public function expr(string $expression): string
+    {
+        return $this->expressionCompiler->compile($expression);
+    }
+
+    /**
+     * Compila uma expressão com possível cadeia de filtros.
+     *
+     * @return array{0: string, 1: bool}  [código PHP, isRaw]
+     */
+    public function exprChain(string $expression): array
+    {
+        return $this->expressionCompiler->compileChain($expression);
+    }
+}