feat(spectacular)!: add required routes option and optional testing features for provideSpectacularFeatureTest

[LayZeeDK]

PR Checklist

Please check if your PR fulfills the following requirements:

• The commit message follows our guidelines: CONTRIBUTING.md#commit
• Tests for the changes have been added (for bug fixes / features)
• Docs have been added / updated (for bug fixes / features)

PR Type

What kind of change does this PR introduce?

[ ] Bugfix
[x] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[ ] Build related changes
[ ] CI related changes
[x] Documentation content changes
[ ] Other... Please describe:

What is the current behavior?

Features

1. provideSpectacularFeatureTest only supports the featurePath option
2. provideSpectacularFeatureTest returns Provider[]
3. provideSpectacularFeatureTest is stable and provideSpectacularFeatureTesting does not exist
4. withInitialFeatureNavigation does not exist
5. SpectacularFeatureTestingModule is stable

Refactors

1. SpectacularFeatureTestingRootModule uses InjectFlags

Testing

1. A classic CapitalizePipe is tested

Documentation

1. The excludeComponentDeclaration option is specified for all Angular Testing Library example tests

Issue Number: N/A

What is the new behavior?

Features

1. provideSpectacularFeatureTest requires a routes option and optionally accepts the withInitialFeatureNavigation feature and Angular Router features
2. provideSpectacularFeatureTest returns (EnvironmentProviders | Provider)[]
3. provideSpectacularFeatureTest is marked as deprecated and a copy is renamed to provideSpectacularFeatureTesting
4. Add withInitialFeatureNavigation for use with provideSpectacularFeatureTest and provideSpectacularFeatureTesting
5. SpectacularFeatureTestingModule is deprecated

Refactors

1. SpectacularFeatureTestingRootModule uses InjectOptions

Testing

1. A classic and a standalone CapitalizePipe are tested

Documentation

1. The excludeComponentDeclaration option is not mentioned in Angular Testing Library example tests

Does this PR introduce a breaking change?

[x] Yes
[ ] No

BREAKING CHANGES

• A routes option must be passed to provideSpectacularFeatureTest.
• provideSpectacularFeatureTest returns (EnvironmentProviders | Provider)[]

DEPRECATIONS

• provideSpectacularFeatureTest is to be removed in Spectacular version 16. Migrate to provideSpectacularFeatureTesting.
• SpectacularFeatureTestingModule is to be removed in Spectacular version 16. Migrate to provideSpectacularFeatureTesting.

Other information

API design Gist

[NachoVazquez]

It is looking great; I'm excited.

[NachoVazquez]

I left some small nitpicks assisted by the linter, but it looks great!