Add stubs for core field types

extension.neon

@@ -13,6 +13,37 @@ parameters:
 		- engine
 	scanFiles:
 		- stubs/Twig/functions.stub
+	stubFiles:
+		- stubs/Drupal/Component/Plugin/PluginInspectionInterface.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldItemBase.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldItemInterface.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/PreconfiguredFieldUiOptionsInterface.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/BooleanItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/ChangedItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/CreatedItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/DecimalItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/EmailItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/EntityReferenceItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/FloatItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/IntegerItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/LanguageItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/MapItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/NumericItemBase.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/PasswordItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/StringItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/StringItemBase.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/StringLongItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/TimestampItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/UriItem.stub
+		- stubs/Drupal/Core/Field/Plugin/Field/FieldType/UuidItem.stub
+		- stubs/Drupal/Core/TypedData/ComplexDataInterface.stub
+		- stubs/Drupal/Core/TypedData/OptionsProviderInterface.stub
+		- stubs/Drupal/Core/TypedData/TraversableTypedDataInterface.stub
+		- stubs/Drupal/Core/TypedData/TypedData.stub
+		- stubs/Drupal/Core/TypedData/TypedDataInterface.stub
+		- stubs/Drupal/Core/TypedData/Plugin/DataType/Map.stub
+		- stubs/Drupal/link/LinkItemInterface.stub
+		- stubs/Drupal/link/Plugin/Field/FieldType/LinkItem.stub
 	drupal:
 		drupal_root: '%currentWorkingDirectory%'
 		entityMapping:

src/Reflection/FieldItemListPropertyReflection.php

@@ -43,6 +43,7 @@ public function getReadableType(): Type
             return new ObjectType('Drupal\Core\Entity\EntityInterface');
         }
         if ($this->propertyName === 'target_id') {
+            // @todo needs to be union type.
             return new StringType();
         }
         // @todo this is wrong, integer/bool/decimal/etc all use single value property.

stubs/Drupal/Component/Plugin/PluginInspectionInterface.stub

