[12.x] DocBlock: Changed typehint for Arr::partition method

[AndrewMast]

DocBlock Change

Changed the docblock for the newly introduced Arr::partition (#54859). The typehint for the $callback parameter now communicates what the callable will be receiving and should be returning (callable(TValue, TKey): bool)

Example

/**
 * @var array<string, bool>
 */
$names = [
    'taylor' => true,
    'francis' => true,
    'primeagen' => false,
];

// Before
[$realNames, $aliasNames] = Arr::partition(
    $names,
    fn (/** @param mixed */ $value, /** @param mixed */ $key) => /** @return mixed */ $value,
);

// After
[$realNames, $aliasNames] = Arr::partition(
    $names,
    fn (/** @param bool */ $value, /** @param string */ $key) => /** @return bool */ $value,
);

Why

Arr::partition was recently added and does not have a generic typehint for the $callback parameter. I matched the typehint to be similar to the typehints for the preexisting Arr::first and Arr::last callbacks.