* @see DependencyScope
 */
@Experimental
@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,

    return ordering.<T>reverse().<@NonNull S>nullsLast();
  }

  @SuppressWarnings("unchecked") // still need the right way to explain this
  @Override
  public <S extends @Nullable T> Ordering<@Nullable S> nullsFirst() {
    return (Ordering<@Nullable S>) this;
  }

  @Override
  public <S extends @Nullable T> Ordering<@Nullable S> nullsLast() {
    return ordering.<@NonNull S>nullsLast();
  }

  @Override

 */
@Experimental
public interface MojoExecution {

    @Nonnull
    Plugin getPlugin();

    @Nonnull
    PluginExecution getModel();

    @Nonnull
    MojoDescriptor getDescriptor();

    @Nonnull
    String getExecutionId();

    @Nonnull
    String getGoal();

    @Nonnull
    String getLifecyclePhase();

    @Nonnull
    Optional<XmlNode> getConfiguration();

     */
    @Nonnull
    String[] option(Iterable<? extends Path> paths);

    /**
     * Returns the name of this path type. For example, if this path type
     * is {@link JavaPathType#MODULES}, then this method returns {@code "MODULES"}.
     *
     * @return the programmatic name of this path type
     */
    @Nonnull
    String name();

    /**

     * @return The path, relative to the local repository's base directory.
     */
    @Nonnull
    Path getPathForRemoteArtifact(
            @Nonnull Session session,
            @Nonnull LocalRepository local,
            @Nonnull RemoteRepository remote,
            @Nonnull Artifact artifact);

     */
    @Nonnull
    Collection<DownloadedArtifact> getArtifacts();

    /**
     * Retrieves the file system path associated with a specific artifact.
     *
     * @param artifact The {@link Artifact} whose path is to be retrieved.
     * @return The {@link Path} to the artifact, or {@code null} if unavailable.
     */
    @Nullable
    Path getPath(@Nonnull Artifact artifact);

    /**

 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */
package org.apache.maven.api;

import org.apache.maven.api.annotations.Nonnull;

/**
 * Represents a repository backed by an IDE workspace, the output of a build session,
 * or similar ad-hoc collections of artifacts. This repository is considered read-only

     *
     * @see DependencyCoordinates#getType()
     */
    @Nonnull
    Type getType();

    /**
     * {@return the time at which the dependency will be used}.
     * It may be, for example, at compile time only, at run time or at test time.
     *
     * @see DependencyCoordinates#getScope()
     */
    @Nonnull
    DependencyScope getScope();

    /**

     * @throws IllegalArgumentException if an argument is {@code null} or invalid
     * @see #build(ProjectBuilderRequest)
     */
    @Nonnull
    default ProjectBuilderResult build(@Nonnull Session session, @Nonnull Source source)
            throws ProjectBuilderException {
        return build(ProjectBuilderRequest.build(session, source));
    }

    /**

     * @throws VersionParserException if the range specification violates the syntax rules of this scheme
     */
    @Nonnull
    VersionConstraint parseVersionConstraint(@Nonnull String constraint);

    /**
     * Checks whether a given artifact version is considered a {@code SNAPSHOT} or not.
     */
    boolean isSnapshot(@Nonnull String version);