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

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

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/Php/ListNode.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\CompileException;
@@ -15,6 +13,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Array destructuring ([$a, $b] = $arr).
+ */
 class ListNode extends Node
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/MatchArmNode.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\PrintContext;
 use Latte\Helpers;
+/**
+ * Match expression arm with conditions and body.
+ */
 class MatchArmNode extends Node
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/ModifierNode.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\PrintContext;
 use Latte\Helpers;
+/**
+ * Chain of filters with auto-escape flag.
+ */
 class ModifierNode extends Node
 {
 	/** @deprecated */

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/NameNode.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\PrintContext;
 use function array_flip, str_starts_with, strtolower, substr;
+/**
+ * Qualified name for functions, classes, or constants (\Foo\Bar).
+ */
 class NameNode extends Node
 {
 	public const

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/NullableTypeNode.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\Php;
 use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Nullable type (?Type).
+ */
 class NullableTypeNode extends ComplexTypeNode
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/OperatorNode.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;

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/ParameterNode.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\CompileException;
@@ -15,6 +13,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Function parameter with type, default value, and variadic support.
+ */
 class ParameterNode extends Node
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Scalar/BooleanNode.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\Scalar;
 use Latte\Compiler\Nodes\Php\ScalarNode;
@@ -14,6 +12,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Boolean literal (true/false).
+ */
 class BooleanNode extends ScalarNode
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Scalar/FloatNode.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\Scalar;
 use Latte\Compiler\Nodes\Php\ScalarNode;
@@ -17,6 +15,9 @@ use function is_finite, preg_match, sprintf, str_replace, strpbrk;
 use const INF;
+/**
+ * Floating-point literal including infinity and NaN.
+ */
 class FloatNode extends ScalarNode
 {
 	public function __construct(
@@ -26,7 +27,7 @@ class FloatNode extends ScalarNode
 	}
-	public static function parse(string $str, Position $position): static
+	public static function parse(string $str, ?Position $position): static
 	{
 		return strpbrk($str, '.eE') === false
 			? new static((float) PhpHelpers::decodeNumber($str), $position)

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Scalar/IntegerNode.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\Scalar;
 use Latte\CompileException;
@@ -17,6 +15,9 @@ use Latte\Compiler\PrintContext;
 use const PHP_INT_MAX;
+/**
+ * Integer literal in decimal, hex, octal, or binary notation.
+ */
 class IntegerNode extends ScalarNode
 {
 	public const KindBinary = 2;
@@ -33,7 +34,7 @@ class IntegerNode extends ScalarNode
 	}
-	public static function parse(string $str, Position $position): static
+	public static function parse(string $str, ?Position $position): static
 	{
 		$num = PhpHelpers::decodeNumber($str, $base);
 		if ($num === null) {

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Scalar/InterpolatedStringNode.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\Scalar;
 use Latte\Compiler\Nodes\Php\ExpressionNode;
@@ -19,6 +17,9 @@ use Latte\Helpers;
 use function substr;
+/**
+ * Double-quoted string with embedded expressions ("Hello $name").
+ */
 class InterpolatedStringNode extends ScalarNode
 {
 	public function __construct(
@@ -29,8 +30,8 @@ class InterpolatedStringNode extends ScalarNode
 	}
-	/** @param array<ExpressionNode|InterpolatedStringPartNode> $parts */
-	public static function parse(array $parts, Position $position): static
+	/** @param array<ExpressionNode|InterpolatedStringPartNode>  $parts */
+	public static function parse(array $parts, ?Position $position): static
 	{
 		foreach ($parts as $part) {
 			if ($part instanceof InterpolatedStringPartNode) {

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Scalar/NullNode.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\Scalar;
 use Latte\Compiler\Nodes\Php\ScalarNode;
@@ -14,6 +12,9 @@ use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Null literal.
+ */
 class NullNode extends ScalarNode
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/Scalar/StringNode.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\Scalar;
 use Latte\Compiler\Nodes\Php\ScalarNode;
@@ -16,6 +14,9 @@ use Latte\Compiler\PrintContext;
 use function strtr, substr;
+/**
+ * String literal, single or double quoted.
+ */
 class StringNode extends ScalarNode
 {
 	public function __construct(
@@ -25,7 +26,7 @@ class StringNode extends ScalarNode
 	}
-	public static function parse(string $str, Position $position): static
+	public static function parse(string $str, ?Position $position): static
 	{
 		$str = $str[0] === "'"
 			? strtr(substr($str, 1, -1), ['\\\\' => '\\', "\\'" => "'"])

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

@@ -1,15 +1,16 @@
-<?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;
+/**
+ * Base for literal value nodes (strings, numbers, booleans, null).
+ */
 abstract class ScalarNode extends ExpressionNode
 {
 	public function &getIterator(): \Generator

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/SuperiorTypeNode.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\Php;
 use Latte\Compiler\Position;
 use Latte\Compiler\PrintContext;
+/**
+ * Type not expressible in native PHP syntax (e.g., int[], array<K,V>).
+ */
 class SuperiorTypeNode extends ComplexTypeNode
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/UnionTypeNode.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\Position;
@@ -14,6 +12,9 @@ use Latte\Compiler\PrintContext;
 use Latte\Helpers;
+/**
+ * Union type (Type1|Type2).
+ */
 class UnionTypeNode extends ComplexTypeNode
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/VarLikeIdentifierNode.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\PrintContext;
+/**
+ * Identifier for static property name in Foo::$bar syntax.
+ */
 class VarLikeIdentifierNode extends IdentifierNode
 {
 	public function print(PrintContext $context): string

package/vendor/latte/latte/src/Latte/Compiler/Nodes/Php/VariadicPlaceholderNode.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;
+/**
+ * Placeholder ... for partial function application or first-class callable creation.
+ */
 class VariadicPlaceholderNode extends Node
 {
 	public function __construct(

package/vendor/latte/latte/src/Latte/Compiler/Nodes/PrintNode.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;
@@ -18,7 +16,8 @@ use Latte\Compiler\TemplateParser;
 /**
- * {= ...}
+ * {= $expr|filter}
+ * Outputs escaped expression.
  */
 class PrintNode extends StatementNode
 {

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

@@ -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 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;
+/**
+ * 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 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\Position;
@@ -14,6 +12,9 @@ use Latte\Compiler\PrintContext;
 use function trim, var_export;
+/**
+ * Literal text content in template.
+ */
 class TextNode extends AreaNode
 {
 	public function __construct(
@@ -27,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 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;
 use Latte\CompileException;
@@ -49,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 = '';
 					}
@@ -70,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++;
 					}
@@ -100,6 +98,9 @@ final class PhpHelpers
 	}
+	/**
+	 * Exports value to PHP code representation.
+	 */
 	public static function dump(mixed $value, bool $multiline = false): string
 	{
 		if (is_array($value)) {
@@ -115,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++) {
 			$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,
 					);
@@ -158,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);
@@ -203,11 +211,11 @@ 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 {
-					$num = octdec($ch);
+					$num = (int) octdec($ch);
 					if ($num > 255) {
 						throw new CompileException("Octal escape sequence \\$ch is greater than \\377");
 					}