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

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

@@ -0,0 +1,176 @@
+<?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\Tools;
+
+use Latte;
+use Latte\Compiler\Node;
+use Latte\Compiler\Nodes\Php;
+use Latte\Compiler\Nodes\Php\Expression;
+use Latte\Compiler\Nodes\TemplateNode;
+use Latte\Compiler\NodeTraverser;
+use function defined;
+
+
+/**
+ * Linter extension for validating filters, functions, classes, methods, constants and more.
+ */
+final class LinterExtension extends Latte\Extension
+{
+	private ?Latte\Engine $engine = null;
+
+
+	public function beforeCompile(Latte\Engine $engine): void
+	{
+		$this->engine = $engine;
+	}
+
+
+	public function getPasses(): array
+	{
+		return [
+			'linter' => $this->linterPass(...),
+		];
+	}
+
+
+	private function linterPass(TemplateNode $node): void
+	{
+		(new NodeTraverser)->traverse($node, function (Node $node) {
+			if ($node instanceof Php\FilterNode) {
+				$this->validateFilter($node);
+
+			} elseif ($node instanceof Expression\FunctionCallNode && $node->name instanceof Php\NameNode) {
+				$this->validateFunction($node);
+
+			} elseif ($node instanceof Expression\NewNode && $node->class instanceof Php\NameNode) {
+				$this->validateNewObject($node);
+
+			} elseif ($node instanceof Expression\StaticMethodCallNode
+				&& $node->class instanceof Php\NameNode
+				&& $node->name instanceof Php\IdentifierNode
+			) {
+				$this->validateStaticMethod($node);
+
+			} elseif ($node instanceof Expression\ClassConstantFetchNode
+				&& $node->class instanceof Php\NameNode
+				&& $node->name instanceof Php\IdentifierNode
+			) {
+				$node->name->name === 'class'
+					? $this->validateClassType($node->class)
+					: $this->validateClassConstant($node);
+
+			} elseif ($node instanceof Expression\ConstantFetchNode) {
+				$this->validateConstant($node);
+
+			} elseif ($node instanceof Expression\InstanceofNode && $node->class instanceof Php\NameNode) {
+				$this->validateInstanceof($node);
+
+			} elseif ($node instanceof Expression\StaticPropertyFetchNode
+				&& $node->class instanceof Php\NameNode
+				&& $node->name instanceof Php\VarLikeIdentifierNode
+			) {
+				$this->validateStaticProperty($node);
+			}
+		});
+	}
+
+
+	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);
+		}
+	}
+
+
+	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);
+		}
+	}
+
+
+	private function validateNewObject(Expression\NewNode $node): void
+	{
+		assert($node->class instanceof Php\NameNode);
+		$className = (string) $node->class;
+		if (!class_exists($className)) {
+			trigger_error("Unknown class $className $node->position", E_USER_WARNING);
+		}
+	}
+
+
+	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)) {
+			trigger_error("Unknown method $className::$methodName() $node->position", E_USER_WARNING);
+		}
+	}
+
+
+	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);
+		}
+	}
+
+
+	private function validateConstant(Expression\ConstantFetchNode $node): void
+	{
+		$magic = ['__LINE__' => 1, '__FILE__' => 1, '__DIR__' => 1];
+		$name = (string) $node->name;
+		if (!defined($name) && !isset($magic[$name])) {
+			trigger_error("Unknown constant $name $node->position", E_USER_WARNING);
+		}
+	}
+
+
+	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);
+		}
+	}
+
+
+	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)) {
+			trigger_error("Unknown static property $className::\$$propertyName $node->position", E_USER_WARNING);
+		}
+	}
+}

package/vendor/nette/utils/composer.json

@@ -15,13 +15,15 @@
 		}
 	],
 	"require": {
-		"php": "8.0 - 8.4"
+		"php": "8.2 - 8.5"
 	},
 	"require-dev": {
 		"nette/tester": "^2.5",
 		"tracy/tracy": "^2.9",
-		"phpstan/phpstan": "^1.0",
-		"jetbrains/phpstorm-attributes": "dev-master"
+		"phpstan/phpstan": "^2.1@stable",
+		"phpstan/extension-installer": "^1.4@stable",
+		"nette/phpstan-rules": "^1.0",
+		"jetbrains/phpstorm-attributes": "^1.2"
 	},
 	"conflict": {
 		"nette/finder": "<3",
@@ -36,7 +38,10 @@
 		"ext-tokenizer": "to use Nette\\Utils\\Reflection::getUseStatements()"
 	},
 	"autoload": {
-		"classmap": ["src/"]
+		"classmap": ["src/"],
+		"psr-4": {
+			"Nette\\": "src"
+		}
 	},
 	"minimum-stability": "dev",
 	"scripts": {
@@ -45,7 +50,12 @@
 	},
 	"extra": {
 		"branch-alias": {
-			"dev-master": "4.0-dev"
+			"dev-master": "4.1-dev"
+		}
+	},
+	"config": {
+		"allow-plugins": {
+			"phpstan/extension-installer": true
 		}
 	}
 }

