Add template types to relation classes (#3262)

Author: mad-briller

Diff for: phpstan-baseline.neon

@@ -10,11 +10,41 @@ parameters:
 			count: 4
 			path: src/MongoDBServiceProvider.php
 
+		-
+			message: "#^Call to an undefined method TDeclaringModel of Illuminate\\\\Database\\\\Eloquent\\\\Model\\:\\:pull\\(\\)\\.$#"
+			count: 1
+			path: src/Relations/BelongsToMany.php
+
 		-
 			message: "#^Method Illuminate\\\\Database\\\\Eloquent\\\\Model\\:\\:push\\(\\) invoked with 3 parameters, 0 required\\.$#"
 			count: 3
 			path: src/Relations/BelongsToMany.php
 
+		-
+			message: "#^Call to an undefined method MongoDB\\\\Laravel\\\\Relations\\\\EmbedsMany\\<TRelatedModel of Illuminate\\\\Database\\\\Eloquent\\\\Model, TDeclaringModel of Illuminate\\\\Database\\\\Eloquent\\\\Model, TResult\\>\\:\\:contains\\(\\)\\.$#"
+			count: 1
+			path: src/Relations/EmbedsMany.php
+
+		-
+			message: "#^Call to an undefined method TDeclaringModel of Illuminate\\\\Database\\\\Eloquent\\\\Model\\:\\:getParentRelation\\(\\)\\.$#"
+			count: 1
+			path: src/Relations/EmbedsOneOrMany.php
+
+		-
+			message: "#^Call to an undefined method TDeclaringModel of Illuminate\\\\Database\\\\Eloquent\\\\Model\\:\\:setParentRelation\\(\\)\\.$#"
+			count: 1
+			path: src/Relations/EmbedsOneOrMany.php
+
+		-
+			message: "#^Call to an undefined method TRelatedModel of Illuminate\\\\Database\\\\Eloquent\\\\Model\\:\\:setParentRelation\\(\\)\\.$#"
+			count: 2
+			path: src/Relations/EmbedsOneOrMany.php
+
+		-
+			message: "#^Call to an undefined method TDeclaringModel of Illuminate\\\\Database\\\\Eloquent\\\\Model\\:\\:pull\\(\\)\\.$#"
+			count: 2
+			path: src/Relations/MorphToMany.php
+
 		-
 			message: "#^Method Illuminate\\\\Database\\\\Eloquent\\\\Model\\:\\:push\\(\\) invoked with 3 parameters, 0 required\\.$#"
 			count: 6

Diff for: src/Relations/BelongsTo.php

@@ -6,8 +6,14 @@
 
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo as EloquentBelongsTo;
 
-class BelongsTo extends \Illuminate\Database\Eloquent\Relations\BelongsTo
+/**
+ * @template TRelatedModel of Model
+ * @template TDeclaringModel of Model
+ * @extends EloquentBelongsTo<TRelatedModel, TDeclaringModel>
+ */
+class BelongsTo extends EloquentBelongsTo
 {
     /**
      * Get the key for comparing against the parent key in "has" query.

Diff for: src/Relations/BelongsToMany.php

@@ -21,6 +21,11 @@
 use function in_array;
 use function is_numeric;
 
+/**
+ * @template TRelatedModel of Model
+ * @template TDeclaringModel of Model
+ * @extends EloquentBelongsToMany<TRelatedModel, TDeclaringModel>
+ */
 class BelongsToMany extends EloquentBelongsToMany
 {
     /**

Diff for: src/Relations/EmbedsMany.php

@@ -21,6 +21,12 @@
 use function throw_if;
 use function value;
 
+/**
+ * @template TRelatedModel of Model
+ * @template TDeclaringModel of Model
+ * @template TResult
+ * @extends EmbedsOneOrMany<TRelatedModel, TDeclaringModel, TResult>
+ */
 class EmbedsMany extends EmbedsOneOrMany
 {
     /** @inheritdoc */

Diff for: src/Relations/EmbedsOne.php

@@ -11,6 +11,12 @@
 
 use function throw_if;
 
+/**
+ * @template TRelatedModel of Model
+ * @template TDeclaringModel of Model
+ * @template TResult
+ * @extends EmbedsOneOrMany<TRelatedModel, TDeclaringModel, TResult>
+ */
 class EmbedsOne extends EmbedsOneOrMany
 {
     public function initRelation(array $models, $relation)

Diff for: src/Relations/EmbedsOneOrMany.php

@@ -21,6 +21,12 @@
 use function str_starts_with;
 use function throw_if;
 
+/**
+ * @template TRelatedModel of Model
+ * @template TDeclaringModel of Model
+ * @template TResult
+ * @extends Relation<TRelatedModel, TDeclaringModel, TResult>
+ */
 abstract class EmbedsOneOrMany extends Relation
 {
     /**

Diff for: src/Relations/HasMany.php

@@ -8,6 +8,11 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany as EloquentHasMany;
 
+/**
+ * @template TRelatedModel of Model
+ * @template TDeclaringModel of Model
+ * @extends EloquentHasMany<TRelatedModel, TDeclaringModel>
+ */
 class HasMany extends EloquentHasMany
 {
     /**

Diff for: src/Relations/HasOne.php

@@ -8,6 +8,11 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasOne as EloquentHasOne;
 
+/**
+ * @template TRelatedModel of Model
+ * @template TDeclaringModel of Model
+ * @extends EloquentHasOne<TRelatedModel, TDeclaringModel>
+ */
 class HasOne extends EloquentHasOne
 {
     /**

Diff for: src/Relations/MorphMany.php

@@ -7,6 +7,11 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\MorphMany as EloquentMorphMany;
 
+/**
+ * @template TRelatedModel of Model
+ * @template TDeclaringModel of Model
+ * @extends EloquentMorphMany<TRelatedModel, TDeclaringModel>
+ */
 class MorphMany extends EloquentMorphMany
 {
     /**

Diff for: src/Relations/MorphTo.php

@@ -7,6 +7,11 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\MorphTo as EloquentMorphTo;
 
+/**
+ * @template TRelatedModel of Model
+ * @template TDeclaringModel of Model
+ * @extends EloquentMorphTo<TRelatedModel, TDeclaringModel>
+ */
 class MorphTo extends EloquentMorphTo
 {
     /** @inheritdoc */

Diff for: src/Relations/MorphToMany.php

@@ -24,6 +24,11 @@
 use function is_array;
 use function is_numeric;
 
+/**
+ * @template TRelatedModel of Model
+ * @template TDeclaringModel of Model
+ * @extends EloquentMorphToMany<TRelatedModel, TDeclaringModel>
+ */
 class MorphToMany extends EloquentMorphToMany
 {
     /** @inheritdoc */