Improve docs for @convertEmptyStringsToNull

#2610

docs/6/api-reference/directives.md

@@ -896,7 +896,10 @@ final class ComplexityAnalyzer
 
 ```graphql
 """
-Replaces `""` with `null`.
+Replaces incoming empty strings `""` with `null`.
+
+When used upon fields, empty strings for non-nullable inputs will pass unchanged.
+Only explicitly placing this on non-nullable inputs will force the conversion.
 """
 directive @convertEmptyStringsToNull on ARGUMENT_DEFINITION | INPUT_FIELD_DEFINITION | FIELD_DEFINITION
 ```

docs/master/api-reference/directives.md

@@ -896,7 +896,10 @@ final class ComplexityAnalyzer
 
 ```graphql
 """
-Replaces `""` with `null`.
+Replaces incoming empty strings `""` with `null`.
+
+When used upon fields, empty strings for non-nullable inputs will pass unchanged.
+Only explicitly placing this on non-nullable inputs will force the conversion.
 """
 directive @convertEmptyStringsToNull on ARGUMENT_DEFINITION | INPUT_FIELD_DEFINITION | FIELD_DEFINITION
 ```

phpstan.neon

@@ -46,7 +46,7 @@ parameters:
  - '#Call to an undefined method Illuminate\\Database\\Eloquent\\Builder<Illuminate\\Database\\Eloquent\\Model>|Illuminate\\Database\\Eloquent\\Relations\\Relation<Illuminate\\Database\\Eloquent\\Model>|Illuminate\\Database\\Query\\Builder::(orderBy|where|whereIn|whereNotIn|whereBetween|whereJsonContains|whereNotBetween)\(\)\.#'
 
  # Laravel 11 added generics that are handled differently, so we just omit them
- - '#generic class Illuminate\\Database\\Eloquent\\Builder but does not specify its types#'
+ - '#generic class (Illuminate\\Database\\Eloquent\\Builder|Laravel\\Scout\\Builder)( but)? does not specify its types#'
 
  # This test cheats and uses reflection to make assertions
  - path: tests/Unit/Schema/Directives/BaseDirectiveTest.php

src/Schema/Directives/ConvertEmptyStringsToNullDirective.php

@@ -16,7 +16,10 @@ public static function definition(): string
  {
  return /** @lang GraphQL */ <<<'GRAPHQL'
 """
-Replaces `""` with `null`.
+Replaces incoming empty strings `""` with `null`.
+
+When used upon fields, empty strings for non-nullable inputs will pass unchanged.
+Only explicitly placing this on non-nullable inputs will force the conversion.
 """
 directive @convertEmptyStringsToNull on ARGUMENT_DEFINITION | INPUT_FIELD_DEFINITION | FIELD_DEFINITION
 GRAPHQL;

tests/Utils/Mutations/ReturnReceivedInput.php

@@ -5,7 +5,7 @@
 final class ReturnReceivedInput
 {
  /**
- * @param array<string, mixed> $args
+ * @param  array<string, mixed>  $args
  *
  * @return array<string, mixed>
  */