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

package/vendor/latte/latte/src/Latte/exceptions.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;
 
 
@@ -18,6 +16,43 @@ interface Exception
 }
 
 
+/**
+ * @internal
+ */
+trait PositionAwareException
+{
+	public ?string $sourceCode = null;
+	public ?string $sourceName = null;
+	public ?Compiler\Position $position = null;
+	private string $origMessage;
+
+
+	public function setSource(string $code, ?string $name = null): self
+	{
+		$this->sourceCode = $code;
+		$this->sourceName = $name;
+		$this->generateMessage();
+		return $this;
+	}
+
+
+	private function generateMessage(): void
+	{
+		$this->origMessage ??= $this->message;
+		$info = [];
+		if ($this->sourceName && @is_file($this->sourceName)) { // @ - may trigger error
+			$info[] = "in '" . str_replace(dirname($this->sourceName, 2), '...', $this->sourceName) . "'";
+		}
+		if ($this->position) {
+			$info[] = $this->position;
+		}
+		$this->message = $info
+			? rtrim($this->origMessage, '.') . ' (' . implode(' ', $info) . ')'
+			: $this->origMessage;
+	}
+}
+
+
 /**
  * Template compilation failed.
  */

package/vendor/latte/latte/src/Tools/Linter.php

@@ -1,29 +1,31 @@
-<?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\Tools;
 
 use Latte;
 use Nette;
 use function in_array, strlen;
