npm - @vituum/vite-plugin-latte - Versions diffs - 2.0.0-next.5 → 2.0.0 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (213) hide show

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

@@ -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 CHANGED Viewed

@@ -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;
+/**
+ * Code generator hidden from compiler passes. Pass child nodes for traversal.
+ */
 class AuxiliaryNode extends AreaNode
 {
 	public function __construct(

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

@@ -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;
 use Latte\Compiler\PrintContext;
@@ -14,13 +12,16 @@ 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) {

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

@@ -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\NodeHelpers;
@@ -16,6 +14,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * HTML attribute with name, optional value, and quote style.
+ */
 class AttributeNode extends AreaNode
 {
 	public function __construct(
@@ -36,13 +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));
 		$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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Html/ElementNode.php CHANGED Viewed

@@ -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\Node;
@@ -21,7 +19,7 @@ use Latte\ContentType;
 /**
- * HTML element node.
+ * HTML/XML element with attributes, content, and n:attribute support.
  */
 class ElementNode extends AreaNode
 {
@@ -91,16 +89,16 @@ class ElementNode extends AreaNode
 			? $this->dynamicTag->print($context)
 			: (new TagNode($this))->print($context, captureEnd: false);
-		if ($this->content) {
+		if ($innerContent = $this->content) {
 			if ($this->dynamicTag) {
 				$endTag = '$ʟ_tags[' . ($context->generateId()) . ']';
 				$res = "\$ʟ_tag = ''; $res $endTag = \$ʟ_tag;";
 			} else {
-				$endTag = var_export('</' . $this->name . '>', true);
+				$endTag = var_export('</' . $this->name . '>', return: true);
 			}
 			$context->beginEscape()->enterHtmlText($this);
-			$content = $this->content->print($context);
+			$content = $innerContent->print($context);
 			$context->restoreEscape();
 			$res .= $this->breakable
 				? 'try { ' . $content . ' } finally { echo ' . $endTag . '; } '

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Html/ExpressionAttributeNode.php CHANGED Viewed

@@ -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,9 +13,13 @@ use Latte\Compiler\Nodes\Php\ModifierNode;
 use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
 use Latte\ContentType;
+use Latte\Feature;
 use Latte\Runtime as LR;
+/**
+ * Dynamic HTML attribute generated from expression.
+ */
 class ExpressionAttributeNode extends AreaNode
 {
 	public function __construct(
@@ -44,7 +46,7 @@ class ExpressionAttributeNode extends AreaNode
 			$this->indentation . $this->name,
 			$this->modifier,
 			$this->value,
-			(!$this->modifier->removeFilter('accept') && $context->migrationWarnings) ?: null,
+			(!$this->modifier->removeFilter('accept') && $context->hasFeature(Feature::MigrationWarnings)) ?: null,
 			$this->value->position,
 		);
 	}

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Html/TagNode.php CHANGED Viewed

@@ -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;

package/vendor/latte/latte/src/Latte/Compiler/Nodes/NopNode.php CHANGED Viewed

@@ -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\Nodes;
 use Latte\Compiler\PrintContext;
+/**
+ * Placeholder for removed or filtered-out content.
+ */
 class NopNode extends AreaNode
 {
 	public function print(PrintContext $context): string

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/ArgumentNode.php CHANGED Viewed

@@ -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\Php;
 use Latte\Compiler\Node;
@@ -14,6 +12,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Function/method argument with optional name, reference, and unpacking.
+ */
 class ArgumentNode extends Node
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/ArrayItemNode.php CHANGED Viewed

@@ -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\Php;
 use Latte\Compiler\Node;
@@ -14,6 +12,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Array item with optional key, reference, and spread operator.
+ */
 class ArrayItemNode extends Node
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/ClosureUseNode.php CHANGED Viewed

@@ -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\Php;
 use Latte\Compiler\Node;
@@ -15,6 +13,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Closure use variable ($var or &$var).
+ */
 class ClosureUseNode extends Node
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/ComplexTypeNode.php CHANGED Viewed

@@ -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\Nodes\Php;
 use Latte\Compiler\Node;
+/**
+ * Base for complex type declarations (nullable, union, intersection).
+ */
 abstract class ComplexTypeNode extends Node
 {
 }

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Expression/ArrayAccessNode.php CHANGED Viewed

@@ -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\Php\Expression;
 use Latte\Compiler\Nodes\Php\ExpressionNode;
@@ -14,6 +12,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Array or string element access ($arr[$key]).
+ */
 class ArrayAccessNode extends ExpressionNode
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Expression/ArrayNode.php CHANGED Viewed

@@ -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\Php\Expression;
 use Latte\Compiler\Nodes\Php\ArgumentNode;
@@ -17,6 +15,9 @@ use Latte\Compiler\PrintContext;
 use Latte\Helpers;
+/**
+ * Array literal.
+ */
 class ArrayNode extends ExpressionNode
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Expression/AssignNode.php CHANGED Viewed

@@ -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\Php\Expression;
 use Latte\CompileException;
@@ -17,6 +15,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Assignment ($var = expr or $var = &$ref).
+ */
 class AssignNode extends ExpressionNode implements OperatorNode
 {
 	public const Precedence = [90, self::AssocRight];

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Expression/AssignOpNode.php CHANGED Viewed

@@ -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\Php\Expression;
 use Latte\CompileException;
@@ -17,6 +15,9 @@ use Latte\Compiler\PrintContext;
 use function in_array;
+/**
+ * Compound assignment ($var += expr, $var .= expr, etc.).
+ */
 class AssignOpNode extends ExpressionNode implements OperatorNode
 {
 	private const Ops = ['+', '-', '*', '/', '.', '%', '&', '|', '^', '<<', '>>', '**', '??'];
@@ -28,7 +29,7 @@ class AssignOpNode extends ExpressionNode implements OperatorNode
 		public ExpressionNode $expr,
 		public ?Position $position = null,
 	) {
-		if (!in_array($this->operator, self::Ops, true)) {
+		if (!in_array($this->operator, self::Ops, strict: true)) {
 			throw new \InvalidArgumentException("Unexpected operator '$this->operator'");
 		}
 		$this->validate();

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Expression/AuxiliaryNode.php CHANGED Viewed

@@ -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\Php\Expression;
 use Latte\Compiler\Node;
@@ -14,6 +12,9 @@ use Latte\Compiler\Nodes\Php\ExpressionNode;
 use Latte\Compiler\PrintContext;
+/**
+ * Code generator hidden from compiler passes. Pass child nodes for traversal.
+ */
 class AuxiliaryNode extends ExpressionNode
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Expression/BinaryOpNode.php CHANGED Viewed

@@ -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\Php\Expression;
 use Latte\Compiler\Nodes\Php\ExpressionNode;
@@ -16,6 +14,9 @@ use Latte\Compiler\PrintContext;
 use function count, in_array, strtolower;
+/**
+ * Binary operation: arithmetic, logical, bitwise, comparison, null-coalescing, or pipe.
+ */
 class BinaryOpNode extends ExpressionNode implements OperatorNode
 {
 	private const Ops = ['||', '&&', 'or', 'and', 'xor', '|', '&', '^', '.', '+', '-', '*', '/', '%', '<<', '>>', '**',
@@ -28,7 +29,7 @@ class BinaryOpNode extends ExpressionNode implements OperatorNode
 		public ExpressionNode $right,
 		public ?Position $position = null,
 	) {
-		if (!in_array(strtolower($this->operator), self::Ops, true)) {
+		if (!in_array(strtolower($this->operator), self::Ops, strict: true)) {
 			throw new \InvalidArgumentException("Unexpected operator '$this->operator'");
 		}
 	}

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Expression/CastNode.php CHANGED Viewed

@@ -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\Php\Expression;
 use Latte\Compiler\Nodes\Php\ExpressionNode;
@@ -15,6 +13,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Type cast (int), (string), (array), etc.
+ */
 class CastNode extends ExpressionNode implements OperatorNode
 {
 	private const Types = ['int' => 1, 'float' => 1, 'string' => 1, 'array' => 1, 'object' => 1, 'bool' => 1];

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Expression/ClassConstantFetchNode.php CHANGED Viewed

@@ -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\Php\Expression;
 use Latte\Compiler\Nodes\Php\ExpressionNode;
@@ -16,6 +14,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Class constant access (Foo::CONST or Foo::class).
+ */
 class ClassConstantFetchNode extends ExpressionNode
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Expression/CloneNode.php CHANGED Viewed

@@ -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\Php\Expression;
 use Latte\Compiler\Nodes\Php\ExpressionNode;
@@ -15,6 +13,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Object cloning (clone $obj).
+ */
 class CloneNode extends ExpressionNode implements OperatorNode
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Expression/ClosureNode.php CHANGED Viewed

@@ -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\Php\Expression;
 use Latte\Compiler\Nodes\Php;
@@ -17,6 +15,9 @@ use Latte\Compiler\PrintContext;
 use Latte\Helpers;
+/**
+ * Closure or arrow function (fn($x) => $x or function($x) use ($y) {}).
+ */
 class ClosureNode extends ExpressionNode
 {
 	public function __construct(
@@ -36,12 +37,12 @@ class ClosureNode extends ExpressionNode
 	public function print(PrintContext $context): string
 	{
-		$arrow = (bool) $this->expr;
+		$usesByRef = false;
 		foreach ($this->uses as $use) {
-			$arrow = $arrow && !$use->byRef;
+			$usesByRef = $usesByRef || $use->byRef;
 		}
-		return $arrow
+		return $this->expr && !$usesByRef
 			? 'fn' . ($this->byRef ? '&' : '')
 				. '(' . $context->implode($this->params) . ')'
 				. ($this->returnType !== null ? ': ' . $this->returnType->print($context) : '')