@vituum/vite-plugin-latte 2.0.0-next.4 → 2.0.0

package/vendor/latte/latte/src/Latte/Compiler/TokenStream.php

@@ -1,15 +1,14 @@
-<?php
+<?php declare(strict_types=1);
 
 /**
  * This file is part of the Latte (https://latte.nette.org)
  * Copyright (c) 2008 David Grudl (https://davidgrudl.com)
  */
 
-declare(strict_types=1);
-
 namespace Latte\Compiler;
 
 use Latte\CompileException;
+use function array_map, count, implode, is_int, is_string, trim;
 
 
 /**
@@ -20,13 +19,12 @@ final class TokenStream
 {
 	/** @var Token[] */
 	private array $tokens = [];
-	private \Iterator /*readonly*/ $source;
 	private int $index = 0;
 
 
-	public function __construct(\Iterator $source)
-	{
-		$this->source = $source;
+	public function __construct(
+		private readonly \Iterator $source,
+	) {
 	}
 
 
@@ -39,10 +37,19 @@ final class TokenStream
 	}
 
 
+	/**
+	 * Gets the token at $offset from the current position or throws.
+	 */
+	public function peek(int $offset = 0): Token
+	{
+		return $this->tryPeek($offset) ?? throw new CompileException('Unexpected end');
+	}
+
+
 	/**
 	 * Gets the token at $offset from the current position.
 	 */