-use const PHP_BINARY, STDERR;
+use const DIRECTORY_SEPARATOR, PHP_BINARY, STDERR;
 
 
+/**
+ * Validates Latte template syntax.
+ */
 final class Linter
 {
+	/** @var string[] */
 	public array $excludedDirs = ['.*', '*.tmp', 'temp', 'vendor', 'node_modules'];
 
 
 	public function __construct(
 		private ?Latte\Engine $engine = null,
-		private bool $debug = false,
-		private bool $strict = false,
+		private readonly bool $debug = false,
+		private readonly bool $strict = false,
 	) {
 	}
 
@@ -61,7 +63,7 @@ final class Linter
 	{
 		$engine = new Latte\Engine;
 		$engine->enablePhpLinter(PHP_BINARY);
-		$engine->setStrictParsing($this->strict);
+		$engine->setFeature(Latte\Feature::StrictParsing, $this->strict);
 		$engine->addExtension(new Latte\Essential\TranslatorExtension(null));
 
 		if (class_exists(Nette\Bridges\ApplicationLatte\UIExtension::class)) {
@@ -95,12 +97,12 @@ final class Linter
 
 	public function lintLatte(string $file): bool
 	{
-		set_error_handler(function (int $severity, string $message) use ($file) {
-			if (in_array($severity, [E_USER_DEPRECATED, E_USER_WARNING, E_USER_NOTICE], true)) {
+		set_error_handler(function (int $severity, string $message, string $errFile = '', int $errLine = 0) use ($file): bool {
+			if (in_array($severity, [E_USER_DEPRECATED, E_USER_WARNING, E_USER_NOTICE], strict: true)) {
 				$pos = preg_match('~on line (\d+)~', $message, $m) ? ':' . $m[1] : '';
 				$label = $severity === E_USER_DEPRECATED ? 'DEPRECATED' : 'WARNING';
 				$this->writeError($label, $file . $pos, $message);
-				return null;
+				return true;
 			}
 			return false;
 		});
@@ -109,7 +111,11 @@ final class Linter
 			echo $file, "\n";
 		}
 		$s = file_get_contents($file);
-		if (substr($s, 0, 3) === "\xEF\xBB\xBF") {
+		if ($s === false) {
+			$this->writeError('ERROR', $file, 'unable to read file');
+			return false;
+		}
+		if (str_starts_with($s, "\xEF\xBB\xBF")) {
 			$this->writeError('WARNING', $file, 'contains BOM');
 		}
 
@@ -138,13 +144,13 @@ final class Linter
 	private function initialize(): void
 	{
 		if (function_exists('pcntl_signal')) {
-			pcntl_signal(SIGINT, function (): void {
+			pcntl_signal(SIGINT, function (): never {
 				pcntl_signal(SIGINT, SIG_DFL);
 				echo "Terminated\n";
 				exit(1);
 			});
 		} elseif (function_exists('sapi_windows_set_ctrl_handler')) {
-			sapi_windows_set_ctrl_handler(function () {
+			sapi_windows_set_ctrl_handler(function (): never {
 				echo "Terminated\n";
 				exit(1);
 			});
@@ -159,7 +165,7 @@ final class Linter
 		$it = match (true) {
 			is_file($path) => new \ArrayIterator([$path]),
 			is_dir($path) => $this->findLatteFiles($path),
-			preg_match('~[*?]~', $path) => new \GlobIterator($path),
+			(bool) preg_match('~[*?]~', $path) => new \GlobIterator($path),
 			default => throw new \InvalidArgumentException("File or directory '$path' not found."),
 		};
 		$it = new \CallbackFilterIterator($it, fn($file) => is_file((string) $file));

package/vendor/latte/latte/src/Tools/LinterExtension.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\Tools;
 
 use Latte;
@@ -50,7 +48,7 @@ final class LinterExtension extends Latte\Extension
 				$this->validateFunction($node);
 
 			} elseif ($node instanceof Expression\NewNode && $node->class instanceof Php\NameNode) {
-				$this->validateClass($node);
+				$this->validateNewObject($node);
 
 			} elseif ($node instanceof Expression\StaticMethodCallNode
 				&& $node->class instanceof Php\NameNode
@@ -62,7 +60,9 @@ final class LinterExtension extends Latte\Extension
 				&& $node->class instanceof Php\NameNode
 				&& $node->name instanceof Php\IdentifierNode
 			) {
-				$this->validateClassConstant($node);
+				$node->name->name === 'class'
+					? $this->validateClassType($node->class)
+					: $this->validateClassConstant($node);
 
 			} elseif ($node instanceof Expression\ConstantFetchNode) {
 				$this->validateConstant($node);
@@ -83,6 +83,7 @@ final class LinterExtension extends Latte\Extension
 	private function validateFilter(Php\FilterNode $node): void
 	{
 		$name = $node->name->name;
+		assert($this->engine !== null);
 		$filters = $this->engine->getFilters();
 		if (!isset($filters[$name])) {
 			trigger_error("Unknown filter |$name $node->position", E_USER_WARNING);
@@ -92,6 +93,7 @@ final class LinterExtension extends Latte\Extension
 
 	private function validateFunction(Expression\FunctionCallNode $node): void
 	{
+		assert($node->name instanceof Php\NameNode);
 		$name = (string) $node->name;
 		if (!function_exists($name)) {
 			trigger_error("Unknown function $name() $node->position", E_USER_WARNING);
@@ -99,10 +101,11 @@ final class LinterExtension extends Latte\Extension
 	}
 
 
-	private function validateClass(Expression\NewNode $node): void
+	private function validateNewObject(Expression\NewNode $node): void
 	{
+		assert($node->class instanceof Php\NameNode);
 		$className = (string) $node->class;
-		if (!class_exists($className) && !interface_exists($className)) {
+		if (!class_exists($className)) {
 			trigger_error("Unknown class $className $node->position", E_USER_WARNING);
 		}
 	}
@@ -110,6 +113,8 @@ final class LinterExtension extends Latte\Extension
 
 	private function validateStaticMethod(Expression\StaticMethodCallNode $node): void
 	{
+		assert($node->class instanceof Php\NameNode);
+		assert($node->name instanceof Php\IdentifierNode);
 		$className = (string) $node->class;
 		$methodName = $node->name->name;
 		if (!method_exists($className, $methodName)) {
@@ -118,8 +123,19 @@ final class LinterExtension extends Latte\Extension
 	}
 
 
+	private function validateClassType(Php\NameNode $node): void
+	{
+		$className = (string) $node;
+		if (!class_exists($className) && !interface_exists($className) && !trait_exists($className)) {
+			trigger_error("Unknown class $className $node->position", E_USER_WARNING);
+		}
+	}
+
+
 	private function validateClassConstant(Expression\ClassConstantFetchNode $node): void
 	{
+		assert($node->class instanceof Php\NameNode);
+		assert($node->name instanceof Php\IdentifierNode);
 		$name = "{$node->class}::{$node->name->name}";
 		if (!defined($name)) {
 			trigger_error("Unknown class constant $name $node->position", E_USER_WARNING);
@@ -139,6 +155,7 @@ final class LinterExtension extends Latte\Extension
 
 	private function validateInstanceof(Expression\InstanceofNode $node): void
 	{
+		assert($node->class instanceof Php\NameNode);
 		$className = (string) $node->class;
 		if (!class_exists($className) && !interface_exists($className)) {
 			trigger_error("Unknown class $className in instanceof $node->position", E_USER_WARNING);
@@ -148,6 +165,8 @@ final class LinterExtension extends Latte\Extension
 
 	private function validateStaticProperty(Expression\StaticPropertyFetchNode $node): void
 	{
+		assert($node->class instanceof Php\NameNode);
+		assert($node->name instanceof Php\VarLikeIdentifierNode);
 		$className = (string) $node->class;
 		$propertyName = $node->name->name;
 		if (!property_exists($className, $propertyName)) {

package/vendor/nette/utils/composer.json

@@ -20,7 +20,9 @@
 	"require-dev": {
 		"nette/tester": "^2.5",
 		"tracy/tracy": "^2.9",
-		"phpstan/phpstan-nette": "^2.0@stable",
+		"phpstan/phpstan": "^2.1@stable",
+		"phpstan/extension-installer": "^1.4@stable",
+		"nette/phpstan-rules": "^1.0",
 		"jetbrains/phpstorm-attributes": "^1.2"
 	},
 	"conflict": {
@@ -50,5 +52,10 @@
 		"branch-alias": {
 			"dev-master": "4.1-dev"
 		}
+	},
+	"config": {
+		"allow-plugins": {
+			"phpstan/extension-installer": true
+		}
 	}
 }

package/vendor/nette/utils/src/HtmlStringable.php

@@ -10,10 +10,13 @@ declare(strict_types=1);
 namespace Nette;
 
 
+/**
+ * Represents object convertible to HTML string.
+ */
 interface HtmlStringable
 {
 	/**
-	 * Returns string in HTML format
+	 * Returns string in HTML format.
 	 */
 	function __toString(): string;
 }

package/vendor/nette/utils/src/Iterators/CachingIterator.php

@@ -13,16 +13,19 @@ use Nette;
 
 
 /**
- * Smarter caching iterator.
+ * Enhanced caching iterator with first/last/counter tracking.
  *
+ * @template TKey
+ * @template TValue
+ * @extends \CachingIterator<TKey, TValue, \Iterator<TKey, TValue>>
  * @property-read bool $first
  * @property-read bool $last
  * @property-read bool $empty
  * @property-read bool $odd
  * @property-read bool $even
  * @property-read int $counter
- * @property-read mixed $nextKey
- * @property-read mixed $nextValue
+ * @property-read TKey $nextKey
+ * @property-read TValue $nextValue
  */
 class CachingIterator extends \CachingIterator implements \Countable
 {
@@ -31,6 +34,7 @@ class CachingIterator extends \CachingIterator implements \Countable
 	private int $counter = 0;
 
 
+	/** @param  iterable<TKey, TValue>|\stdClass  $iterable */
 	public function __construct(iterable|\stdClass $iterable)
 	{
 		$iterable = $iterable instanceof \stdClass
@@ -58,45 +62,30 @@ class CachingIterator extends \CachingIterator implements \Countable
 	}
 
 
-	/**
-	 * Is the iterator empty?
-	 */
 	public function isEmpty(): bool
 	{
 		return $this->counter === 0;
 	}
 
 
-	/**
-	 * Is the counter odd?
-	 */
 	public function isOdd(): bool
 	{
 		return $this->counter % 2 === 1;
 	}
 
 
-	/**
-	 * Is the counter even?
-	 */
 	public function isEven(): bool
 	{
 		return $this->counter % 2 === 0;
 	}
 
 
-	/**
-	 * Returns the counter.
-	 */
 	public function getCounter(): int
 	{
 		return $this->counter;
 	}
 
 
-	/**
-	 * Returns the count of elements.
-	 */
 	public function count(): int
 	{
 		$inner = $this->getInnerIterator();
@@ -131,18 +120,14 @@ class CachingIterator extends \CachingIterator implements \Countable
 	}
 
 
-	/**
-	 * Returns the next key.
-	 */
+	/** @return TKey */
 	public function getNextKey(): mixed
 	{
 		return $this->getInnerIterator()->key();
 	}
 
 
-	/**
-	 * Returns the next element.
-	 */
+	/** @return TValue */
 	public function getNextValue(): mixed
 	{
 		return $this->getInnerIterator()->current();

package/vendor/nette/utils/src/Iterators/Mapper.php

@@ -15,14 +15,13 @@ namespace Nette\Iterators;
  */
 class Mapper extends \IteratorIterator
 {
-	/** @var callable */
-	private $callback;
+	private \Closure $callback;
 
 
 	public function __construct(\Traversable $iterator, callable $callback)
 	{
 		parent::__construct($iterator);
-		$this->callback = $callback;
+		$this->callback = $callback(...);
 	}
 
 

package/vendor/nette/utils/src/SmartObject.php

@@ -22,6 +22,7 @@ use Nette\Utils\ObjectHelpers;
 trait SmartObject
 {
 	/**
+	 * @param  mixed[]  $args
 	 * @return mixed
 	 * @throws MemberAccessException
 	 */
@@ -47,6 +48,8 @@ trait SmartObject
 
 
 	/**
+	 * @param  mixed[]  $args
+	 * @return never
 	 * @throws MemberAccessException
 	 */
 	public static function __callStatic(string $name, array $args)

package/vendor/nette/utils/src/StaticClass.php

@@ -11,7 +11,7 @@ namespace Nette;
 
 
 /**
- * Static class.
+ * Prevents instantiation.
  */
 trait StaticClass
 {

package/vendor/nette/utils/src/Translator.php

@@ -11,7 +11,7 @@ namespace Nette\Localization;
 
 
 /**
- * Translator adapter.
+ * Translation provider.
  */
 interface Translator
 {

package/vendor/nette/utils/src/Utils/ArrayHash.php

@@ -14,7 +14,7 @@ use function count, is_array, is_scalar, sprintf;
 
 
 /**
- * Provides objects to work as array.
+ * Array-like object with property access.
  * @template T
  * @implements \IteratorAggregate<array-key, T>
  * @implements \ArrayAccess<array-key, T>
@@ -39,7 +39,6 @@ class ArrayHash extends \stdClass implements \ArrayAccess, \Countable, \Iterator
 
 
 	/**
-	 * Returns an iterator over all items.
 	 * @return \Iterator<array-key, T>
 	 */
 	public function &getIterator(): \Iterator
@@ -50,9 +49,6 @@ class ArrayHash extends \stdClass implements \ArrayAccess, \Countable, \Iterator
 	}
 
 
-	/**
-	 * Returns items count.
-	 */
 	public function count(): int
 	{
 		return count((array) $this);

package/vendor/nette/utils/src/Utils/ArrayList.php

@@ -14,13 +14,14 @@ use function array_slice, array_splice, count, is_int;
 
 
 /**
- * Provides the base class for a generic list (items can be accessed by index).
+ * Generic list with integer indices.
  * @template T
  * @implements \IteratorAggregate<int, T>
  * @implements \ArrayAccess<int, T>
  */
 class ArrayList implements \ArrayAccess, \Countable, \IteratorAggregate
 {
+	/** @var list<T> */
 	private array $list = [];
 
 
@@ -41,7 +42,6 @@ class ArrayList implements \ArrayAccess, \Countable, \IteratorAggregate
 
 
 	/**
-	 * Returns an iterator over all items.
 	 * @return \Iterator<int, T>
 	 */
 	public function &getIterator(): \Iterator
@@ -52,9 +52,6 @@ class ArrayList implements \ArrayAccess, \Countable, \IteratorAggregate
 	}
 
 
-	/**
-	 * Returns items count.
-	 */
 	public function count(): int
 	{
 		return count($this->list);
@@ -63,7 +60,7 @@ class ArrayList implements \ArrayAccess, \Countable, \IteratorAggregate
 
 	/**
 	 * Replaces or appends an item.
-	 * @param  int|null  $index
+	 * @param  ?int  $index
 	 * @param  T  $value
 	 * @throws Nette\OutOfRangeException
 	 */

package/vendor/nette/utils/src/Utils/Arrays.php

@@ -79,7 +79,7 @@ class Arrays
 	 * @template T2
 	 * @param  array<T1>  $array1
 	 * @param  array<T2>  $array2
-	 * @return array<T1|T2>
+	 * @return array<T1|T2|array<mixed>>
 	 */
 	public static function mergeTree(array $array1, array $array2): array
 	{
@@ -96,6 +96,7 @@ class Arrays
 
 	/**
 	 * Returns zero-indexed position of given array key. Returns null if key is not found.
+	 * @param  array<mixed>  $array
 	 */
 	public static function getKeyOffset(array $array, string|int $key): ?int
 	{
@@ -104,9 +105,10 @@ class Arrays
 
 
 	/**
+	 * @param  array<mixed>  $array
 	 * @deprecated  use  getKeyOffset()
 	 */
-	public static function searchKey(array $array, $key): ?int
+	public static function searchKey(array $array, string|int $key): ?int
 	{
 		return self::getKeyOffset($array, $key);
 	}
@@ -114,10 +116,11 @@ class Arrays
 
 	/**
 	 * Tests an array for the presence of value.
+	 * @param  array<mixed>  $array
 	 */
 	public static function contains(array $array, mixed $value): bool
 	{
-		return in_array($value, $array, true);
+		return in_array($value, $array, strict: true);
 	}
 
 
@@ -125,9 +128,11 @@ class Arrays
 	 * Returns the first item (matching the specified predicate if given). If there is no such item, it returns result of invoking $else or null.
 	 * @template K of int|string
 	 * @template V
+	 * @template E
 	 * @param  array<K, V>  $array
 	 * @param  ?callable(V, K, array<K, V>): bool  $predicate
-	 * @return ?V
+	 * @param  ?callable(): E  $else
+	 * @return ($else is null ? ?V : V|E)
 	 */
 	public static function first(array $array, ?callable $predicate = null, ?callable $else = null): mixed
 	{
@@ -142,9 +147,11 @@ class Arrays
 	 * Returns the last item (matching the specified predicate if given). If there is no such item, it returns result of invoking $else or null.
 	 * @template K of int|string
 	 * @template V
+	 * @template E
 	 * @param  array<K, V>  $array
 	 * @param  ?callable(V, K, array<K, V>): bool  $predicate
-	 * @return ?V
+	 * @param  ?callable(): E  $else
+	 * @return ($else is null ? ?V : V|E)
 	 */
 	public static function last(array $array, ?callable $predicate = null, ?callable $else = null): mixed
 	{
@@ -196,6 +203,8 @@ class Arrays
 	/**
 	 * Inserts the contents of the $inserted array into the $array immediately after the $key.
 	 * If $key is null (or does not exist), it is inserted at the beginning.
+	 * @param  array<mixed>  $array
+	 * @param  array<mixed>  $inserted
 	 */
 	public static function insertBefore(array &$array, string|int|null $key, array $inserted): void
 	{
@@ -209,6 +218,8 @@ class Arrays
 	/**
 	 * Inserts the contents of the $inserted array into the $array before the $key.
 	 * If $key is null (or does not exist), it is inserted at the end.
+	 * @param  array<mixed>  $array
+	 * @param  array<mixed>  $inserted
 	 */
 	public static function insertAfter(array &$array, string|int|null $key, array $inserted): void
 	{
@@ -224,6 +235,7 @@ class Arrays
 
 	/**
 	 * Renames key in array.
+	 * @param  array<mixed>  $array
 	 */
 	public static function renameKey(array &$array, string|int $oldKey, string|int $newKey): bool
 	{
@@ -260,6 +272,8 @@ class Arrays
 
 	/**
 	 * Transforms multidimensional array to flat array.
+	 * @param  array<mixed>  $array
+	 * @return array<mixed>
 	 */
 	public static function flatten(array $array, bool $preserveKeys = false): array
 	{
@@ -284,16 +298,18 @@ class Arrays
 
 	/**
 	 * Reformats table to associative tree. Path looks like 'field|field[]field->field=field'.
-	 * @param  string|string[]  $path
+	 * @param  array<mixed>  $array
+	 * @param  string|list<string>  $path
+	 * @return array<mixed>|\stdClass
 	 */
-	public static function associate(array $array, $path): array|\stdClass
+	public static function associate(array $array, string|array $path): array|\stdClass
 	{
 		$parts = is_array($path)
 			? $path
 			: preg_split('#(\[\]|->|=|\|)#', $path, -1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY);
 
 		if (!$parts || $parts === ['->'] || $parts[0] === '=' || $parts[0] === '|') {
-			throw new Nette\InvalidArgumentException("Invalid path '$path'.");
+			throw new Nette\InvalidArgumentException("Invalid path '" . (is_array($path) ? implode('', $path) : $path) . "'.");
 		}
 
 		$res = $parts[0] === '->' ? new \stdClass : [];
@@ -312,6 +328,8 @@ class Arrays
 						$x = $row[$parts[$i]];
 						$row = null;
 					}
+					break; // '=' is always the final operation
+
 				} elseif ($part === '->') {
 					if (isset($parts[++$i])) {
 						if ($x === null) {
@@ -338,6 +356,8 @@ class Arrays
 
 	/**
 	 * Normalizes array to associative array. Replace numeric keys with their values, the new value will be $filling.
+	 * @param  array<mixed>  $array
+	 * @return array<string, mixed>
 	 */
 	public static function normalize(array $array, mixed $filling = null): array
 	{
@@ -481,8 +501,9 @@ class Arrays
 	/**
 	 * Invokes all callbacks and returns array of results.
 	 * @param  callable[]  $callbacks
+	 * @return array<mixed>
 	 */
-	public static function invoke(iterable $callbacks, ...$args): array
+	public static function invoke(iterable $callbacks, mixed ...$args): array
 	{
 		$res = [];
 		foreach ($callbacks as $k => $cb) {
@@ -496,8 +517,9 @@ class Arrays
 	/**
 	 * Invokes method on every object in an array and returns array of results.
 	 * @param  object[]  $objects
+	 * @return array<mixed>
 	 */
-	public static function invokeMethod(iterable $objects, string $method, ...$args): array
+	public static function invokeMethod(iterable $objects, string $method, mixed ...$args): array
 	{
 		$res = [];
 		foreach ($objects as $k => $obj) {
@@ -511,6 +533,7 @@ class Arrays
 	/**
 	 * Copies the elements of the $array array to the $object object and then returns it.
 	 * @template T of object
+	 * @param  iterable<mixed>  $array
 	 * @param  T  $object
 	 * @return T
 	 */