Add PHPDoc callable types for BusFake methods (#58070)

Add proper callable type hints that document the callback signatures.
This improves IDE autocompletion and static analysis support.

Author: alies-dev

src/Illuminate/Support/Testing/Fakes/BusFake.php

@@ -488,7 +488,7 @@ protected function assertDispatchedWithChainOfObjects($command, $expectedChain,
     /**
      * Create a new assertion about a chained batch.
      *
-     * @param  \Closure  $callback
+     * @param  \Closure(\Illuminate\Bus\PendingBatch): bool  $callback
      * @return \Illuminate\Support\Testing\Fakes\ChainedBatchTruthTest
      */
     public function chainedBatch(Closure $callback)
@@ -499,7 +499,7 @@ public function chainedBatch(Closure $callback)
     /**
      * Assert if a batch was dispatched based on a truth-test callback.
      *
-     * @param  callable  $callback
+     * @param  callable(\Illuminate\Bus\PendingBatch): bool  $callback
      * @return void
      */
     public function assertBatched(callable $callback)
@@ -606,8 +606,8 @@ public function dispatchedAfterResponse(string $command, $callback = null)
     /**
      * Get all of the pending batches matching a truth-test callback.
      *
-     * @param  callable  $callback
-     * @return \Illuminate\Support\Collection
+     * @param  callable(\Illuminate\Bus\PendingBatch): bool  $callback
+     * @return \Illuminate\Support\Collection<int, \Illuminate\Bus\PendingBatch>
      */
     public function batched(callable $callback)
     {

src/Illuminate/Support/Testing/Fakes/ChainedBatchTruthTest.php

@@ -9,14 +9,14 @@ class ChainedBatchTruthTest
     /**
      * The underlying truth test.
      *
-     * @var \Closure
+     * @var \Closure(\Illuminate\Bus\PendingBatch): bool
      */
     protected $callback;
 
     /**
      * Create a new truth test instance.
      *
-     * @param  \Closure  $callback
+     * @param  \Closure(\Illuminate\Bus\PendingBatch): bool  $callback
      */
     public function __construct(Closure $callback)
     {