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

package/vendor/latte/latte/src/Latte/Essential/Nodes/FirstLastSepNode.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\AreaNode;
@@ -18,9 +16,8 @@ use Latte\Compiler\Tag;
 
 
 /**
- * {first [$width]}
- * {last [$width]}
- * {sep [$width]}
+ * {first} ... {/first}, {last} ... {/last}, {sep} ... {/sep}
+ * Loop iteration helpers inside {foreach}.
  */
 class FirstLastSepNode extends StatementNode
 {
@@ -31,7 +28,7 @@ class FirstLastSepNode extends StatementNode
 	public ?Position $elseLine = null;
 
 
-	/** @return \Generator<int, ?array, array{AreaNode, ?Tag}, static> */
+	/** @return \Generator<int, ?list<string>, array{AreaNode, ?Tag}, static> */
 	public static function create(Tag $tag): \Generator
 	{
 		$node = $tag->node = new static;

package/vendor/latte/latte/src/Latte/Essential/Nodes/ForNode.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\AreaNode;
@@ -18,7 +16,7 @@ use Latte\Helpers;
 
 
 /**
- * {for $init; $cond; $next}
+ * {for $i = 0; $i < 10; $i++} ... {/for}
  */
 class ForNode extends StatementNode
 {
@@ -31,7 +29,7 @@ class ForNode 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();

package/vendor/latte/latte/src/Latte/Essential/Nodes/ForeachNode.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,11 +22,12 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
 use Latte\Compiler\Tag;
 use Latte\Compiler\TagParser;
-use function array_map, array_unshift, implode, preg_match;
+use function array_map, array_unshift, implode, is_string, preg_match;
 
 
 /**
- * {foreach $expr as $key => $value} & {else}
+ * {foreach $array as $item} ... {/foreach}
+ * {foreach $array as $key => $value} ... {else} ... {/foreach}
  */
 class ForeachNode extends StatementNode
 {
@@ -43,7 +42,7 @@ class ForeachNode extends StatementNode
 	public bool $checkArgs = true;
 
 
-	/** @return \Generator<int, ?array, array{AreaNode, ?Tag}, static|NopNode> */
+	/** @return \Generator<int, ?list<string>, array{AreaNode, ?Tag}, static> */
 	public static function create(Tag $tag): \Generator
 	{
 		$tag->expectArguments();
@@ -160,8 +159,8 @@ class ForeachNode extends StatementNode
 		(new NodeTraverser)->traverse($node, function (Node $node) use (&$vars) {
 			if ($node instanceof self && $node->checkArgs) {
 				foreach ([$node->key, $node->value] as $var) {
-					if ($var instanceof VariableNode) {
-						$vars[$var->name][] = $node->position->line;
+					if ($var instanceof VariableNode && is_string($var->name)) {
+						$vars[$var->name][] = $node->position?->line;
 					}
 				}
 			}

package/vendor/latte/latte/src/Latte/Essential/Nodes/IfChangedNode.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\AreaNode;
@@ -18,7 +16,8 @@ use Latte\Compiler\Tag;
 
 
 /**
- * {ifchanged [$var]} ... {else}
+ * {ifchanged [$var]} ... {/ifchanged}
+ * Renders content only when value changes between iterations.
  */
 class IfChangedNode extends StatementNode
 {
@@ -28,7 +27,7 @@ class IfChangedNode extends StatementNode
 	public ?Position $elseLine = null;
 
 
-	/** @return \Generator<int, ?array, array{AreaNode, ?Tag}, static> */
+	/** @return \Generator<int, ?list<string>, array{AreaNode, ?Tag}, static> */
 	public static function create(Tag $tag): \Generator
 	{
 		$node = $tag->node = new static;

package/vendor/latte/latte/src/Latte/Essential/Nodes/IfContentNode.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\TemplateParser;
 
 
 /**
- * n:ifcontent
+ * <div n:ifcontent> ... </div>
+ * Omits element if content is empty or whitespace only.
  */
 class IfContentNode extends StatementNode
 {
@@ -30,12 +29,13 @@ class IfContentNode extends StatementNode
 	public ?AreaNode $else = null;
 
 
-	/** @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
 	{
 		$node = $tag->node = new static;
 		$node->id = $parser->generateId();
 		[$node->content] = yield;
+		assert($tag->htmlElement !== null);
 		$node->htmlElement = $tag->htmlElement;
 		if (!$node->htmlElement->content) {
 			throw new CompileException("Unnecessary n:ifcontent on empty element <{$node->htmlElement->name}>", $tag->position);
@@ -46,8 +46,9 @@ class IfContentNode extends StatementNode
 
 	public function print(PrintContext $context): string
 	{
+		$saved = $this->htmlElement->content;
+		assert($saved !== null);
 		try {
-			$saved = $this->htmlElement->content;
 			$else = $this->else ?? new AuxiliaryNode(fn() => '');
 			$this->htmlElement->content = new AuxiliaryNode(fn() => <<<XX
 				ob_start();

package/vendor/latte/latte/src/Latte/Essential/Nodes/IfNode.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,10 +22,8 @@ use function in_array;
 
 
 /**
- * {if $cond} & {elseif $cond} & {else}
- * {if} & {/if $cond}
- * {ifset $var} & {elseifset $var}
- * {ifset block} & {elseifset block}
+ * {if $cond} ... {elseif $cond} ... {else} ... {/if}
+ * {ifset $var} ... {elseifset $var} ... {/ifset}
  */
 class IfNode extends StatementNode
 {
@@ -39,11 +35,11 @@ class IfNode extends StatementNode
 	public bool $ifset = false;
 
 
-	/** @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
 	{
 		$node = $tag->node = new static;
-		$node->ifset = in_array($tag->name, ['ifset', 'elseifset'], true);
+		$node->ifset = in_array($tag->name, ['ifset', 'elseifset'], strict: true);
 		$node->capture = !$tag->isNAttribute() && $tag->name === 'if' && $tag->parser->isEnd();
 		$node->position = $tag->position;
 		if (!$node->capture) {
@@ -71,6 +67,7 @@ class IfNode extends StatementNode
 		}
 
 		if ($node->capture) {
+			assert($nextTag !== null);
 			$node->condition = $nextTag->parser->parseExpression();
 		}
 

package/vendor/latte/latte/src/Latte/Essential/Nodes/ImportNode.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\Expression\ArrayNode;
@@ -17,7 +15,8 @@ use Latte\Compiler\Tag;
 
 
 /**
- * {import "file"[, args]}
+ * {import 'file.latte'}
+ * Imports block definitions from another template.
  */
 class ImportNode extends StatementNode
 {

package/vendor/latte/latte/src/Latte/Essential/Nodes/IncludeBlockNode.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,7 @@ use Latte\Runtime\Template;
 
 
 /**
- * {include [block] name [from file] [, args]}
+ * {include #name|parent|this [from 'file.latte']}
  */
 class IncludeBlockNode extends StatementNode
 {
@@ -65,12 +63,14 @@ class IncludeBlockNode extends StatementNode
 		} elseif ($node->parent || $tokenName->is('this')) {
 			$item = $tag->closestTag(
 				[BlockNode::class, DefineNode::class],
-				fn($item) => $item->node?->block && !$item->node->block->isDynamic() && $item->node->block->name !== '',
+				fn($item) => ($item->node instanceof BlockNode || $item->node instanceof DefineNode)
+					&& $item->node->block && !$item->node->block->isDynamic(),
 			);
-			if (!$item) {
+			if (!$item || !($item->node instanceof BlockNode || $item->node instanceof DefineNode)) {
 				throw new CompileException("Cannot include $tokenName->text block outside of any block.", $tag->position);
 			}
 
+			assert($item->node->block !== null);
 			$node->name = $item->node->block->name;
 		}
 
@@ -100,7 +100,7 @@ class IncludeBlockNode extends StatementNode
 	{
 		if ($this->name instanceof Scalar\StringNode || $this->name instanceof Scalar\IntegerNode) {
 			$staticName = (string) $this->name->value;
-			$block = $this->blocks[$this->layer][$staticName] ?? $this->blocks[Template::LayerLocal][$staticName] ?? null;
+			$block = ($this->layer !== null ? $this->blocks[$this->layer][$staticName] ?? null : null) ?? $this->blocks[Template::LayerLocal][$staticName] ?? null;
 		}
 
 		return $context->format(
@@ -118,6 +118,7 @@ class IncludeBlockNode extends StatementNode
 
 	private function printBlockFrom(PrintContext $context, string $contentFilter): string
 	{
+		assert($this->from !== null);
 		return $context->format(
 			'$this->createTemplate(%raw, %node? + $this->params, "include")->renderToContentType(%raw, %raw) %line;',
 			$context->ensureString($this->from, 'Template name'),

package/vendor/latte/latte/src/Latte/Essential/Nodes/IncludeFileNode.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\Expression\ArrayNode;
@@ -19,7 +17,7 @@ use Latte\Compiler\Tag;
 
 
 /**
- * {include [file] "file" [with blocks] [,] [params]}
+ * {include 'file.latte' [with blocks]}
  */
 class IncludeFileNode extends StatementNode
 {

package/vendor/latte/latte/src/Latte/Essential/Nodes/IterateWhileNode.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,7 +17,8 @@ use Latte\Compiler\Tag;
 
 
 /**
- * {iterateWhile $cond}
+ * {iterateWhile [$cond]} ... {/iterateWhile [$cond]}
+ * Groups consecutive items in {foreach} by condition.
  */
 class IterateWhileNode extends StatementNode
 {
@@ -30,11 +29,11 @@ class IterateWhileNode extends StatementNode
 	public bool $postTest;
 
 
-	/** @return \Generator<int, ?array, array{AreaNode, ?Tag}, static> */
+	/** @return \Generator<int, ?list<string>, array{AreaNode, ?Tag}, static> */
 	public static function create(Tag $tag): \Generator
 	{
 		$foreach = $tag->closestTag([ForeachNode::class])?->node;
-		if (!$foreach) {
+		if (!$foreach instanceof ForeachNode) {
 			throw new CompileException("Tag {{$tag->name}} must be inside {foreach} ... {/foreach}.", $tag->position);
 		}
 
@@ -48,6 +47,7 @@ class IterateWhileNode extends StatementNode
 		$node->value = $foreach->value;
 		[$node->content, $nextTag] = yield;
 		if ($node->postTest) {
+			assert($nextTag !== null);
 			$nextTag->expectArguments();
 			$node->condition = $nextTag->parser->parseExpression();
 		}

package/vendor/latte/latte/src/Latte/Essential/Nodes/JumpNode.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;
@@ -17,10 +15,8 @@ use Latte\Compiler\Tag;
 
 
 /**
- * {breakIf ...}
- * {continueIf ...}
- * {skipIf ...}
- * {exitIf ...}
+ * {breakIf $cond}, {continueIf $cond}, {skipIf $cond}, {exitIf $cond}
+ * Note: {skipIf} is like {continueIf} but doesn't increment $iterator->counter.
  */
 class JumpNode extends StatementNode
 {
@@ -50,7 +46,7 @@ class JumpNode extends StatementNode
 		}
 
 		$last = $parent?->prefix === Tag::PrefixNone
-			? $parent->htmlElement->parent
+			? $parent->htmlElement?->parent
 			: $parent?->htmlElement;
 		$el = $tag->htmlElement;
 		while ($el && $el !== $last) {

package/vendor/latte/latte/src/Latte/Essential/Nodes/NAttrNode.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;
@@ -19,7 +17,7 @@ use function is_array;
 
 
 /**
- * n:attr="..."
+ * <div n:attr="class => $class, id => $id">
  */
 final class NAttrNode extends StatementNode
 {
@@ -43,7 +41,7 @@ final class NAttrNode extends StatementNode
 			$this->args,
 			self::class,
 			$context->getEscaper()->getContentType() === Latte\ContentType::Xml,
-			$context->migrationWarnings ?: null,
+			$context->hasFeature(Latte\Feature::MigrationWarnings) ?: null,
 			$this->position,
 		);
 	}

package/vendor/latte/latte/src/Latte/Essential/Nodes/NClassNode.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;
@@ -17,7 +15,7 @@ use Latte\Compiler\Tag;
 
 
 /**
- * n:class="..."
+ * <div n:class="$isActive ? active, highlight">
  */
 final class NClassNode extends StatementNode
 {
@@ -26,6 +24,7 @@ final class NClassNode extends StatementNode
 
 	public static function create(Tag $tag): static
 	{
+		assert($tag->htmlElement !== null);
 		if ($tag->htmlElement->getAttribute('class')) {
 			throw new CompileException('It is not possible to combine class with n:class.', $tag->position);
 		}

package/vendor/latte/latte/src/Latte/Essential/Nodes/NElseNode.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;
@@ -21,7 +19,8 @@ use Latte\Compiler\Tag;
 
 
 /**
- * n:else & n:elseif
+ * <div n:if="$cond"> ... <div n:else>
+ * <div n:if="$cond"> ... <div n:elseif="$cond2">
  */
 final class NElseNode extends StatementNode
 {
@@ -29,7 +28,7 @@ final class NElseNode extends StatementNode
 	public ?ExpressionNode $condition = null;
 
 
-	/** @return \Generator<int, ?array, array{AreaNode, ?Tag}, static> */
+	/** @return \Generator<int, ?list<string>, array{AreaNode, ?Tag}, static> */
 	public static function create(Tag $tag): \Generator
 	{
 		$node = $tag->node = new static;
@@ -69,6 +68,10 @@ final class NElseNode extends StatementNode
 	}
 
 
+	/**
+	 * @param  AreaNode[]  $children
+	 * @return AreaNode[]
+	 */
 	private static function processFragment(array $children): array
 	{
 		$currentNode = null;

package/vendor/latte/latte/src/Latte/Essential/Nodes/NTagNode.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,18 +16,20 @@ use function preg_match;
 
 
 /**
- * n:tag="..."
+ * <div n:tag="$useSpan ? span">
  */
 final class NTagNode extends StatementNode
 {
 	public static function create(Tag $tag): void
 	{
+		assert($tag->htmlElement !== null);
 		if (preg_match('(style$|script$)iA', $tag->htmlElement->name)) {
 			throw new CompileException('Attribute n:tag is not allowed in <script> or <style>', $tag->position);
 		}
 
 		$tag->expectArguments();
 		$tag->htmlElement->dynamicTag ??= new TagNode($tag->htmlElement);
+		assert($tag->htmlElement->dynamicTag instanceof TagNode);
 		$tag->htmlElement->dynamicTag->name = $tag->parser->parseExpression();
 	}
 

package/vendor/latte/latte/src/Latte/Essential/Nodes/ParametersNode.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,8 @@ use function is_string;
 
 
 /**
- * {parameters [type] $var, ...}
+ * {parameters [Type] $name [= default], ...}
+ * Declares and filters template parameters.
  */
 class ParametersNode extends StatementNode
 {
@@ -43,6 +42,7 @@ class ParametersNode extends StatementNode
 	}
 
 
+	/** @return ParameterNode[] */
 	private static function parseParameters(Tag $tag): array
 	{
 		$stream = $tag->parser->stream;

package/vendor/latte/latte/src/Latte/Essential/Nodes/RawPhpNode.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\StatementNode;
@@ -16,7 +14,7 @@ use function preg_match, trim;
 
 
 /**
- * {php statement; statement; ...}
+ * {php code} (requires RawPhpExtension)
  */
 class RawPhpNode extends StatementNode
 {

package/vendor/latte/latte/src/Latte/Essential/Nodes/RollbackNode.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;
@@ -17,6 +15,7 @@ use Latte\Compiler\Tag;
 
 /**
  * {rollback}
+ * Discards {try} block output and jumps to {else}.
  */
 class RollbackNode extends StatementNode
 {

package/vendor/latte/latte/src/Latte/Essential/Nodes/SpacelessNode.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\AreaNode;
@@ -17,14 +15,15 @@ use Latte\ContentType;
 
 
 /**
- * {spaceless}
+ * {spaceless} ... {/spaceless}
+ * Removes whitespace between HTML tags.
  */
 class SpacelessNode 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
 	{
 		$node = $tag->node = new static;