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

package/vendor/nette/utils/src/Utils/Image.php

@@ -10,6 +10,8 @@ declare(strict_types=1);
 namespace Nette\Utils;
 
 use Nette;
+use function is_array, is_int, is_string;
+use const IMG_BMP, IMG_FLIP_BOTH, IMG_FLIP_HORIZONTAL, IMG_FLIP_VERTICAL, IMG_GIF, IMG_JPG, IMG_PNG, IMG_WEBP, PATHINFO_EXTENSION;
 
 
 /**
@@ -22,7 +24,7 @@ use Nette;
  * $image->send();
  * </code>
  *
- * @method Image affine(array $affine, ?array $clip = null)
+ * @method Image affine(array<int, float|int> $affine, ?array{x: int, y: int, width: int, height: int} $clip = null)
  * @method void alphaBlending(bool $enable)
  * @method void antialias(bool $enable)
  * @method void arc(int $centerX, int $centerY, int $width, int $height, int $startAngle, int $endAngle, ImageColor $color)
@@ -39,51 +41,51 @@ use Nette;
  * @method int colorResolve(int $red, int $green, int $blue)
  * @method int colorResolveAlpha(int $red, int $green, int $blue, int $alpha)
  * @method void colorSet(int $index, int $red, int $green, int $blue, int $alpha = 0)
- * @method array colorsForIndex(int $color)
+ * @method array{red: int, green: int, blue: int, alpha: int} colorsForIndex(int $color)
  * @method int colorsTotal()
  * @method int colorTransparent(?int $color = null)
- * @method void convolution(array $matrix, float $div, float $offset)
+ * @method void convolution(array<int, array<int, float>> $matrix, float $div, float $offset)
  * @method void copy(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $srcW, int $srcH)
  * @method void copyMerge(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $srcW, int $srcH, int $pct)
  * @method void copyMergeGray(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $srcW, int $srcH, int $pct)
  * @method void copyResampled(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $dstW, int $dstH, int $srcW, int $srcH)
  * @method void copyResized(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $dstW, int $dstH, int $srcW, int $srcH)
- * @method Image cropAuto(int $mode = IMG_CROP_DEFAULT, float $threshold = .5, ?ImageColor $color = null)
+ * @method Image cropAuto(int $mode = 0, float $threshold = .5, ?ImageColor $color = null)
  * @method void ellipse(int $centerX, int $centerY, int $width, int $height, ImageColor $color)
  * @method void fill(int $x, int $y, ImageColor $color)
  * @method void filledArc(int $centerX, int $centerY, int $width, int $height, int $startAngle, int $endAngle, ImageColor $color, int $style)
  * @method void filledEllipse(int $centerX, int $centerY, int $width, int $height, ImageColor $color)
- * @method void filledPolygon(array $points, ImageColor $color)
+ * @method void filledPolygon(array<int, int> $points, ImageColor $color)
  * @method void filledRectangle(int $x1, int $y1, int $x2, int $y2, ImageColor $color)
  * @method void fillToBorder(int $x, int $y, ImageColor $borderColor, ImageColor $color)
  * @method void filter(int $filter, ...$args)
  * @method void flip(int $mode)
- * @method array ftText(float $size, float $angle, int $x, int $y, ImageColor $color, string $fontFile, string $text, array $options = [])
+ * @method array<int, int> ftText(float $size, float $angle, int $x, int $y, ImageColor $color, string $fontFile, string $text, array<string, mixed> $options = [])
  * @method void gammaCorrect(float $inputgamma, float $outputgamma)
- * @method array getClip()
+ * @method array{int, int, int, int} getClip()
  * @method int getInterpolation()
  * @method int interlace(?bool $enable = null)
  * @method bool isTrueColor()
  * @method void layerEffect(int $effect)
  * @method void line(int $x1, int $y1, int $x2, int $y2, ImageColor $color)
- * @method void openPolygon(array $points, ImageColor $color)
+ * @method void openPolygon(array<int, int> $points, ImageColor $color)
  * @method void paletteCopy(Image $source)
  * @method void paletteToTrueColor()
- * @method void polygon(array $points, ImageColor $color)
+ * @method void polygon(array<int, int> $points, ImageColor $color)
  * @method void rectangle(int $x1, int $y1, int $x2, int $y2, ImageColor $color)
  * @method mixed resolution(?int $resolutionX = null, ?int $resolutionY = null)
  * @method Image rotate(float $angle, ImageColor $backgroundColor)
  * @method void saveAlpha(bool $enable)
- * @method Image scale(int $newWidth, int $newHeight = -1, int $mode = IMG_BILINEAR_FIXED)
+ * @method Image scale(int $newWidth, int $newHeight = -1, int $mode = 3)
  * @method void setBrush(Image $brush)
  * @method void setClip(int $x1, int $y1, int $x2, int $y2)
- * @method void setInterpolation(int $method = IMG_BILINEAR_FIXED)
+ * @method void setInterpolation(int $method = 3)
  * @method void setPixel(int $x, int $y, ImageColor $color)
- * @method void setStyle(array $style)
+ * @method void setStyle(array<int, int> $style)
  * @method void setThickness(int $thickness)
  * @method void setTile(Image $tile)
  * @method void trueColorToPalette(bool $dither, int $ncolors)
- * @method array ttfText(float $size, float $angle, int $x, int $y, ImageColor $color, string $fontfile, string $text, array $options = [])
+ * @method array<int, int> ttfText(float $size, float $angle, int $x, int $y, ImageColor $color, string $fontfile, string $text, array<string, mixed> $options = [])
  * @property-read positive-int $width
  * @property-read positive-int $height
  * @property-read \GdImage $imageResource
@@ -144,6 +146,7 @@ class Image
 	/**
 	 * Returns RGB color (0..255) and transparency (0..127).
 	 * @deprecated use ImageColor::rgb()
+	 * @return array{red: int, green: int, blue: int, alpha: int}
 	 */
 	public static function rgb(int $red, int $green, int $blue, int $transparency = 0): array
 	{
@@ -190,6 +193,7 @@ class Image
 	}
 
 
