[8.x] Update doc blocks (#1218)

* Update top level

* Chrome

* Commands

* Traits

Author: MizouziE

src/Browser.php

@@ -639,7 +639,7 @@ public function elsewhereWhenAvailable($selector, Closure $callback, $seconds =
      * Return a browser scoped to the given component.
      *
      * @param  \Laravel\Dusk\Component  $component
-     * @return \Laravel\Dusk\Browser
+     * @return static
      */
     public function component(Component $component)
     {

src/Chrome/SupportsChrome.php

@@ -14,7 +14,7 @@ trait SupportsChrome
     /**
      * The Chromedriver process instance.
      *
-     * @var \Symfony\Component\Process\Process
+     * @var \Symfony\Component\Process\Process|null
      */
     protected static $chromeProcess;
 

src/Concerns/InteractsWithAuthentication.php

@@ -20,7 +20,7 @@ public function login()
     /**
      * Log into the application using a given user ID or email.
      *
-     * @param  object|string  $userId
+     * @param  object|string|int  $userId
      * @param  string|null  $guard
      * @return $this
      */

src/Concerns/InteractsWithCookies.php

@@ -16,7 +16,7 @@ trait InteractsWithCookies
      * @param  string|null  $value
      * @param  int|DateTimeInterface|null  $expiry
      * @param  array  $options
-     * @return $this|string|null
+     * @return ($value is null ? string|null : $this)
      */
     public function cookie($name, $value = null, $expiry = null, array $options = [])
     {
@@ -46,7 +46,7 @@ public function cookie($name, $value = null, $expiry = null, array $options = []
      * @param  string|null  $value
      * @param  int|DateTimeInterface|null  $expiry
      * @param  array  $options
-     * @return $this|string|null
+     * @return ($value is null ? string|null : $this)
      */
     public function plainCookie($name, $value = null, $expiry = null, array $options = [])
     {

src/Concerns/InteractsWithElements.php

@@ -59,7 +59,7 @@ public function clickLink($link, $element = 'a')
      *
      * @param  string  $selector
      * @param  string|null  $value
-     * @return $this
+     * @return ($value is null ? string|true|null : $this)
      */
     public function value($selector, $value = null)
     {
@@ -92,7 +92,7 @@ public function text($selector)
      *
      * @param  string  $selector
      * @param  string  $attribute
-     * @return string
+     * @return string|true|null
      */
     public function attribute($selector, $attribute)
     {

src/Concerns/MakesAssertions.php

@@ -435,7 +435,7 @@ public function assertInputValueIsNot($field, $value)
      * Get the value of the given input or text area field.
      *
      * @param  string  $field
-     * @return string
+     * @return string|true|null
      */
     public function inputValue($field)
     {
@@ -1199,7 +1199,7 @@ public function assertVueDoesNotContain($key, $value, $componentSelector = null)
     /**
      * Retrieve the value of the Vue component's attribute at the given key.
      *
-     * @param  string  $componentSelector
+     * @param  string|null  $componentSelector
      * @param  string  $key
      * @return mixed
      */

src/Concerns/MakesUrlAssertions.php

@@ -258,7 +258,7 @@ public function assertRouteIs($route, $parameters = [])
      * Assert that the given query string parameter is present and has a given value.
      *
      * @param  string  $name
-     * @param  string|null  $value
+     * @param  string|array|null  $value
      * @return $this
      */
     public function assertQueryStringHas($name, $value = null)

src/Concerns/ProvidesBrowser.php

@@ -16,7 +16,7 @@ trait ProvidesBrowser
     /**
      * All of the active browser instances.
      *
-     * @var array
+     * @var \Illuminate\Support\Collection|array
      */
     protected static $browsers = [];
 
@@ -57,7 +57,7 @@ public static function afterClass(Closure $callback)
      * Create a new browser instance.
      *
      * @param  \Closure  $callback
-     * @return \Laravel\Dusk\Browser|void
+     * @return void
      *
      * @throws \Exception
      * @throws \Throwable
@@ -89,7 +89,7 @@ public function browse(Closure $callback)
      * Create the browser instances needed for the given callback.
      *
      * @param  \Closure  $callback
-     * @return array
+     * @return \Illuminate\Support\Collection
      *
      * @throws \ReflectionException
      */

src/Concerns/WaitsForElements.php

@@ -73,7 +73,7 @@ public function waitUntilMissing($selector, $seconds = null)
     /**
      * Wait for the given text to be removed.
      *
-     * @param  string  $text
+     * @param  array|string  $text
      * @param  int|null  $seconds
      * @return $this
      *

src/Console/ChromeDriverCommand.php

@@ -158,7 +158,7 @@ protected function latestVersion()
      * Detect the installed Chrome / Chromium major version.
      *
      * @param  string  $os
-     * @return int|bool
+     * @return string|false
      */
     protected function detectChromeVersion($os)
     {