- WIP on Picea's Asset.

docs/99-dependency-injection.md

@@ -10,7 +10,7 @@ use function DI\autowire, DI\create, DI\get;
 use Laminas\Diactoros\Response\HtmlResponse;
 
 use Picea\{ Picea, Caching\Cache, Caching\Opcache, Compiler, Compiler\Context, Compiler\BaseContext, FileFetcher, Language\DefaultRegistrations, Method\Request };
-use Picea\Extension\{ LanguageHandler, LanguageExtension, TitleExtension, NumberExtension, UrlExtension };
+use Picea\Extension\{ LanguageHandlerInterface, LanguageExtension, TitleExtension, NumberExtension, UrlExtension };
 use Picea\Ui\{ Method, Ui };
 
 return [
@@ -49,10 +49,10 @@ return [
 
     Method\Pagination::class => autowire(Method\Pagination::class),
 
-    LanguageExtension::class => create(LanguageExtension::class)->constructor(get(LanguageHandler::class)),
+    LanguageExtension::class => create(LanguageExtension::class)->constructor(get(LanguageHandlerInterface::class)),
 
-    LanguageHandler::class => function($c) {
+    LanguageHandlerInterface::class => function($c) {
-        return new class( $c->get(Tell\I18n::class) ) implements LanguageHandler {
+        return new class( $c->get(Tell\I18n::class) ) implements LanguageHandlerInterface {
             public Tell\I18n $tell;
 
             public function __construct(Tell\I18n $tell) {

src/Builder/ClassTemplate.php

@@ -50,15 +50,21 @@ if (! class_exists("%NAMESPACE%\%CLASSNAME%", false) ) {
 
             $__event->eventExecute(\Picea\Event\Builder\ClassTemplateOutputing::class, $variablesList);
 
+            try {
                 ( function($___class__template, $___global_variables, $___variables, $__event, $picea) {
                     extract($___global_variables);
                     extract($___variables, \EXTR_OVERWRITE);
                     ?>%CONTENT%<?php
                 } )->call($this->thisProxy ?? new class() {}, $this, $this->variableList, $variablesList, $__event, $this->picea);
+            } catch (\Throwable $error) {
+                throw $this->errorHandler($error);
+            }
 
             $__event->eventExecute(\Picea\Event\Builder\ClassTemplateOutputDone::class, $variablesList);
 
-            %PARENT_OUTPUT%
+            try { %PARENT_OUTPUT% } catch (\Throwable $error) {
+                throw $this->errorHandler($error);
+            }
 
             $this->depth--;
 
@@ -138,6 +144,32 @@ if (! class_exists("%NAMESPACE%\%CLASSNAME%", false) ) {
             $this->output($variablesList);
             return ob_get_clean();
         }
+
+        public static function isTemplateError(\Throwable $error) : bool
+        {
+            $class = substr(static::class, strripos(static::class, '\\') + 1) . ".php";
+
+            return substr($error->getFile(), -strlen($class)) === $class;
+        }
+
+        protected function errorHandler(\Throwable $error) : \Throwable
+        {
+            $class = substr(static::class, strrpos(static::class, '\\') + 1) . ".php";
+
+            #dump( __NAMESPACE__, basename($error->getFile()), $class );
+            $basename = basename($error->getFile());
+
+            #dump(is_subclass_of(sprintf("\\%s\\%s", __NAMESPACE__, substr($basename,0 , strrpos($basename, '.'))), static::class, true));
+
+            if (str_ends_with($error->getFile(), $class)) {
+                $error = new \Picea\Exception\RenderHtmlException($this, $error->getMessage(), $error->getCode(), $error);
+            }
+            #elseif (is_subclass_of(sprintf("\\%s\\%s", __NAMESPACE__, substr($basename,0 , strrpos($basename, '.'))), static::class, true)) {
+             #   $error = new \Picea\Exception\RenderHtmlException($this, $error->getMessage(), $error->getCode(), $error);
+            #}
+
+            return $error;
+        }
     }
 
 }

src/Caching/Opcache.php

@@ -12,9 +12,9 @@ class Opcache implements Cache {
 
     protected array $compiled = [];
     
-    protected ? Context $context;
+    protected null|Context $context;
 
-    public function __construct(?string $cachePath = null, ? Context $context)
+    public function __construct(?string $cachePath = null, null|Context $context  = null)
     {
         $this->cachePath = $cachePath ?? sys_get_temp_dir();
         $this->context = $context;
@@ -34,7 +34,7 @@ class Opcache implements Cache {
 
         $compiledContext = $this->compiled[$viewPath];
 
-        $fullName = isset($compiledContext['namespace']) ? "\\{$compiledContext['namespace']}\\{$compiledContext['classname']}" : $compiledContext['classname'];
+        $fullName = isset($compiledContext['namespace']) ? "\\{$compiledContext['namespace']}\\{$compiledContext['classname']}" : ($compiledContext['classname'] ?? $viewPath);
 
         return new $fullName(...$arguments);
     }

src/Compiler.php

@@ -2,12 +2,17 @@
 
 namespace Picea;
 
+use Picea\Event\Compiler\CompileTokenExtension;
+use Picea\Event\Compiler\CompileTokenExtensionEvent;
+use Picea\Event\Compiler\CompileTokenTagEvent;
 use Picea\Exception\RegisterExtensionToken;
 use Picea\Extension\FunctionExtension;
 use Picea\Language\LanguageRegistration;
 
 class Compiler
 {
+    use EventTrait;
+
     protected string $sourceCode = "";
 
     protected array $syntaxObjectList = [];
@@ -20,11 +25,10 @@ class Compiler
 
     public array $extensionList = [];
 
-    public ? LanguageRegistration $languageRegistration;
+    public function __construct(
-
+        public LanguageRegistration $languageRegistration
-    public function __construct(?LanguageRegistration $languageRegistration = null)
+    )
     {
-        $this->languageRegistration = $languageRegistration;
         $this->languageRegistration->registerAll($this);
     }
 
@@ -53,11 +57,14 @@ class Compiler
             $tokenName = $context->tokenName($token);
             $tokenOptions = $context->tokenOptions($token);
 
-            # @TODO Refractor this parts to allows registration to the tag's name
             if ( $this->tagList[$tokenName] ?? false ) {
+                $this->eventExecute(CompileTokenTagEvent::class, $context, $arguments, $tokenName, $tokenOptions);
+
                 return $this->tagList[$tokenName]->parse($context, $arguments, $tokenName, $tokenOptions);
             }
             elseif ( $this->extensionList[$tokenName] ?? false ) {
+                $this->eventExecute(CompileTokenExtensionEvent::class, $context, $arguments, $tokenName, $tokenOptions);
+
                 return $this->extensionList[$tokenName]->parse($context, $arguments, $tokenName, $tokenOptions);
             }
             else {
@@ -135,7 +142,7 @@ class Compiler
 
     public function __toString() : string
     {
-        return "WHATAFAK";
+        return "???";
     }
 
     public function getExtensionFromToken(string $name) : Extension\Extension

src/ControlStructure/SectionToken.php

@@ -63,12 +63,12 @@ class SectionToken implements ControlStructure {
         $order = $options['order'] ?? "count(\$___class__template->sectionList[$name]['$action'])";
 
         return "<?php \$___class__template->sectionList[$name] ??= [ 'prepend' => [], 'append' => [], 'default' => [] ];" .
-                      "\$___class__template->sectionList[$name]['$action'][] = [ 
+                      "\$___class__template->sectionList[$name]['$action'][] = [ ".
-                      'order' => $order, 
+                      "'order' => $order, " .
-                      'callback' => function() use (\$picea, \$___class__template, \$___global_variables, \$___variables, \$__event) {".
+                      "'callback' => function() use (\$picea, \$___class__template, \$___global_variables, \$___variables, \$__event) {" .
-                          "extract(\$___global_variables); extract(\$___variables, \EXTR_OVERWRITE); 
+                          "extract(\$___global_variables); extract(\$___variables, \EXTR_OVERWRITE);" .
-                          \$___class__template->sectionStack[] = $name; 
+                          "\$___class__template->sectionStack[] = $name;" .
-                          \$__event->eventExecute(\Picea\Event\Builder\ClassTemplateRenderSection::class, $name);?>";
+                          "\$__event->eventExecute(\Picea\Event\Builder\ClassTemplateRenderSection::class, $name);?>";
     }
 
     protected function printEndSection($context) : string
@@ -76,13 +76,10 @@ class SectionToken implements ControlStructure {
         $section = array_pop($context->sections);
         $build = $context->extendFrom ? "!empty(\$___class__template->sectionStack) && \$___class__template->renderSection({$section['name']}, false);" : "\$___class__template->renderSection({$section['name']}, false);";
 
-        return <<<PHP
+        return "<?php \$__event->eventExecute(\Picea\Event\Builder\ClassTemplateRenderSectionDone::class, {$section['name']});" .
-            <?php 
+                "array_pop(\$___class__template->sectionStack); }];" .
-                \$__event->eventExecute(\Picea\Event\Builder\ClassTemplateRenderSectionDone::class, {$section['name']});
+                $build .
-                array_pop(\$___class__template->sectionStack); }]; 
+                "?>";
-                $build
-            ?>
-        PHP;
 
     }
 }

src/Event/Compiler/CompileTokenExtensionEvent.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Picea\Event\Compiler;
+
+use Picea\Compiler\Context;
+
+interface CompileTokenExtensionEvent
+{
+    public function execute(Context $context, ?string $arguments, string $token, array $options = []);
+}

src/Event/Compiler/CompileTokenTagEvent.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Picea\Event\Compiler;
+
+use Picea\Compiler\Context;
+
+interface CompileTokenTagEvent
+{
+    public function execute(Context &$context, ?string $arguments, string $token, array $options = []);
+}

src/Event/Extension/UrlBuildAssetEvent.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace Picea\Event\Extension;
+
+interface UrlBuildAssetEvent
+{
+    public function execute(string $uri, array $parameters = [], bool $appendVersion) : void;
+}

src/Event/Extension/UrlBuildRouteEvent.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace Picea\Event\Extension;
+
+interface UrlBuildRouteEvent
+{
+    public function execute(string $uri, array $parameters = [], bool $appendVersion) : void;
+}

src/Event/Extension/UrlBuildUrlEvent.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace Picea\Event\Extension;
+
+interface UrlBuildUrlEvent
+{
+    public function execute(string $uri, array $parameters = [], bool $appendVersion) : void;
+}

src/Event/Extension/UrlRegisterRouteEvent.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace Picea\Event\Extension;
+
+interface UrlRegisterRouteEvent
+{
+    public function execute(string $name, array $route) : void;
+}

src/EventTrait.php

@@ -4,26 +4,26 @@ namespace Picea;
 
 trait EventTrait
 {
-    protected $_eventTraitMethod = "execute";
+    protected $eventTraitMethod = "execute";
 
-    public array $_eventList = [];
+    public array $eventTraitList = [];
 
-    protected array $_returnList = [];
+    protected array $eventTraitReturnList = [];
 
     public function eventRegister(object $event) : void 
     {
-        $this->_eventList[] = $event;
+        $this->eventTraitList[] = $event;
     }
     
     public function eventFromType(string $type) : array 
     {
-        return array_filter($this->_eventList, fn($ev) => $ev instanceof $type);
+        return array_filter($this->eventTraitList, fn($ev) => $ev instanceof $type);
     }
 
     public function eventExecute(string $type, ...$arguments) : void 
     {
         foreach($this->eventFromType($type) as $event) {
-            $this->_returnList[$event::class][] = call_user_func_array([ $event, $this->_eventTraitMethod ], $arguments);
+            $this->eventTraitReturnList[$event::class][] = call_user_func_array([ $event, $this->eventTraitMethod ], $arguments);
         }
     }
 }

src/Exception/RenderHtmlException.php

@@ -10,33 +10,20 @@ use Picea\Picea;
  */
 class RenderHtmlException extends \Exception
 {
-    protected Picea $picea;
 
-    public function __construct(object $compiledObject, Picea $picea, string $message, int $code, \Throwable $previous)
+    public function __construct(object $template, string $message, int $code, \Throwable $previous)
     {
         parent::__construct($message, $code, $previous);
 
-        $this->picea = $picea;
+        $this->defineError($previous, $template);
-
-        $this->defineError($previous, $compiledObject);
     }
 
-    protected function defineError(\Throwable $previous, object $compiledObject) : void
+    protected function defineError(\Throwable $previous, object $template) : void
     {
-        $loadedTemplates = array_flip($this->picea->loadedTemplateFile);
+        /*$loadedTemplates = array_flip($this->picea->loadedTemplateFile);*/
 
-        foreach($previous->getTrace() as $trace) {
+        $this->file = $template::getParam('view');
-            if ( isset($trace['file'], $loadedTemplates[$trace['file']]) ) {
+        $this->line = $template::getSourceLineFromException($previous->getLine());
-                $class = $loadedTemplates[ $trace['file'] ];
-
-                $content = include($trace['file']);
-
-                $this->file = $content['view'];
-                $this->line = $class::getSourceLineFromException($trace['line']);
-
-                return;
-            }
-        }
     }
 
     protected function getTemplateFile(string $filePath) : ? array

src/Extension/BatchExtension.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Picea\Extension;
+
+use Picea\Compiler\Context;
+
+class BatchExtension implements Extension, FunctionExtension {
+
+    public string $token = "batch";
+
+    public function exportFunctions(): array
+    {
+        return [
+            "batch" => [ $this, 'batch' ]
+        ];
+    }
+
+    public function parse(\Picea\Compiler\Context &$context, ?string $arguments, string $token, array $options = []) : string
+    {
+        return "<?php echo batch($arguments) ?>";
+    }
+
+    public function batch(iterable $array, int $size, mixed $default = null) : \Generator
+    {
+        $split = ceil( count($array) / $size );
+
+        for($i = 0; $i < $split; $i++) {
+            $slice = array_slice(is_array($array) ? $array : iterator_to_array($array, true), $i * $size, $size, true);
+            $pad = ( count($slice) !== $size ) && ( $default !== null );
+            yield $pad ? array_pad($slice, $size, $default) : $slice;
+        }
+    }
+}

src/Extension/LanguageExtension.php

@@ -11,9 +11,9 @@ class LanguageExtension implements Extension, FunctionExtension {
 
     public string $currentLanguage = "";
 
-    protected LanguageHandler $languageHandler;
+    protected LanguageHandlerInterface $languageHandler;
 
-    public function __construct(LanguageHandler $handler) {
+    public function __construct(LanguageHandlerInterface $handler) {
         $this->languageHandler = $handler;
     }
 

src/Extension/LanguageHandlerInterface.php

@@ -2,7 +2,7 @@
 
 namespace Picea\Extension;
 
-interface LanguageHandler
+interface LanguageHandlerInterface
 {
     public function languageFromKey(string $key, array $variables = []); #: array|string;
 }

src/Extension/PrintExtension.php

@@ -6,7 +6,7 @@ use Picea\Compiler\Context;
 
 class PrintExtension implements Extension {
 
-    public array $token = [ "echo", "print", "printf" ];
+    public array $token = [ "echo", "print", "printf", "no_html" ];
     
     public int $flag = \ENT_QUOTES;
 
@@ -35,6 +35,10 @@ class PrintExtension implements Extension {
                 }
 
                 return "<?php echo htmlspecialchars(sprintf((string) $arguments), {$this->flag}, '{$this->encoding}', " . ($this->doubleEncode ? "true" : "false") . ") ?>";
+
+            case 'no_html':
+                return "<?php echo nl2br(strip_tags((string) $arguments)) ?>";
+
         }
     }
     

src/Extension/TitleExtension.php

@@ -17,13 +17,10 @@ class TitleExtension implements Extension, FunctionExtension {
 
     public function parse(\Picea\Compiler\Context &$context, ?string $arguments, string $token, array $options = []) : string
     {
-        return <<<PHP
+        return "<?php ".
-            <?php 
+                "if ( null !== \$title = title($arguments) ) {".
-                if ( null !== \$title = title($arguments) ) {
+                "echo \$title;".
-                    echo \$title;
+                "} ?>";
-                }    
-            ?>
-        PHP;
     }
     
     public function handleTitle(? string $set = null, ...$arguments) : ? string

src/Extension/UrlExtension.php

@@ -2,9 +2,16 @@
 
 namespace Picea\Extension;
 
+use Notes\Route\Attribute\Object\Route;
+use Picea\EventTrait;
 use Picea\Compiler\Context;
 
+use Picea\Event\Extension\{ UrlBuildAssetEvent, UrlBuildUrlEvent, UrlBuildRouteEvent, UrlRegisterRouteEvent };
+
 class UrlExtension implements Extension, FunctionExtension {
+    use \Picea\EventTrait;
+
+    use EventTrait;
 
     public const URLIZE_PATTERN_URL = <<<PATTERN
         ~(?<!href=['"])https?://[\w/._\-&?]*(?!</a>)(?=[^\w/._\-&])~s
@@ -16,7 +23,7 @@ PATTERN;
 
     protected string $urlBase;
 
-    protected string $appUrl;
+    protected array $appUrl;
 
     protected string $assetToken;
 
@@ -31,7 +38,7 @@ PATTERN;
     #[\Deprecated]
     protected bool $enforceExistingArguments = true;
 
-    public function __construct(string $urlBase = "", string $assetToken = "", string $appUrl = "", bool $forceSSL = false) {
+    public function __construct(string $urlBase = "", string $assetToken = "", array $appUrl = [], bool $forceSSL = false) {
         $this->urlBase = trim($urlBase, "/");
         $this->assetToken = $assetToken;
         $this->appUrl = $appUrl;
@@ -104,18 +111,22 @@ PATTERN;
 
     public function buildUrl(string $uri = "", array $parameters = [], bool $appendVersion = false) : string
     {
+        $this->eventExecute(UrlBuildUrlEvent::class, $uri, $parameters, $appendVersion);
+
         return $this->setUrlParameters($this->url() . "/" . ltrim($uri, "/"), $appendVersion ? array_replace([ 'v' => $this->assetToken ], $parameters) : $parameters);
     }
     
     public function buildAssetUrl(string $uri, array $parameters = [], bool $appendVersion = true) : string
     {
+        $this->eventExecute(UrlBuildAssetEvent::class, $uri, $parameters, $appendVersion);
+
         return $this->buildUrl($uri, $parameters, $appendVersion);
     }
 
     public function buildRouteUrl(string $name, array $parameters = [], bool $appendVersion = false) : string
     {
         if ( false !== ( $route = $this->routes[$name] ?? false ) ) {
-            return $this->buildUrl($this->prepareRoute($route['route'], $parameters), $parameters, $appendVersion);
+            return $this->buildUrl($this->prepareRoute($route, $parameters), $parameters, $appendVersion);
         }
 
         $routeList = json_encode($this->routes, \JSON_PRETTY_PRINT);
@@ -149,6 +160,8 @@ PATTERN;
             'class' => $class,
             'classMethod' => $method,
         ];
+
+        $this->eventExecute(UrlRegisterRouteEvent::class, $name, $this->routes[$name]);
     }
 
     /**
@@ -194,9 +207,25 @@ PATTERN;
 
     protected function domain() : string
     {
+        if ( ! empty($_SERVER['HTTP_X_FORWARDED_PROTO']) || ! empty($_SERVER['HTTP_X_FORWARDED_SSL']) ) {
+            $port = "";
+        }
+        else {
             $port = $this->isDefaultPort() ? "" : ":" . $_SERVER['SERVER_PORT'];
+        }
 
-        return strtolower($this->appUrl ? $this->appUrl . $port : $_SERVER['HTTP_HOST']);
+        return strtolower($this->appUrl($port) ?: $_SERVER['HTTP_HOST']);
+    }
+
+    protected function appUrl(string $port) : string
+    {
+        $domain = strtolower($_SERVER['HTTP_HOST']);
+
+        if (in_array($domain, $this->appUrl)) {
+            return $domain . $port;
+        }
+
+        return $this->appUrl[0] . $port;
     }
 
     protected function isDefaultPort() : bool
@@ -221,8 +250,10 @@ PATTERN;
             || ( "off" !== ( strtolower($_SERVER['HTTPS'] ?? $_SERVER['HTTP_X_FORWARDED_SSL'] ?? $_SERVER['X-Forwarded-Ssl'] ?? "off")) );
     }
 
-    protected function prepareRoute(string $route, array &$arguments)
+    protected function prepareRoute(array $routeParam, array &$arguments)
     {
+        $route = $routeParam['route'];
+
         if ( preg_match_all('~{(.*?)}~si', $route, $matches, PREG_SET_ORDER) ) {
             $search = [];
 
@@ -249,13 +280,12 @@ PATTERN;
                     if ($default ?? false) {
                         $value = $default;
                     }
-                    elseif ($this->enforceExistingArguments && ! strpos($route, sprintf('[/{%s:', $variable)) ) {
+                    elseif ( strpos($route, "[{$matches[0][0]}]") !== false && $this->enforceExistingArguments) {
-                        throw new \RuntimeException(sprintf("Error while preparing route %s : could not match variable '%s' into given arguments ( %s )", $route, $variable, json_encode($arguments)));
+                        throw new \RuntimeException(sprintf("Error while preparing route %s : could not match variable '%s' into given arguments ( %s ) from %s::%s", $route, $variable, json_encode($arguments), $routeParam['class'], $routeParam['classMethod']));
                     }
                 }
 
                 $search[$item[0]] = $value ?? "";
-
             }
 
             $route = str_replace(array_keys($search), array_values($search), $route);

src/Language/DefaultRegistrations.php

@@ -6,18 +6,11 @@ use Picea\Compiler;
 
 class DefaultRegistrations implements LanguageRegistration
 {
-    protected array $extensions;
+    public function __construct(
-    
+        protected array $extensions,
-    protected array $syntaxes;
+        protected array $syntaxes,
-    
+        protected array $controlStructures,
-    protected array $controlStructures;
+    ) { }
-
-    public function __construct(array $extensions = [], array $syntaxes = [], array $controlStructure = [])
-    {
-        $this->extensions = $extensions;
-        $this->syntaxes = $syntaxes;
-        $this->controlStructures = $controlStructure;
-    }
     
     public function registerAll(Compiler $compiler) : void
     {
@@ -67,6 +60,7 @@ class DefaultRegistrations implements LanguageRegistration
         $compiler->registerExtension(new \Picea\Extension\PhpExtension());
         $compiler->registerExtension(new \Picea\Extension\PrintExtension());
         $compiler->registerExtension(new \Picea\Extension\JsonExtension());
+        $compiler->registerExtension(new \Picea\Extension\BatchExtension());
 
         foreach($this->extensions ?? [] as $extension) {
             $compiler->registerExtension($extension);

src/Picea.php

@@ -43,7 +43,7 @@ class Picea implements LanguageRegistration
     ){
         $this->cache = $cache ?? new Caching\Memory("");
         $this->context = $context ?? new Compiler\BaseContext();
-        $this->languageRegistration = $languageRegistration ?? new Language\DefaultRegistrations();
+        $this->languageRegistration = $languageRegistration ?? new Language\DefaultRegistrations([], [], []);
         $this->builderTemplatePath = $builderTemplatePath ?? dirname(__FILE__) . static::DEFAULT_BUILDER_TEMPLATE;
         $this->compiler = $compiler ?? $this->instanciateCompiler();
         $this->fileFetcher = $fileFetcher ?? $this->instanciateFileFetcher();
@@ -79,7 +79,7 @@ class Picea implements LanguageRegistration
             #}
         }
 
-        exit();
+        return null;
     }
 
     /**