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

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

@@ -1,21 +1,21 @@
-<?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 Latte;
 use Latte\Compiler\NodeHelpers;
 use Latte\Compiler\Nodes\Php;
+use Latte\Compiler\Nodes\Php\ExpressionNode;
+use Latte\Compiler\Nodes\PrintNode;
 use Latte\Compiler\Tag;
 use Latte\Engine;
-use Latte\Essential\Nodes\PrintNode;
 use Nette\Localization\Translator;
+use function array_unshift, is_array, is_string;
 
 
 /**
@@ -23,25 +23,25 @@ use Nette\Localization\Translator;
  */
 final class TranslatorExtension extends Latte\Extension
 {
-	/** @var callable|Translator|null */
-	private $translator;
+	private ?\Closure $translator;
 
 
 	public function __construct(
 		callable|Translator|null $translator,
 		private ?string $key = null,
 	) {
-		$this->translator = $translator;
-		if ($translator instanceof Translator) {
-			$this->translator = [$translator, 'translate'];
-		}
+		$this->translator = match (true) {
+			$translator === null => null,
+			$translator instanceof Translator => $translator->translate(...),
+			default => $translator(...),
+		};
 	}
 
 
 	public function getTags(): array
 	{
 		return [
-			'_' => [$this, 'parseTranslate'],
+			'_' => $this->parseTranslate(...),
 			'translate' => fn(Tag $tag) => yield from Nodes\TranslateNode::create($tag, $this->key ? $this->translator : null),
 		];
 	}
@@ -66,7 +66,7 @@ final class TranslatorExtension extends Latte\Extension
 	/**
 	 * {_ ...}
 	 */
-	public function parseTranslate(Tag $tag): PrintNode
+	private function parseTranslate(Tag $tag): PrintNode
 	{
 		$tag->outputMode = $tag::OutputKeepIndentation;
 		$tag->expectArguments();
@@ -78,7 +78,7 @@ final class TranslatorExtension extends Latte\Extension
 		}
 
 		$node->modifier = $tag->parser->parseModifier();
-		$node->modifier->escape = true;
+		$node->modifier->escape = !$node->modifier->removeFilter('noescape');
 
 		if ($this->translator
 			&& $this->key
@@ -95,7 +95,7 @@ final class TranslatorExtension extends Latte\Extension
 	}
 
 
-	public static function toValue($args): mixed
+	public static function toValue(ExpressionNode $args): mixed
 	{
 		try {
 			return NodeHelpers::toValue($args, constants: true);

package/vendor/latte/latte/src/Latte/Extension.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;
 
+use function get_defined_vars;
+
 
 /**
  * Latte extension.
@@ -16,7 +16,7 @@ namespace Latte;
 abstract class Extension
 {
 	/**
-	 * Initializes before template is compiler.
+	 * Initializes before template is compiled.
 	 */
 	public function beforeCompile(Engine $engine): void
 	{
@@ -34,7 +34,7 @@ abstract class Extension
 
 
 	/**
-	 * Returns a list of parsers for Latte tags.
+	 * Returns a list of compiler passes.
 	 * @return array<string, callable(Compiler\Nodes\TemplateNode): void|\stdClass>
 	 */
 	public function getPasses(): array
@@ -65,7 +65,7 @@ abstract class Extension
 
 	/**
 	 * Returns a list of providers.
-	 * @return array<mixed>
+	 * @return array<string, mixed>
 	 */
 	public function getProviders(): array
 	{
@@ -90,8 +90,14 @@ abstract class Extension
 	}
 
 
+	/**
+	 * Wraps callable with ordering metadata for tags and passes.
+	 * @param  array<string>|string  $before
+	 * @param  array<string>|string  $after
+	 */
 	public static function order(callable $subject, array|string $before = [], array|string $after = []): \stdClass
 	{
+		$subject = $subject(...);
 		return (object) get_defined_vars();
 	}
 }

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

@@ -0,0 +1,24 @@
+<?php declare(strict_types=1);
+
+/**
+ * This file is part of the Latte (https://latte.nette.org)
+ * Copyright (c) 2008 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Latte;
+
+
+/**
+ * Latte engine feature flags.
+ */
+enum Feature
+{
+	/** Adds declare(strict_types=1) to compiled templates (enabled by default) */
+	case StrictTypes;
+
+	/** Enforces strict HTML parsing */
+	case StrictParsing;
+
+	/** Shows warnings for deprecated Latte 3.0 syntax */
+	case MigrationWarnings;
+}

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

@@ -1,14 +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 function array_filter, array_keys, array_search, array_slice, array_unique, count, is_array, is_object, is_string, levenshtein, max, min, strlen, strpos;
+use const PHP_VERSION_ID;
+
 
 /**
  * Latte helpers.
@@ -16,13 +17,6 @@ namespace Latte;
  */
 class Helpers
 {
-	/** @var array<string, int>  empty (void) HTML elements */
-	public static array $emptyElements = [
-		'img' => 1, 'hr' => 1, 'br' => 1, 'input' => 1, 'meta' => 1, 'area' => 1, 'embed' => 1, 'keygen' => 1, 'source' => 1, 'base' => 1,
-		'col' => 1, 'link' => 1, 'param' => 1, 'basefont' => 1, 'frame' => 1, 'isindex' => 1, 'wbr' => 1, 'command' => 1, 'track' => 1,
-	];
-
-
 	/**
 	 * Finds the best suggestion.
 	 * @param  string[]  $items
@@ -43,7 +37,7 @@ class Helpers
 
 
 	/** intentionally without callable typehint, because it generates bad error messages */
-	public static function toReflection($callable): \ReflectionFunctionAbstract
+	public static function toReflection(mixed $callable): \ReflectionFunctionAbstract
 	{
 		if (is_string($callable) && strpos($callable, '::')) {
 			return PHP_VERSION_ID < 80300
@@ -59,6 +53,10 @@ class Helpers
 	}
 
 
+	/**
+	 * @param  array<string, mixed|\stdClass>  $list
+	 * @return array<string, mixed|\stdClass>
+	 */
 	public static function sortBeforeAfter(array $list): array
 	{
 		foreach ($list as $name => $info) {
@@ -74,7 +72,7 @@ class Helpers
 				if ($target === '*') {
 					$best = 0;
 				} elseif (isset($list[$target])) {
-					$pos = array_search($target, $names, true);
+					$pos = (int) array_search($target, $names, strict: true);
 					$best = min($pos, $best ?? $pos);
 				}
 			}
@@ -83,16 +81,68 @@ class Helpers
 				if ($target === '*') {
 					$best = count($names);
 				} elseif (isset($list[$target])) {
-					$pos = array_search($target, $names, true);
+					$pos = (int) array_search($target, $names, strict: true);
 					$best = max($pos + 1, $best);
 				}
 			}
 
-			$list = array_slice($list, 0, $best, true)
+			$best ??= count($names);
+			$list = array_slice($list, 0, $best, preserve_keys: true)
 				+ [$name => $info]
-				+ array_slice($list, $best, null, true);
+				+ array_slice($list, $best, null, preserve_keys: true);
 		}
 
 		return $list;
 	}
+
+
+	/** @param  mixed[]  $items */
+	public static function removeNulls(array &$items): void
+	{
+		$items = array_values(array_filter($items, fn($item) => $item !== null));
+	}
+
+
+	/**
+	 * Attempts to map the compiled template to the source.
+	 * @return array{name: ?string, line: ?int, column: ?int}|null
+	 */
+	public static function mapCompiledToSource(string $compiledFile, ?int $compiledLine = null): ?array
+	{
+		if (!Runtime\Cache::isCacheFile($compiledFile)) {
+			return null;
+		}
+
+		$content = file_get_contents($compiledFile);
+		if ($content === false) {
+			return null;
+		}
+		$name = preg_match('#^/\*\* source: (\S.+) \*/#m', $content, $m) ? $m[1] : null;
+		$compiledLine && preg_match('~/\* pos (\d+)(?::(\d+))? \*/~', explode("\n", $content)[$compiledLine - 1], $pos);
+		$line = isset($pos[1]) ? (int) $pos[1] : null;
+		$column = isset($pos[2]) ? (int) $pos[2] : null;
+		return $name || $line ? compact('name', 'line', 'column') : null;
+	}
+
+
+	/**
+	 * Tries to guess the position in the template from the backtrace
+	 */
+	public static function guessTemplatePosition(): ?string
+	{
+		$trace = debug_backtrace();
+		foreach ($trace as $item) {
+			if (isset($item['file']) && ($source = self::mapCompiledToSource($item['file'], $item['line'] ?? null))) {
+				$res = [];
+				if ($source['name'] && is_file($source['name'])) {
+					$res[] = "in '" . str_replace(dirname($source['name'], 2), '...', $source['name']) . "'";
+				}
+				if ($source['line']) {
+					$res[] = 'on line ' . $source['line'] . ($source['column'] ? ' at column ' . $source['column'] : '');
+				}
+				return implode(' ', $res);
+			}
+		}
+		return null;
+	}
 }

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

@@ -1,12 +1,10 @@
-<?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;
 
 
@@ -20,12 +18,6 @@ interface Loader
 	 */
 	function getContent(string $name): string;
 
-	/**
-	 * Checks whether template is expired.
-	 * @deprecated
-	 */
-	function isExpired(string $name, int $time): bool;
-
 	/**
 	 * Returns referred template name.
 	 */

package/vendor/latte/latte/src/Latte/Loaders/FileLoader.php

@@ -1,19 +1,19 @@
-<?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\Loaders;
 
 use Latte;
+use function array_pop, end, explode, file_get_contents, implode, is_file, preg_match, str_starts_with, strtr;
+use const DIRECTORY_SEPARATOR;
 
 
 /**
- * Template loader.
+ * Loads templates from filesystem.
  */
 class FileLoader implements Latte\Loader
 {
@@ -36,21 +36,15 @@ class FileLoader implements Latte\Loader
 			throw new Latte\RuntimeException("Template '$file' is not within the allowed path '{$this->baseDir}'.");
 
 		} elseif (!is_file($file)) {
-			throw new Latte\RuntimeException("Missing template file '$file'.");
-
-		} elseif ($this->isExpired($fileName, time())) {
-			if (@touch($file) === false) {
-				trigger_error("File's modification time is in the future. Cannot update it: " . error_get_last()['message'], E_USER_WARNING);
-			}
+			throw new Latte\TemplateNotFoundException("Missing template file '$file'.");
 		}
 
-		return file_get_contents($file);
-	}
-
+		$content = file_get_contents($file);
+		if ($content === false) {
+			throw new Latte\RuntimeException("Unable to read file '$file'.");
+		}
 
-	public function isExpired(string $file, int $time): bool
-	{
-		return false;
+		return $content;
 	}
 
 
@@ -59,7 +53,7 @@ class FileLoader implements Latte\Loader
 	 */
 	public function getReferredName(string $file, string $referringFile): string
 	{
-		if ($this->baseDir || !preg_match('#/|\\\\|[a-z]:|phar:#iA', $file)) {
+		if ($this->baseDir || !preg_match('#/|\\\|[a-z]:|phar:#iA', $file)) {
 			$file = $this->normalizePath($referringFile . '/../' . $file);
 		}
 

package/vendor/latte/latte/src/Latte/Loaders/StringLoader.php

@@ -1,12 +1,10 @@
-<?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\Loaders;
 
 use Latte;
@@ -17,16 +15,10 @@ use Latte;
  */
 class StringLoader implements Latte\Loader
 {
-	/** @var string[]|null  [name => content] */
-	private ?array $templates = null;
-
-
-	/**
-	 * @param  string[]  $templates
-	 */
-	public function __construct(?array $templates = null)
-	{
-		$this->templates = $templates;
+	public function __construct(
+		/** @var array<string, string>|null */
+		private ?array $templates = null,
+	) {
 	}
 
 
@@ -40,24 +32,18 @@ class StringLoader implements Latte\Loader
 		} elseif (isset($this->templates[$name])) {
 			return $this->templates[$name];
 		} else {
-			throw new Latte\RuntimeException("Missing template '$name'.");
+			throw new Latte\TemplateNotFoundException("Missing template '$name'.");
 		}
 	}
 
 
-	public function isExpired(string $name, int $time): bool
-	{
-		return false;
-	}
-
-
 	/**
 	 * Returns referred template name.
 	 */
 	public function getReferredName(string $name, string $referringName): string
 	{
 		if ($this->templates === null) {
-			throw new \LogicException("Missing template '$name'.");
+			throw new Latte\TemplateNotFoundException("Missing template '$name'.");
 		}
 
 		return $name;

package/vendor/latte/latte/src/Latte/Policy.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;
 
 
+/**
+ * Security policy for sandbox mode.
+ */
 interface Policy
 {
 	function isTagAllowed(string $tag): bool;

package/vendor/latte/latte/src/Latte/Runtime/Block.php

@@ -1,12 +1,10 @@
-<?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\Runtime;
 
 
@@ -15,6 +13,6 @@ final class Block
 {
 	public ?string $contentType = null;
 
-	/** @var callable[] */
+	/** @var \Closure[] */
 	public array $functions = [];
 }

package/vendor/latte/latte/src/Latte/Runtime/Cache.php

@@ -0,0 +1,143 @@
+<?php declare(strict_types=1);
+
+/**
+ * This file is part of the Latte (https://latte.nette.org)
+ * Copyright (c) 2008 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Latte\Runtime;
+
+use Latte\Engine;
+use Latte\RuntimeException;
+use function array_map, defined, dirname, file_put_contents, filemtime, flock, fopen, fseek, ftell, ftruncate, function_exists, fwrite, is_dir, is_file, mkdir, preg_match, preg_replace, rename, serialize, stream_get_contents, strlen, substr, unlink;
+use const LOCK_EX, LOCK_SH, LOCK_UN;
+
+
+/**
+ * Caching of compiled templates.
+ * @internal
+ */
+final class Cache
+{
+	public ?string $directory = null;
+	public bool $autoRefresh = true;
+
+
+	/**
+	 * Loads existing cache or compiles template if needed.
+	 * Uses file locking to ensure atomic operations and prevent race conditions.
+	 */
+	public function loadOrCreate(Engine $engine, string $name): void
+	{
+		// 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.
+		$file = $this->generateFilePath($engine, $name);
+		$signature = $this->autoRefresh
+			? hash('xxh128', serialize($this->generateRefreshSignature($engine, $name)))
+			: null;
+		$lock = defined('PHP_WINDOWS_VERSION_BUILD') || $signature
+			? $this->acquireLock("$file.lock", LOCK_SH)
+			: null;
+
+		if (
+			!($signature && $lock && $signature !== stream_get_contents($lock))
+			&& (@include $file) !== 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("$file.lock", LOCK_EX);
+
+		// while waiting for exclusive lock, someone might have already created the cache
+		if (!is_file($file) || ($signature && $signature !== stream_get_contents($lock))) {
+			$compiled = $engine->compile($name);
+			if (
+				file_put_contents("$file.tmp", $compiled) !== strlen($compiled)
+				|| !rename("$file.tmp", $file)
+			) {
+				@unlink("$file.tmp"); // @ - file may not exist
+				throw new RuntimeException("Unable to create '$file'.");
+			}
+
+			fseek($lock, 0);
+			fwrite($lock, $signature ?? hash('xxh128', serialize($this->generateRefreshSignature($engine, $name))));
+			ftruncate($lock, (int) ftell($lock));
+
+			if (function_exists('opcache_invalidate')) {
+				@opcache_invalidate($file, force: true); // @ can be restricted
+			}
+		}
+
+		if ((include $file) === false) {
+			throw new RuntimeException("Unable to load '$file'.");
+		}
+
+		flock($lock, LOCK_UN);
+	}
+
+
+	/** @return resource */
+	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;
+	}
+
+
+	/**
+	 * Returns the file path where compiled template will be cached.
+	 * Different configurations produce different file paths.
+	 */
+	public function generateFilePath(Engine $engine, string $name): string
+	{
+		$base = preg_match('#([/\\\][\w@.-]{3,35}){1,3}$#D', '/' . $name, $m)
+			? preg_replace('#[^\w@.-]+#', '-', substr($m[0], 1))
+			: '';
+		if (!str_ends_with($base, 'latte')) {
+			$base .= '-latte';
+		}
+		return $this->directory . '/' . $base . '--' . $engine->generateTemplateHash($name) . '.php';
+	}
+
+
+	public static function isCacheFile(string $file): bool
+	{
+		return (bool) preg_match('/latte--\w{10}\.php$/', $file);
+	}
+
+
+	/**
+	 * Returns values used to detect if cached template needs recompilation when autoRefresh is enabled.
+	 * Triggers recompilation when template code, Latte engine, or any extension changes.
+	 * @return list<mixed>
+	 */
+	protected function generateRefreshSignature(Engine $engine, string $name): array
+	{
+		return [
+			Engine::Version,
+			$engine->getLoader()->getContent($name),
+			array_map(
+				fn($extension) => @filemtime((string) (new \ReflectionObject($extension))->getFileName()), // @ file may not exist
+				$engine->getExtensions(),
+			),
+		];
+	}
+}

package/vendor/latte/latte/src/Latte/Runtime/FilterExecutor.php

@@ -1,17 +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\Runtime;
 
 use Latte;
 use Latte\ContentType;
 use Latte\Helpers;
+use function array_column, array_combine, array_keys, array_unshift, strtoupper;
 
 
 /**
@@ -21,7 +20,7 @@ use Latte\Helpers;
 #[\AllowDynamicProperties]
 class FilterExecutor
 {
-	/** @var callable[] */
+	/** @var array<callable> */
 	private array $_dynamic = [];
 
 	/** @var array<string, array{callable, ?bool}> */
@@ -46,7 +45,7 @@ class FilterExecutor
 
 	/**
 	 * Returns all run-time filters.
-	 * @return callable[]
+	 * @return array<string, callable>
 	 */
 	public function getAll(): array
 	{
@@ -117,7 +116,7 @@ class FilterExecutor
 		$hint = ($t = Helpers::getSuggestion(array_keys($this->_static), $name))
 			? ", did you mean '$t'?"
 			: '.';
-		throw new \LogicException("Filter '$name' is not defined$hint");
+		throw new \LogicException("Filter '$name' is not defined or not allowed here$hint");
 	}