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

package/vendor/latte/latte/src/Latte/Essential/Filters.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\Essential;
 
 use Latte;
@@ -30,7 +28,7 @@ final class Filters
 	/**
 	 * Converts HTML to plain text.
 	 */
-	public static function stripHtml(FilterInfo $info, $s): string
+	public static function stripHtml(FilterInfo $info, string|Stringable|null $s): string
 	{
 		$info->validate([null, 'html', 'html/attr', 'xml', 'xml/attr'], __FUNCTION__);
 		$info->contentType = ContentType::Text;
@@ -41,7 +39,7 @@ final class Filters
 	/**
 	 * Removes tags from HTML (but remains HTML entities).
 	 */
-	public static function stripTags(FilterInfo $info, $s): string
+	public static function stripTags(FilterInfo $info, string|Stringable|null $s): string
 	{
 		$info->contentType ??= ContentType::Html;
 		$info->validate(['html', 'html/attr', 'xml', 'xml/attr'], __FUNCTION__);
@@ -149,6 +147,7 @@ final class Filters
 
 	/**
 	 * Splits a string by a string.
+	 * @return list<string>
 	 */
 	public static function explode(string $value, string $separator = ''): array
 	{
@@ -161,7 +160,7 @@ final class Filters
 	/**
 	 * Repeats text.
 	 */
-	public static function repeat(FilterInfo $info, $s, int $count): string
+	public static function repeat(FilterInfo $info, string|Stringable|null $s, int $count): string
 	{
 		return str_repeat((string) $s, $count);
 	}
@@ -287,15 +286,16 @@ final class Filters
 
 	/**
 	 * Performs a search and replace.
+	 * @param  string|array<string, string>|array<string>  $search
+	 * @param  string|array<string>|null  $replace
 	 */
 	public static function replace(
 		FilterInfo $info,
-		string|array $subject,
+		string $subject,
 		string|array $search,
 		string|array|null $replace = null,
 	): string
 	{
-		$subject = (string) $subject;
 		if (is_array($search)) {
 			if (is_array($replace)) {
 				return strtr($subject, array_combine($search, $replace));
@@ -316,7 +316,7 @@ final class Filters
 	public static function replaceRe(string $subject, string $pattern, string $replacement = ''): string
 	{
 		$res = preg_replace($pattern, $replacement, $subject);
-		if (preg_last_error()) {
+		if (preg_last_error() || $res === null) {
 			throw new Latte\RuntimeException(preg_last_error_msg());
 		}
 
@@ -329,15 +329,23 @@ final class Filters
 	 */
 	public static function dataStream(string $data, ?string $type = null): string
 	{
-		$type ??= finfo_buffer(finfo_open(FILEINFO_MIME_TYPE), $data);
+		if ($type === null) {
+			$finfo = finfo_open(FILEINFO_MIME_TYPE);
+			if ($finfo) {
+				$type = finfo_buffer($finfo, $data) ?: null;
+			}
+		}
 		return 'data:' . ($type ? "$type;" : '') . 'base64,' . base64_encode($data);
 	}
 
 
+	/**
+	 * Converts newlines to HTML <br> tags.
+	 */
 	public static function breaklines(string|Stringable|null $s): Html
 	{
 		$s = htmlspecialchars((string) $s, ENT_NOQUOTES | ENT_SUBSTITUTE, 'UTF-8');
-		return new Html(nl2br($s, false));
+		return new Html(nl2br($s, use_xhtml: false));
 	}
 
 
@@ -349,7 +357,7 @@ final class Filters
 		$s = (string) $s;
 		return match (true) {
 			extension_loaded('mbstring') => mb_substr($s, $start, $length, 'UTF-8'),
-			extension_loaded('iconv') => iconv_substr($s, $start, $length, 'UTF-8'),
+			extension_loaded('iconv') => (string) iconv_substr($s, $start, $length, 'UTF-8'),
 			default => throw new Latte\RuntimeException("Filter |substr requires 'mbstring' or 'iconv' extension."),
 		};
 	}
@@ -381,7 +389,7 @@ final class Filters
 	/**
 	 * Convert to lower case.
 	 */
-	public static function lower($s): string
+	public static function lower(string|Stringable|null $s): string
 	{
 		return mb_strtolower((string) $s, 'UTF-8');
 	}
@@ -390,7 +398,7 @@ final class Filters
 	/**
 	 * Convert to upper case.
 	 */
-	public static function upper($s): string
+	public static function upper(string|Stringable|null $s): string
 	{
 		return mb_strtoupper((string) $s, 'UTF-8');
 	}
@@ -399,7 +407,7 @@ final class Filters
 	/**
 	 * Convert first character to lower case.
 	 */
-	public static function firstLower($s): string
+	public static function firstLower(string|Stringable|null $s): string
 	{
 		$s = (string) $s;
 		return self::lower(self::substring($s, 0, 1)) . self::substring($s, 1);
@@ -409,7 +417,7 @@ final class Filters
 	/**
 	 * Convert first character to upper case.
 	 */
-	public static function firstUpper($s): string
+	public static function firstUpper(string|Stringable|null $s): string
 	{
 		$s = (string) $s;
 		return self::upper(self::substring($s, 0, 1)) . self::substring($s, 1);
@@ -419,7 +427,7 @@ final class Filters
 	/**
 	 * Capitalize string.
 	 */
-	public static function capitalize($s): string
+	public static function capitalize(string|Stringable|null $s): string
 	{
 		return mb_convert_case((string) $s, MB_CASE_TITLE, 'UTF-8');
 	}
@@ -427,10 +435,11 @@ final class Filters
 
 	/**
 	 * Returns length of string or iterable.
+	 * @param  array<mixed>|\Countable|\Traversable<mixed>|string  $val
 	 */
 	public static function length(array|\Countable|\Traversable|string $val): int
 	{
-		if (is_array($val) || $val instanceof \Countable) {
+		if (is_countable($val)) {
 			return count($val);
 		} elseif ($val instanceof \Traversable) {
 			return iterator_count($val);
@@ -444,7 +453,7 @@ final class Filters
 	{
 		return match (true) {
 			extension_loaded('mbstring') => mb_strlen($s, 'UTF-8'),
-			extension_loaded('iconv') => iconv_strlen($s, 'UTF-8'),
+			extension_loaded('iconv') => (int) iconv_strlen($s, 'UTF-8'),
 			default => strlen(@utf8_decode($s)), // deprecated
 		};
 	}
@@ -457,7 +466,7 @@ final class Filters
 	{
 		$charlist = preg_quote($charlist, '#');
 		$s = preg_replace('#^[' . $charlist . ']+|[' . $charlist . ']+$#Du', '', (string) $s);
-		if (preg_last_error()) {
+		if (preg_last_error() || $s === null) {
 			throw new Latte\RuntimeException(preg_last_error_msg());
 		}
 
@@ -468,7 +477,7 @@ final class Filters
 	/**
 	 * Pad a string to a certain length with another string.
 	 */
-	public static function padLeft($s, int $length, string $append = ' '): string
+	public static function padLeft(string|Stringable|null $s, int $length, string $append = ' '): string
 	{
 		$s = (string) $s;
 		$length = max(0, $length - self::strLength($s));
@@ -480,7 +489,7 @@ final class Filters
 	/**
 	 * Pad a string to a certain length with another string.
 	 */
-	public static function padRight($s, int $length, string $append = ' '): string
+	public static function padRight(string|Stringable|null $s, int $length, string $append = ' '): string
 	{
 		$s = (string) $s;
 		$length = max(0, $length - self::strLength($s));
@@ -491,23 +500,25 @@ final class Filters
 
 	/**
 	 * Reverses string or array.
+	 * @template K
+	 * @template V
+	 * @param  iterable<K, V>|string  $val
+	 * @return ($val is string ? string : array<K, V>)
 	 */
 	public static function reverse(string|iterable $val, bool $preserveKeys = false): string|array
 	{
-		if (is_array($val)) {
-			return array_reverse($val, $preserveKeys);
-		} elseif ($val instanceof \Traversable) {
-			return array_reverse(iterator_to_array($val), $preserveKeys);
-		} else {
-			return iconv('UTF-32LE', 'UTF-8', strrev(iconv('UTF-8', 'UTF-32BE', (string) $val)));
-		}
+		return is_string($val)
+			? (string) iconv('UTF-32LE', 'UTF-8', strrev((string) iconv('UTF-8', 'UTF-32BE', $val)))
+			: array_reverse(iterator_to_array($val), $preserveKeys);
 	}
 
 
 	/**
 	 * Chunks items by returning an array of arrays with the given number of items.
+	 * @param  iterable<mixed>  $list
+	 * @return \Generator<int, array<mixed>>
 	 */
-	public static function batch(iterable $list, int $length, $rest = null): \Generator
+	public static function batch(iterable $list, int $length, mixed $rest = null): \Generator
 	{
 		$batch = [];
 		foreach ($list as $key => $value) {
@@ -535,6 +546,9 @@ final class Filters
 	 * @template K
 	 * @template V
 	 * @param  iterable<K, V>  $data
+	 * @param  ?(\Closure(V, V): int)  $comparison
+	 * @param  string|int|(\Closure(V): mixed)|null  $by
+	 * @param  string|int|(\Closure(K): mixed)|bool  $byKey
 	 * @return iterable<K, V>
 	 */
 	public function sort(
@@ -587,6 +601,7 @@ final class Filters
 	 * @template K
 	 * @template V
 	 * @param  iterable<K, V>  $data
+	 * @param  string|int|(\Closure(V, K): mixed)  $by
 	 * @return iterable<iterable<K, V>>
 	 */
 	public static function group(iterable $data, string|int|\Closure $by): iterable
@@ -597,7 +612,7 @@ final class Filters
 		foreach ($data as $k => $v) {
 			$groupKey = $fn($v, $k);
 			if (!$groups || $prevKey !== $groupKey) {
-				$index = array_search($groupKey, $keys, true);
+				$index = array_search($groupKey, $keys, strict: true);
 				if ($index === false) {
 					$index = count($keys);
 					$keys[$index] = $groupKey;
@@ -648,6 +663,7 @@ final class Filters
 
 	/**
 	 * Generates URL-encoded query string
+	 * @param  string|array<mixed>  $data
 	 */
 	public static function query(string|array $data): string
 	{
@@ -686,6 +702,8 @@ final class Filters
 
 	/**
 	 * Returns the first element in an array or character in a string, or null if none.
+	 * @param  string|iterable<mixed>  $value
+	 * @return ($value is string ? string : mixed)
 	 */
 	public static function first(string|iterable $value): mixed
 	{
@@ -703,6 +721,8 @@ final class Filters
 
 	/**
 	 * Returns the last element in an array or character in a string, or null if none.
+	 * @param  string|array<mixed>  $value
+	 * @return ($value is string ? string : mixed)
 	 */
 	public static function last(string|array $value): mixed
 	{
@@ -714,6 +734,8 @@ final class Filters
 
 	/**
 	 * Extracts a slice of an array or string.
+	 * @param  string|array<mixed>  $value
+	 * @return ($value is string ? string : array<mixed>)
 	 */
 	public static function slice(
 		string|array $value,
@@ -728,18 +750,27 @@ final class Filters
 	}
 
 
+	/**
+	 * Rounds number to specified precision.
+	 */
 	public static function round(float $value, int $precision = 0): float
 	{
 		return round($value, $precision);
 	}
 
 
+	/**
+	 * Rounds number down to specified precision.
+	 */
 	public static function floor(float $value, int $precision = 0): float
 	{
 		return floor($value * 10 ** $precision) / 10 ** $precision;
 	}
 
 
+	/**
+	 * Rounds number up to specified precision.
+	 */
 	public static function ceil(float $value, int $precision = 0): float
 	{
 		return ceil($value * 10 ** $precision) / 10 ** $precision;
@@ -748,6 +779,8 @@ final class Filters
 
 	/**
 	 * Picks random element/char.
+	 * @param  string|array<mixed>  $values
+	 * @return ($values is string ? string : mixed)
 	 */
 	public static function random(string|array $values): mixed
 	{
@@ -764,7 +797,7 @@ final class Filters
 	/**
 	 * Sanitizes string for use inside href attribute.
 	 */
-	public static function checkUrl($s): string
+	public static function checkUrl(mixed $s): string
 	{
 		$s = $s instanceof Latte\Runtime\HtmlStringable
 			? Latte\Runtime\HtmlHelpers::convertHtmlToText((string) $s)

package/vendor/latte/latte/src/Latte/Essential/Nodes/BlockNode.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\Essential\Nodes;
 
 use Latte\CompileException;
@@ -24,7 +22,8 @@ use Latte\Runtime\Template;
 
 
 /**
- * {block [local] [name]}
+ * {block [local] name} ... {/block}
+ * {block|filter} ... {/block}  (anonymous filter block)
  */
 class BlockNode extends StatementNode
 {
@@ -33,12 +32,13 @@ class BlockNode extends StatementNode
 	public AreaNode $content;
 
 
-	/** @return \Generator<int, ?array, array{AreaNode, ?Tag}, static|AreaNode> */
+	/** @return \Generator<int, ?list<string>, array{AreaNode, ?Tag}, static> */
 	public static function create(Tag $tag, TemplateParser $parser): \Generator
 	{
 		$tag->outputMode = $tag::OutputRemoveIndentation;
 		$stream = $tag->parser->stream;
 		$node = $tag->node = new static;
+		$name = null;
 
 		if (!$stream->is('|', Token::End)) {
 			$layer = $tag->parser->tryConsumeTokenBeforeUnquotedString('local')
@@ -108,6 +108,7 @@ class BlockNode extends StatementNode
 
 	private function printStatic(PrintContext $context): string
 	{
+		assert($this->block !== null);
 		$this->modifier->escape = $this->modifier->escape || $context->getEscaper()->getState() === Escaper::HtmlAttribute;
 		$context->addBlock($this->block);
 		$this->block->content = $this->content->print($context); // must be compiled after is added
@@ -127,13 +128,14 @@ class BlockNode extends StatementNode
 
 	private function printDynamic(PrintContext $context): string
 	{
+		assert($this->block !== null);
 		$context->addBlock($this->block);
 		$this->block->content = $this->content->print($context); // must be compiled after is added
 		$escaper = $context->getEscaper();
 		$this->modifier->escape = $this->modifier->escape || $escaper->getState() === Escaper::HtmlAttribute;
 
 		return $context->format(
-			'$this->addBlock($ʟ_nm = %raw, %dump, [[$this, %dump]], %dump);
+			'$this->addBlock($ʟ_nm = %raw, %dump, [$this->%raw(...)], %dump);
 			$this->renderBlock($ʟ_nm, get_defined_vars()'
 			. ($this->modifier->filters || $this->modifier->escape
 				? ', function ($s, $type) { $ʟ_fi = new LR\FilterInfo($type); return %modifyContent($s); }'

package/vendor/latte/latte/src/Latte/Essential/Nodes/CaptureNode.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\Essential\Nodes;
 
 use Latte\CompileException;
@@ -20,7 +18,8 @@ use Latte\Compiler\Tag;
 
 
 /**
- * {capture $variable}
+ * {capture $var} ... {/capture}
+ * Captures block output into variable.
  */
 class CaptureNode extends StatementNode
 {
@@ -29,7 +28,7 @@ class CaptureNode extends StatementNode
 	public AreaNode $content;
 
 
-	/** @return \Generator<int, ?array, array{AreaNode, ?Tag}, static> */
+	/** @return \Generator<int, ?list<string>, array{AreaNode, ?Tag}, static> */
 	public static function create(Tag $tag): \Generator
 	{
 		$tag->expectArguments();
@@ -37,7 +36,7 @@ class CaptureNode extends StatementNode
 		if (!$variable->isWritable()) {
 			$text = '';
 			$i = 0;
-			while ($token = $tag->parser->stream->peek(--$i)) {
+			while ($token = $tag->parser->stream->tryPeek(--$i)) {
 				$text = $token->text . $text;
 			}
 

package/vendor/latte/latte/src/Latte/Essential/Nodes/ContentTypeNode.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\Essential\Nodes;
 
 use Latte\CompileException;
@@ -18,7 +16,8 @@ use Latte\ContentType;
 
 
 /**
- * {contentType ...}
+ * {contentType html|xml|js|css|text|...}
+ * Switches escaping mode and optionally sends HTTP header.
  */
 class ContentTypeNode extends StatementNode
 {

package/vendor/latte/latte/src/Latte/Essential/Nodes/CustomFunctionCallNode.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\Essential\Nodes;
 
 use Latte\Compiler\Nodes\Php;
@@ -17,7 +15,7 @@ use Latte\Helpers;
 
 
 /**
- * Custom function call node.
+ * Wrapper for custom function calls in Latte expressions.
  */
 class CustomFunctionCallNode extends ExpressionNode
 {

package/vendor/latte/latte/src/Latte/Essential/Nodes/DebugbreakNode.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\Essential\Nodes;
 
 use Latte\Compiler\Nodes\Php\ExpressionNode;
@@ -17,6 +15,7 @@ use Latte\Compiler\Tag;
 
 /**
  * {debugbreak [$cond]}
+ * Triggers debugger breakpoint.
  */
 class DebugbreakNode extends StatementNode
 {

package/vendor/latte/latte/src/Latte/Essential/Nodes/DefineNode.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\Essential\Nodes;
 
 use Latte\Compiler\Block;
@@ -26,7 +24,8 @@ use function is_string;
 
 
 /**
- * {define [local] name}
+ * {define name($params)} ... {/define}
+ * Defines reusable block with parameters.
  */
 class DefineNode extends StatementNode
 {
@@ -34,7 +33,7 @@ class DefineNode extends StatementNode
 	public AreaNode $content;
 
 
-	/** @return \Generator<int, ?array, array{AreaNode, ?Tag}, static> */
+	/** @return \Generator<int, ?list<string>, array{AreaNode, ?Tag}, static> */
 	public static function create(Tag $tag, TemplateParser $parser): \Generator
 	{
 		$tag->expectArguments();
@@ -61,6 +60,7 @@ class DefineNode extends StatementNode
 	}
 
 
+	/** @return ParameterNode[] */
 	private static function parseParameters(Tag $tag): array
 	{
 		$stream = $tag->parser->stream;
@@ -114,7 +114,7 @@ class DefineNode extends StatementNode
 		$this->block->content = $this->content->print($context); // must be compiled after is added
 
 		return $context->format(
-			'$this->addBlock(%raw, %dump, [[$this, %dump]], %dump);',
+			'$this->addBlock(%raw, %dump, [$this->%raw(...)], %dump);',
 			$context->ensureString($this->block->name, 'Block name'),
 			$context->getEscaper()->export(),
 			$this->block->method,

package/vendor/latte/latte/src/Latte/Essential/Nodes/DoNode.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\Essential\Nodes;
 
 use Latte\Compiler\Nodes\Php\ExpressionNode;
@@ -16,7 +14,8 @@ use Latte\Compiler\Tag;
 
 
 /**
- * {do expression}
+ * {do $expr}
+ * Executes expression without output.
  */
 class DoNode extends StatementNode
 {

package/vendor/latte/latte/src/Latte/Essential/Nodes/DumpNode.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\Essential\Nodes;
 
 use Latte\Compiler\Nodes\Php\ExpressionNode;
@@ -17,6 +15,7 @@ use Latte\Compiler\Tag;
 
 /**
  * {dump [$var]}
+ * Dumps variable or all variables to Tracy Bar.
  */
 class DumpNode extends StatementNode
 {

package/vendor/latte/latte/src/Latte/Essential/Nodes/EmbedNode.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\Essential\Nodes;
 
 use Latte\CompileException;
@@ -23,7 +21,7 @@ use function count, preg_match;
 
 
 /**
- * {embed [block|file] name [,] [params]}
+ * {embed 'file.latte'|#block} ... {/embed}
  */
 class EmbedNode extends StatementNode
 {
@@ -34,7 +32,7 @@ class EmbedNode extends StatementNode
 	public int|string|null $layer;
 
 
-	/** @return \Generator<int, ?array, array{FragmentNode, ?Tag}, static> */
+	/** @return \Generator<int, ?list<string>, array{FragmentNode, ?Tag}, static> */
 	public static function create(Tag $tag, TemplateParser $parser): \Generator
 	{
 		if ($tag->isNAttribute()) {

package/vendor/latte/latte/src/Latte/Essential/Nodes/ExtendsNode.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\Essential\Nodes;
 
 use Latte\CompileException;
@@ -19,8 +17,8 @@ use Latte\Compiler\Tag;
 
 
 /**
- * {extends none | auto | "file"}
- * {layout none | auto | "file"}
+ * {extends 'parent.latte'}
+ * {layout 'layout.latte'}
  */
 class ExtendsNode extends StatementNode
 {