+	/** @param  callable-string  $func */
 	private static function invokeSafe(string $func, string $arg, string $message, string $callee): static
 	{
 		$errors = [];
@@ -211,6 +215,7 @@ class Image
 	 * Creates a new true color image of the given dimensions. The default color is black.
 	 * @param  positive-int  $width
 	 * @param  positive-int  $height
+	 * @param  ImageColor|array{red: int, green: int, blue: int, alpha?: int}|null  $color
 	 * @throws Nette\NotSupportedException if gd extension is not loaded
 	 */
 	public static function fromBlank(int $width, int $height, ImageColor|array|null $color = null): static
@@ -222,9 +227,9 @@ class Image
 
 		$image = new static(imagecreatetruecolor($width, $height));
 		if ($color) {
-			$image->alphablending(false);
-			$image->filledrectangle(0, 0, $width - 1, $height - 1, $color);
-			$image->alphablending(true);
+			$image->alphaBlending(false);
+			$image->filledRectangle(0, 0, $width - 1, $height - 1, self::normalizeColor($color));
+			$image->alphaBlending(true);
 		}
 
 		return $image;
@@ -233,23 +238,27 @@ class Image
 
 	/**
 	 * Returns the type of image from file.
-	 * @return ImageType::*|null
+	 * @param-out ?int  $width
+	 * @param-out ?int  $height
+	 * @return ?ImageType::*
 	 */
-	public static function detectTypeFromFile(string $file, &$width = null, &$height = null): ?int
+	public static function detectTypeFromFile(string $file, mixed &$width = null, mixed &$height = null): ?int
 	{
-		[$width, $height, $type] = @getimagesize($file); // @ - files smaller than 12 bytes causes read error
-		return isset(self::Formats[$type]) ? $type : null;
+		[$width, $height, $type] = Helpers::falseToNull(@getimagesize($file)); // @ - files smaller than 12 bytes causes read error
+		return $type && isset(self::Formats[$type]) ? $type : null;
 	}
 
 
 	/**
 	 * Returns the type of image from string.
-	 * @return ImageType::*|null
+	 * @param-out ?int  $width
+	 * @param-out ?int  $height
+	 * @return ?ImageType::*
 	 */
-	public static function detectTypeFromString(string $s, &$width = null, &$height = null): ?int
+	public static function detectTypeFromString(string $s, mixed &$width = null, mixed &$height = null): ?int
 	{
-		[$width, $height, $type] = @getimagesizefromstring($s); // @ - strings smaller than 12 bytes causes read error
-		return isset(self::Formats[$type]) ? $type : null;
+		[$width, $height, $type] = Helpers::falseToNull(@getimagesizefromstring($s)); // @ - strings smaller than 12 bytes causes read error
+		return $type && isset(self::Formats[$type]) ? $type : null;
 	}
 
 
@@ -312,7 +321,7 @@ class Image
 	}
 
 
