loophp / collection

src/Operation/Dispersion.php

<?php

declare(strict_types=1);

namespace loophp\collection\Operation;

use Closure;
use Generator;

/**
 * @immutable
 *
 * @template TKey
 * @template T
 */
final class Dispersion extends AbstractOperation
{
    /**
     * @return Closure(iterable<TKey, T>): Generator<int, float|int<0,1>>
     */
    public function __invoke(): Closure
    {
        /** @var Closure(iterable<TKey, T>): Generator<int, float|int<0,1>> $pipe */
        $pipe = (new Pipe())()(
            (new Normalize())(),
            (new ScanLeft())()(
                /**
                 * @param array<numeric-string|int<0,1>, T> $acc

The doc comment array<numeric-string|int<0,1>, T> at position 2 could not be parsed: Unknown type name 'numeric-string' at position 2 in array<numeric-string|int<0,1>, T>.

                 * @param T $value
                 *
                 * @return list{float|int<0,1>, T}
                 */
                static function (array $acc, mixed $value, int $key): array {
                    [$c, $v] = $acc;

                    return [(0 === $key) ? 0 : (($c * ($key - 1) + (($v === $value) ? 0 : 1)) / $key), $value];

The expression return array(0 === $key ? 0 : $c * $key - 1 + $v === $value ? 0 : 1 / $key, $value) returns the type array<integer,integer|mixed> which is incompatible with the documented return type loophp\collection\Operation\list.

                }
            )([0, null]),
            (new Drop())()(1),
            (new Map())()(
                /**
                 * @param array<numeric-string|int<0,1>, T> $value

The doc comment array<numeric-string|int<0,1>, T> at position 2 could not be parsed: Unknown type name 'numeric-string' at position 2 in array<numeric-string|int<0,1>, T>.

                 *
                 * @return float|int<0,1>
                 */
                static fn (array $value): float|int => (0.0 === $value[0] || 1.0 === $value[0]) ? (int) $value[0] : $value[0]
            )
        );

        return $pipe;
    }
}