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

    /**
     * Creates a new ProjectScope instance with the specified ID.
     *

     * It may be, for example, at compile time only, at run time or at test time.
     *
     * @see DependencyCoordinates#getScope()
     */
    @Nonnull
    DependencyScope getScope();

    /**
     * Returns whether the dependency is optional or mandatory.
     * Unlike {@link DependencyCoordinates}, the obligation of a {@code Dependency} is always present.

 *     public Collection<PathScope> 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
@Named

     */
    @Nonnull
    ProjectScope requireProjectScope(@Nonnull String id);

    /**
     * Obtain the {@link DependencyScope} from the specified {@code id}.
     * <p>
     * Shortcut for {@code DependencyScope.forId(...)} with a verification that the given identifier exists.
     *
     * @param id the identifier of the scope (case-sensitive)