apply code suggestions

Author: michalsn

system/DataCaster/Cast/CastInterface.php

@@ -18,9 +18,9 @@ interface CastInterface
     /**
      * Takes a value from DataSource, returns its value for PHP.
      *
-     * @param mixed        $value  Data from database driver
-     * @param list<string> $params Additional param
-     * @param object|null  $helper Helper object. E.g., database connection
+     * @param mixed              $value  Data from database driver
+     * @param array<int, string> $params Additional param
+     * @param object|null        $helper Helper object. E.g., database connection
      *
      * @return mixed PHP native value
      */
@@ -33,9 +33,9 @@ public static function get(
     /**
      * Takes a PHP value, returns its value for DataSource.
      *
-     * @param mixed        $value  PHP native value
-     * @param list<string> $params Additional param
-     * @param object|null  $helper Helper object. E.g., database connection
+     * @param mixed              $value  PHP native value
+     * @param array<int, string> $params Additional param
+     * @param object|null        $helper Helper object. E.g., database connection
      *
      * @return mixed Data to pass to database driver
      */

system/DataCaster/Cast/EnumCast.php

@@ -28,9 +28,6 @@
  */
 class EnumCast extends BaseCast implements CastInterface
 {
-    /**
-     * @param array<int, string> $params
-     */
     public static function get(
         mixed $value,
         array $params = [],
@@ -83,9 +80,6 @@ public static function get(
         return $enum;
     }
 
-    /**
-     * @param array<int, string> $params
-     */
     public static function set(
         mixed $value,
         array $params = [],

system/Entity/Cast/EnumCast.php

@@ -18,16 +18,8 @@
 use ReflectionEnum;
 use UnitEnum;
 
-/**
- * Class EnumCast
- *
- * Handles casting for PHP enums (both backed and unit enums)
- */
 class EnumCast extends BaseCast
 {
-    /**
-     * {@inheritDoc}
-     */
     public static function get($value, array $params = [])
     {
         $enumClass = $params[0] ?? null;
@@ -72,10 +64,7 @@ public static function get($value, array $params = [])
         throw CastException::forInvalidEnumCaseName($enumClass, $value);
     }
 
-    /**
-     * {@inheritDoc}
-     */
-    public static function set($value, array $params = []): int|string|null
+    public static function set($value, array $params = []): int|string
     {
         // Get the expected enum class
         $enumClass = $params[0] ?? null;

user_guide_src/source/models/entities.rst

@@ -301,7 +301,6 @@ Enum casting supports:
 
 * **Backed enums** (string or int) - The backing value is stored in the database
 * **Unit enums** - The case name is stored in the database as a string
-* **Nullable enums** - Use the ``?`` prefix
 
 For example, if you had a User entity with a ``status`` property using a backed enum: