docs, import sorting

src/Concerns/InteractsWithAuthentication.php

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

src/Concerns/MakesAssertions.php

@@ -455,8 +455,8 @@ public function assertNotSelected($field, $value)
     /**
      * Assert that the given array of values are available to be selected.
      *
-     * @param string  $field
-     * @param array  $values
+     * @param  string  $field
+     * @param  array  $values
      * @return $this
      */
     public function assertSelectHasOptions($field, array $values)
@@ -478,8 +478,8 @@ public function assertSelectHasOptions($field, array $values)
     /**
      * Assert that the given array of values are not available to be selected.
      *
-     * @param string  $field
-     * @param array  $values
+     * @param  string  $field
+     * @param  array  $values
      * @return $this
      */
     public function assertSelectMissingOptions($field, array $values)
@@ -495,8 +495,8 @@ public function assertSelectMissingOptions($field, array $values)
     /**
      * Assert that the given value is available to be selected on the given field.
      *
-     * @param string  $field
-     * @param string  $value
+     * @param  string  $field
+     * @param  string  $value
      * @return $this
      */
     public function assertSelectHasOption($field, $value)
@@ -507,8 +507,8 @@ public function assertSelectHasOption($field, $value)
     /**
      * Assert that the given value is not available to be selected on the given field.
      *
-     * @param string  $field
-     * @param string  $value
+     * @param  string  $field
+     * @param  string  $value
      * @return $this
      */
     public function assertSelectMissingOption($field, $value)

src/Concerns/ProvidesBrowser.php

@@ -56,6 +56,7 @@ public static function afterClass(Closure $callback)
      *
      * @param  \Closure  $callback
      * @return \Laravel\Dusk\Browser|void
+     *
      * @throws \Exception
      * @throws \Throwable
      */
@@ -85,6 +86,7 @@ public function browse(Closure $callback)
      *
      * @param  \Closure  $callback
      * @return array
+     *
      * @throws \ReflectionException
      */
     protected function createBrowsersFor(Closure $callback)
@@ -118,6 +120,7 @@ protected function newBrowser($driver)
      *
      * @param  \Closure  $callback
      * @return int
+     *
      * @throws \ReflectionException
      */
     protected function browsersNeededFor(Closure $callback)
@@ -184,6 +187,7 @@ public static function closeAll()
      * Create the remote web driver instance.
      *
      * @return \Facebook\WebDriver\Remote\RemoteWebDriver
+     *
      * @throws \Exception
      */
     protected function createWebDriver()

src/Concerns/WaitsForElements.php

@@ -17,9 +17,10 @@ trait WaitsForElements
      * Execute the given callback in a scoped browser once the selector is available.
      *
      * @param  string  $selector
-     * @param  Closure  $callback
+     * @param  \Closure  $callback
      * @param  int  $seconds
      * @return $this
+     *
      * @throws \Facebook\WebDriver\Exception\TimeOutException
      */
     public function whenAvailable($selector, Closure $callback, $seconds = null)
@@ -33,6 +34,7 @@ public function whenAvailable($selector, Closure $callback, $seconds = null)
      * @param  string  $selector
      * @param  int  $seconds
      * @return $this
+     *
      * @throws \Facebook\WebDriver\Exception\TimeOutException
      */
     public function waitFor($selector, $seconds = null)
@@ -50,6 +52,7 @@ public function waitFor($selector, $seconds = null)
      * @param  string  $selector
      * @param  int  $seconds
      * @return $this
+     *
      * @throws \Facebook\WebDriver\Exception\TimeOutException
      */
     public function waitUntilMissing($selector, $seconds = null)
@@ -73,6 +76,7 @@ public function waitUntilMissing($selector, $seconds = null)
      * @param  array|string  $text
      * @param  int  $seconds
      * @return $this
+     *
      * @throws \Facebook\WebDriver\Exception\TimeOutException
      */
     public function waitForText($text, $seconds = null)
@@ -92,6 +96,7 @@ public function waitForText($text, $seconds = null)
      * @param  string  $link
      * @param  int  $seconds
      * @return $this
+     *
      * @throws \Facebook\WebDriver\Exception\TimeOutException
      */
     public function waitForLink($link, $seconds = null)
@@ -109,6 +114,7 @@ public function waitForLink($link, $seconds = null)
      * @param  string  $path
      * @param  int  $seconds
      * @return $this
+     *
      * @throws \Facebook\WebDriver\Exception\TimeOutException
      */
     public function waitForLocation($path, $seconds = null)
@@ -125,6 +131,7 @@ public function waitForLocation($path, $seconds = null)
      * @param  array  $parameters
      * @param  int  $seconds
      * @return $this
+     *
      * @throws \Facebook\WebDriver\Exception\TimeOutException
      */
     public function waitForRoute($route, $parameters = [], $seconds = null)
@@ -139,6 +146,7 @@ public function waitForRoute($route, $parameters = [], $seconds = null)
      * @param  int  $seconds
      * @param  string  $message
      * @return $this
+     *
      * @throws \Facebook\WebDriver\Exception\TimeOutException
      */
     public function waitUntil($script, $seconds = null, $message = null)
@@ -213,6 +221,7 @@ public function waitForDialog($seconds = null)
      * @param  Closure  $callback
      * @param  int  $seconds
      * @return $this
+     *
      * @throws \Facebook\WebDriver\Exception\TimeOutException
      */
     public function waitForReload($callback = null, $seconds = null)
@@ -235,9 +244,10 @@ public function waitForReload($callback = null, $seconds = null)
      *
      * @param  int  $seconds
      * @param  int  $interval
-     * @param  Closure  $callback
+     * @param  \Closure  $callback
      * @param  string|null  $message
      * @return $this
+     *
      * @throws \Facebook\WebDriver\Exception\TimeOutException
      */
     public function waitUsing($seconds, $interval, Closure $callback, $message = null)

src/Console/ChromeDriverCommand.php

@@ -229,7 +229,7 @@ protected function rename($binary, $os)
     /**
      * Get the contents of a URL using the 'proxy' and 'ssl-no-verify' command options.
      *
-     * @param string $url
+     * @param  string  $url
      * @return string|bool
      */
     protected function getUrl(string $url)

src/DuskServiceProvider.php

@@ -35,6 +35,7 @@ public function boot()
      * Register any package services.
      *
      * @return void
+     *
      * @throws \Exception
      */
     public function register()

src/ElementResolver.php

@@ -77,6 +77,7 @@ public function pageElements(array $elements)
      *
      * @param  string  $field
      * @return \Facebook\WebDriver\Remote\RemoteWebElement
+     *
      * @throws \Exception
      */
     public function resolveForTyping($field)
@@ -95,6 +96,7 @@ public function resolveForTyping($field)
      *
      * @param  string  $field
      * @return \Facebook\WebDriver\Remote\RemoteWebElement
+     *
      * @throws \Exception
      */
     public function resolveForSelection($field)
@@ -111,9 +113,10 @@ public function resolveForSelection($field)
     /**
      * Resolve all the options with the given value on the select field.
      *
-     * @param string  $field
-     * @param array  $values
+     * @param  string  $field
+     * @param  array  $values
      * @return \Facebook\WebDriver\Remote\RemoteWebElement[]
+     *
      * @throws \Exception
      */
     public function resolveSelectOptions($field, array $values)
@@ -136,6 +139,7 @@ public function resolveSelectOptions($field, array $values)
      * @param  string  $field
      * @param  string  $value
      * @return \Facebook\WebDriver\Remote\RemoteWebElement
+     *
      * @throws \Exception
      */
     public function resolveForRadioSelection($field, $value = null)
@@ -161,6 +165,7 @@ public function resolveForRadioSelection($field, $value = null)
      * @param  string|null  $field
      * @param  string  $value
      * @return \Facebook\WebDriver\Remote\RemoteWebElement
+     *
      * @throws \Exception
      */
     public function resolveForChecking($field, $value = null)
@@ -189,6 +194,7 @@ public function resolveForChecking($field, $value = null)
      *
      * @param  string  $field
      * @return \Facebook\WebDriver\Remote\RemoteWebElement
+     *
      * @throws \Exception
      */
     public function resolveForAttachment($field)
@@ -207,6 +213,7 @@ public function resolveForAttachment($field)
      *
      * @param  string  $field
      * @return \Facebook\WebDriver\Remote\RemoteWebElement
+     *
      * @throws \Exception
      */
     public function resolveForField($field)
@@ -331,6 +338,7 @@ public function find($selector)
      *
      * @param  array  $selectors
      * @return \Facebook\WebDriver\Remote\RemoteWebElement
+     *
      * @throws \Exception
      */
     public function firstOrFail($selectors)

src/Http/Controllers/UserController.php

@@ -32,6 +32,7 @@ public function user($guard = null)
      *
      * @param  string  $userId
      * @param  string  $guard
+     * @return void
      */
     public function login($userId, $guard = null)
     {
@@ -50,6 +51,7 @@ public function login($userId, $guard = null)
      * Log the user out of the application.
      *
      * @param  string  $guard
+     * @return void
      */
     public function logout($guard = null)
     {

stubs/DuskTestCase.stub

@@ -2,10 +2,10 @@
 
 namespace Tests;
 
-use Laravel\Dusk\TestCase as BaseTestCase;
 use Facebook\WebDriver\Chrome\ChromeOptions;
-use Facebook\WebDriver\Remote\RemoteWebDriver;
 use Facebook\WebDriver\Remote\DesiredCapabilities;
+use Facebook\WebDriver\Remote\RemoteWebDriver;
+use Laravel\Dusk\TestCase as BaseTestCase;
 
 abstract class DuskTestCase extends BaseTestCase
 {

stubs/ExampleTest.stub

@@ -2,9 +2,9 @@
 
 namespace Tests\Browser;
 
-use Tests\DuskTestCase;
-use Laravel\Dusk\Browser;
 use Illuminate\Foundation\Testing\DatabaseMigrations;
+use Laravel\Dusk\Browser;
+use Tests\DuskTestCase;
 
 class ExampleTest extends DuskTestCase
 {