Add stubs for daterange field type (#786)

* Add stubs for datetime field type

* Set date property of DateTimeItem to be writable

* Add stubs for daterange field type

* Use property instead of property-read

* Use never type for DateRangeItem::$date and add test coverage

DateRangeItem::propertyDefinitions() does not call parent:: so the
inherited $date property from DateTimeItem does not exist at runtime.
Using @Property never $date accurately signals this is inaccessible,
rather than null which implied the property was valid to access.

Also add assertType('never', ...) to cover this override in tests.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Matt Glaman <nmd.matt@gmail.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: 3 people

stubs/Drupal/datetime_range/Plugin/Field/FieldType/DateRangeItem.stub

@@ -0,0 +1,18 @@
+<?php
+
+namespace Drupal\datetime_range\Plugin\Field\FieldType;
+
+use Drupal\datetime\Plugin\Field\FieldType\DateTimeItem;
+
+/**
+ * @property never $date
+ *   Even though this extends DateTimeItem, the date property does not actually
+ *   exist. DateRangeItem::propertyDefinitions() does not call parent:: and does
+ *   not define 'date'. Use $start_date instead.
+ * @property ?\Drupal\Core\Datetime\DrupalDateTime $start_date
+ * @property ?string $end_value
+ * @property ?\Drupal\Core\Datetime\DrupalDateTime $end_date
+ */
+class DateRangeItem extends DateTimeItem {
+
+}

tests/src/Type/data/field-types.php

@@ -20,6 +20,7 @@
 use Drupal\Core\Field\Plugin\Field\FieldType\UriItem;
 use Drupal\Core\Field\Plugin\Field\FieldType\UuidItem;
 use Drupal\datetime\Plugin\Field\FieldType\DateTimeItem;
+use Drupal\datetime_range\Plugin\Field\FieldType\DateRangeItem;
 use Drupal\file\Plugin\Field\FieldType\FileItem;
 use Drupal\file\Plugin\Field\FieldType\FileUriItem;
 use Drupal\link\Plugin\Field\FieldType\LinkItem;
@@ -156,6 +157,16 @@
 assertType('string|null', $datetime_field->value);
 assertType('Drupal\Core\Datetime\DrupalDateTime|null', $datetime_field->date);
 
+// DateRangeItem.
+$daterange_field = $node->get('field_daterange')->first();
+assert($daterange_field instanceof DateRangeItem);
+assertType(DateRangeItem::class, $daterange_field);
+assertType('string|null', $daterange_field->value);
+assertType('never', $daterange_field->date);
+assertType('Drupal\Core\Datetime\DrupalDateTime|null', $daterange_field->start_date);
+assertType('string|null', $daterange_field->end_value);
+assertType('Drupal\Core\Datetime\DrupalDateTime|null', $daterange_field->end_date);
+
 // FileItem.
 $file_field = $node->get('field_file')->first();
 assert($file_field instanceof FileItem);