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

package/vendor/latte/latte/src/Latte/Helpers.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;
 
 use function array_filter, array_keys, array_search, array_slice, array_unique, count, is_array, is_object, is_string, levenshtein, max, min, strlen, strpos;
@@ -39,7 +37,7 @@ class Helpers
 
 
 	/** intentionally without callable typehint, because it generates bad error messages */
-	public static function toReflection($callable): \ReflectionFunctionAbstract
+	public static function toReflection(mixed $callable): \ReflectionFunctionAbstract
 	{
 		if (is_string($callable) && strpos($callable, '::')) {
 			return PHP_VERSION_ID < 80300
@@ -55,6 +53,10 @@ class Helpers
 	}
 
 
+	/**
+	 * @param  array<string, mixed|\stdClass>  $list
+	 * @return array<string, mixed|\stdClass>
+	 */
 	public static function sortBeforeAfter(array $list): array
 	{
 		foreach ($list as $name => $info) {
@@ -70,7 +72,7 @@ class Helpers
 				if ($target === '*') {
 					$best = 0;
 				} elseif (isset($list[$target])) {
-					$pos = array_search($target, $names, true);
+					$pos = (int) array_search($target, $names, strict: true);
 					$best = min($pos, $best ?? $pos);
 				}
 			}
@@ -79,20 +81,22 @@ class Helpers
 				if ($target === '*') {
 					$best = count($names);
 				} elseif (isset($list[$target])) {
-					$pos = array_search($target, $names, true);
+					$pos = (int) array_search($target, $names, strict: true);
 					$best = max($pos + 1, $best);
 				}
 			}
 
-			$list = array_slice($list, 0, $best, true)
+			$best ??= count($names);
+			$list = array_slice($list, 0, $best, preserve_keys: true)
 				+ [$name => $info]
-				+ array_slice($list, $best, null, true);
+				+ array_slice($list, $best, null, preserve_keys: true);
 		}
 
 		return $list;
 	}
 
 
