Add closure signatures to return phpdoc

Author: greg0ire

src/Expr/ClosureExpressionVisitor.php

@@ -81,6 +81,8 @@ public static function getObjectFieldValue(object|array $object, string $field):
 
     /**
      * Helper for sorting arrays of objects based on multiple fields + orientations.
+     *
+     * @return Closure(mixed, mixed): int
      */
     public static function sortByField(string $name, int $orientation = 1, Closure|null $next = null): Closure
     {
@@ -171,7 +173,11 @@ public function walkCompositeExpression(CompositeExpression $expr): Closure
         };
     }
 
-    /** @param callable[] $expressions */
+    /**
+     * @param callable[] $expressions
+     *
+     * @return Closure(object): bool
+     */
     private function andExpressions(array $expressions): Closure
     {
         return static fn (object $object): bool => array_all(
@@ -180,7 +186,11 @@ private function andExpressions(array $expressions): Closure
         );
     }
 
-    /** @param callable[] $expressions */
+    /**
+     * @param callable[] $expressions
+     *
+     * @return Closure(object): bool
+     */
     private function orExpressions(array $expressions): Closure
     {
         return static fn (object $object): bool => array_any(
@@ -189,7 +199,11 @@ private function orExpressions(array $expressions): Closure
         );
     }
 
-    /** @param callable[] $expressions */
+    /**
+     * @param callable[] $expressions
+     *
+     * @return Closure(object): bool
+     */
     private function notExpression(array $expressions): Closure
     {
         return static fn (object $object) => ! $expressions[0]($object);