@@ -0,0 +1,6 @@
+<?php
+
+namespace Drupal\Component\Plugin;
+
+interface PluginInspectionInterface {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldItemBase.stub

@@ -0,0 +1,8 @@
+<?php
+
+namespace Drupal\Core\Field;
+
+use Drupal\Core\TypedData\Plugin\DataType\Map;
+
+abstract class FieldItemBase extends Map implements FieldItemInterface {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldItemInterface.stub

@@ -0,0 +1,8 @@
+<?php
+
+namespace Drupal\Core\Field;
+
+use Drupal\Core\TypedData\ComplexDataInterface;
+
+interface FieldItemInterface extends ComplexDataInterface {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/BooleanItem.stub

@@ -0,0 +1,12 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+use Drupal\Core\Field\FieldItemBase;
+use Drupal\Core\TypedData\OptionsProviderInterface;
+
+/**
+ * @property int $value
+ */
+class BooleanItem extends FieldItemBase implements OptionsProviderInterface {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/ChangedItem.stub

@@ -0,0 +1,6 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+class ChangedItem extends CreatedItem {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/CreatedItem.stub

@@ -0,0 +1,6 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+class CreatedItem extends TimestampItem {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/DecimalItem.stub

@@ -0,0 +1,9 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+/**
+ * @property string $value
+ */
+class DecimalItem extends NumericItemBase {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/EmailItem.stub

@@ -0,0 +1,11 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+use Drupal\Core\Field\FieldItemBase;
+
+/**
+ * @property string $value
+ */
+class EmailItem extends FieldItemBase {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/EntityReferenceItem.stub

@@ -0,0 +1,14 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+use Drupal\Core\Field\FieldItemBase;
+use Drupal\Core\Field\PreconfiguredFieldUiOptionsInterface;
+use Drupal\Core\TypedData\OptionsProviderInterface;
+
+/**
+ * @property string|integer $target_id
+ * @property \Drupal\Core\Entity\EntityInterface $entity
+ */
+class EntityReferenceItem extends FieldItemBase implements OptionsProviderInterface, PreconfiguredFieldUiOptionsInterface {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/FloatItem.stub

@@ -0,0 +1,9 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+/**
+ * @property float $value
+ */
+class FloatItem extends NumericItemBase {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/IntegerItem.stub

@@ -0,0 +1,9 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+/**
+ * @property int $value
+ */
+class IntegerItem extends NumericItemBase {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/LanguageItem.stub

@@ -0,0 +1,13 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+use Drupal\Core\Field\FieldItemBase;
+use Drupal\Core\TypedData\OptionsProviderInterface;
+
+/**
+ * @property string $value
+ * @property \Drupal\Core\Language\LanguageInterface $language
+ */
+class LanguageItem extends FieldItemBase implements OptionsProviderInterface {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/MapItem.stub

@@ -0,0 +1,11 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+use Drupal\Core\Field\FieldItemBase;
+
+/**
+ * @property array<string, mixed> $value
+ */
+class MapItem extends FieldItemBase {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/NumericItemBase.stub

@@ -0,0 +1,8 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+use Drupal\Core\Field\FieldItemBase;
+
+abstract class NumericItemBase extends FieldItemBase {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/PasswordItem.stub

@@ -0,0 +1,10 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+/**
+ * @property ?string $existing
+ * @property bool $pre_hashed
+ */
+class PasswordItem extends StringItem {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/StringItem.stub

@@ -0,0 +1,6 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+class StringItem extends StringItemBase {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/StringItemBase.stub

@@ -0,0 +1,11 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+use Drupal\Core\Field\FieldItemBase;
+
+/**
+ * @property string $value
+ */
+abstract class StringItemBase extends FieldItemBase {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/StringLongItem.stub

@@ -0,0 +1,6 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+class StringLongItem extends StringItemBase {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/TimestampItem.stub

@@ -0,0 +1,11 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+use Drupal\Core\Field\FieldItemBase;
+
+/**
+ * @property string $value
+ */
+class TimestampItem extends FieldItemBase {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/UriItem.stub

@@ -0,0 +1,6 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+class UriItem extends StringItem {
+}

stubs/Drupal/Core/Field/Plugin/Field/FieldType/UuidItem.stub

@@ -0,0 +1,6 @@
+<?php
+
+namespace Drupal\Core\Field\Plugin\Field\FieldType;
+
+class UuidItem extends StringItem {
+}

stubs/Drupal/Core/Field/Plugin/Field/PreconfiguredFieldUiOptionsInterface.stub

@@ -0,0 +1,6 @@
+<?php
+
+namespace Drupal\Core\Field;
+
+interface PreconfiguredFieldUiOptionsInterface {
+}

stubs/Drupal/Core/TypedData/ComplexDataInterface.stub

@@ -0,0 +1,6 @@
+<?php
+
+namespace Drupal\Core\TypedData;
+
+interface ComplexDataInterface extends TraversableTypedDataInterface {
+}

stubs/Drupal/Core/TypedData/OptionsProviderInterface.stub

@@ -0,0 +1,6 @@
+<?php
+
+namespace Drupal\Core\TypedData;
+
+interface OptionsProviderInterface {
+}

stubs/Drupal/Core/TypedData/Plugin/DataType/Map.stub

@@ -0,0 +1,12 @@
+<?php
+
+namespace Drupal\Core\TypedData\Plugin\DataType;
+
+use Drupal\Core\TypedData\TypedData;
+use Drupal\Core\TypedData\ComplexDataInterface;
+
+/**
+ * @implements \IteratorAggregate<string, \Drupal\Core\TypedData\TypedDataInterface>
+ */
+class Map extends TypedData implements \IteratorAggregate, ComplexDataInterface {
+}

stubs/Drupal/Core/TypedData/TraversableTypedDataInterface.stub

@@ -0,0 +1,9 @@
+<?php
+
+namespace Drupal\Core\TypedData;
+
+/**
+ * @extends \Traversable<string, \Drupal\Core\TypedData\TypedDataInterface>
+ */
+interface TraversableTypedDataInterface extends TypedDataInterface, \Traversable {
+}

stubs/Drupal/Core/TypedData/TypedData.stub

@@ -0,0 +1,8 @@
+<?php
+
+namespace Drupal\Core\TypedData;
+
+use Drupal\Component\Plugin\PluginInspectionInterface;
+
+abstract class TypedData implements TypedDataInterface, PluginInspectionInterface {
+}

stubs/Drupal/Core/TypedData/TypedDataInterface.stub

@@ -0,0 +1,6 @@
+<?php
+
+namespace Drupal\Core\TypedData;
+
+interface TypedDataInterface {
+}

stubs/Drupal/link/LinkItemInterface.stub

@@ -0,0 +1,8 @@
+<?php
+
+namespace Drupal\link;
+
+use Drupal\Core\Field\FieldItemInterface;
+
+interface LinkItemInterface extends FieldItemInterface {
+}

stubs/Drupal/link/Plugin/Field/FieldType/LinkItem.stub

@@ -0,0 +1,15 @@
+<?php
+
+namespace Drupal\link\Plugin\Field\FieldType;
+
+use Drupal\Core\Field\FieldItemBase;
+use Drupal\link\LinkItemInterface;
+
+/**
+ * @property string $uri
+ * @property string $title
+ * @property array<string, mixed> $options
+ */
+class LinkItem extends FieldItemBase implements LinkItemInterface {
+
+}

tests/src/Type/FieldTypesTest.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace mglaman\PHPStanDrupal\Tests\Type;
+
+use mglaman\PHPStanDrupal\Tests\AdditionalConfigFilesTrait;
+use PHPStan\Testing\TypeInferenceTestCase;
+
+final class FieldTypesTest extends TypeInferenceTestCase
+{
+    use AdditionalConfigFilesTrait;
+
+    public function dataFileAsserts(): iterable
+    {
+        yield from $this->gatherAssertTypes(__DIR__ . '/data/field-types.php');
+    }
+
+    /**
+     * @dataProvider dataFileAsserts
+     * @param string $assertType
+     * @param string $file
+     * @param mixed ...$args
+     */
+    public function testFileAsserts(
+        string $assertType,
+        string $file,
+        ...$args
+    ): void
+    {
+        $this->assertFileAsserts($assertType, $file, ...$args);
+    }
+}