* {@link ThreadSafe}.
 *
 * @see ThreadSafe
 * @since 4.0.0
 */
@Experimental
@Documented
@Retention(RetentionPolicy.CLASS)
@ThreadSafe
@Target(ElementType.TYPE)

package org.apache.maven.cling.invoker;

import java.util.Optional;

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

/**
 * Container capsule.
 */
public interface ContainerCapsule extends AutoCloseable {
    /**
     * Updates the existing capsule logging setup.
     */
    void updateLogging(LookupContext context);

    /**

package org.apache.maven.execution;

import java.util.Optional;

/**
 * Instances of this class are responsible for determining whether it makes sense to "resume" a build using
 * the {@code --resume} flag.
 */
public interface BuildResumptionAnalyzer {
    /**
     * Construct an instance of {@link BuildResumptionData} based on the outcome of the current Maven build.
     * @param result Outcome of the current Maven build.

import org.jspecify.annotations.Nullable;

/**
 * Creates multisets, containing sample elements, to be tested.
 *
 * @author Jared Levy
 */
@GwtCompatible
@NullMarked
public interface TestMultisetGenerator<E extends @Nullable Object>
    extends TestCollectionGenerator<E> {
  @Override
  Multiset<E> create(Object... elements);

import org.eclipse.aether.repository.WorkspaceReader;

/**
 * MavenWorkspaceReader
 *
 * @deprecated since 4.0.0, use {@code maven-api-impl} jar instead
 */
@Deprecated(since = "4.0.0")
public interface MavenWorkspaceReader extends WorkspaceReader {

    Model findModel(Artifact artifact);

import org.eclipse.aether.RepositorySystemSession;

/**
 * Factory for {@link ModelCache} objects.
 *
 * @deprecated since 4.0.0, use {@code maven-api-impl} jar instead
 */
@Deprecated(since = "4.0.0")
public interface ModelCacheFactory {

    ModelCache createCache(RepositorySystemSession session);

import org.apache.maven.api.plugin.descriptor.PluginDescriptor;

/**
 * Reads and writes a {@link PluginDescriptor} object to/from XML.
 *
 * @since 4.0.0
 */
@Experimental

import org.apache.maven.api.annotations.Experimental;
import org.apache.maven.api.settings.Settings;

/**
 * Reads and writes a {@link Settings} object to/from XML.
 *
 * @since 4.0.0
 */
@Experimental

/**
 * Provides access to the contents of settings independently of the backing store (e.g. file system, database, memory).
 *
 *
 * @deprecated instead use {@link Source}
 */
@Deprecated

import org.apache.maven.lifecycle.LifecycleExecutionException;

/**
 * Provides context for mojo execution. Invocation of {@link #run(MojoExecution)} will result in actual execution
 */
public interface MojoExecutionRunner {
    /**
     * Runs mojo execution
     *
     * @param execution mojo execution
     * @throws LifecycleExecutionException
     */