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

package/vendor/latte/latte/src/Latte/Compiler/Position.php

@@ -1,23 +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\Compiler;
 
 use function strlen, strrpos, substr_count;
 
 
-final class Position
+final readonly class Position
 {
 	public function __construct(
-		public readonly int $line = 1,
-		public readonly int $column = 1,
-		public readonly int $offset = 0,
+		public int $line = 1,
+		public int $column = 1,
+		public int $offset = 0,
 	) {
 	}
 

package/vendor/latte/latte/src/Latte/Compiler/PrintContext.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\Compiler;
 
 use Latte\Compiler\Nodes\Php as Nodes;
@@ -14,15 +12,19 @@ use Latte\Compiler\Nodes\Php\Expression;
 use Latte\Compiler\Nodes\Php\OperatorNode;
 use Latte\Compiler\Nodes\Php\Scalar;
 use Latte\ContentType;
-use function addcslashes, array_map, array_pop, end, implode, preg_replace, preg_replace_callback, strtolower, substr, trim, ucfirst;
+use Latte\Feature;
+use function addcslashes, array_pop, count, end, implode, preg_replace, preg_replace_callback, strtolower, substr, trim, ucfirst;
 
 
 /**
- * PHP printing helpers and context.
+ * Context for PHP code generation with escaping management.
  */
 final class PrintContext
 {
+	/** @var Nodes\ParameterNode[] */
 	public array $paramsExtraction = [];
+
+	/** @var array<string, Block> */
 	public array $blocks = [];
 	private int $counter = 0;
 
@@ -32,7 +34,8 @@ final class PrintContext
 
 	public function __construct(
 		string $contentType = ContentType::Html,
-		public bool $migrationWarnings = false,
+		/** @var array<string, bool> */
+		private array $features = [],
 	) {
 		$this->escaperStack[] = new Escaper($contentType);
 	}
@@ -63,7 +66,7 @@ final class PrintContext
 				return match ($fn) {
 					'modify' => $args[$pos]->printSimple($this, $var),
 					'modifyContent' => $args[$pos]->printContentAware($this, $var),
-					'escape' => end($this->escaperStack)->escape($var),
+					'escape' => $this->getEscaper()->escape($var),
 				};
 			},
 			$mask,
@@ -100,12 +103,18 @@ final class PrintContext
 	}
 
 
+	/**
+	 * Pushes current escaper onto stack.
+	 */
 	public function beginEscape(): Escaper
 	{
 		return $this->escaperStack[] = $this->getEscaper();
 	}
 
 
+	/**
+	 * Restores previous escaper from stack.
+	 */
 	public function restoreEscape(): void
 	{
 		array_pop($this->escaperStack);
@@ -114,7 +123,9 @@ final class PrintContext
 
 	public function getEscaper(): Escaper
 	{
-		return clone end($this->escaperStack);
+		$escaper = end($this->escaperStack);
+		assert($escaper instanceof Escaper);
+		return clone $escaper;
 	}
 
 
@@ -134,12 +145,21 @@ final class PrintContext
 	}
 
 
+	/**
+	 * Generates unique ID for temporary variables.
+	 */
 	public function generateId(): int
 	{
 		return $this->counter++;
 	}
 
 
+	public function hasFeature(Feature $feature): bool
+	{
+		return $this->features[$feature->name] ?? false;
+	}
+
+
 	// PHP helpers
 
 
