* @param directory the directory to add if not already present in the source
     *
     * @see #getEnabledSourceRoots(Project, ProjectScope, Language)
     */
    void addSourceRoot(
            @Nonnull Project project, @Nonnull ProjectScope scope, @Nonnull Language language, @Nonnull Path directory);

    /**
     * Returns an immutable list of project remote repositories (directly specified or inherited).

     * @see Build#getDirectory()
     */
    @Nonnull
    default Path getOutputDirectory(@Nullable ProjectScope scope) {
        String dir;
        Build build = getBuild();
        if (scope == ProjectScope.MAIN) {
            dir = build.getOutputDirectory();
        } else if (scope == ProjectScope.TEST) {
            dir = build.getTestOutputDirectory();
        } else {
            dir = build.getDirectory();

     * that this provider wants to contribute.
     * <p>
     * The values returned by this method should be created using the appropriate factory methods
     * for the specific enum type, such as {@code language()}, {@code projectScope()}, or
     * {@code pathScope()}.
     *
     * @return a non-null collection of enum instances to register
     */
    @Nonnull
    Collection<T> provides();

    Packaging requirePackaging(@Nonnull String id);

    /**
     * Obtain the {@link ProjectScope} from the specified {@code id}.
     * <p>
     * Shortcut for {@code getService(ProjectScopeRegistry.class).require(...)}.
     *
     * @see org.apache.maven.api.services.ProjectScopeRegistry#require(String)
     */
    @Nonnull
    ProjectScope requireProjectScope(@Nonnull String id);

    /**

 * <pre>
 * public class CustomPathScopeProvider implements PathScopeProvider {
 *     public Collection&lt;PathScope&gt; provides() {
 *         return Collections.singleton(pathScope("integration-test",
 *                 ProjectScope.TEST, DependencyScope.TEST));
 *     }
 * }
 * </pre>
 *
 * @see org.apache.maven.api.PathScope
 * @see org.apache.maven.api.spi.ExtensibleEnumProvider
 * @since 4.0.0
 */
@Experimental
@Consumer