package/vendor/nette/utils/readme.md

@@ -41,7 +41,7 @@ The recommended way to install is via Composer:
 composer require nette/utils
 ```
 
-Nette Utils 4.0 is compatible with PHP 8.0 to 8.4.
+Nette Utils 4.1 is compatible with PHP 8.2 to 8.5.
 
  <!---->
 

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,10 +34,11 @@ 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
-			? new \ArrayIterator($iterable)
+			? new \ArrayIterator((array) $iterable)
 			: Nette\Utils\Iterables::toIterator($iterable);
 		parent::__construct($iterable, 0);
 	}
@@ -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
 {
@@ -21,14 +21,4 @@ trait StaticClass
 	private function __construct()
 	{
 	}
-
-
-	/**
-	 * Call to undefined static method.
-	 * @throws MemberAccessException
-	 */
-	public static function __callStatic(string $name, array $args): mixed
-	{
-		Utils\ObjectHelpers::strictStaticCall(static::class, $name);
-	}
 }

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

@@ -10,10 +10,11 @@ declare(strict_types=1);
 namespace Nette\Utils;
 
 use Nette;
+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>
@@ -38,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
@@ -49,9 +49,6 @@ class ArrayHash extends \stdClass implements \ArrayAccess, \Countable, \Iterator
 	}
 
 
-	/**
-	 * Returns items count.
-	 */
 	public function count(): int
 	{
 		return count((array) $this);
@@ -59,7 +56,7 @@ class ArrayHash extends \stdClass implements \ArrayAccess, \Countable, \Iterator
 
 
 	/**
-	 * Replaces or appends a item.
+	 * Replaces or appends an item.
 	 * @param  array-key  $key
 	 * @param  T  $value
 	 */
@@ -74,19 +71,18 @@ class ArrayHash extends \stdClass implements \ArrayAccess, \Countable, \Iterator
 
 
 	/**
-	 * Returns a item.
+	 * Returns an item.
 	 * @param  array-key  $key
 	 * @return T
 	 */
-	#[\ReturnTypeWillChange]
-	public function offsetGet($key)
+	public function offsetGet($key): mixed
 	{
 		return $this->$key;
 	}
 
 
 	/**
-	 * Determines whether a item exists.
+	 * Determines whether an item exists.
 	 * @param  array-key  $key
 	 */
 	public function offsetExists($key): bool

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

@@ -10,18 +10,18 @@ declare(strict_types=1);
 namespace Nette\Utils;
 
 use Nette;
+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
 {
-	use Nette\SmartObject;
-
+	/** @var list<T> */
 	private array $list = [];
 
 
@@ -42,7 +42,6 @@ class ArrayList implements \ArrayAccess, \Countable, \IteratorAggregate
 
 
 	/**
-	 * Returns an iterator over all items.
 	 * @return \Iterator<int, T>
 	 */
 	public function &getIterator(): \Iterator
@@ -53,9 +52,6 @@ class ArrayList implements \ArrayAccess, \Countable, \IteratorAggregate
 	}
 
 
-	/**
-	 * Returns items count.
-	 */
 	public function count(): int
 	{
 		return count($this->list);
@@ -63,8 +59,8 @@ class ArrayList implements \ArrayAccess, \Countable, \IteratorAggregate
 
 
 	/**
-	 * Replaces or appends a item.
-	 * @param  int|null  $index
+	 * Replaces or appends an item.
+	 * @param  ?int  $index
 	 * @param  T  $value
 	 * @throws Nette\OutOfRangeException
 	 */
@@ -83,7 +79,7 @@ class ArrayList implements \ArrayAccess, \Countable, \IteratorAggregate
 
 
 	/**
-	 * Returns a item.
+	 * Returns an item.
 	 * @param  int  $index
 	 * @return T
 	 * @throws Nette\OutOfRangeException
@@ -99,7 +95,7 @@ class ArrayList implements \ArrayAccess, \Countable, \IteratorAggregate
 
 
 	/**
-	 * Determines whether a item exists.
+	 * Determines whether an item exists.
 	 * @param  int  $index
 	 */
 	public function offsetExists($index): bool
@@ -124,7 +120,7 @@ class ArrayList implements \ArrayAccess, \Countable, \IteratorAggregate
 
 
 	/**
-	 * Prepends a item.
+	 * Prepends an item.
 	 * @param  T  $value
 	 */
 	public function prepend(mixed $value): void