@@ -180,7 +200,7 @@ final class PrintContext
 	public function parenthesize(OperatorNode $parentNode, Node $childNode, int $childPosition): string
 	{
 		[$parentPrec, $parentAssoc] = $parentNode->getOperatorPrecedence();
-		[$childPrec] = $childNode instanceof OperatorNode ? $childNode->getOperatorPrecedence() : null;
+		[$childPrec] = $childNode instanceof OperatorNode ? $childNode->getOperatorPrecedence() : [null];
 		return $childPrec && ($childPrec < $parentPrec || ($parentPrec === $childPrec && $parentAssoc !== $childPosition))
 			? '(' . $childNode->print($this) . ')'
 			: $childNode->print($this);
@@ -189,6 +209,7 @@ final class PrintContext
 
 	/**
 	 * Prints an array of nodes and implodes the printed values with $glue
+	 * @param  (?Node)[]  $nodes
 	 */
 	public function implode(array $nodes, string $glue = ', '): string
 	{

package/vendor/latte/latte/src/Latte/Compiler/Tag.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\Compiler;
 
 use Latte\CompileException;
@@ -16,7 +14,7 @@ use function array_search, in_array;
 
 
 /**
- * Latte tag or n:attribute.
+ * Represents a Latte tag or n:attribute during parsing.
  */
 final class Tag
 {
@@ -34,6 +32,7 @@ final class Tag
 	public int $outputMode = self::OutputNone;
 
 
+	/** @param list<Token> $tokens */
 	public function __construct(
 		public readonly string $name,
 		array $tokens,
@@ -91,7 +90,7 @@ final class Tag
 	{
 		$tag = $this->parent;
 		while ($tag && (
-			!in_array($tag->node ? $tag->node::class : null, $classes, true)
+			!in_array($tag->node ? $tag->node::class : null, $classes, strict: true)
 			|| ($condition && !$condition($tag))
 		)) {
 			$tag = $tag->parent;
@@ -111,7 +110,8 @@ final class Tag
 
 	public function replaceNAttribute(AreaNode $node): void
 	{
-		$index = array_search($this->nAttribute, $this->htmlElement->attributes->children, true);
+		assert($this->htmlElement !== null);
+		$index = array_search($this->nAttribute, $this->htmlElement->attributes->children, strict: true);
 		$this->htmlElement->attributes->children[$index] = $this->nAttribute = $node;
 	}
 }

package/vendor/latte/latte/src/Latte/Compiler/TagLexer.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\Compiler;
 
 use Latte\CompileException;
@@ -211,7 +209,7 @@ final class TagLexer
 				|| isset($m[$type = 'Php_NullsafeObjectOperator'])
 				|| isset($m[$type = 'Php_UndefinedsafeObjectOperator'])
 			) {
-				$this->addToken(constant(Token::class . '::' . $type), $m[$type]);
+				$this->addToken(constant(Token::class . '::' . $type), $m[$type] ?? '');
 				if (isset($m['Php_Whitespace'])) {
 					$this->addToken(Token::Php_Whitespace, $m['Php_Whitespace']);
 				}
@@ -361,8 +359,8 @@ final class TagLexer
 					|| isset($m[$type = 'Php_NullsafeObjectOperator'])
 					|| isset($m[$type = 'Php_UndefinedsafeObjectOperator'])
 				) {
-					$this->addToken(constant(Token::class . '::' . $type), $m[$type]);
-					$this->addToken(Token::Php_Identifier, $m['Php_Identifier']);
+					$this->addToken(constant(Token::class . '::' . $type), $m[$type] ?? '');
+					$this->addToken(Token::Php_Identifier, $m['Php_Identifier'] ?? '');
 
 				} elseif (isset($m['offset'])) {
 					$this->addToken(null, '[');

package/vendor/latte/latte/src/Latte/Compiler/TagParser.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\Compiler;
 
 use Latte;
@@ -38,11 +36,12 @@ final class TagParser
 	public readonly TokenStream $stream;
 	public string $text;
 
-	/** @var \SplObjectStorage<Expression\ArrayNode> */
+	/** @var \SplObjectStorage<Expression\ArrayNode, null> */
 	protected \SplObjectStorage $shortArrays;
 	private readonly int $offsetDelta;
 
 
+	/** @param array<int, mixed>  $tokens */
 	public function __construct(array $tokens)
 	{
 		$this->offsetDelta = $tokens[0]->position->offset;
@@ -124,6 +123,7 @@ final class TagParser
 
 	/**
 	 * Parses variables used in foreach.
+	 * @return array{?Nodes\Php\ExpressionNode, Nodes\Php\ExpressionNode|Nodes\Php\ListNode, bool}
 	 * @internal
 	 */
 	public function parseForeach(): array
@@ -291,13 +291,13 @@ final class TagParser
 	}
 
 
-	public function throwReservedKeywordException(Token $token)
+	public function throwReservedKeywordException(Token $token): never
 	{
 		throw new Latte\CompileException("Keyword '$token->text' cannot be used in Latte.", $token->position);
 	}
 
 
-	protected function checkFunctionName(Expression\FunctionCallNode $func): ExpressionNode
+	private function checkFunctionName(Expression\FunctionCallNode $func): Expression\FunctionCallNode
 	{
 		if ($func->name instanceof NameNode && $func->name->isKeyword()) {
 			$this->throwReservedKeywordException(new Token(0, (string) $func->name, $func->name->position));
@@ -306,7 +306,7 @@ final class TagParser
 	}
 
 
-	protected static function handleBuiltinTypes(NameNode $name): NameNode|Node\IdentifierNode
+	private static function handleBuiltinTypes(NameNode $name): NameNode|Node\IdentifierNode
 	{
 		$builtinTypes = [
 			'bool' => true, 'int' => true, 'float' => true, 'string' => true, 'iterable' => true, 'void' => true,
@@ -320,7 +320,7 @@ final class TagParser
 	}
 
 
-	protected static function parseOffset(string $str, Position $position): Scalar\StringNode|Scalar\IntegerNode
+	private static function parseOffset(string $str, Position $position): Scalar\StringNode|Scalar\IntegerNode
 	{
 		if (!preg_match('/^(?:0|-?[1-9][0-9]*)$/', $str)) {
 			return new Scalar\StringNode($str, $position);
@@ -335,8 +335,8 @@ final class TagParser
 	}
 
 
-	/** @param ExpressionNode[] $parts */
-	protected function parseDocString(
+	/** @param ExpressionNode[]  $parts */
+	private function parseDocString(
 		string $startToken,
 		array $parts,
 		string $endToken,
@@ -458,7 +458,10 @@ final class TagParser
 	}
 
 
-	/** @param  Token[]  $tokens */
+	/**
+	 * @param  Token[]  $tokens
+	 * @return Token[]
+	 */
 	private function filterTokens(array $tokens): array
 	{
 		$this->text = '';

package/vendor/latte/latte/src/Latte/Compiler/TagParserData.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\Compiler;
 
 use Latte\Compiler\Nodes\Php as Node;
@@ -428,7 +426,7 @@ trait TagParserData
 	/** Semantic value stack (contains values of tokens and semantic action results) */
 	protected array $semStack;
 
-	/** @var Token[] Start attribute stack */
+	/** @var array<int, ?Token> Start attribute stack */
 	protected array $startTokenStack;
 
 

package/vendor/latte/latte/src/Latte/Compiler/TemplateGenerator.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\Compiler;
 
 use Latte\ContentType;
@@ -31,10 +29,11 @@ final class TemplateGenerator
 
 	/**
 	 * Builds template class.
+	 * @param array<string, bool>  $features
 	 */
-	public function buildClass(Nodes\TemplateNode $node, bool $migrationWarnings): void
+	public function buildClass(Nodes\TemplateNode $node, array $features = []): void
 	{
-		$context = new PrintContext($node->contentType, $migrationWarnings);
+		$context = new PrintContext($node->contentType, $features);
 		$this->generateBase($node, $context);
 		$this->generateBlocks($context);
 	}
@@ -47,11 +46,11 @@ final class TemplateGenerator
 	{
 		$members = [];
 		foreach ($this->constants as $name => $value) {
-			$members[] = "\tpublic const $name = " . PhpHelpers::dump($value, true) . ';';
+			$members[] = "\tpublic const $name = " . PhpHelpers::dump($value, multiline: true) . ';';
 		}
 
 		foreach ($this->properties as $name => $value) {
-			$members[] = "\tpublic $$name = " . PhpHelpers::dump($value, true) . ';';
+			$members[] = "\tpublic $$name = " . PhpHelpers::dump($value, multiline: true) . ';';
 		}
 
 		foreach (array_filter($this->methods) as $name => $method) {
@@ -87,7 +86,7 @@ final class TemplateGenerator
 			$node->head,
 			fn(Node $node) => $node instanceof Nodes\TextNode ? new Nodes\NopNode : $node,
 		);
-		$code = $head->print($context);
+		$code = $head?->print($context) ?? '';
 		if ($code || $context->paramsExtraction) {
 			$code .= 'return get_defined_vars();';
 			$code = self::buildParams($code, $context->paramsExtraction, '$this->params', $context);
@@ -100,13 +99,15 @@ final class TemplateGenerator
 	}
 
 
-	/** @param  Block[]  $blocks */
 	private function generateBlocks(PrintContext $context): void
 	{
 		$contentType = $context->getEscaper()->getContentType();
 		foreach ($context->blocks as $block) {
-			if (!$block->isDynamic()) {
-				$meta[$block->layer][$block->name->value] = $contentType === $block->escaping
+			$name = $block->name;
+			if (!$block->isDynamic()
+				&& ($name instanceof Nodes\Php\Scalar\StringNode || $name instanceof Nodes\Php\Scalar\IntegerNode)
+			) {
+				$meta[$block->layer][$name->value] = $contentType === $block->escaping
 					? $block->method
 					: [$block->method, $block->escaping];
 			}
@@ -132,6 +133,7 @@ final class TemplateGenerator
 	}
 
 
+	/** @param Nodes\Php\ParameterNode[] $params */
 	private function buildParams(string $body, array $params, string $cont, PrintContext $context): string
 	{
 		if (!str_contains($body, '$') && !str_contains($body, 'get_defined_vars()')) {

package/vendor/latte/latte/src/Latte/Compiler/TemplateLexer.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\Compiler;
 
 use Latte\CompileException;
@@ -14,6 +12,9 @@ use function array_merge, array_pop, array_shift, array_unshift, constant, deche
 use const PREG_UNMATCHED_AS_NULL;
 
 
+/**
+ * Tokenizes Latte template source code.
+ */
 final class TemplateLexer
 {
 	public const
@@ -40,6 +41,8 @@ final class TemplateLexer
 
 	private string $openDelimiter = '';
 	private string $closeDelimiter = '';
+
+	/** @var array{string, string}[] */
 	private array $delimiters = [];
 	private TagLexer $tagLexer;
 
@@ -79,6 +82,7 @@ final class TemplateLexer
 	}
 
 
+	/** @return Token[] */
 	private function statePlain(): array
 	{
 		return $this->match('~
@@ -93,6 +97,7 @@ final class TemplateLexer
 	}
 
 
+	/** @return Token[] */
 	private function stateLatteTag(): array
 	{
 		$tokens[] = $this->match('~
@@ -106,6 +111,7 @@ final class TemplateLexer
 	}
 
 
+	/** @return Token[] */
 	private function stateLatteContent(): array
 	{
 		$tokens[] = $this->tagLexer->tokenizePartially($this->input, $this->position);
@@ -120,6 +126,7 @@ final class TemplateLexer
 	}
 
 
+	/** @return Token[] */
 	private function stateLatteComment(): array
 	{
 		return $this->match('~
@@ -132,6 +139,7 @@ final class TemplateLexer
 	}
 
 
+	/** @return Token[] */
 	private function stateHtmlText(): array
 	{
 		return $this->match('~(?J)
@@ -148,6 +156,7 @@ final class TemplateLexer
 	}
 
 
+	/** @return Token[] */
 	private function stateHtmlTag(): array
 	{
 		return $this->match('~(?J)
@@ -165,6 +174,7 @@ final class TemplateLexer
 	}
 
 
+	/** @return Token[] */
 	private function stateHtmlQuotedValue(string $quote): array
 	{
 		return $this->match('~
@@ -179,6 +189,7 @@ final class TemplateLexer
 	}
 
 
+	/** @return Token[] */
 	private function stateHtmlQuotedNAttrValue(string $quote): array
 	{
 		return $this->match('~
@@ -191,6 +202,7 @@ final class TemplateLexer
 	}
 
 
+	/** @return Token[] */
 	private function stateHtmlRawText(string $tagName): array
 	{
 		return $this->match('~
@@ -206,6 +218,7 @@ final class TemplateLexer
 	}
 
 
+	/** @return Token[] */
 	private function stateHtmlComment(): array
 	{
 		return $this->match('~(?J)
@@ -220,6 +233,7 @@ final class TemplateLexer
 	}
 
 
+	/** @return Token[] */
 	private function stateHtmlBogus(): array
 	{
 		return $this->match('~
@@ -257,15 +271,15 @@ final class TemplateLexer
 	}
 
 
-	public function setState(string $state, ...$args): void
+	public function setState(string $state, mixed ...$args): void
 	{
 		$this->states[0] = ['name' => $state, 'args' => $args];
 	}
 
 
-	public function pushState(string $state, ...$args): void
+	public function pushState(string $state, mixed ...$args): void
 	{
-		array_unshift($this->states, null);
+		array_unshift($this->states, ['name' => '', 'args' => []]);
 		$this->setState($state, ...$args);
 	}
 
@@ -305,7 +319,7 @@ final class TemplateLexer
 
 	public function popSyntax(): void
 	{
-		[$this->openDelimiter, $this->closeDelimiter] = array_pop($this->delimiters);
+		[$this->openDelimiter, $this->closeDelimiter] = array_pop($this->delimiters) ?? throw new \LogicException;
 	}