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

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

@@ -22,21 +22,24 @@ final class Callback
 
 	/**
 	 * Invokes internal PHP function with own error handler.
+	 * @param  callable-string  $function
+	 * @param  list<mixed>  $args
+	 * @param  callable(string, int): (bool|void|null)  $onError
 	 */
 	public static function invokeSafe(string $function, array $args, callable $onError): mixed
 	{
-		$prev = set_error_handler(function ($severity, $message, $file) use ($onError, &$prev, $function): ?bool {
+		$prev = set_error_handler(function (int $severity, string $message, string $file, int $line) use ($onError, &$prev, $function): bool {
 			if ($file === __FILE__) {
 				$msg = ini_get('html_errors')
 					? Html::htmlToText($message)
 					: $message;
-				$msg = preg_replace("#^$function\\(.*?\\): #", '', $msg);
+				$msg = (string) preg_replace("#^$function\\(.*?\\): #", '', $msg);
 				if ($onError($msg, $severity) !== false) {
-					return null;
+					return true;
 				}
 			}
 
-			return $prev ? $prev(...func_get_args()) : false;
+			return $prev ? $prev(...func_get_args()) !== false : false;
 		});
 
 		try {
@@ -53,7 +56,7 @@ final class Callback
 	 * @return callable
 	 * @throws Nette\InvalidArgumentException
 	 */
-	public static function check(mixed $callable, bool $syntax = false)
+	public static function check(mixed $callable, bool $syntax = false): mixed
 	{
 		if (!is_callable($callable, $syntax)) {
 			throw new Nette\InvalidArgumentException(
@@ -87,7 +90,7 @@ final class Callback
 	 * @param  callable  $callable  type check is escalated to ReflectionException
 	 * @throws \ReflectionException  if callback is not valid
 	 */
-	public static function toReflection($callable): \ReflectionMethod|\ReflectionFunction
+	public static function toReflection(mixed $callable): \ReflectionMethod|\ReflectionFunction
 	{
 		if ($callable instanceof \Closure) {
 			$callable = self::unwrap($callable);
@@ -100,6 +103,7 @@ final class Callback
 		} elseif (is_object($callable) && !$callable instanceof \Closure) {
 			return new ReflectionMethod($callable, '__invoke');
 		} else {
+			assert($callable instanceof \Closure || is_string($callable));
 			return new \ReflectionFunction($callable);
 		}
 	}
@@ -116,8 +120,9 @@ final class Callback
 
 	/**
 	 * Unwraps closure created by Closure::fromCallable().
+	 * @return callable|array{object|class-string, string}|string
 	 */
-	public static function unwrap(\Closure $closure): callable|array
+	public static function unwrap(\Closure $closure): callable|array|string
 	{
 		$r = new \ReflectionFunction($closure);
 		$class = $r->getClosureScopeClass()?->name;

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

@@ -142,7 +142,7 @@ class DateTime extends \DateTime implements \JsonSerializable
 	}
 
 
-	private function apply(string $datetime, $timezone = null, bool $ctr = false): void
+	private function apply(string $datetime, ?\DateTimeZone $timezone = null, bool $ctr = false): void
 	{
 		$relPart = '';
 		$absPart = preg_replace_callback(

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

@@ -19,14 +19,12 @@ use const DIRECTORY_SEPARATOR;
  */
 final class FileInfo extends \SplFileInfo
 {
-	private readonly string $relativePath;
-
-
-	public function __construct(string $file, string $relativePath = '')
-	{
+	public function __construct(
+		string $file,
+		private readonly string $relativePath = '',
+	) {
 		parent::__construct($file);
-		$this->setInfoClass(static::class);
-		$this->relativePath = $relativePath;
+		$this->setInfoClass(self::class);
 	}
 
 

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

@@ -52,14 +52,15 @@ final class FileSystem
 		} elseif (is_dir($origin)) {
 			static::createDir($target);
 			foreach (new \FilesystemIterator($target) as $item) {
+				\assert($item instanceof \SplFileInfo);
 				static::delete($item->getPathname());
 			}
 
 			foreach ($iterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($origin, \RecursiveDirectoryIterator::SKIP_DOTS), \RecursiveIteratorIterator::SELF_FIRST) as $item) {
 				if ($item->isDir()) {
-					static::createDir($target . '/' . $iterator->getSubPathName());
+					static::createDir($target . '/' . $iterator->getSubPathname());
 				} else {
-					static::copy($item->getPathname(), $target . '/' . $iterator->getSubPathName());
+					static::copy($item->getPathname(), $target . '/' . $iterator->getSubPathname());
 				}
 			}
 		} else {
@@ -112,6 +113,7 @@ final class FileSystem
 			}
 		} elseif (is_dir($path)) {
 			foreach (new \FilesystemIterator($path) as $item) {
+				\assert($item instanceof \SplFileInfo);
 				static::delete($item->getPathname());
 			}
 
@@ -251,6 +253,7 @@ final class FileSystem
 			}
 		} elseif (is_dir($path)) {
 			foreach (new \FilesystemIterator($path) as $item) {
+				\assert($item instanceof \SplFileInfo);
 				static::makeWritable($item->getPathname(), $dirMode, $fileMode);
 			}
 

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

@@ -32,24 +32,25 @@ class Finder implements \IteratorAggregate
 	/** @var string[] */
 	private array $in = [];
 
-	/** @var \Closure[] */
+	/** @var array<\Closure(FileInfo): bool> */
 	private array $filters = [];
 
-	/** @var \Closure[] */
+	/** @var array<\Closure(FileInfo): bool> */
 	private array $descentFilters = [];
 
 	/** @var array<string|self> */
 	private array $appends = [];
 	private bool $childFirst = false;
 
-	/** @var ?callable */
-	private $sort;
+	/** @var ?(\Closure(FileInfo, FileInfo): int) */
+	private ?\Closure $sort = null;
 	private int $maxDepth = -1;
 	private bool $ignoreUnreadableDirs = true;
 
 
 	/**
 	 * Begins search for files and directories matching mask.
+	 * @param  string|list<string>  $masks
 	 */
 	public static function find(string|array $masks = ['*']): static
 	{
@@ -60,6 +61,7 @@ class Finder implements \IteratorAggregate
 
 	/**
 	 * Begins search for files matching mask.
+	 * @param  string|list<string>  $masks
 	 */
 	public static function findFiles(string|array $masks = ['*']): static
 	{
@@ -70,6 +72,7 @@ class Finder implements \IteratorAggregate
 
 	/**
 	 * Begins search for directories matching mask.
+	 * @param  string|list<string>  $masks
 	 */
 	public static function findDirectories(string|array $masks = ['*']): static
 	{
@@ -80,6 +83,7 @@ class Finder implements \IteratorAggregate
 
 	/**
 	 * Finds files matching the specified masks.
+	 * @param  string|list<string>  $masks
 	 */
 	public function files(string|array $masks = ['*']): static
 	{
@@ -89,6 +93,7 @@ class Finder implements \IteratorAggregate
 
 	/**
 	 * Finds directories matching the specified masks.
+	 * @param  string|list<string>  $masks
 	 */
 	public function directories(string|array $masks = ['*']): static
 	{
@@ -96,6 +101,7 @@ class Finder implements \IteratorAggregate
 	}
 
 
+	/** @param  list<string>  $masks */
 	private function addMask(array $masks, string $mode): static
 	{
 		foreach ($masks as $mask) {
@@ -117,6 +123,7 @@ class Finder implements \IteratorAggregate
 
 	/**
 	 * Searches in the given directories. Wildcards are allowed.
+	 * @param  string|list<string>  $paths
 	 */
 	public function in(string|array $paths): static
 	{
@@ -128,6 +135,7 @@ class Finder implements \IteratorAggregate
 
 	/**
 	 * Searches recursively from the given directories. Wildcards are allowed.
+	 * @param  string|list<string>  $paths
 	 */
 	public function from(string|array $paths): static
 	{
@@ -137,6 +145,7 @@ class Finder implements \IteratorAggregate
 	}
 
 
+	/** @param  list<string>  $paths */
 	private function addLocation(array $paths, string $ext): void
 	{
 		foreach ($paths as $path) {
@@ -175,7 +184,7 @@ class Finder implements \IteratorAggregate
 	 */
 	public function sortBy(callable $callback): static
 	{
-		$this->sort = $callback;
+		$this->sort = $callback(...);
 		return $this;
 	}
 
@@ -192,6 +201,7 @@ class Finder implements \IteratorAggregate
 
 	/**
 	 * Adds the specified paths or appends a new finder that returns.
+	 * @param  string|list<string>|null  $paths
 	 */
 	public function append(string|array|null $paths = null): static
 	{
@@ -209,6 +219,7 @@ class Finder implements \IteratorAggregate
 
 	/**
 	 * Skips entries that matches the given masks relative to the ones defined with the in() or from() methods.
+	 * @param  string|list<string>  $masks
 	 */
 	public function exclude(string|array $masks): static
 	{
@@ -239,7 +250,7 @@ class Finder implements \IteratorAggregate
 	 */
 	public function filter(callable $callback): static
 	{
-		$this->filters[] = \Closure::fromCallable($callback);
+		$this->filters[] = $callback(...);
 		return $this;
 	}
 
@@ -250,7 +261,7 @@ class Finder implements \IteratorAggregate
 	 */
 	public function descentFilter(callable $callback): static
 	{
-		$this->descentFilters[] = \Closure::fromCallable($callback);
+		$this->descentFilters[] = $callback(...);
 		return $this;
 	}
 
@@ -267,6 +278,7 @@ class Finder implements \IteratorAggregate
 
 	/**
 	 * Restricts the search by size. $operator accepts "[operator] [size] [unit]" example: >=10kB
+	 * @param  '>'|'>='|'<'|'<='|'='|'=='|'==='|'!='|'!=='|'<>'  $operator  or predicate string
 	 */
 	public function size(string $operator, ?int $size = null): static
 	{
@@ -277,7 +289,7 @@ class Finder implements \IteratorAggregate
 
 			[, $operator, $size, $unit] = $matches;
 			$units = ['' => 1, 'k' => 1e3, 'm' => 1e6, 'g' => 1e9];
-			$size *= $units[strtolower($unit)];
+			$size = (float) $size * $units[strtolower($unit)];
 			$operator = $operator ?: '=';
 		}
 
@@ -287,6 +299,7 @@ class Finder implements \IteratorAggregate
 
 	/**
 	 * Restricts the search by modified time. $operator accepts "[operator] [date]" example: >1978-01-23
+	 * @param  '>'|'>='|'<'|'<='|'='|'=='|'==='|'!='|'!=='|'<>'  $operator  or predicate string
 	 */
 	public function date(string $operator, string|int|\DateTimeInterface|null $date = null): static
 	{
@@ -401,6 +414,7 @@ class Finder implements \IteratorAggregate
 	}
 
 
+	/** @param  iterable<string>  $pathNames */
 	private function convertToFiles(iterable $pathNames, string $relativePath, bool $absolute): \Generator
 	{
 		foreach ($pathNames as $pathName) {
@@ -413,6 +427,10 @@ class Finder implements \IteratorAggregate
 	}
 
 
+	/**
+	 * @param  (\Closure(FileInfo): bool)[]  $filters
+	 * @param  array<int, bool>  $cache
+	 */
 	private function proveFilters(array $filters, FileInfo $file, array &$cache): bool
 	{
 		foreach ($filters as $filter) {
@@ -468,6 +486,7 @@ class Finder implements \IteratorAggregate
 
 	/**
 	 * Since glob() does not know ** wildcard, we divide the path into a part for glob and a part for manual traversal.
+	 * @return array{string, string, bool}
 	 */
 	private static function splitRecursivePart(string $path): array
 	{

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

@@ -14,6 +14,9 @@ use function array_unique, ini_get, levenshtein, max, min, ob_end_clean, ob_get_
 use const PHP_OS_FAMILY;
 
 
+/**
+ * Miscellaneous utilities.
+ */
 class Helpers
 {
 	public const IsWindows = PHP_OS_FAMILY === 'Windows';
@@ -21,6 +24,7 @@ class Helpers
 
 	/**
 	 * Executes a callback and returns the captured output as a string.
+	 * @param  callable(): void  $func
 	 */
 	public static function capture(callable $func): string
 	{
@@ -37,7 +41,7 @@ class Helpers
 
 	/**
 	 * Returns the last occurred PHP error or an empty string if no error occurred. Unlike error_get_last(),
-	 * it is nit affected by the PHP directive html_errors and always returns text, not HTML.
+	 * it is not affected by the PHP directive html_errors and always returns text, not HTML.
 	 */
 	public static function getLastError(): string
 	{
@@ -59,6 +63,7 @@ class Helpers
 
 	/**
 	 * Returns value clamped to the inclusive range of min and max.
+	 * @return ($value is float ? float : ($min is float ? float : ($max is float ? float : int)))
 	 */
 	public static function clamp(int|float $value, int|float $min, int|float $max): int|float
 	{
@@ -91,6 +96,7 @@ class Helpers
 
 	/**
 	 * Compares two values in the same way that PHP does. Recognizes operators: >, >=, <, <=, =, ==, ===, !=, !==, <>
+	 * @param  '>'|'>='|'<'|'<='|'='|'=='|'==='|'!='|'!=='|'<>'  $operator
 	 */
 	public static function compare(mixed $left, string $operator, mixed $right): bool
 	{