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

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

@@ -1,17 +1,18 @@
-<?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;
 use Latte\Compiler\Nodes\Html\ElementNode;
 use Latte\ContentType;
-use Latte\Runtime\Filters;
+use Latte\Runtime\Helpers;
+use Latte\Runtime\HtmlHelpers;
+use function in_array, is_string, str_starts_with, strtolower;
 
 
 /**
@@ -23,8 +24,7 @@ final class Escaper
 		Text = 'text',
 		JavaScript = 'js',
 		Css = 'css',
-		ICal = 'ical',
-		Url = 'url';
+		ICal = 'ical';
 
 	public const
 		HtmlText = 'html',
@@ -36,55 +36,49 @@ final class Escaper
 
 	private const Convertors = [
 		self::Text => [
-			self::HtmlText => 'escapeHtmlText',
-			self::HtmlAttribute => 'escapeHtmlAttr',
-			self::HtmlAttribute . '/' . self::JavaScript => 'escapeHtmlAttr',
-			self::HtmlAttribute . '/' . self::Css => 'escapeHtmlAttr',
-			self::HtmlAttribute . '/' . self::Url => 'escapeHtmlAttr',
-			self::HtmlComment => 'escapeHtmlComment',
-			'xml' => 'escapeXml',
-			'xml/attr' => 'escapeXml',
+			self::HtmlText => 'HtmlHelpers::escapeText',
+			self::HtmlAttribute => 'HtmlHelpers::escapeAttr',
+			self::HtmlAttribute . '/' . self::JavaScript => 'HtmlHelpers::escapeAttr',
+			self::HtmlAttribute . '/' . self::Css => 'HtmlHelpers::escapeAttr',
+			self::HtmlComment => 'HtmlHelpers::escapeComment',
+			'xml' => 'XmlHelpers::escapeText',
+			'xml/attr' => 'XmlHelpers::escapeAttr',
 		],
 		self::JavaScript => [
-			self::HtmlText => 'escapeHtmlText',
-			self::HtmlAttribute => 'escapeHtmlAttr',
-			self::HtmlAttribute . '/' . self::JavaScript => 'escapeHtmlAttr',
-			self::HtmlRawText . '/' . self::JavaScript => 'convertJSToHtmlRawText',
-			self::HtmlComment => 'escapeHtmlComment',
+			self::HtmlText => 'HtmlHelpers::escapeText',
+			self::HtmlAttribute => 'HtmlHelpers::escapeAttr',
+			self::HtmlAttribute . '/' . self::JavaScript => 'HtmlHelpers::escapeAttr',
+			self::HtmlRawText . '/' . self::JavaScript => 'HtmlHelpers::convertJSToRawText',
+			self::HtmlComment => 'HtmlHelpers::escapeComment',
 		],
 		self::Css => [
-			self::HtmlText => 'escapeHtmlText',
-			self::HtmlAttribute => 'escapeHtmlAttr',
-			self::HtmlAttribute . '/' . self::Css => 'escapeHtmlAttr',
-			self::HtmlRawText . '/' . self::Css => 'convertJSToHtmlRawText',
-			self::HtmlComment => 'escapeHtmlComment',
+			self::HtmlText => 'HtmlHelpers::escapeText',
+			self::HtmlAttribute => 'HtmlHelpers::escapeAttr',
+			self::HtmlAttribute . '/' . self::Css => 'HtmlHelpers::escapeAttr',
+			self::HtmlRawText . '/' . self::Css => 'HtmlHelpers::convertJSToRawText',
+			self::HtmlComment => 'HtmlHelpers::escapeComment',
 		],
 		self::HtmlText => [
-			self::HtmlAttribute => 'convertHtmlToHtmlAttr',
-			self::HtmlAttribute . '/' . self::JavaScript => 'convertHtmlToHtmlAttr',
-			self::HtmlAttribute . '/' . self::Css => 'convertHtmlToHtmlAttr',
-			self::HtmlAttribute . '/' . self::Url => 'convertHtmlToHtmlAttr',
-			self::HtmlComment => 'escapeHtmlComment',
-			self::HtmlRawText . '/' . self::HtmlText => 'convertHtmlToHtmlRawText',
+			self::Text => 'HtmlHelpers::convertHtmlToText',
+			self::HtmlAttribute => 'HtmlHelpers::convertHtmlToAttr',
+			self::HtmlAttribute . '/' . self::JavaScript => 'HtmlHelpers::convertHtmlToAttr',
+			self::HtmlAttribute . '/' . self::Css => 'HtmlHelpers::convertHtmlToAttr',
+			self::HtmlComment => 'HtmlHelpers::escapeComment',
+			self::HtmlRawText . '/' . self::HtmlText => 'HtmlHelpers::convertHtmlToRawText',
 		],
 		self::HtmlAttribute => [
-			self::HtmlText => 'convertHtmlToHtmlAttr',
-		],
-		self::HtmlAttribute . '/' . self::Url => [
-			self::HtmlText => 'convertHtmlToHtmlAttr',
-			self::HtmlAttribute => 'nop',
+			self::HtmlText => 'HtmlHelpers::convertAttrToHtml',
 		],
 	];
 
 	private string $state = '';
-	private string $tag = '';
 	private string $subType = '';
 
 
 	public function __construct(
 		private string $contentType,
 	) {
-		$this->state = in_array($contentType, [ContentType::Html, ContentType::Xml], true)
+		$this->state = in_array($contentType, [ContentType::Html, ContentType::Xml], strict: true)
 			? self::HtmlText
 			: $contentType;
 	}
@@ -118,18 +112,11 @@ final class Escaper
 	{
 		if ($el->isRawText()) {
 			$this->state = self::HtmlRawText;
-			$this->subType = self::Text;
 			if ($el->is('script')) {
 				$type = $el->getAttribute('type');
-				if ($type === true || $type === null
-					|| is_string($type) && preg_match('#((application|text)/(((x-)?java|ecma|j|live)script|json)|application/.+\+json|text/plain|module|importmap|)$#Ai', $type)
-				) {
-					$this->subType = self::JavaScript;
-
-				} elseif (is_string($type) && preg_match('#text/((x-)?template|html)$#Ai', $type)) {
-					$this->subType = self::HtmlText;
-				}
-
+				$this->subType = $type === true || $type === null
+					? self::JavaScript
+					: (is_string($type) ? HtmlHelpers::classifyScriptType($type) : '');
 			} elseif ($el->is('style')) {
 				$this->subType = self::Css;
 			}
@@ -144,7 +131,6 @@ final class Escaper
 	public function enterHtmlTag(string $name): void
 	{
 		$this->state = self::HtmlTag;
-		$this->tag = strtolower($name);
 	}
 
 
@@ -166,10 +152,6 @@ final class Escaper
 				$this->subType = self::JavaScript;
 			} elseif ($name === 'style') {
 				$this->subType = self::Css;
-			} elseif ((in_array($name, ['href', 'src', 'action', 'formaction'], true)
-				|| ($name === 'data' && $this->tag === 'object'))
-			) {
-				$this->subType = self::Url;
 			}
 		}
 	}
@@ -191,56 +173,55 @@ final class Escaper
 	{
 		return match ($this->contentType) {
 			ContentType::Html => match ($this->state) {
-				self::HtmlText => 'LR\Filters::escapeHtmlText(' . $str . ')',
-				self::HtmlTag => 'LR\Filters::escapeHtmlTag(' . $str . ')',
+				self::HtmlText => 'LR\HtmlHelpers::escapeText(' . $str . ')',
+				self::HtmlTag => 'LR\HtmlHelpers::escapeTag(' . $str . ')',
 				self::HtmlAttribute => match ($this->subType) {
-					'',
-					self::Url => 'LR\Filters::escapeHtmlAttr(' . $str . ')',
-					self::JavaScript => 'LR\Filters::escapeHtmlAttr(LR\Filters::escapeJs(' . $str . '))',
-					self::Css => 'LR\Filters::escapeHtmlAttr(LR\Filters::escapeCss(' . $str . '))',
+					'' => 'LR\HtmlHelpers::escapeAttr(' . $str . ')',
+					self::JavaScript => 'LR\HtmlHelpers::escapeAttr(LR\Helpers::escapeJs(' . $str . '))',
+					self::Css => 'LR\HtmlHelpers::escapeAttr(LR\Helpers::escapeCss(' . $str . '))',
 				},
-				self::HtmlComment => 'LR\Filters::escapeHtmlComment(' . $str . ')',
-				self::HtmlBogusTag => 'LR\Filters::escapeHtml(' . $str . ')',
+				self::HtmlComment => 'LR\HtmlHelpers::escapeComment(' . $str . ')',
+				self::HtmlBogusTag => 'LR\HtmlHelpers::escapeTag(' . $str . ')',
 				self::HtmlRawText => match ($this->subType) {
-					self::Text => 'LR\Filters::convertJSToHtmlRawText(' . $str . ')', // sanitization, escaping is not possible
-					self::HtmlText => 'LR\Filters::escapeHtmlRawTextHtml(' . $str . ')',
-					self::JavaScript => 'LR\Filters::escapeJs(' . $str . ')',
-					self::Css => 'LR\Filters::escapeCss(' . $str . ')',
+					self::Text => 'LR\HtmlHelpers::convertJSToRawText(' . $str . ')', // sanitization, escaping is not possible
+					self::HtmlText => 'LR\HtmlHelpers::escapeRawHtml(' . $str . ')',
+					self::JavaScript => 'LR\Helpers::escapeJs(' . $str . ')',
+					self::Css => 'LR\Helpers::escapeCss(' . $str . ')',
 				},
 				default => throw new \LogicException("Unknown context $this->contentType, $this->state."),
 			},
 			ContentType::Xml => match ($this->state) {
-				self::HtmlText,
-				self::HtmlBogusTag => 'LR\Filters::escapeXml(' . $str . ')',
-				self::HtmlAttribute => 'LR\Filters::escapeXml(' . $str . ')',
-				self::HtmlComment => 'LR\Filters::escapeHtmlComment(' . $str . ')',
-				self::HtmlTag => 'LR\Filters::escapeXmlTag(' . $str . ')',
+				self::HtmlText => 'LR\XmlHelpers::escapeText(' . $str . ')',
+				self::HtmlBogusTag => 'LR\XmlHelpers::escapeTag(' . $str . ')',
+				self::HtmlAttribute => 'LR\XmlHelpers::escapeAttr(' . $str . ')',
+				self::HtmlComment => 'LR\HtmlHelpers::escapeComment(' . $str . ')',
+				self::HtmlTag => 'LR\XmlHelpers::escapeTag(' . $str . ')',
 				default => throw new \LogicException("Unknown context $this->contentType, $this->state."),
 			},
-			ContentType::JavaScript => 'LR\Filters::escapeJs(' . $str . ')',
-			ContentType::Css => 'LR\Filters::escapeCss(' . $str . ')',
-			ContentType::ICal => 'LR\Filters::escapeIcal(' . $str . ')',
+			ContentType::JavaScript => 'LR\Helpers::escapeJs(' . $str . ')',
+			ContentType::Css => 'LR\Helpers::escapeCss(' . $str . ')',
+			ContentType::ICal => 'LR\Helpers::escapeIcal(' . $str . ')',
 			ContentType::Text => '($this->filters->escape)(' . $str . ')',
 			default => throw new \LogicException("Unknown content-type $this->contentType."),
 		};
 	}
 
 
-	public function escapeMandatory(string $str): string
+	public function escapeMandatory(string $str, ?Position $position = null): string
 	{
 		return match ($this->contentType) {
 			ContentType::Html => match ($this->state) {
-				self::HtmlAttribute => "LR\\Filters::escapeHtmlQuotes($str)",
+				self::HtmlAttribute => "LR\\HtmlHelpers::escapeQuotes($str)",
 				self::HtmlRawText => match ($this->subType) {
-					self::HtmlText => 'LR\Filters::convertHtmlToHtmlRawText(' . $str . ')',
-					default => "LR\\Filters::convertJSToHtmlRawText($str)",
+					self::HtmlText => 'LR\HtmlHelpers::convertHtmlToRawText(' . $str . ')',
+					default => "LR\\HtmlHelpers::convertJSToRawText($str)",
 				},
-				self::HtmlComment => 'LR\Filters::escapeHtmlComment(' . $str . ')',
+				self::HtmlComment => throw new Latte\CompileException('Using |noescape is not allowed in this context.', $position),
 				default => $str,
 			},
 			ContentType::Xml => match ($this->state) {
-				self::HtmlAttribute => "LR\\Filters::escapeHtmlQuotes($str)",
-				self::HtmlComment => 'LR\Filters::escapeHtmlComment(' . $str . ')',
+				self::HtmlAttribute => "LR\\HtmlHelpers::escapeQuotes($str)",
+				self::HtmlComment => throw new Latte\CompileException('Using |noescape is not allowed in this context.', $position),
 				default => $str,
 			},
 			default => $str,
@@ -248,20 +229,20 @@ final class Escaper
 	}
 
 
-	public function check(string $str): string
+	public function escapeContent(string $str): string
 	{
-		if ($this->state === self::HtmlAttribute && $this->subType === self::Url) {
-			$str = 'LR\Filters::safeUrl(' . $str . ')';
-		}
-		return $str;
+		return 'LR\Helpers::convertTo($ʟ_fi, '
+			. var_export($this->export(), return: true) . ', '
+			. $str
+			. ')';
 	}
 
 
 	public static function getConvertor(string $source, string $dest): ?callable
 	{
 		return match (true) {
-			$source === $dest => [Filters::class, 'nop'],
-			isset(self::Convertors[$source][$dest]) => [Filters::class, self::Convertors[$source][$dest]],
+			$source === $dest => Helpers::nop(...),
+			isset(self::Convertors[$source][$dest]) => 'Latte\Runtime\\' . self::Convertors[$source][$dest],
 			default => null,
 		};
 	}

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

@@ -1,11 +1,14 @@
-<?php
-
-declare(strict_types=1);
+<?php declare(strict_types=1);
 
 namespace Latte\Compiler;
 
 
 /**
+ * Base class for AST nodes representing parsed template structure.
+ *
+ * Each node must implement print() to generate PHP code and getIterator()
+ * to yield child nodes for compiler passes.
+ *
  * @implements \IteratorAggregate<Node>
  */
 abstract class Node implements \IteratorAggregate

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

