Allow \Drupal\Core\Field\EntityReferenceFieldItemListInterface::referencedEntities to work with generic

Author: dpi

stubs/Drupal/Core/Field/EntityReferenceFieldItemListInterface.stub

@@ -13,4 +13,9 @@ use Drupal\Core\Field\Plugin\Field\FieldType\EntityReferenceItem;
  */
 interface EntityReferenceFieldItemListInterface extends FieldItemListInterface {
 
+  /**
+   * @return array<int, T>
+   */
+  public function referencedEntities();
+
 }

tests/fixtures/drupal/modules/phpstan_fixtures/src/Entity/ReflectionEntityTest.php

@@ -9,6 +9,7 @@
 
 /**
  * @property \Drupal\Core\Field\EntityReferenceFieldItemListInterface $user_id
+ * @property \Drupal\Core\Field\EntityReferenceFieldItemListInterface<\Drupal\entity_test\Entity\EntityTest> $related
  */
 final class ReflectionEntityTest extends ContentEntityBase {
 
@@ -34,6 +35,14 @@ public static function baseFieldDefinitions(EntityTypeInterface $entity_type)
                     'placeholder' => '',
                 ],
             ]);
+
+        $fields['related'] = BaseFieldDefinition::create('entity_reference')
+            ->setLabel(t('Related entities'))
+            ->setDescription(t('The IDs of the related entities.'))
+            ->setSetting('target_type', 'entity_test')
+            ->setSetting('handler', 'default')
+            ->setTranslatable(TRUE)
+            ->setDisplayConfigurable('form', FALSE);
         return $fields;
     }
 

tests/src/Type/data/entity-properties.php

@@ -11,3 +11,6 @@
 
 $entity = ReflectionEntityTest::create();
 assertType('Drupal\Core\Field\EntityReferenceFieldItemListInterface', $entity->user_id);
+assertType('Drupal\Core\Field\EntityReferenceFieldItemListInterface<Drupal\entity_test\Entity\EntityTest>', $entity->related);
+// Value of array is derived from 'related' generic.
+assertType('array<int, Drupal\entity_test\Entity\EntityTest>', $entity->related->referencedEntities());