*
 * @see Provider
 * @since 4.0.0
 */
@Experimental
@Documented
@Retention(RetentionPolicy.CLASS)
@Target({ElementType.TYPE, ElementType.PACKAGE})

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

/**
 * Defines a hierarchical visitor for collecting dependency node trees.
 *
 * @since 4.0.0
 */
@Experimental
@Consumer
public interface NodeVisitor {
    /**
     * Starts the visit to the specified dependency node.
     *
     * @param node the dependency node to visit

/**
 * Deploys {@link ProducedArtifact}s to a {@link RemoteRepository}.
 *
 * @since 4.0.0
 * @see Session#deployArtifact(RemoteRepository, ProducedArtifact...)
 */
@Experimental
public interface ArtifactDeployer extends Service {

    /**
     * @param request {@link ArtifactDeployerRequest}
     * @throws ArtifactDeployerException if the deployment failed
     */

 *
 * @param <REQ> the type of Request that produced this result, ensuring type-safe
 *              access to the original request parameters
 *
 * @see Request
 * @since 4.0.0
 */
@Experimental
@Immutable
public interface Result<REQ extends Request<?>> {

    /**
     * Returns the request that produced this result.
     *
     * @return the originating request instance, never {@code null}
     */
    @Nonnull

 *
 * <p>This factory is responsible for instantiating concrete toolchain implementations
 * based on toolchain model configurations or default settings.</p>
 *
 * @since 4.0.0
 */
@Experimental
@Consumer
public interface ToolchainFactory {
    /**
     * Creates a toolchain instance from the provided model configuration.
     *
     * @param model The toolchain configuration model
     * @return A configured toolchain instance

// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
//

import org.jspecify.annotations.Nullable;

/**
 * Helper interface to implement both {@link ListenableFuture} and {@link ScheduledFuture}.
 *
 * @author Anthony Zana
 * @since 15.0
 */
@GwtCompatible
public interface ListenableScheduledFuture<V extends @Nullable Object>

import org.jspecify.annotations.Nullable;

/**
 * Creates collections, containing sample elements, to be tested.
 *
 * @author Kevin Bourrillion
 */
@GwtCompatible
@NullMarked
public interface TestCollectionGenerator<E extends @Nullable Object>

 * specific language governing permissions and limitations
 * under the License.
 */
package org.apache.maven.api.services;

import org.apache.maven.api.Language;

 * This class processes Lucene TermQuery objects and converts them to OpenSearch QueryBuilder instances.
 */
public class TermQueryCommand extends QueryCommand {
    private static final Logger logger = LogManager.getLogger(TermQueryCommand.class);

    /**
     * Default constructor for TermQueryCommand.
     */
    public TermQueryCommand() {
        super();
    }

    private static final String SORT_FIELD = "sort";