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

package/vendor/latte/latte/src/Latte/Compiler/Nodes/StatementNode.php

@@ -1,15 +1,19 @@
-<?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\Nodes;
 
 
+/**
+ * Base for Latte tags like {if}, {foreach}, {block}.
+ *
+ * Extend this class when creating custom tags. Implement static create(Tag)
+ * for parsing and print(PrintContext) for PHP code generation.
+ */
 abstract class StatementNode extends AreaNode
 {
 }

package/vendor/latte/latte/src/Latte/Compiler/Nodes/TemplateNode.php

@@ -1,18 +1,19 @@
-<?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\Nodes;
 
 use Latte\Compiler\Node;
 use Latte\Compiler\PrintContext;
 
 
+/**
+ * Root of template AST containing head declarations and main content fragment.
+ */
 final class TemplateNode extends Node
 {
 	public FragmentNode $head;

package/vendor/latte/latte/src/Latte/Compiler/Nodes/TextNode.php

@@ -1,18 +1,20 @@
-<?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\Nodes;
 
 use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+use function trim, var_export;
 
 
+/**
+ * Literal text content in template.
+ */
 class TextNode extends AreaNode
 {
 	public function __construct(
@@ -26,7 +28,7 @@ class TextNode extends AreaNode
 	{
 		return $this->content === ''
 			? ''
-			: 'echo ' . var_export($this->content, true) . ";\n";
+			: 'echo ' . var_export($this->content, return: true) . ";\n";
 	}
 
 

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

@@ -1,15 +1,15 @@
-<?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;
+use function bindec, chr, count, explode, fclose, fwrite, hexdec, in_array, is_array, is_resource, max, octdec, preg_match, preg_replace, preg_replace_callback, proc_close, proc_open, str_repeat, str_replace, stream_get_contents, strip_tags, stripslashes, strlen, strpbrk, substr, substr_count, substr_replace, token_get_all, trim, var_export;
+use const T_CATCH, T_CLOSE_TAG, T_COMMENT, T_CONSTANT_ENCAPSED_STRING, T_CURLY_OPEN, T_DOC_COMMENT, T_DOLLAR_OPEN_CURLY_BRACES, T_ECHO, T_ELSE, T_ELSEIF, T_FINALLY, T_OBJECT_OPERATOR, T_OPEN_TAG, T_WHITESPACE;
 
 
 /**
@@ -47,11 +47,11 @@ final class PhpHelpers
 				} elseif ($name === T_WHITESPACE) {
 					$prev = $tokens[$n - 1];
 					$lines = substr_count($token, "\n");
-					if ($prev === '}' && in_array($next[0], [T_ELSE, T_ELSEIF, T_CATCH, T_FINALLY], true)) {
+					if ($prev === '}' && in_array($next[0], [T_ELSE, T_ELSEIF, T_CATCH, T_FINALLY], strict: true)) {
 						$token = ' ';
 					} elseif ($prev === '{' || $prev === '}' || $prev === ';' || $lines) {
 						$token = str_repeat("\n", max(1, $lines)) . str_repeat("\t", $level); // indent last line
-					} elseif ($prev[0] === T_OPEN_TAG) {
+					} elseif (is_array($prev) && $prev[0] === T_OPEN_TAG) {
 						$token = '';
 					}
 
@@ -68,7 +68,7 @@ final class PhpHelpers
 					throw new \LogicException('Unexpected token');
 
 				} else {
-					if (in_array($name, [T_CURLY_OPEN, T_DOLLAR_OPEN_CURLY_BRACES], true)) {
+					if (in_array($name, [T_CURLY_OPEN, T_DOLLAR_OPEN_CURLY_BRACES], strict: true)) {
 						$level++;
 					}
 
@@ -98,10 +98,13 @@ final class PhpHelpers
 	}
 
 
+	/**
+	 * Exports value to PHP code representation.
+	 */
 	public static function dump(mixed $value, bool $multiline = false): string
 	{
 		if (is_array($value)) {
-			$indexed = $value && array_keys($value) === range(0, count($value) - 1);
+			$indexed = array_is_list($value);
 			$s = '';
 			foreach ($value as $k => $v) {
 				$s .= $multiline
@@ -113,33 +116,37 @@ final class PhpHelpers
 		} elseif ($value === null) {
 			return 'null';
 		} else {
-			return var_export($value, true);
+			return var_export($value, return: true);
 		}
 	}
 
 
+	/**
+	 * Optimizes consecutive echo statements into single call.
+	 */
 	public static function optimizeEcho(string $source): string
 	{
 		$res = '';
 		$tokens = token_get_all($source);
 		$start = null;
+		$str = '';
 
-		for ($i = 0; $i < \count($tokens); $i++) {
+		for ($i = 0; $i < count($tokens); $i++) {
 			$token = $tokens[$i];
 			if ($token[0] === T_ECHO) {
-				if (!$start) {
+				if ($start === null) {
 					$str = '';
 					$start = strlen($res);
 				}
 
-			} elseif ($start && $token[0] === T_CONSTANT_ENCAPSED_STRING && $token[1][0] === "'") {
+			} elseif ($start !== null && $token[0] === T_CONSTANT_ENCAPSED_STRING && $token[1][0] === "'") {
 				$str .= stripslashes(substr($token[1], 1, -1));
 
-			} elseif ($start && $token === ';') {
+			} elseif ($start !== null && $token === ';') {
 				if ($str !== '') {
 					$res = substr_replace(
 						$res,
-						'echo ' . ($str === "\n" ? '"\n"' : var_export($str, true)),
+						'echo ' . ($str === "\n" ? '"\n"' : var_export($str, return: true)),
 						$start,
 						strlen($res) - $start,
 					);
@@ -156,7 +163,10 @@ final class PhpHelpers
 	}
 
 
-	public static function decodeNumber(string $str, &$base = null): int|float|null
+	/**
+	 * Decodes number string to int or float value.
+	 */
+	public static function decodeNumber(string $str, ?int &$base = null): int|float|null
 	{
 		$str = str_replace('_', '', $str);
 
@@ -185,7 +195,7 @@ final class PhpHelpers
 		}
 
 		return preg_replace_callback(
-			'~\\\\([\\\\$nrtfve]|[xX][0-9a-fA-F]{1,2}|[0-7]{1,3}|u\{([0-9a-fA-F]+)\})~',
+			'~\\\([\\\$nrtfve]|[xX][0-9a-fA-F]{1,2}|[0-7]{1,3}|u\{([0-9a-fA-F]+)\})~',
 			function ($matches) {
 				$ch = $matches[1];
 				$replacements = [
@@ -201,11 +211,15 @@ final class PhpHelpers
 				if (isset($replacements[$ch])) {
 					return $replacements[$ch];
 				} elseif ($ch[0] === 'x' || $ch[0] === 'X') {
-					return chr(hexdec(substr($ch, 1)));
+					return chr((int) hexdec(substr($ch, 1)));
 				} elseif ($ch[0] === 'u') {
-					return self::codePointToUtf8(hexdec($matches[2]));
+					return self::codePointToUtf8((int) hexdec($matches[2]));
 				} else {
-					return chr(octdec($ch));
+					$num = (int) octdec($ch);
+					if ($num > 255) {
+						throw new CompileException("Octal escape sequence \\$ch is greater than \\377");
+					}
+					return chr($num);
 				}
 			},
 			$str,

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

@@ -1,21 +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,82 +1,42 @@
-<?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;
 use Latte\Compiler\Nodes\Php\Expression;
+use Latte\Compiler\Nodes\Php\OperatorNode;
 use Latte\Compiler\Nodes\Php\Scalar;
 use Latte\ContentType;
+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.
- * The parts are based on great nikic/PHP-Parser project by Nikita Popov.
+ * Context for PHP code generation with escaping management.
  */
 final class PrintContext
 {
+	/** @var Nodes\ParameterNode[] */
 	public array $paramsExtraction = [];
-	public array $blocks = [];
 
-	private array $exprPrecedenceMap = [
-		// [precedence, associativity] (-1 is %left, 0 is %nonassoc and 1 is %right)
-		Expression\PreOpNode::class              => [10,  1],
-		Expression\PostOpNode::class             => [10, -1],
-		Expression\UnaryOpNode::class            => [10,  1],
-		Expression\CastNode::class               => [10,  1],
-		Expression\ErrorSuppressNode::class      => [10,  1],
-		Expression\InstanceofNode::class         => [20,  0],
-		Expression\NotNode::class                => [30,  1],
-		Expression\TernaryNode::class            => [150,  0],
-		// parser uses %left for assignments, but they really behave as %right
-		Expression\AssignNode::class             => [160,  1],
-		Expression\AssignOpNode::class           => [160,  1],
-	];
-
-	private array $binaryPrecedenceMap = [
-		// [precedence, associativity] (-1 is %left, 0 is %nonassoc and 1 is %right)
-		'**'  => [0, 1],
-		'*'   => [40, -1],
-		'/'   => [40, -1],
-		'%'   => [40, -1],
-		'+'   => [50, -1],
-		'-'   => [50, -1],
-		'.'   => [50, -1],
-		'<<'  => [60, -1],
-		'>>'  => [60, -1],
-		'<'   => [70, 0],
-		'<='  => [70, 0],
-		'>'   => [70, 0],
-		'>='  => [70, 0],
-		'=='  => [80, 0],
-		'!='  => [80, 0],
-		'===' => [80, 0],
-		'!==' => [80, 0],
-		'<=>' => [80, 0],
-		'&'   => [90, -1],
-		'^'   => [100, -1],
-		'|'   => [110, -1],
-		'&&'  => [120, -1],
-		'||'  => [130, -1],
-		'??'  => [140, 1],
-		'and' => [170, -1],
-		'xor' => [180, -1],
-		'or'  => [190, -1],
-	];
+	/** @var array<string, Block> */
+	public array $blocks = [];
 	private int $counter = 0;
 
 	/** @var Escaper[] */
 	private array $escaperStack = [];
 
 
-	public function __construct(string $contentType = ContentType::Html)
-	{
+	public function __construct(
+		string $contentType = ContentType::Html,
+		/** @var array<string, bool> */
+		private array $features = [],
+	) {
 		$this->escaperStack[] = new Escaper($contentType);
 	}
 
@@ -106,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,
@@ -115,36 +75,46 @@ final class PrintContext
 		return preg_replace_callback(
 			'#([,+]?\s*)? % (\d+) \. ([a-z]{3,}) (\?)? (\s*\+\s*)? ()#xi',
 			function ($m) use ($args) {
-				[, $l, $pos, $format, $cond, $r] = $m;
+				[, $left, $pos, $format, $cond, $right] = $m;
 				$arg = $args[$pos];
 
 				$code = match ($format) {
 					'dump' => PhpHelpers::dump($arg),
-					'node' => $arg ? $arg->print($this) : '',
+					'node' => match (true) {
+						!$arg => '',
+						$arg instanceof OperatorNode && $arg->getOperatorPrecedence() < Expression\AssignNode::Precedence => '(' . $arg->print($this) . ')',
+						default => $arg->print($this),
+					},
 					'raw' => (string) $arg,
 					'args' => $this->implode($arg instanceof Expression\ArrayNode ? $arg->toArguments() : $arg),
-					'line' => $arg?->line ? "/* line $arg->line */" : '',
+					'line' => $arg?->line ? "/* pos $arg->line" . ($arg->column ? ":$arg->column" : '') . ' */' : '',
 				};
 
-				if ($cond && ($code === '[]' || $code === '')) {
-					return $r ? $l : $r;
+				if ($cond && ($code === '[]' || $code === '' || $code === 'null')) {
+					return $right ? $left : $right;
 				}
 
 				return $code === ''
-					? trim($l) . $r
-					: $l . $code . $r;
+					? trim($left) . $right
+					: $left . $code . $right;
 			},
 			$mask,
 		);
 	}
 
 
+	/**
+	 * 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);
@@ -153,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;
 	}
 
 
@@ -173,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
 
 
@@ -190,67 +171,45 @@ final class PrintContext
 	}
 
 
-	/**
-	 * Prints an infix operation while taking precedence into account.
-	 */
+	#[\Deprecated]
 	public function infixOp(Node $node, Node $leftNode, string $operatorString, Node $rightNode): string
 	{
-		[$precedence, $associativity] = $this->getPrecedence($node);
-		return $this->prec($leftNode, $precedence, $associativity, -1)
+		return $this->parenthesize($node, $leftNode, OperatorNode::AssocLeft)
 			. $operatorString
-			. $this->prec($rightNode, $precedence, $associativity, 1);
+			. $this->parenthesize($node, $rightNode, OperatorNode::AssocRight);
 	}
 
 
-	/**
-	 * Prints a prefix operation while taking precedence into account.
-	 */
+	#[\Deprecated]
 	public function prefixOp(Node $node, string $operatorString, Node $expr): string
 	{
-		[$precedence, $associativity] = $this->getPrecedence($node);
-		return $operatorString . $this->prec($expr, $precedence, $associativity, 1);
+		return $operatorString . $this->parenthesize($node, $expr, OperatorNode::AssocRight);
 	}
 
 
-	/**
-	 * Prints a postfix operation while taking precedence into account.
-	 */
+	#[\Deprecated]
 	public function postfixOp(Node $node, Node $var, string $operatorString): string
 	{
-		[$precedence, $associativity] = $this->getPrecedence($node);
-		return $this->prec($var, $precedence, $associativity, -1) . $operatorString;
+		return $this->parenthesize($node, $var, OperatorNode::AssocLeft) . $operatorString;
 	}
 
 
 	/**
 	 * Prints an expression node with the least amount of parentheses necessary to preserve the meaning.
 	 */
-	private function prec(Node $node, int $parentPrecedence, int $parentAssociativity, int $childPosition): string
-	{
-		$precedence = $this->getPrecedence($node);
-		if ($precedence) {
-			$childPrecedence = $precedence[0];
-			if ($childPrecedence > $parentPrecedence
-				|| ($parentPrecedence === $childPrecedence && $parentAssociativity !== $childPosition)
-			) {
-				return '(' . $node->print($this) . ')';
-			}
-		}
-
-		return $node->print($this);
-	}
-
-
-	private function getPrecedence(Node $node): ?array
+	public function parenthesize(OperatorNode $parentNode, Node $childNode, int $childPosition): string
 	{
-		return $node instanceof Expression\BinaryOpNode
-			? $this->binaryPrecedenceMap[$node->operator]
-			: $this->exprPrecedenceMap[$node::class] ?? null;
+		[$parentPrec, $parentAssoc] = $parentNode->getOperatorPrecedence();
+		[$childPrec] = $childNode instanceof OperatorNode ? $childNode->getOperatorPrecedence() : [null];
+		return $childPrec && ($childPrec < $parentPrec || ($parentPrec === $childPrec && $parentAssoc !== $childPosition))
+			? '(' . $childNode->print($this) . ')'
+			: $childNode->print($this);
 	}
 
 
 	/**
 	 * Prints an array of nodes and implodes the printed values with $glue
+	 * @param  (?Node)[]  $nodes
 	 */
 	public function implode(array $nodes, string $glue = ', '): string
 	{
@@ -292,11 +251,8 @@ final class PrintContext
 			|| $expr instanceof Expression\VariableNode
 			|| $expr instanceof Expression\ArrayAccessNode
 			|| $expr instanceof Expression\FunctionCallNode
-			|| $expr instanceof Expression\FunctionCallableNode
 			|| $expr instanceof Expression\MethodCallNode
-			|| $expr instanceof Expression\MethodCallableNode
 			|| $expr instanceof Expression\StaticMethodCallNode
-			|| $expr instanceof Expression\StaticMethodCallableNode
 			|| $expr instanceof Expression\ArrayNode
 			? $expr->print($this)
 			: '(' . $expr->print($this) . ')';
@@ -314,11 +270,8 @@ final class PrintContext
 			|| $expr instanceof Expression\PropertyFetchNode
 			|| $expr instanceof Expression\StaticPropertyFetchNode
 			|| $expr instanceof Expression\FunctionCallNode
-			|| $expr instanceof Expression\FunctionCallableNode
 			|| $expr instanceof Expression\MethodCallNode
-			|| $expr instanceof Expression\MethodCallableNode
 			|| $expr instanceof Expression\StaticMethodCallNode
-			|| $expr instanceof Expression\StaticMethodCallableNode
 			|| $expr instanceof Expression\ArrayNode
 			|| $expr instanceof Scalar\StringNode
 			|| $expr instanceof Scalar\BooleanNode
@@ -338,4 +291,19 @@ final class PrintContext
 		$items = array_map(fn(Nodes\ArgumentNode $arg) => $arg->toArrayItem(), $args);
 		return '[' . $this->implode($items) . ']';
 	}
+
+
+	/**
+	 * Ensures that expression evaluates to string or throws exception.
+	 */
+	public function ensureString(Nodes\ExpressionNode $name, string $entity): string
+	{
+		return $name instanceof Scalar\StringNode
+			? $name->print($this)
+			: $this->format(
+				'(LR\Helpers::stringOrNull($ʟ_tmp = %node) ?? throw new InvalidArgumentException(sprintf(%dump, get_debug_type($ʟ_tmp))))',
+				$name,
+				$entity . ' must be a string, %s given.',
+			);
+	}
 }

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

@@ -1,21 +1,20 @@
-<?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;
 use Latte\Compiler\Nodes\AreaNode;
 use Latte\Compiler\Nodes\Html\ElementNode;
+use function array_search, in_array;
 
 
 /**
- * Latte tag or n:attribute.
+ * Represents a Latte tag or n:attribute during parsing.
  */
 final class Tag
 {
@@ -33,19 +32,20 @@ final class Tag
 	public int $outputMode = self::OutputNone;
 
 
+	/** @param list<Token> $tokens */
 	public function __construct(
-		public /*readonly*/ string $name,
+		public readonly string $name,
 		array $tokens,
-		public /*readonly*/ Position $position,
-		public /*readonly*/ bool $void = false,
-		public /*readonly*/ bool $closing = false,
-		public /*readonly*/ bool $inHead = false,
-		public /*readonly*/ bool $inTag = false,
-		public /*readonly*/ ?ElementNode $htmlElement = null,
+		public readonly Position $position,
+		public readonly bool $void = false,
+		public readonly bool $closing = false,
+		public readonly bool $inHead = false,
+		public readonly bool $inTag = false,
+		public readonly ?ElementNode $htmlElement = null,
 		public ?self $parent = null,
-		public /*readonly*/ ?string $prefix = null,
+		public readonly ?string $prefix = null,
 		public ?AreaNode $node = null,
-		public ?AreaNode $nAttributeNode = null,
+		public ?AreaNode $nAttribute = null,
 	) {
 		$this->parser = new TagParser($tokens);
 	}
@@ -90,7 +90,7 @@ final class Tag
 	{
 		$tag = $this->parent;
 		while ($tag && (
-			(!in_array($tag->node ? $tag->node::class : null, $classes, true) && !in_array($tag->name, $classes, true))
+			!in_array($tag->node ? $tag->node::class : null, $classes, strict: true)
 			|| ($condition && !$condition($tag))
 		)) {
 			$tag = $tag->parent;
@@ -110,7 +110,8 @@ final class Tag
 
 	public function replaceNAttribute(AreaNode $node): void
 	{
-		$index = array_search($this->nAttributeNode, $this->htmlElement->attributes->children, true);
-		$this->htmlElement->attributes->children[$index] = $this->nAttributeNode = $node;
+		assert($this->htmlElement !== null);
+		$index = array_search($this->nAttribute, $this->htmlElement->attributes->children, strict: true);
+		$this->htmlElement->attributes->children[$index] = $this->nAttribute = $node;
 	}
 }