Correct PHPDoc for Arr::sole callable type to avoid return type ambiguity (#56108)

AhmedAlaa4611 · web-flow · commit 677618b028a2 · 2025-06-23T17:32:37.000-05:00
diff --git a/src/Illuminate/Collections/Arr.php b/src/Illuminate/Collections/Arr.php
@@ -951,7 +951,7 @@ public static function shuffle($array)
      * Get the first item in the array, but only if exactly one item exists. Otherwise, throw an exception.
      *
      * @param  array  $array
-     * @param  callable(mixed, array-key): array|null  $callback
+     * @param  (callable(mixed, array-key): array)|null  $callback
      *
      * @throws \Illuminate\Support\ItemNotFoundException
      * @throws \Illuminate\Support\MultipleItemsFoundException

Original file line number	Diff line number	Diff line change
`@@ -951,7 +951,7 @@ public static function shuffle($array)`
`951`	`951`	`* Get the first item in the array, but only if exactly one item exists. Otherwise, throw an exception.`
`952`	`952`	`*`
`953`	`953`	`* @param array $array`
`954`		`- * @param callable(mixed, array-key): array\|null $callback`
	`954`	`+ * @param (callable(mixed, array-key): array)\|null $callback`
`955`	`955`	`*`
`956`	`956`	`* @throws \Illuminate\Support\ItemNotFoundException`
`957`	`957`	`* @throws \Illuminate\Support\MultipleItemsFoundException`