-	/** @return  ImageType[] */
+	/** @return  ImageType::*[] */
 	public static function getSupportedTypes(): array
 	{
 		self::ensureExtension();
@@ -384,6 +393,10 @@ class Image
 	public function resize(int|string|null $width, int|string|null $height, int $mode = self::OrSmaller): static
 	{
 		if ($mode & self::Cover) {
+			if ($width === null || $height === null) {
+				throw new Nette\InvalidArgumentException('Both width and height must be set for Cover mode.');
+			}
+
 			return $this->resize($width, $height, self::OrBigger)->crop('50%', '50%', $width, $height);
 		}
 
@@ -417,12 +430,13 @@ class Image
 	/**
 	 * Calculates dimensions of resized image. Width and height accept pixels or percent.
 	 * @param  int-mask-of<self::OrSmaller|self::OrBigger|self::Stretch|self::Cover|self::ShrinkOnly>  $mode
+	 * @return array{int<1, max>, int<1, max>}
 	 */
 	public static function calculateSize(
 		int $srcWidth,
 		int $srcHeight,
-		$newWidth,
-		$newHeight,
+		int|string|null $newWidth,
+		int|string|null $newHeight,
 		int $mode = self::OrSmaller,
 	): array
 	{
@@ -466,19 +480,19 @@ class Image
 			}
 
 			if ($mode & self::OrBigger) {
-				$scale = [max($scale)];
+				$scale = [max($scale ?: [1])];
 			}
 
 			if ($mode & self::ShrinkOnly) {
 				$scale[] = 1;
 			}
 
-			$scale = min($scale);
+			$scale = min($scale ?: [1]);
 			$newWidth = (int) round($srcWidth * $scale);
 			$newHeight = (int) round($srcHeight * $scale);
 		}
 
-		return [max($newWidth, 1), max($newHeight, 1)];
+		return [max((int) $newWidth, 1), max((int) $newHeight, 1)];
 	}
 
 
@@ -493,7 +507,7 @@ class Image
 			$this->image = imagecrop($this->image, $r);
 			imagesavealpha($this->image, true);
 		} else {
-			$newImage = static::fromBlank($r['width'], $r['height'], ImageColor::rgb(0, 0, 0, 0))->getImageResource();
+			$newImage = static::fromBlank(max(1, $r['width']), max(1, $r['height']), ImageColor::rgb(0, 0, 0, 0))->getImageResource();
 			imagecopy($newImage, $this->image, 0, 0, $r['x'], $r['y'], $r['width'], $r['height']);
 			$this->image = $newImage;
 		}