-	public function peek(int $offset = 0): ?Token
+	public function tryPeek(int $offset = 0): ?Token
 	{
 		$pos = $this->index + $offset;
 		while ($pos >= 0 && !isset($this->tokens[$pos]) && $this->source->valid()) {
@@ -81,8 +88,8 @@ final class TokenStream
 	 */
 	public function tryConsume(int|string ...$kind): ?Token
 	{
-		$token = $this->peek();
-		if (!$token->is(...$kind)) {
+		$token = $this->tryPeek();
+		if (!$token?->is(...$kind)) {
 			return null;
 		} elseif (!$token->isEnd()) {
 			$this->index++;
@@ -114,11 +121,11 @@ final class TokenStream
 
 	/**
 	 * @throws CompileException
-	 * @return never
+	 * @param  array<string|int>  $expected
 	 */
-	public function throwUnexpectedException(array $expected = [], string $addendum = '', string $excerpt = ''): void
+	public function throwUnexpectedException(array $expected = [], string $addendum = '', string $excerpt = ''): never
 	{
-		$token = $this->peek()->text . $excerpt;
+		$token = ($this->tryPeek()->text ?? '') . $excerpt;
 		$expected = array_map(fn($item) => is_int($item) ? Token::Names[$item] : $item, $expected);
 		throw new CompileException(
 			'Unexpected '
@@ -129,7 +136,7 @@ final class TokenStream
 				? ', expecting ' . implode(', ', $expected)
 				: '')
 			. $addendum,
-			$this->peek()->position,
+			$this->tryPeek()?->position,
 		);
 	}
 }

package/vendor/latte/latte/src/Latte/ContentType.php

@@ -1,15 +1,16 @@
-<?php
+<?php declare(strict_types=1);
 
 /**
  * This file is part of the Latte (https://latte.nette.org)
  * Copyright (c) 2008 David Grudl (https://davidgrudl.com)
  */
 
-declare(strict_types=1);
-
 namespace Latte;
 
 
+/**
+ * Content type constants for context-aware escaping.
+ */
 /*enum*/ final class ContentType
 {
 	public const

package/vendor/latte/latte/src/Latte/Engine.php

@@ -1,15 +1,15 @@
-<?php
+<?php declare(strict_types=1);
 
 /**
  * This file is part of the Latte (https://latte.nette.org)
  * Copyright (c) 2008 David Grudl (https://davidgrudl.com)
  */
 
-declare(strict_types=1);
-
 namespace Latte;
 
 use Latte\Compiler\Nodes\TemplateNode;
+use function array_map, array_merge, class_exists, extension_loaded, get_debug_type, get_object_vars, is_array, preg_match, serialize, substr;
+use const PHP_VERSION_ID;
 
 
 /**
@@ -17,22 +17,31 @@ use Latte\Compiler\Nodes\TemplateNode;
  */
 class Engine
 {
-	public const Version = '3.0.20';
-	public const VersionId = 30020;
+	public const Version = '3.1.2';
+	public const VersionId = 30102;
 
 	/** @deprecated use Engine::Version */
 	public const
 		VERSION = self::Version,
 		VERSION_ID = self::VersionId;
 
-	/** @deprecated use ContentType::* */
-	public const
-		CONTENT_HTML = ContentType::Html,
-		CONTENT_XML = ContentType::Xml,
-		CONTENT_JS = ContentType::JavaScript,
-		CONTENT_CSS = ContentType::Css,
-		CONTENT_ICAL = ContentType::ICal,
-		CONTENT_TEXT = ContentType::Text;
+	#[\Deprecated('use Latte\ContentType::Html')]
+	public const CONTENT_HTML = ContentType::Html;
+
+	#[\Deprecated('use Latte\ContentType::Xml')]
+	public const CONTENT_XML = ContentType::Xml;
+
+	#[\Deprecated('use Latte\ContentType::JavaScript')]
+	public const CONTENT_JS = ContentType::JavaScript;
+
+	#[\Deprecated('use Latte\ContentType::Css')]
+	public const CONTENT_CSS = ContentType::Css;
+
+	#[\Deprecated('use Latte\ContentType::ICal')]
+	public const CONTENT_ICAL = ContentType::ICal;
+
+	#[\Deprecated('use Latte\ContentType::Text')]
+	public const CONTENT_TEXT = ContentType::Text;
 
 	private ?Loader $loader = null;
 	private Runtime\FilterExecutor $filters;
@@ -42,19 +51,24 @@ class Engine
 	/** @var Extension[] */
 	private array $extensions = [];
 	private string $contentType = ContentType::Html;
-	private ?string $tempDirectory = null;
-	private bool $autoRefresh = true;
-	private bool $strictTypes = false;
-	private bool $strictParsing = false;
+	private Runtime\Cache $cache;
+
+	/** @var array<string, bool> */
+	private array $features = [
+		Feature::StrictTypes->name => true,
+	];
+
 	private ?Policy $policy = null;
 	private bool $sandboxed = false;
 	private ?string $phpBinary = null;
-	private ?string $cacheKey;
+	private ?string $configurationHash;
 	private ?string $locale = null;
+	private ?string $syntax = null;
 
 
 	public function __construct()
 	{
+		$this->cache = new Runtime\Cache;
 		$this->filters = new Runtime\FilterExecutor;
 		$this->functions = new Runtime\FunctionExecutor;
 		$this->providers = new \stdClass;
@@ -91,14 +105,10 @@ class Engine
 	 * Creates template object.
 	 * @param  mixed[]  $params
 	 */
-	public function createTemplate(string $name, array $params = [], $clearCache = true): Runtime\Template
+	public function createTemplate(string $name, array $params = [], bool $clearCache = true): Runtime\Template
 	{
-		$this->cacheKey = $clearCache ? null : $this->cacheKey;
-		$class = $this->getTemplateClass($name);
-		if (!class_exists($class, false)) {
-			$this->loadTemplate($name);
-		}
-
+		$this->configurationHash = $clearCache ? null : $this->configurationHash;
+		$class = $this->loadTemplate($name);
 		$this->providers->fn = $this->functions;
 		return new $class(
 			$this,
@@ -148,7 +158,8 @@ class Engine
 	public function parse(string $template): TemplateNode
 	{
 		$parser = new Compiler\TemplateParser;
-		$parser->strict = $this->strictParsing;
+		$parser->getLexer()->setSyntax($this->syntax);
+		$parser->strict = $this->hasFeature(Feature::StrictParsing);
 
 		foreach ($this->extensions as $extension) {
 			$extension->beforeCompile($this);
@@ -186,12 +197,8 @@ class Engine
 	public function generate(TemplateNode $node, string $name): string
 	{
 		$generator = new Compiler\TemplateGenerator;
-		return $generator->generate(
-			$node,
-			$this->getTemplateClass($name),
-			$name,
-			$this->strictTypes,
-		);
+		$generator->buildClass($node, $this->features);
+		return $generator->generateCode($this->getTemplateClass($name), $name, $this->hasFeature(Feature::StrictTypes));
 	}
 
 
@@ -201,157 +208,77 @@ class Engine
 	 */
 	public function warmupCache(string $name): void
 	{
-		if (!$this->tempDirectory) {
+		if (!$this->cache->directory) {
 			throw new \LogicException('Path to temporary directory is not set.');
 		}
 
-		$class = $this->getTemplateClass($name);
-		if (!class_exists($class, false)) {
-			$this->loadTemplate($name);
-		}
+		$this->loadTemplate($name);
 	}
 
 
-	private function loadTemplate(string $name): void
+	/** @return class-string<Runtime\Template> */
+	private function loadTemplate(string $name): string
 	{
-		if (!$this->tempDirectory) {
+		$class = $this->getTemplateClass($name);
+		if (class_exists($class, autoload: false)) {
+			// nothing
+		} elseif ($this->cache->directory) {
+			$this->cache->loadOrCreate($this, $name);
+		} else {
 			$compiled = $this->compile($name);
 			if (@eval(substr($compiled, 5)) === false) { // @ is escalated to exception, substr removes <?php
-				throw (new CompileException('Error in template: ' . error_get_last()['message']))
+				throw (new CompileException('Error in template: ' . (error_get_last()['message'] ?? '')))
 					->setSource($compiled, "$name (compiled)");
 			}
-
-			return;
-		}
-
-		// Solving atomicity to work everywhere is really pain in the ass.
-		// 1) We want to do as little as possible IO calls on production and also directory and file can be not writable
-		// so on Linux we include the file directly without shared lock, therefore, the file must be created atomically by renaming.
-		// 2) On Windows file cannot be renamed-to while is open (ie by include), so we have to acquire a lock.
-		$cacheFile = $this->getCacheFile($name);
-		$cacheKey = $this->autoRefresh
-			? md5(serialize($this->getCacheSignature($name)))
-			: null;
-		$lock = defined('PHP_WINDOWS_VERSION_BUILD') || $this->autoRefresh
-			? $this->acquireLock("$cacheFile.lock", LOCK_SH)
-			: null;
-
-		if (
-			!($this->autoRefresh && $cacheKey !== stream_get_contents($lock))
-			&& (@include $cacheFile) !== false // @ - file may not exist
-		) {
-			return;
-		}
-
-		if ($lock) {
-			flock($lock, LOCK_UN); // release shared lock so we can get exclusive
-			fseek($lock, 0);
-		}
-
-		$lock = $this->acquireLock("$cacheFile.lock", LOCK_EX);
-
-		// while waiting for exclusive lock, someone might have already created the cache
-		if (!is_file($cacheFile) || ($this->autoRefresh && $cacheKey !== stream_get_contents($lock))) {
-			$compiled = $this->compile($name);
-			if (
-				file_put_contents("$cacheFile.tmp", $compiled) !== strlen($compiled)
-				|| !rename("$cacheFile.tmp", $cacheFile)
-			) {
-				@unlink("$cacheFile.tmp"); // @ - file may not exist
-				throw new RuntimeException("Unable to create '$cacheFile'.");
-			}
-
-			fseek($lock, 0);
-			fwrite($lock, $cacheKey ?? md5(serialize($this->getCacheSignature($name))));
-			ftruncate($lock, ftell($lock));
-
-			if (function_exists('opcache_invalidate')) {
-				@opcache_invalidate($cacheFile, true); // @ can be restricted
-			}
-		}
-
-		if ((include $cacheFile) === false) {
-			throw new RuntimeException("Unable to load '$cacheFile'.");
 		}
-
-		flock($lock, LOCK_UN);
+		return $class;
 	}
 
 
 	/**
-	 * @return resource
+	 * Returns the file path where compiled template will be cached.
 	 */
-	private function acquireLock(string $file, int $mode)
-	{
-		$dir = dirname($file);
-		if (!is_dir($dir) && !@mkdir($dir) && !is_dir($dir)) { // @ - dir may already exist
-			throw new RuntimeException("Unable to create directory '$dir'. " . error_get_last()['message']);
-		}
-
-		$handle = @fopen($file, 'c+'); // @ is escalated to exception
-		if (!$handle) {
-			throw new RuntimeException("Unable to create file '$file'. " . error_get_last()['message']);
-		} elseif (!@flock($handle, $mode)) { // @ is escalated to exception
-			throw new RuntimeException('Unable to acquire ' . ($mode & LOCK_EX ? 'exclusive' : 'shared') . " lock on file '$file'. " . error_get_last()['message']);
-		}
-
-		return $handle;
-	}
-
-
 	public function getCacheFile(string $name): string
 	{
-		$base = preg_match('#([/\\\\][\w@.-]{3,35}){1,3}$#D', '/' . $name, $m)
-			? preg_replace('#[^\w@.-]+#', '-', substr($m[0], 1)) . '--'
-			: '';
-		return $this->tempDirectory . '/' . $base . $this->generateCacheHash($name) . '.php';
+		return $this->cache->generateFilePath($this, $name);
 	}
 
 
+	/**
+	 * Returns the PHP class name for compiled template.
+	 */
 	public function getTemplateClass(string $name): string
 	{
-		return 'Template_' . $this->generateCacheHash($name);
-	}
-
-
-	private function generateCacheHash(string $name): string
-	{
-		$this->cacheKey ??= md5(serialize($this->getCacheKey()));
-		$hash = $this->cacheKey . $this->getLoader()->getUniqueId($name);
-		return substr(md5($hash), 0, 10);
+		return 'Template_' . $this->generateTemplateHash($name);
 	}
 
 
 	/**
-	 * Values that affect the results of compilation and the name of the cache file.
+	 * Generates unique hash for template based on current configuration.
+	 * Used to create isolated cache files for different engine configurations.
+	 * @internal
 	 */
-	protected function getCacheKey(): array
+	public function generateTemplateHash(string $name): string
 	{
-		return [
-			$this->contentType,
-			array_keys($this->getFunctions()),
-			array_map(
-				fn($extension) => [
-					get_debug_type($extension),
-					$extension->getCacheKey($this),
-					filemtime((new \ReflectionObject($extension))->getFileName()),
-				],
-				$this->extensions,
-			),
-		];
+		$hash = $this->configurationHash ?? hash('xxh128', serialize($this->generateConfigurationSignature()));
+		$hash .= $this->getLoader()->getUniqueId($name);
+		return substr(hash('xxh128', $hash), 0, 10);
 	}
 
 
 	/**
-	 * Values that check the expiration of the compiled template.
+	 * Returns values that determine isolation for different configurations.
+	 * When any of these values change, a new compiled template is created to avoid conflicts.
+	 * @return list<mixed>
 	 */
-	protected function getCacheSignature(string $name): array
+	protected function generateConfigurationSignature(): array
 	{
 		return [
-			self::Version,
-			$this->getLoader()->getContent($name),
+			$this->contentType,
+			$this->features,
+			$this->syntax,
 			array_map(
-				fn($extension) => filemtime((new \ReflectionObject($extension))->getFileName()),
+				fn($extension) => [get_debug_type($extension), $extension->getCacheKey($this)],
 				$this->extensions,
 			),
 		];
@@ -372,11 +299,10 @@ class Engine
 	}
 
 
-	/**
-	 * Registers filter loader.
-	 */
+	#[\Deprecated('Use addFilter() instead.')]
 	public function addFilterLoader(callable $loader): static
 	{
+		trigger_error('Filter loader is deprecated, use addFilter() instead.', E_USER_DEPRECATED);
 		$this->filters->add(null, $loader);
 		return $this;
 	}
@@ -384,7 +310,7 @@ class Engine
 
 	/**
 	 * Returns all run-time filters.
-	 * @return callable[]
+	 * @return array<string, callable>
 	 */
 	public function getFilters(): array
 	{
@@ -423,10 +349,10 @@ class Engine
 	}
 
 
-	/** @return Extension[] */
+	/** @return list<Extension> */
 	public function getExtensions(): array
 	{
-		return $this->extensions;
+		return array_values($this->extensions);
 	}
 
 
@@ -455,7 +381,7 @@ class Engine
 
 
 	/**
-	 * @return callable[]
+	 * @return array<string, callable>
 	 */
 	public function getFunctions(): array
 	{
@@ -479,7 +405,7 @@ class Engine
 
 	/**
 	 * Returns all providers.
-	 * @return mixed[]
+	 * @return array<string, mixed>
 	 */
 	public function getProviders(): array
 	{
@@ -504,7 +430,7 @@ class Engine
 
 	public function setExceptionHandler(callable $handler): static
 	{
-		$this->providers->coreExceptionHandler = $handler;
+		$this->providers->coreExceptionHandler = $handler(...);
 		return $this;
 	}
 
@@ -524,45 +450,72 @@ class Engine
 
 
 	/**
-	 * Sets path to temporary directory.
+	 * Sets path to cache directory.
 	 */
-	public function setTempDirectory(?string $path): static
+	public function setCacheDirectory(?string $path): static
 	{
-		$this->tempDirectory = $path;
+		$this->cache->directory = $path;
 		return $this;
 	}
 
 
+	/** @deprecated use setCacheDirectory() instead */
+	public function setTempDirectory(?string $path): static
+	{
+		return $this->setCacheDirectory($path);
+	}
+
+
 	/**
 	 * Sets auto-refresh mode.
 	 */
 	public function setAutoRefresh(bool $state = true): static
 	{
-		$this->autoRefresh = $state;
+		$this->cache->autoRefresh = $state;
+		return $this;
+	}
+
+
+	/**
+	 * Enables or disables an engine feature.
+	 */
+	public function setFeature(Feature $feature, bool $state = true): static
+	{
+		$this->features[$feature->name] = $state;
 		return $this;
 	}
 
 
+	/**
+	 * Checks if a feature is enabled.
+	 */
+	public function hasFeature(Feature $feature): bool
+	{
+		return $this->features[$feature->name] ?? false;
+	}
+
+
 	/**
 	 * Enables declare(strict_types=1) in templates.
+	 * @deprecated use setFeature(Feature::StrictTypes, ...) instead
 	 */
 	public function setStrictTypes(bool $state = true): static
 	{
-		$this->strictTypes = $state;
-		return $this;
+		return $this->setFeature(Feature::StrictTypes, $state);
 	}
 
 
+	/** @deprecated use setFeature(Feature::StrictParsing, ...) instead */
 	public function setStrictParsing(bool $state = true): static
 	{
-		$this->strictParsing = $state;
-		return $this;
+		return $this->setFeature(Feature::StrictParsing, $state);
 	}
 
 
+	/** @deprecated use hasFeature(Feature::StrictParsing) instead */
 	public function isStrictParsing(): bool
 	{
-		return $this->strictParsing;
+		return $this->hasFeature(Feature::StrictParsing);
 	}
 
 
@@ -605,9 +558,26 @@ class Engine
 	}
 
 
+	/**
+	 * Sets default Latte syntax. Available options: 'single', 'double', 'off'
+	 */
+	public function setSyntax(string $syntax): static
+	{
+		$this->syntax = $syntax;
+		return $this;
+	}
+
+
+	/** @deprecated use setFeature(Feature::MigrationWarnings, ...) instead */
+	public function setMigrationWarnings(bool $state = true): static
+	{
+		return $this->setFeature(Feature::MigrationWarnings, $state);
+	}
+
+
 	/**
 	 * @param  object|mixed[]  $params
-	 * @return mixed[]
+	 * @return array<string, mixed>
 	 */
 	private function processParams(object|array $params): array
 	{
@@ -615,39 +585,28 @@ class Engine
 			return $params;
 		}
 
-		$methods = (new \ReflectionClass($params))->getMethods(\ReflectionMethod::IS_PUBLIC);
+		$rc = new \ReflectionClass($params);
+		$methods = $rc->getMethods(\ReflectionMethod::IS_PUBLIC);
 		foreach ($methods as $method) {
 			if ($method->getAttributes(Attributes\TemplateFilter::class)) {
-				$this->addFilter($method->name, [$params, $method->name]);
+				$this->addFilter($method->name, $method->getClosure($params));
 			}
 
 			if ($method->getAttributes(Attributes\TemplateFunction::class)) {
-				$this->addFunction($method->name, [$params, $method->name]);
-			}
-
-			if (strpos((string) $method->getDocComment(), '@filter')) {
-				trigger_error('Annotation @filter is deprecated, use attribute #[Latte\Attributes\TemplateFilter]', E_USER_DEPRECATED);
-				$this->addFilter($method->name, [$params, $method->name]);
+				$this->addFunction($method->name, $method->getClosure($params));
 			}
+		}
 
-			if (strpos((string) $method->getDocComment(), '@function')) {
-				trigger_error('Annotation @function is deprecated, use attribute #[Latte\Attributes\TemplateFunction]', E_USER_DEPRECATED);
-				$this->addFunction($method->name, [$params, $method->name]);
+		$res = get_object_vars($params);
+		if (PHP_VERSION_ID >= 80400) {
+			foreach ($rc->getProperties(\ReflectionProperty::IS_PUBLIC) as $property) {
+				if ($property->isVirtual() && $property->hasHook(\PropertyHookType::Get)) {
+					$name = $property->getName();
+					$res[$name] = $params->$name;
+				}
 			}
 		}
 
-		return array_filter((array) $params, fn($key) => $key[0] !== "\0", ARRAY_FILTER_USE_KEY);
-	}
-
-
-	public function __get(string $name)
-	{
-		if ($name === 'onCompile') {
-			$trace = debug_backtrace(0)[0];
-			$loc = isset($trace['file'], $trace['line'])
-				? ' (in ' . $trace['file'] . ' on ' . $trace['line'] . ')'
-				: '';
-			throw new \LogicException('You use Latte 3 together with the code designed for Latte 2' . $loc);
-		}
+		return $res;
 	}
 }

package/vendor/latte/latte/src/Latte/Essential/AuxiliaryIterator.php

@@ -1,14 +1,14 @@
-<?php
+<?php declare(strict_types=1);
 
 /**
  * This file is part of the Latte (https://latte.nette.org)
  * Copyright (c) 2008 David Grudl (https://davidgrudl.com)
  */
 
-declare(strict_types=1);
-
 namespace Latte\Essential;
 
+use function count;
+
 
 /**
  * Iterates over key-value pairs.
@@ -19,11 +19,9 @@ namespace Latte\Essential;
  */
 class AuxiliaryIterator implements \IteratorAggregate, \Countable
 {
-	/**
-	 * @param  array<array{K, V}>  $pairs
-	 */
 	public function __construct(
-		private array $pairs,
+		/** @var  array<array{K, V}> */
+		private readonly array $pairs,
 	) {
 	}