+	/** @param  mixed[]  $items */
 	public static function removeNulls(array &$items): void
 	{
 		$items = array_values(array_filter($items, fn($item) => $item !== null));
@@ -101,14 +105,18 @@ class Helpers
 
 	/**
 	 * Attempts to map the compiled template to the source.
+	 * @return array{name: ?string, line: ?int, column: ?int}|null
 	 */
 	public static function mapCompiledToSource(string $compiledFile, ?int $compiledLine = null): ?array
 	{
-		if (!Cache::isCacheFile($compiledFile)) {
+		if (!Runtime\Cache::isCacheFile($compiledFile)) {
 			return null;
 		}
 
 		$content = file_get_contents($compiledFile);
+		if ($content === false) {
+			return null;
+		}
 		$name = preg_match('#^/\*\* source: (\S.+) \*/#m', $content, $m) ? $m[1] : null;
 		$compiledLine && preg_match('~/\* pos (\d+)(?::(\d+))? \*/~', explode("\n", $content)[$compiledLine - 1], $pos);
 		$line = isset($pos[1]) ? (int) $pos[1] : null;
@@ -124,7 +132,7 @@ class Helpers
 	{
 		$trace = debug_backtrace();
 		foreach ($trace as $item) {
-			if (isset($item['file']) && ($source = self::mapCompiledToSource($item['file'], $item['line']))) {
+			if (isset($item['file']) && ($source = self::mapCompiledToSource($item['file'], $item['line'] ?? null))) {
 				$res = [];
 				if ($source['name'] && is_file($source['name'])) {
 					$res[] = "in '" . str_replace(dirname($source['name'], 2), '...', $source['name']) . "'";

package/vendor/latte/latte/src/Latte/Loader.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;
 
 

package/vendor/latte/latte/src/Latte/Loaders/FileLoader.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\Loaders;
 
 use Latte;
@@ -15,7 +13,7 @@ use const DIRECTORY_SEPARATOR;
 
 
 /**
- * Template loader.
+ * Loads templates from filesystem.
  */
 class FileLoader implements Latte\Loader
 {
@@ -41,7 +39,12 @@ class FileLoader implements Latte\Loader
 			throw new Latte\TemplateNotFoundException("Missing template file '$file'.");
 		}
 
-		return file_get_contents($file);
+		$content = file_get_contents($file);
+		if ($content === false) {
+			throw new Latte\RuntimeException("Unable to read file '$file'.");
+		}
+
+		return $content;
 	}
 
 

package/vendor/latte/latte/src/Latte/Loaders/StringLoader.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\Loaders;
 
 use Latte;
@@ -17,16 +15,10 @@ use Latte;
  */
 class StringLoader implements Latte\Loader
 {
-	/** @var string[]|null  [name => content] */
-	private ?array $templates = null;
-
-
-	/**
-	 * @param  string[]  $templates
-	 */
-	public function __construct(?array $templates = null)
-	{
-		$this->templates = $templates;
+	public function __construct(
+		/** @var array<string, string>|null */
+		private ?array $templates = null,
+	) {
 	}
 
 

package/vendor/latte/latte/src/Latte/Policy.php

@@ -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;
 
 
+/**
+ * Security policy for sandbox mode.
+ */
 interface Policy
 {
 	function isTagAllowed(string $tag): bool;

package/vendor/latte/latte/src/Latte/Runtime/Block.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\Runtime;
 
 
@@ -15,6 +13,6 @@ final class Block
 {
 	public ?string $contentType = null;
 
-	/** @var callable[] */
+	/** @var \Closure[] */
 	public array $functions = [];
 }

package/vendor/latte/latte/src/Latte/{Cache.php → Runtime/Cache.php}

@@ -1,14 +1,14 @@
-<?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;
+namespace Latte\Runtime;
 
+use Latte\Engine;
+use Latte\RuntimeException;
 use function array_map, defined, dirname, file_put_contents, filemtime, flock, fopen, fseek, ftell, ftruncate, function_exists, fwrite, is_dir, is_file, mkdir, preg_match, preg_replace, rename, serialize, stream_get_contents, strlen, substr, unlink;
 use const LOCK_EX, LOCK_SH, LOCK_UN;
 
@@ -42,7 +42,7 @@ final class Cache
 			: null;
 
 		if (
-			!($signature && $signature !== stream_get_contents($lock))
+			!($signature && $lock && $signature !== stream_get_contents($lock))
 			&& (@include $file) !== false // @ - file may not exist
 		) {
 			return;
@@ -68,10 +68,10 @@ final class Cache
 
 			fseek($lock, 0);
 			fwrite($lock, $signature ?? hash('xxh128', serialize($this->generateRefreshSignature($engine, $name))));
-			ftruncate($lock, ftell($lock));
+			ftruncate($lock, (int) ftell($lock));
 
 			if (function_exists('opcache_invalidate')) {
-				@opcache_invalidate($file, true); // @ can be restricted
+				@opcache_invalidate($file, force: true); // @ can be restricted
 			}
 		}
 
@@ -88,14 +88,14 @@ final class Cache
 	{
 		$dir = dirname($file);
 		if (!is_dir($dir) && !@mkdir($dir) && !is_dir($dir)) { // @ - dir may already exist
-			throw new RuntimeException("Unable to create directory '$dir'. " . error_get_last()['message']);
+			throw new RuntimeException("Unable to create directory '$dir'. " . (error_get_last()['message'] ?? ''));
 		}
 
 		$handle = @fopen($file, 'c+'); // @ is escalated to exception
 		if (!$handle) {
-			throw new RuntimeException("Unable to create file '$file'. " . error_get_last()['message']);
+			throw new RuntimeException("Unable to create file '$file'. " . (error_get_last()['message'] ?? ''));
 		} elseif (!@flock($handle, $mode)) { // @ is escalated to exception
-			throw new RuntimeException('Unable to acquire ' . ($mode & LOCK_EX ? 'exclusive' : 'shared') . " lock on file '$file'. " . error_get_last()['message']);
+			throw new RuntimeException('Unable to acquire ' . ($mode & LOCK_EX ? 'exclusive' : 'shared') . " lock on file '$file'. " . (error_get_last()['message'] ?? ''));
 		}
 
 		return $handle;
@@ -127,6 +127,7 @@ final class Cache
 	/**
 	 * Returns values used to detect if cached template needs recompilation when autoRefresh is enabled.
 	 * Triggers recompilation when template code, Latte engine, or any extension changes.
+	 * @return list<mixed>
 	 */
 	protected function generateRefreshSignature(Engine $engine, string $name): array
 	{
@@ -134,7 +135,7 @@ final class Cache
 			Engine::Version,
 			$engine->getLoader()->getContent($name),
 			array_map(
-				fn($extension) => filemtime((new \ReflectionObject($extension))->getFileName()),
+				fn($extension) => @filemtime((string) (new \ReflectionObject($extension))->getFileName()), // @ file may not exist
 				$engine->getExtensions(),
 			),
 		];

package/vendor/latte/latte/src/Latte/Runtime/FilterExecutor.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\Runtime;
 
 use Latte;
@@ -22,7 +20,7 @@ use function array_column, array_combine, array_keys, array_unshift, strtoupper;
 #[\AllowDynamicProperties]
 class FilterExecutor
 {
-	/** @var callable[] */
+	/** @var array<callable> */
 	private array $_dynamic = [];
 
 	/** @var array<string, array{callable, ?bool}> */
@@ -47,7 +45,7 @@ class FilterExecutor
 
 	/**
 	 * Returns all run-time filters.
-	 * @return callable[]
+	 * @return array<string, callable>
 	 */
 	public function getAll(): array
 	{

package/vendor/latte/latte/src/Latte/Runtime/FilterInfo.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\Runtime;
 
 use Latte;
@@ -14,22 +12,23 @@ use function in_array, strtoupper;
 
 
 /**
- * Filter runtime info
+ * Content type context for contextual filters.
  */
 class FilterInfo
 {
-	public ?string $contentType = null;
-
-
-	public function __construct(?string $contentType = null)
-	{
-		$this->contentType = $contentType;
+	public function __construct(
+		public ?string $contentType = null,
+	) {
 	}
 
 
+	/**
+	 * Validates content type is allowed for this filter.
+	 * @param  list<string|null>  $contentTypes
+	 */
 	public function validate(array $contentTypes, ?string $name = null): void
 	{
-		if (!in_array($this->contentType, $contentTypes, true)) {
+		if (!in_array($this->contentType, $contentTypes, strict: true)) {
 			$name = $name ? " |$name" : $name;
 			$type = $this->contentType ? ' ' . strtoupper($this->contentType) : '';
 			throw new Latte\RuntimeException("Filter{$name} used with incompatible type{$type}.");

package/vendor/latte/latte/src/Latte/Runtime/FunctionExecutor.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\Runtime;
 
 use Latte\Helpers;
@@ -20,10 +18,10 @@ use function array_keys;
 #[\AllowDynamicProperties]
 class FunctionExecutor
 {
-	/** @var callable[] */
+	/** @var array<string, callable> */
 	private array $_list = [];
 
-	/** @var bool[] */
+	/** @var array<string, bool> */
 	private array $_aware = [];
 
 
@@ -40,7 +38,7 @@ class FunctionExecutor
 
 	/**
 	 * Returns all run-time functions.
-	 * @return callable[]
+	 * @return array<string, callable>
 	 */
 	public function getAll(): array
 	{

package/vendor/latte/latte/src/Latte/Runtime/Helpers.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\Runtime;
 
 use Latte;
@@ -36,7 +34,7 @@ class Helpers
 	/**
 	 * Escapes string for use inside CSS template.
 	 */
-	public static function escapeCss($s): string
+	public static function escapeCss(mixed $s): string
 	{
 		// http://www.w3.org/TR/2006/WD-CSS21-20060411/syndata.html#q6
 		return addcslashes((string) $s, "\x00..\x1F!\"#$%&'()*+,./:;<=>?@[\\]^`{|}~");
@@ -60,7 +58,7 @@ class Helpers
 	/**
 	 * Escapes string for use inside iCal template.
 	 */
-	public static function escapeICal($s): string
+	public static function escapeICal(mixed $s): string
 	{
 		// https://www.ietf.org/rfc/rfc5545.txt
 		$s = str_replace("\r", '', (string) $s);
@@ -70,7 +68,7 @@ class Helpers
 
 
 	/**
-	 * Converts ... to ...
+	 * Converts content between content types.
 	 */
 	public static function convertTo(FilterInfo $info, string $dest, string $s): string
 	{
@@ -86,7 +84,7 @@ class Helpers
 	}
 
 
-	public static function nop($s): string
+	public static function nop(mixed $s): string
 	{
 		return (string) $s;
 	}

package/vendor/latte/latte/src/Latte/Runtime/Html.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\Runtime;
 
 
@@ -15,10 +13,10 @@ namespace Latte\Runtime;
  */
 class Html implements HtmlStringable
 {
-	private string $value;
+	private readonly string $value;
 
 
-	public function __construct($value)
+	public function __construct(string|\Stringable|null $value)
 	{
 		$this->value = (string) $value;
 	}

package/vendor/latte/latte/src/Latte/Runtime/HtmlHelpers.php

@@ -1,19 +1,17 @@
-<?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\Runtime;
 
 use Latte;
 use Latte\ContentType;
 use Nette;
-use function get_debug_type, html_entity_decode, htmlspecialchars, in_array, is_array, is_bool, is_float, is_int, is_scalar, is_string, ord, preg_match, preg_replace, preg_replace_callback, str_replace, strip_tags, strtolower, strtr, substr;
-use const ENT_HTML5, ENT_NOQUOTES, ENT_QUOTES, ENT_SUBSTITUTE;
+use function get_debug_type, html_entity_decode, htmlspecialchars, in_array, is_array, is_bool, is_float, is_int, is_string, ord, preg_match, preg_replace, preg_replace_callback, str_replace, strip_tags, strtolower, strtr;
+use const ENT_HTML5, ENT_NOQUOTES, ENT_QUOTES, ENT_SUBSTITUTE, JSON_INVALID_UTF8_SUBSTITUTE, JSON_THROW_ON_ERROR, JSON_UNESCAPED_SLASHES, JSON_UNESCAPED_UNICODE;
 
 
 /**
@@ -38,7 +36,7 @@ final class HtmlHelpers
 	/**
 	 * Escapes string for use inside HTML text.
 	 */
-	public static function escapeText($s): string
+	public static function escapeText(mixed $s): string
 	{
 		if ($s instanceof HtmlStringable || $s instanceof Nette\HtmlStringable) {
 			return $s->__toString();
@@ -53,7 +51,7 @@ final class HtmlHelpers
 	/**
 	 * Escapes string for use inside HTML attribute value.
 	 */
-	public static function escapeAttr($s): string
+	public static function escapeAttr(mixed $s): string
 	{
 		if ($s instanceof HtmlStringable) {
 			$s = self::convertHtmlToText($s->__toString());
@@ -68,7 +66,7 @@ final class HtmlHelpers
 	/**
 	 * Escapes string for use inside HTML tag.
 	 */
-	public static function escapeTag($s): string
+	public static function escapeTag(mixed $s): string
 	{
 		$s = (string) $s;
 		$s = htmlspecialchars($s, ENT_QUOTES | ENT_HTML5 | ENT_SUBSTITUTE, 'UTF-8');
@@ -83,7 +81,7 @@ final class HtmlHelpers
 	/**
 	 * Escapes string for use inside HTML/XML comments.
 	 */
-	public static function escapeComment($s): string
+	public static function escapeComment(mixed $s): string
 	{
 		$s = (string) $s;
 		if ($s && ($s[0] === '-' || $s[0] === '>' || $s[0] === '!')) {
@@ -91,7 +89,7 @@ final class HtmlHelpers
 		}
 
 		$s = str_replace('--', '- - ', $s);
-		if (substr($s, -1) === '-') {
+		if (str_ends_with($s, '-')) {
 			$s .= ' ';
 		}
 
@@ -102,7 +100,7 @@ final class HtmlHelpers
 	/**
 	 * Escapes HTML for usage in <script type=text/html>
 	 */
-	public static function escapeRawHtml($s): string
+	public static function escapeRawHtml(mixed $s): string
 	{
 		if ($s instanceof HtmlStringable || $s instanceof Nette\HtmlStringable) {
 			return self::convertHtmlToRawText($s->__toString());
@@ -115,7 +113,7 @@ final class HtmlHelpers
 	/**
 	 * Escapes only quotes.
 	 */
-	public static function escapeQuotes($s): string
+	public static function escapeQuotes(mixed $s): string
 	{
 		return strtr((string) $s, ['"' => '&quot;', "'" => '&apos;']);
 	}
@@ -124,7 +122,7 @@ final class HtmlHelpers
 	/**
 	 * Converts JS and CSS for usage in <script> or <style>
 	 */
-	public static function convertJSToRawText($s): string
+	public static function convertJSToRawText(mixed $s): string
 	{
 		return preg_replace('#</(script|style)#i', '<\/$1', (string) $s);
 	}
@@ -196,7 +194,7 @@ final class HtmlHelpers
 		return match (true) {
 			is_string($value), is_int($value), is_float($value), $value instanceof \Stringable => $namePart . '="' . self::escapeAttr($value) . '"',
 			$value === null => '',
-			default => self::triggerInvalidValue(trim($namePart), $value) ?? '',
+			default => self::triggerInvalidValue(trim($namePart), $value),
 		};
 	}
 
@@ -269,7 +267,8 @@ final class HtmlHelpers
 	}
 
 
-	private static function formatArrayAttribute(string $namePart, array $items, \Closure $cb, $separator): string
+	/** @param  array<mixed>  $items */
+	private static function formatArrayAttribute(string $namePart, array $items, \Closure $cb, string $separator): string
 	{
 		$res = [];
 		foreach ($items as $k => $v) {
@@ -281,11 +280,12 @@ final class HtmlHelpers
 	}
 
 
-	public static function triggerInvalidValue(string $name, mixed $value): void
+	public static function triggerInvalidValue(string $name, mixed $value): string
 	{
 		$source = Latte\Helpers::guessTemplatePosition();
 		$type = get_debug_type($value);
 		trigger_error("Invalid value for attribute '$name': $type is not allowed" . ($source ? " ($source)" : '.'), E_USER_WARNING);
+		return '';
 	}
 
 
@@ -321,7 +321,7 @@ final class HtmlHelpers
 	public static function isUrlAttribute(string $tag, string $attr): bool
 	{
 		$attr = strtolower($attr);
-		return in_array($attr, ['href', 'src', 'action', 'formaction'], true)
+		return in_array($attr, ['href', 'src', 'action', 'formaction'], strict: true)
 			|| ($attr === 'data' && strtolower($tag) === 'object');
 	}
 
@@ -355,7 +355,7 @@ final class HtmlHelpers
 			throw new Latte\RuntimeException("Invalid tag name '$name'");
 
 		} elseif (self::isVoidElement($name) !== self::isVoidElement($origName ?? 'div') // non-void is default
-			|| in_array(strtolower($name), ['style', 'script'], true)) {
+			|| in_array(strtolower($name), ['style', 'script'], strict: true)) {
 			throw new Latte\RuntimeException("Forbidden: Cannot change element to <$name>");
 		}
 		return $name;

package/vendor/latte/latte/src/Latte/Runtime/HtmlStringable.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\Runtime;