Add generics to BaseRack and its children

Author: spawnia

CHANGELOG.md

@@ -9,6 +9,12 @@ See [GitHub releases](https://github.com/mll-lab/php-utils/releases).
 
 ## Unreleased
 
+## v4.1.0
+
+### Added
+
+- Add generics to `BaseRack` and its children
+
 ## v4.0.0
 
 ### Added

src/Tecan/Rack/AlublockA.php

@@ -2,6 +2,11 @@
 
 namespace MLL\Utils\Tecan\Rack;
 
+/**
+ * @template TContent
+ *
+ * @extends BaseRack<TContent>
+ */
 class AlublockA extends BaseRack
 {
     public function type(): string

src/Tecan/Rack/BaseRack.php

@@ -4,11 +4,12 @@
 
 use Illuminate\Support\Collection;
 
+/** @template TContent */
 abstract class BaseRack implements Rack
 {
     public const EMPTY_POSITION = null;
 
-    /** @var Collection<int, mixed> */
+    /** @var Collection<int, TContent|null> */
     public Collection $positions;
 
     public function __construct()
@@ -31,13 +32,13 @@ public function toString(): string
         ]);
     }
 
-    /** @param mixed $content Anything goes, null is considered empty */
+    /** @param TContent|null $content Anything goes, null is considered empty */
     public function assignFirstEmptyPosition($content): int
     {
         return $this->assignPosition($content, $this->findFirstEmptyPosition());
     }
 
-    /** @param mixed $content Anything goes, null is considered empty */
+    /** @param TContent|null $content Anything goes, null is considered empty */
     public function assignLastEmptyPosition($content): int
     {
         return $this->assignPosition($content, $this->findLastEmptyPosition());
@@ -71,7 +72,7 @@ public function findLastEmptyPosition(): int
         return $lastEmpty;
     }
 
-    /** @param mixed $content Anything goes, null is considered empty */
+    /** @param TContent|null $content Anything goes, null is considered empty */
     public function assignPosition($content, int $position): int
     {
         if (! $this->positions->has($position)) {

src/Tecan/Rack/DestLC.php

@@ -2,6 +2,11 @@
 
 namespace MLL\Utils\Tecan\Rack;
 
+/**
+ * @template TContent
+ *
+ * @extends BaseRack<TContent>
+ */
 class DestLC extends BaseRack
 {
     public function type(): string

src/Tecan/Rack/DestPCR.php

@@ -2,6 +2,11 @@
 
 namespace MLL\Utils\Tecan\Rack;
 
+/**
+ * @template TContent
+ *
+ * @extends BaseRack<TContent>
+ */
 class DestPCR extends BaseRack
 {
     public function type(): string

src/Tecan/Rack/DestTaqMan.php

@@ -2,6 +2,11 @@
 
 namespace MLL\Utils\Tecan\Rack;
 
+/**
+ * @template TContent
+ *
+ * @extends BaseRack<TContent>
+ */
 class DestTaqMan extends BaseRack
 {
     public function type(): string

src/Tecan/Rack/FluidXRack.php

@@ -2,6 +2,11 @@
 
 namespace MLL\Utils\Tecan\Rack;
 
+/**
+ * @template TContent
+ *
+ * @extends BaseRack<TContent>
+ */
 class FluidXRack extends BaseRack implements ScannedRack
 {
     public function type(): string

src/Tecan/Rack/MPCDNA.php

@@ -2,6 +2,11 @@
 
 namespace MLL\Utils\Tecan\Rack;
 
+/**
+ * @template TContent
+ *
+ * @extends BaseRack<TContent>
+ */
 class MPCDNA extends BaseRack
 {
     public function type(): string

src/Tecan/Rack/MPSample.php

@@ -2,6 +2,11 @@
 
 namespace MLL\Utils\Tecan\Rack;
 
+/**
+ * @template TContent
+ *
+ * @extends BaseRack<TContent>
+ */
 class MPSample extends BaseRack
 {
     public function type(): string

src/Tecan/Rack/MPWater.php

@@ -2,6 +2,11 @@
 
 namespace MLL\Utils\Tecan\Rack;
 
+/**
+ * @template TContent
+ *
+ * @extends BaseRack<TContent>
+ */
 class MPWater extends BaseRack
 {
     public function type(): string