valkyrjaio / valkyrja / 24374846282

100%

master: 100%

push

github

[Application] Add component provider dependencies capability (#727)

# Description

Add component provider dependencies capability.

## New `ComponentProviderContract` Dependency Pattern

The `ComponentProviderContract` interface gains a
`getComponentProviders()` method, allowing a component provider to
declare other component providers it depends on. `Kernel\Valkyrja`
expands these declarations into a flat provider list at boot time: the
declaring component is positioned first, followed by its declared
sub-components in order. This means the declaring component's own
service, route, and event provider registrations take effect before its
dependencies' registrations — enabling explicit overrides.

---

## Four Built-in Application Component Providers

Four aggregator providers are added to `Valkyrja\Application\Provider`,
each implementing `ComponentProviderContract` and declaring a curated
set of framework sub-components via `getComponentProviders()` while
returning `[]` from all other methods:

| Class | Components Included | Default For |
|---|---|---|
| `ApplicationComponentProvider` | Container, Dispatch, all CLI, Event,
all HTTP, Log, View | `Config` |
| `CliApplicationComponentProvider` | Container, Dispatch, all CLI,
Event, Log | — |
| `CliWithHttpApplicationComponentProvider` | Container, Dispatch, all
CLI, Event, all HTTP, Log | `CliConfig` |
| `HttpApplicationComponentProvider` | Container, Dispatch, Event, all
HTTP, Log, View | `HttpConfig` |

`HttpConfig` now defaults providers to
`[HttpApplicationComponentProvider]` and `CliConfig` defaults to
`[CliWithHttpApplicationComponentProvider]`, replacing the previous flat
lists of individual framework component providers.

---

## Tests

Unit tests are added to `Tests\Unit\Application\Kernel\ApplicationTest`
covering:

- `getProviders()` sub-component expansion
- `getContainerProviders()`, `getEventProviders()`, `getCliProviders()`,
and `getHttpProviders()` result collection
- Cache population ... (continued)

171 of 171 new or added lines in 34 files covered. (100.0%)

13153 of 13153 relevant lines covered (100.0%)

16.46 hits per line