Issue with Typing in keySet and key Methods

[agchan12]

Problem Description

There is a typing mismatch in the keySet method that causes PHPStan (our static analysis tool) to flag its usage as invalid typing, even though it works at runtime.

The docs do recommend provide the following usage examples.

$dict = ['foo' => 42];

v::keySet(
    v::key('foo', v::intVal())
)->validate($dict); // true

So I am just looking for guidance here.

Specifically:

The keySet method is typed as accepting Key ...$rule.

public static function keySet(Key ...$rule): ChainedValidator;

The key method, often used with keySet, returns a ChainedValidator

public static function key(
    string $reference,
    ?Validatable $referenceValidator = null,
    bool $mandatory = true
): ChainedValidator;

This creates an issue with PHPStan because keySet expects Key objects, but key returns a ChainedValidator.

This is more a question to see where your thoughts are at with this?