Make resolve() variadic-aware and add ParameterResolver interface

[alganet]

resolve() now returns an ordered, ready-to-splat list (in parameter order) instead of a name-keyed array, and expands a trailing variadic parameter into all remaining positional arguments. It also accepts named arguments directly (keyed by parameter name, taking precedence over the container), so a single algorithm handles positional, named, and variadic resolution.

Add a ParameterResolver interface exposing just resolve(), so consumers can depend on the contract rather than the concrete Resolver. Resolver implements it.

Deprecate resolveNamed() as a thin alias of resolve(); update the README for the new return shape, precedence, variadics, and interface.

[Copilot]

Pull request overview

This PR updates the parameter resolution API to return an ordered, “ready-to-splat” argument list (instead of a name-keyed array), adds support for expanding trailing variadic parameters, and introduces a ParameterResolver interface so consumers can depend on the contract rather than the concrete Resolver.

Changes:

• Changed Resolver::resolve() to accept mixed positional/named inputs and return an ordered list<mixed> suitable for ...$args / newInstanceArgs().
• Added ParameterResolver interface and made Resolver implement it; deprecated resolveNamed() as an alias of resolve().
• Updated tests and README to reflect the new return shape, precedence rules, and variadic behavior.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/Resolver.php	Reworks resolution algorithm to produce ordered arguments and expand variadics; keeps resolveNamed() as deprecated alias.
src/ParameterResolver.php	Introduces the ParameterResolver interface exposing resolve().
tests/unit/ResolverTest.php	Updates expectations for ordered return shape; adds coverage for variadics and interface implementation.
tests/fixtures/VariadicConsumer.php	Adds a variadic constructor fixture to exercise variadic argument expansion.
README.md	Documents new resolution precedence, ordered return list, variadic behavior, and interface usage.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.