* beyond the standard {@link ProjectScope#MAIN} and {@link ProjectScope#TEST} scopes.
 * Implementations of this interface will be discovered through the Java ServiceLoader mechanism
 * and their provided project scopes will be available throughout the Maven build process.
 * <p>
 * Example usage:
 * <pre>
 * public class CustomProjectScopeProvider implements ProjectScopeProvider {
 *     public Collection&lt;ProjectScope&gt; provides() {

 */
fun Settings.packaging(moduleConfiguration: ProjectScope.() -> Unit) =
    ProjectScope("packaging", this).moduleConfiguration()

/**
 * Defines the testing module, for project helping test Gradle.
 */
fun Settings.testing(moduleConfiguration: ProjectScope.() -> Unit) =
    ProjectScope("testing", this).moduleConfiguration()

/**
 * Defines a bucket of unassigned projects.
 */

}

class ArchitectureModuleBuilder(
    name: String,
    settings: Settings,
    private val projectScope: ProjectScope = ProjectScope("platforms/$name", settings),
) : ArchitectureElementBuilder(name) {

    fun subproject(projectName: String) {
        projectScope.subproject(projectName)
    }

    override fun build(): ArchitectureModule {
        return ArchitectureModule(name, id)
    }
}

     * @param projectScope the project scope associated with this path scope
     * @param dependencyScopes the dependency scopes associated with this path scope
     * @return a new PathScope instance
     */
    static PathScope pathScope(String id, ProjectScope projectScope, DependencyScope... dependencyScopes) {
        return new DefaultPathScope(id, projectScope, dependencyScopes);
    }

    /**

import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.when;

public class SourceRootTest implements SourceRoot {
    private ProjectScope scope;

    private Language language;

    private String moduleName;

    @Override
    public ProjectScope scope() {
        return (scope != null) ? scope : SourceRoot.super.scope();
    }

    @Override
    public Language language() {

     * {@return in which context the source files will be used}
     * Not to be confused with dependency scope.
     * The default value is {@code "main"}.
     *
     * @see ProjectScope#MAIN
     */
    default ProjectScope scope() {
        return ProjectScope.MAIN;
    }

    /**
     * {@return the language of the source files}
     * The default value is {@code "java"}.
     *
     * @see Language#JAVA_FAMILY

@Immutable
public interface PathScope extends ExtensibleEnum {

    // TODO: what if I simply want all dependencies ?
    @Nonnull
    ProjectScope projectScope();

    @Nonnull
    Set<DependencyScope> dependencyScopes();

    PathScope MAIN_COMPILE = pathScope(
            "main-compile",
            ProjectScope.MAIN,
            DependencyScope.COMPILE_ONLY,
            DependencyScope.COMPILE,
            DependencyScope.PROVIDED);

import java.util.stream.Stream;

import org.apache.maven.RepositoryUtils;
import org.apache.maven.api.Language;
import org.apache.maven.api.ProducedArtifact;
import org.apache.maven.api.Project;
import org.apache.maven.api.ProjectScope;
import org.apache.maven.api.RemoteRepository;
import org.apache.maven.api.Service;
import org.apache.maven.api.SourceRoot;
import org.apache.maven.api.annotations.Nonnull;
import org.apache.maven.api.di.SessionScoped;

     * @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();