@@ -1,23 +1,28 @@
-<?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;
 use Latte\Compiler\Nodes\Php\Expression;
 use Latte\Compiler\Nodes\Php\ExpressionNode;
 use Latte\Compiler\Nodes\Php\Scalar;
+use function array_merge, constant, defined;
 
 
+/**
+ * Utility functions for working with AST nodes.
+ */
 final class NodeHelpers
 {
-	/** @return Node[] */
+	/**
+	 * @param callable(Node): bool  $filter
+	 * @return Node[]
+	 */
 	public static function find(Node $node, callable $filter): array
 	{
 		$found = [];
@@ -31,6 +36,7 @@ final class NodeHelpers
 	}
 
 
+	/** @param callable(Node): bool  $filter */
 	public static function findFirst(Node $node, callable $filter): ?Node
 	{
 		$found = null;
@@ -48,7 +54,7 @@ final class NodeHelpers
 	public static function clone(Node $node): Node
 	{
 		return (new NodeTraverser)
-			->traverse($node, enter: fn(Node $node) => clone $node);
+			->traverse($node, enter: fn(Node $node) => clone $node) ?? throw new \LogicException;
 	}
 
 
@@ -90,7 +96,11 @@ final class NodeHelpers
 				? constant($name)
 				: throw new \InvalidArgumentException("The constant '$name' is not defined.");
 
-		} elseif ($node instanceof Expression\ClassConstantFetchNode && $constants) {
+		} elseif (
+			$node instanceof Expression\ClassConstantFetchNode
+			&& $constants
+			&& $node->name instanceof Php\IdentifierNode
+		) {
 			$class = $node->class instanceof Php\NameNode
 				? $node->class->toCodeString()
 				: self::toValue($node->class, $constants);

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

@@ -1,39 +1,45 @@
-<?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;
 
 
+/**
+ * Traverses and transforms AST nodes using visitor pattern.
+ */
 final class NodeTraverser
 {
 	public const DontTraverseChildren = 1;
 	public const StopTraversal = 2;
+	public const RemoveNode = 3;
 
-	/** @var ?callable(Node): (Node|int|null) */
-	private $enter;
+	/** @var ?(\Closure(Node): (Node|int|void|null)) */
+	private ?\Closure $enter = null;
 
-	/** @var ?callable(Node): (Node|int|null) */
-	private $leave;
+	/** @var ?(\Closure(Node): (Node|int|void|null)) */
+	private ?\Closure $leave = null;
 
 	private bool $stop;
 
 
-	public function traverse(Node $node, ?callable $enter = null, ?callable $leave = null): Node
+	/**
+	 * @param ?(callable(Node): (Node|int|void|null))  $enter
+	 * @param ?(callable(Node): (Node|int|void|null))  $leave
+	 */
+	public function traverse(Node $node, ?callable $enter = null, ?callable $leave = null): ?Node
 	{
-		$this->enter = $enter;
-		$this->leave = $leave;
+		$this->enter = $enter ? $enter(...) : null;
+		$this->leave = $leave ? $leave(...) : null;
 		$this->stop = false;
 		return $this->traverseNode($node);
 	}
 
 
-	private function traverseNode(Node $node): Node
+	private function traverseNode(Node $node): ?Node
 	{
 		$children = true;
 		if ($this->enter) {
@@ -46,7 +52,10 @@ final class NodeTraverser
 
 			} elseif ($res === self::StopTraversal) {
 				$this->stop = true;
-				$children = false;
+				return $node;
+
+			} elseif ($res === self::RemoveNode) {
+				return null;
 			}
 		}
 
@@ -63,8 +72,12 @@ final class NodeTraverser
 			$res = ($this->leave)($node);
 			if ($res instanceof Node) {
 				$node = $res;
+
 			} elseif ($res === self::StopTraversal) {
 				$this->stop = true;
+
+			} elseif ($res === self::RemoveNode) {
+				return null;
 			}
 		}
 

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

@@ -1,17 +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\Nodes;
 
 use Latte\Compiler\Node;
 
 
+/**
+ * Base for nodes representing template content that produces output.
+ *
+ * Includes text, HTML elements, and Latte tags. Extend StatementNode
+ * for custom Latte tags, or AreaNode directly for passive content.
+ */
 abstract class AreaNode extends Node
 {
 }

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

@@ -1,22 +1,23 @@
-<?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;
 
 
+/**
+ * Code generator hidden from compiler passes. Pass child nodes for traversal.
+ */
 class AuxiliaryNode extends AreaNode
 {
 	public function __construct(
-		public /*readonly*/ \Closure $print,
+		public readonly \Closure $print,
 		/** @var (?Node)[] */
 		public array $nodes = [],
 	) {

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

@@ -1,24 +1,27 @@
-<?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\PrintContext;
+use Latte\Helpers;
+use function array_merge, count;
 
 
+/**
+ * Container for sequence of child nodes.
+ */
 final class FragmentNode extends AreaNode
 {
 	/** @var AreaNode[] */
 	public array $children = [];
 
 
-	/** @param AreaNode[] $children */
+	/** @param AreaNode[]  $children */
 	public function __construct(array $children = [])
 	{
 		foreach ($children as $child) {
@@ -65,5 +68,6 @@ final class FragmentNode extends AreaNode
 		foreach ($this->children as &$item) {
 			yield $item;
 		}
+		Helpers::removeNulls($this->children);
 	}
 }

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Html/AttributeNode.php

@@ -1,22 +1,22 @@
-<?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\Html;
 
 use Latte\Compiler\NodeHelpers;
 use Latte\Compiler\Nodes\AreaNode;
-use Latte\Compiler\Nodes\FragmentNode;
 use Latte\Compiler\Nodes\TextNode;
 use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
 
 
+/**
+ * HTML attribute with name, optional value, and quote style.
+ */
 class AttributeNode extends AreaNode
 {
 	public function __construct(
@@ -37,21 +37,13 @@ class AttributeNode extends AreaNode
 
 		$res .= "echo '=';";
 		$quote = $this->quote ?? ($this->value instanceof TextNode ? null : '"');
-		$res .= $quote ? 'echo ' . var_export($quote, true) . ';' : '';
+		$res .= $quote ? 'echo ' . var_export($quote, return: true) . ';' : '';
 
 		$escaper = $context->beginEscape();
 		$escaper->enterHtmlAttribute(NodeHelpers::toText($this->name));
-		if ($this->value instanceof FragmentNode && $escaper->export() === 'html/attr/url') {
-			foreach ($this->value->children as $child) {
-				$res .= $child->print($context);
-				$escaper->enterHtmlAttribute(null);
-			}
-		} else {
-			$res .= $this->value->print($context);
-		}
-
+		$res .= $this->value->print($context);
 		$context->restoreEscape();
-		$res .= $quote ? 'echo ' . var_export($quote, true) . ';' : '';
+		$res .= $quote ? 'echo ' . var_export($quote, return: true) . ';' : '';
 		return $res;
 	}
 

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Html/BogusTagNode.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\Nodes\Html;
 
 use Latte\Compiler\Nodes\AreaNode;
@@ -15,7 +13,7 @@ use Latte\Compiler\PrintContext;
 
 
 /**
- * HTML bogus tag.
+ * DOCTYPE or bogus HTML tags.
  */
 class BogusTagNode extends AreaNode
 {
@@ -30,11 +28,11 @@ class BogusTagNode extends AreaNode
 
 	public function print(PrintContext $context): string
 	{
-		$res = 'echo ' . var_export($this->openDelimiter, true) . ';';
+		$res = 'echo ' . var_export($this->openDelimiter, return: true) . ';';
 		$context->beginEscape()->enterHtmlBogusTag();
 		$res .= $this->content->print($context);
 		$context->restoreEscape();
-		$res .= 'echo ' . var_export($this->endDelimiter, true) . ';';
+		$res .= 'echo ' . var_export($this->endDelimiter, return: true) . ';';
 		return $res;
 	}
 

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Html/CommentNode.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\Nodes\Html;
 
 use Latte\Compiler\Nodes\AreaNode;
@@ -14,6 +12,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
 
 
+/**
+ * HTML comment (<!-- ... -->).
+ */
 class CommentNode extends AreaNode
 {
 	public function __construct(