@@ -504,6 +518,7 @@ class Image
 
 	/**
 	 * Calculates dimensions of cutout in image. Arguments accepts pixels or percent.
+	 * @return array{int, int, int, int}
 	 */
 	public static function calculateCutout(
 		int $srcWidth,
@@ -514,21 +529,10 @@ class Image
 		int|string $newHeight,
 	): array
 	{
-		if (self::isPercent($newWidth)) {
-			$newWidth = (int) round($srcWidth / 100 * $newWidth);
-		}
-
-		if (self::isPercent($newHeight)) {
-			$newHeight = (int) round($srcHeight / 100 * $newHeight);
-		}
-
-		if (self::isPercent($left)) {
-			$left = (int) round(($srcWidth - $newWidth) / 100 * $left);
-		}
-
-		if (self::isPercent($top)) {
-			$top = (int) round(($srcHeight - $newHeight) / 100 * $top);
-		}
+		$newWidth = (int) (self::isPercent($newWidth) ? round($srcWidth / 100 * $newWidth) : $newWidth);
+		$newHeight = (int) (self::isPercent($newHeight) ? round($srcHeight / 100 * $newHeight) : $newHeight);
+		$left = (int) (self::isPercent($left) ? round(($srcWidth - $newWidth) / 100 * $left) : $left);
+		$top = (int) (self::isPercent($top) ? round(($srcHeight - $newHeight) / 100 * $top) : $top);
 
 		if ($left < 0) {
 			$newWidth += $left;
@@ -573,14 +577,8 @@ class Image
 
 		$width = $image->getWidth();
 		$height = $image->getHeight();
-
-		if (self::isPercent($left)) {
-			$left = (int) round(($this->getWidth() - $width) / 100 * $left);
-		}
-
-		if (self::isPercent($top)) {
-			$top = (int) round(($this->getHeight() - $height) / 100 * $top);
-		}
+		$left = (int) (self::isPercent($left) ? round(($this->getWidth() - $width) / 100 * $left) : $left);
+		$top = (int) (self::isPercent($top) ? round(($this->getHeight() - $height) / 100 * $top) : $top);
 
 		$output = $input = $image->image;
 		if ($opacity < 100) {
@@ -593,7 +591,7 @@ class Image
 			imagealphablending($output, false);
 			if (!$image->isTrueColor()) {
 				$input = $output;
-				imagefilledrectangle($output, 0, 0, $width, $height, imagecolorallocatealpha($output, 0, 0, 0, 127));
+				imagefilledrectangle($output, 0, 0, $width, $height, (int) imagecolorallocatealpha($output, 0, 0, 0, 127));
 				imagecopy($output, $image->image, 0, 0, 0, 0, $width, $height);
 			}
 
@@ -624,6 +622,8 @@ class Image
 
 	/**
 	 * Calculates the bounding box for a TrueType text. Returns keys left, top, width and height.
+	 * @param  array<string, mixed>  $options
+	 * @return array{left: int, top: int, width: int, height: int}
 	 */
 	public static function calculateTextBox(
 		string $text,
@@ -668,7 +668,7 @@ class Image
 
 	/**
 	 * Saves image to the file. Quality is in the range 0..100 for JPEG (default 85), WEBP (default 80) and AVIF (default 30) and 0..9 for PNG (default 9).
-	 * @param  ImageType::*|null  $type
+	 * @param  ?ImageType::*  $type
 	 * @throws ImageException
 	 */
 	public function save(string $file, ?int $quality = null, ?int $type = null): void
@@ -744,6 +744,7 @@ class Image
 
 	/**
 	 * Call to undefined method.
+	 * @param  mixed[]  $args
 	 * @throws Nette\MemberAccessException
 	 */
 	public function __call(string $name, array $args): mixed
@@ -758,6 +759,7 @@ class Image
 				$args[$key] = $value->getImageResource();
 
 			} elseif ($value instanceof ImageColor || (is_array($value) && isset($value['red']))) {
+				/** @var ImageColor|array{red: int, green: int, blue: int, alpha?: int} $value */
 				$args[$key] = $this->resolveColor($value);
 			}
 		}
@@ -771,12 +773,13 @@ class Image
 
 	public function __clone()
 	{
-		ob_start(function () {});
+		ob_start(fn() => '');
 		imagepng($this->image, null, 0);
-		$this->setImageResource(imagecreatefromstring(ob_get_clean()));
+		$this->setImageResource(imagecreatefromstring(ob_get_clean()) ?: throw new Nette\ShouldNotHappenException);
 	}
 
 
+	/** @param-out int|float $num */
 	private static function isPercent(int|string &$num): bool
 	{
 		if (is_string($num) && str_ends_with($num, '%')) {
@@ -794,19 +797,36 @@ class Image
 	/**
 	 * Prevents serialization.
 	 */
-	public function __sleep(): array
+	public function __serialize(): array
 	{
 		throw new Nette\NotSupportedException('You cannot serialize or unserialize ' . self::class . ' instances.');
 	}
 
 
+	/**
+	 * @param  ImageColor|array{red: int, green: int, blue: int, alpha?: int}  $color
+	 */
 	public function resolveColor(ImageColor|array $color): int
 	{
-		$color = $color instanceof ImageColor ? $color->toRGBA() : array_values($color);
+		$color = self::normalizeColor($color)->toRGBA();
 		return imagecolorallocatealpha($this->image, ...$color) ?: imagecolorresolvealpha($this->image, ...$color);
 	}
 
 
+	/** @param  ImageColor|array{red: int, green: int, blue: int, alpha?: int}  $color */
+	private static function normalizeColor(ImageColor|array $color): ImageColor
+	{
+		return $color instanceof ImageColor
+			? $color
+			: ImageColor::rgb(
+				$color['red'],
+				$color['green'],
+				$color['blue'],
+				(127 - ($color['alpha'] ?? 0)) / 127,
+			);
+	}
+
+
 	private static function ensureExtension(): void
 	{
 		if (!extension_loaded('gd')) {

package/vendor/nette/utils/src/Utils/ImageColor.php

@@ -10,6 +10,7 @@ declare(strict_types=1);
 namespace Nette\Utils;
 
 use Nette;
+use function hexdec, ltrim, max, min, round, strlen;
 
 
 /**
@@ -63,6 +64,10 @@ class ImageColor
 	}
 
 
+	/**
+	 * Returns GD-compatible color array [R, G, B, alpha].
+	 * @return array{int<0, 255>, int<0, 255>, int<0, 255>, int<0, 127>}
+	 */
 	public function toRGBA(): array
 	{
 		return [

package/vendor/nette/utils/src/Utils/ImageType.php

@@ -9,6 +9,8 @@ declare(strict_types=1);
 
 namespace Nette\Utils;
 
+use const IMAGETYPE_BMP, IMAGETYPE_GIF, IMAGETYPE_JPEG, IMAGETYPE_PNG, IMAGETYPE_WEBP;
+
 
 /**
  * Type of image file.

package/vendor/nette/utils/src/Utils/Iterables.php

@@ -10,6 +10,7 @@ declare(strict_types=1);
 namespace Nette\Utils;
 
 use Nette;
+use function is_array;
 
 
 /**
@@ -21,6 +22,7 @@ final class Iterables
 
 	/**
 	 * Tests for the presence of value.
+	 * @param  iterable<mixed>  $iterable
 	 */
 	public static function contains(iterable $iterable, mixed $value): bool
 	{
@@ -35,6 +37,7 @@ final class Iterables
 
 	/**
 	 * Tests for the presence of key.
+	 * @param  iterable<mixed>  $iterable
 	 */
 	public static function containsKey(iterable $iterable, mixed $key): bool
 	{
@@ -51,9 +54,11 @@ final class Iterables
 	 * Returns the first item (matching the specified predicate if given). If there is no such item, it returns result of invoking $else or null.
 	 * @template K
 	 * @template V
+	 * @template E
 	 * @param  iterable<K, V>  $iterable
 	 * @param  ?callable(V, K, iterable<K, V>): bool  $predicate
-	 * @return ?V
+	 * @param  ?callable(): E  $else
+	 * @return ($else is null ? ?V : V|E)
 	 */
 	public static function first(iterable $iterable, ?callable $predicate = null, ?callable $else = null): mixed
 	{
@@ -70,9 +75,11 @@ final class Iterables
 	 * Returns the key of first item (matching the specified predicate if given). If there is no such item, it returns result of invoking $else or null.
 	 * @template K
 	 * @template V
+	 * @template E
 	 * @param  iterable<K, V>  $iterable
 	 * @param  ?callable(V, K, iterable<K, V>): bool  $predicate
-	 * @return ?K
+	 * @param  ?callable(): E  $else
+	 * @return ($else is null ? ?K : K|E)
 	 */
 	public static function firstKey(iterable $iterable, ?callable $predicate = null, ?callable $else = null): mixed
 	{
@@ -160,11 +167,11 @@ final class Iterables
 	 * Iterator that transforms keys and values by calling $transformer. If it returns null, the element is skipped.
 	 * @template K
 	 * @template V
-	 * @template ResV
 	 * @template ResK
+	 * @template ResV
 	 * @param  iterable<K, V>  $iterable
-	 * @param  callable(V, K, iterable<K, V>): ?array{ResV, ResK}  $transformer
-	 * @return \Generator<ResV, ResK>
+	 * @param  callable(V, K, iterable<K, V>): ?array{ResK, ResV}  $transformer
+	 * @return \Generator<ResK, ResV>
 	 */
 	public static function mapWithKeys(iterable $iterable, callable $transformer): \Generator
 	{
@@ -177,6 +184,32 @@ final class Iterables
 	}
 
 
+	/**
+	 * Creates a repeatable iterator from a factory function.
+	 * The factory is called every time the iterator is iterated.
+	 * @template K
+	 * @template V
+	 * @param  callable(): iterable<K, V>  $factory
+	 * @return \IteratorAggregate<K, V>
+	 */
+	public static function repeatable(callable $factory): \IteratorAggregate
+	{
+		return new class ($factory(...)) implements \IteratorAggregate {
+			public function __construct(
+				/** @var \Closure(): iterable<mixed, mixed> */
+				private \Closure $factory,
+			) {
+			}
+
+
+			public function getIterator(): \Iterator
+			{
+				return Iterables::toIterator(($this->factory)());
+			}
+		};
+	}
+
+
 	/**
 	 * Wraps around iterator and caches its keys and values during iteration.
 	 * This allows the data to be re-iterated multiple times.
@@ -185,11 +218,12 @@ final class Iterables
 	 * @param  iterable<K, V>  $iterable
 	 * @return \IteratorAggregate<K, V>
 	 */
-	public static function memoize(iterable $iterable): iterable
+	public static function memoize(iterable $iterable): \IteratorAggregate
 	{
 		return new class (self::toIterator($iterable)) implements \IteratorAggregate {
 			public function __construct(
-				private \Iterator $iterator,
+				private readonly \Iterator $iterator,
+				/** @var array<array{mixed, mixed}> */
 				private array $cache = [],
 			) {
 			}

package/vendor/nette/utils/src/Utils/Json.php

@@ -10,6 +10,8 @@ declare(strict_types=1);
 namespace Nette\Utils;
 
 use Nette;
+use function defined, is_int, json_decode, json_encode, json_last_error, json_last_error_msg;
+use const JSON_BIGINT_AS_STRING, JSON_FORCE_OBJECT, JSON_HEX_AMP, JSON_HEX_APOS, JSON_HEX_QUOT, JSON_HEX_TAG, JSON_OBJECT_AS_ARRAY, JSON_PRESERVE_ZERO_FRACTION, JSON_PRETTY_PRINT, JSON_UNESCAPED_SLASHES, JSON_UNESCAPED_UNICODE;
 
 
 /**

package/vendor/nette/utils/src/Utils/ObjectHelpers.php

@@ -11,6 +11,8 @@ namespace Nette\Utils;
 
 use Nette;
 use Nette\MemberAccessException;
+use function array_filter, array_merge, array_pop, array_unique, get_class_methods, get_parent_class, implode, is_a, levenshtein, method_exists, preg_match_all, preg_replace, strlen, ucfirst;
+use const PREG_SET_ORDER, SORT_REGULAR;
 
 
 /**

package/vendor/nette/utils/src/Utils/Paginator.php

@@ -17,17 +17,17 @@ use Nette;
  *
  * @property   int $page
  * @property-read int $firstPage
- * @property-read int|null $lastPage
+ * @property-read ?int $lastPage
  * @property-read int<0,max> $firstItemOnPage
  * @property-read int<0,max> $lastItemOnPage
  * @property   int $base
  * @property-read bool $first
  * @property-read bool $last
- * @property-read int<0,max>|null $pageCount
+ * @property-read ?int<0,max> $pageCount
  * @property   positive-int $itemsPerPage
- * @property   int<0,max>|null $itemCount
+ * @property   ?int<0,max> $itemCount
  * @property-read int<0,max> $offset
- * @property-read int<0,max>|null $countdownOffset
+ * @property-read ?int<0,max> $countdownOffset
  * @property-read int<0,max> $length
  */
 class Paginator
@@ -41,13 +41,10 @@ class Paginator
 
 	private int $page = 1;
 
-	/** @var int<0, max>|null */
+	/** @var ?int<0, max> */
 	private ?int $itemCount = null;
 
 
-	/**
-	 * Sets current page number.
-	 */
 	public function setPage(int $page): static
 	{
 		$this->page = $page;
@@ -55,27 +52,18 @@ class Paginator
 	}
 
 
-	/**
-	 * Returns current page number.
-	 */
 	public function getPage(): int
 	{
 		return $this->base + $this->getPageIndex();
 	}
 
 
-	/**
-	 * Returns first page number.
-	 */
 	public function getFirstPage(): int
 	{
 		return $this->base;
 	}
 
 
-	/**
-	 * Returns last page number.
-	 */
 	public function getLastPage(): ?int
 	{
 		return $this->itemCount === null
@@ -106,9 +94,6 @@ class Paginator
 	}
 
 
-	/**
-	 * Sets first page (base) number.
-	 */
 	public function setBase(int $base): static
 	{
 		$this->base = $base;
@@ -116,9 +101,6 @@ class Paginator
 	}
 
 
-	/**
-	 * Returns first page (base) number.
-	 */
 	public function getBase(): int
 	{
 		return $this->base;
@@ -138,18 +120,12 @@ class Paginator
 	}
 
 
-	/**
-	 * Is the current page the first one?
-	 */
 	public function isFirst(): bool
 	{
 		return $this->getPageIndex() === 0;
 	}
 
 
-	/**
-	 * Is the current page the last one?
-	 */
 	public function isLast(): bool
 	{
 		return $this->itemCount === null
@@ -159,20 +135,16 @@ class Paginator
 
 
 	/**
-	 * Returns the total number of pages.
-	 * @return int<0, max>|null
+	 * @return ?int<0, max>
 	 */
 	public function getPageCount(): ?int
 	{
 		return $this->itemCount === null
 			? null
-			: (int) ceil($this->itemCount / $this->itemsPerPage);
+			: max(0, (int) ceil($this->itemCount / $this->itemsPerPage));
 	}
 
 
-	/**
-	 * Sets the number of items to display on a single page.
-	 */
 	public function setItemsPerPage(int $itemsPerPage): static
 	{
 		$this->itemsPerPage = max(1, $itemsPerPage);
@@ -181,7 +153,6 @@ class Paginator
 
 
 	/**
-	 * Returns the number of items to display on a single page.
 	 * @return positive-int
 	 */
 	public function getItemsPerPage(): int
@@ -190,9 +161,6 @@ class Paginator
 	}
 
 
-	/**
-	 * Sets the total number of items.
-	 */
 	public function setItemCount(?int $itemCount = null): static
 	{
 		$this->itemCount = $itemCount === null ? null : max(0, $itemCount);
@@ -201,8 +169,7 @@ class Paginator
 
 
 	/**
-	 * Returns the total number of items.
-	 * @return int<0, max>|null
+	 * @return ?int<0, max>
 	 */
 	public function getItemCount(): ?int
 	{
@@ -222,7 +189,7 @@ class Paginator
 
 	/**
 	 * Returns the absolute index of the first item on current page in countdown paging.
-	 * @return int<0, max>|null
+	 * @return ?int<0, max>
 	 */
 	public function getCountdownOffset(): ?int
 	{
@@ -240,6 +207,6 @@ class Paginator
 	{
 		return $this->itemCount === null
 			? $this->itemsPerPage
-			: min($this->itemsPerPage, $this->itemCount - $this->getPageIndex() * $this->itemsPerPage);
+			: max(0, min($this->itemsPerPage, $this->itemCount - $this->getPageIndex() * $this->itemsPerPage));
 	}
 }