/**
     * Creates a {@link org.apache.maven.api.Project} from a POM file.
     *
     * @param request {@link ProjectBuilderRequest}
     * @return the {@link ProjectBuilderResult} containing the built project and possible errors
     * @throws ProjectBuilderException if the project cannot be created
     * @throws IllegalArgumentException if an argument is {@code null} or invalid
     */
    @Nonnull

    protected FacetInfo defaultFacetInfo;

    /** Default geographic information configuration for location-based searches */
    protected GeoInfo defaultGeoInfo;

    /** Map containing field-specific boost values for search scoring */
    protected Map<String, String> fieldBoostMap = new HashMap<>();

    /** List of boost functions to be applied to search queries for custom scoring */

    @Resource
    protected SuggestHelper suggestHelper;

    /**
     * Retrieves suggest statistics including word counts.
     *
     * @return JSON response containing suggest statistics
     */
    // GET /api/admin/suggest
    @Execute
    public JsonResponse<ApiResult> get$index() {
        final SuggestBody body = new SuggestBody();

import com.google.common.annotations.J2ktIncompatible;
import java.util.Collections;
import java.util.Set;
import org.jspecify.annotations.Nullable;

/** Implementation of an {@link Optional} not containing a reference. */
@GwtCompatible
final class Absent<T> extends Optional<T> {
  static final Absent<Object> INSTANCE = new Absent<>();

  @SuppressWarnings("unchecked") // implementation is "fully variant"

 * prompt construction, parameter tuning, and response parsing.
 */
public interface LlmClient {

    /**
     * Performs a chat completion request.
     *
     * @param request the chat request containing messages and parameters
     * @return the chat response from the LLM
     * @throws LlmException if an error occurs during the request
     */
    LlmChatResponse chat(LlmChatRequest request);

    /**

 * when listing directory contents in SMB shares.
 */
public interface SmbFilenameFilter {
    /**
     * Tests whether the specified filename should be included in a file list.
     *
     * @param dir the directory containing the file
     * @param name the name of the file
     * @return true if the file should be included, false otherwise
     * @throws SmbException if an SMB error occurs during evaluation
     */

   */
  public static <E extends @Nullable Object> LinkedHashMultiset<E> create(int distinctElements) {
    return new LinkedHashMultiset<>(distinctElements);
  }

  /**
   * Creates a new {@code LinkedHashMultiset} containing the specified elements.
   *
   * <p>This implementation is highly efficient when {@code elements} is itself a {@link Multiset}.
   *
   * @param elements the elements that the multiset should contain
   */

public interface TestContainerGenerator<T, E extends @Nullable Object> {
  /** Returns the sample elements that this generate populates its container with. */
  SampleElements<E> samples();

  /**
   * Creates a new container containing the given elements. TODO: would be nice to figure out how to
   * use E... or E[] as a parameter type, but this doesn't seem to work because Java creates an
   * array of the erased type.
   */
  T create(Object... elements);

     *
     * @param parser
     *            The {@link SAXParser} to use. Must not be {@literal null}.
     * @param inputSource
     *            The {@link InputSource} containing the content to be parsed. Must not be {@literal null}.
     * @param handler
     *            The SAX {@link DefaultHandler} to use. Must not be {@literal null}.
     */

 */
@Experimental
public interface DependencyCoordinatesFactory extends Service {

    /**
     * Creates a new {@link DependencyCoordinates} object from the request.
     *
     * @param request the request containing the various data
     * @return a new {@link DependencyCoordinates} object
     *
     * @throws IllegalArgumentException if {@code request} is null or
     *         if {@code request.getSession()} is null or invalid