[Form] Add generics to DataTransformerInterface

Author: VincentLanglet

DataTransformerInterface.php

@@ -17,6 +17,9 @@
  * Transforms a value between different representations.
  *
  * @author Bernhard Schussek <[email protected]>
+ *
+ * @template TValue
+ * @template TTransformedValue
  */
 interface DataTransformerInterface
 {
@@ -53,9 +56,9 @@ interface DataTransformerInterface
      * of the first data transformer outputs NULL, the second must be able to
      * process that value.
      *
-     * @param mixed $value The value in the original representation
+     * @param TValue|null $value The value in the original representation
      *
-     * @return mixed
+     * @return TTransformedValue|null
      *
      * @throws TransformationFailedException when the transformation fails
      */
@@ -82,9 +85,9 @@ public function transform(mixed $value);
      * By convention, reverseTransform() should return NULL if an empty string
      * is passed.
      *
-     * @param mixed $value The value in the transformed representation
+     * @param TTransformedValue|null $value The value in the transformed representation
      *
-     * @return mixed
+     * @return TValue|null
      *
      * @throws TransformationFailedException when the transformation fails
      */

Extension/Core/DataTransformer/ArrayToPartsTransformer.php

@@ -16,6 +16,8 @@
 
 /**
  * @author Bernhard Schussek <[email protected]>
+ *
+ * @implements DataTransformerInterface<array, array>
  */
 class ArrayToPartsTransformer implements DataTransformerInterface
 {

Extension/Core/DataTransformer/BaseDateTimeTransformer.php

@@ -14,6 +14,10 @@
 use Symfony\Component\Form\DataTransformerInterface;
 use Symfony\Component\Form\Exception\InvalidArgumentException;
 
+/**
+ * @template TTransformedValue
+ * @implements DataTransformerInterface<\DateTimeInterface, TTransformedValue>
+ */
 abstract class BaseDateTimeTransformer implements DataTransformerInterface
 {
     protected static $formats = [

Extension/Core/DataTransformer/BooleanToStringTransformer.php

@@ -20,6 +20,8 @@
  *
  * @author Bernhard Schussek <[email protected]>
  * @author Florian Eckerstorfer <[email protected]>
+ *
+ * @implements DataTransformerInterface<bool, string>
  */
 class BooleanToStringTransformer implements DataTransformerInterface
 {

Extension/Core/DataTransformer/ChoiceToValueTransformer.php

@@ -17,6 +17,8 @@
 
 /**
  * @author Bernhard Schussek <[email protected]>
+ *
+ * @implements DataTransformerInterface<string, string>
  */
 class ChoiceToValueTransformer implements DataTransformerInterface
 {

Extension/Core/DataTransformer/ChoicesToValuesTransformer.php

@@ -17,6 +17,8 @@
 
 /**
  * @author Bernhard Schussek <[email protected]>
+ *
+ * @implements DataTransformerInterface<array, array>
  */
 class ChoicesToValuesTransformer implements DataTransformerInterface
 {

Extension/Core/DataTransformer/DateIntervalToArrayTransformer.php

@@ -19,6 +19,8 @@
  * Transforms between a normalized date interval and an interval string/array.
  *
  * @author Steffen Roßkamp <[email protected]>
+ *
+ * @implements DataTransformerInterface<\DateInterval, array>
  */
 class DateIntervalToArrayTransformer implements DataTransformerInterface
 {

Extension/Core/DataTransformer/DateIntervalToStringTransformer.php

@@ -19,6 +19,8 @@
  * Transforms between a date string and a DateInterval object.
  *
  * @author Steffen Roßkamp <[email protected]>
+ *
+ * @implements DataTransformerInterface<\DateInterval, string>
  */
 class DateIntervalToStringTransformer implements DataTransformerInterface
 {

Extension/Core/DataTransformer/DateTimeImmutableToDateTimeTransformer.php

@@ -18,6 +18,8 @@
  * Transforms between a DateTimeImmutable object and a DateTime object.
  *
  * @author Valentin Udaltsov <[email protected]>
+ *
+ * @implements DataTransformerInterface<\DateTimeImmutable, \DateTime>
  */
 final class DateTimeImmutableToDateTimeTransformer implements DataTransformerInterface
 {

Extension/Core/DataTransformer/DateTimeToArrayTransformer.php

@@ -18,6 +18,8 @@
  *
  * @author Bernhard Schussek <[email protected]>
  * @author Florian Eckerstorfer <[email protected]>
+ *
+ * @extends BaseDateTimeTransformer<array>
  */
 class DateTimeToArrayTransformer extends BaseDateTimeTransformer
 {