Generate the phpdoc for the static create method of objects (#1464)

Author: stof

src/Input/TranslateTextRequest.php

@@ -95,6 +95,16 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   Text?: string,
+     *   TerminologyNames?: string[],
+     *   SourceLanguageCode?: string,
+     *   TargetLanguageCode?: string,
+     *   Settings?: TranslationSettings|array,
+     *   '@region'?: string|null,
+     * }|TranslateTextRequest $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/AppliedTerminology.php

@@ -33,6 +33,12 @@ public function __construct(array $input)
         $this->terms = isset($input['Terms']) ? array_map([Term::class, 'create'], $input['Terms']) : null;
     }
 
+    /**
+     * @param array{
+     *   Name?: null|string,
+     *   Terms?: null|Term[],
+     * }|AppliedTerminology $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/Term.php

@@ -29,6 +29,12 @@ public function __construct(array $input)
         $this->targetText = $input['TargetText'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   SourceText?: null|string,
+     *   TargetText?: null|string,
+     * }|Term $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/TranslationSettings.php

@@ -59,6 +59,12 @@ public function __construct(array $input)
         $this->profanity = $input['Profanity'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   Formality?: null|Formality::*,
+     *   Profanity?: null|Profanity::*,
+     * }|TranslationSettings $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);