}).orElse(Collections.emptyList());
    }

    /**
     * Retrieves a stopwords file for a given dictionary ID.
     *
     * @param dictId The ID of the dictionary.
     * @return An optional entity containing the stopwords file, or empty if not found.
     */
    public OptionalEntity<StopwordsFile> getStopwordsFile(final String dictId) {
        return dictionaryManager.getDictionaryFile(dictId)

        }).orElse(Collections.emptyList());
    }

    /**
     * Retrieves a synonym file for a given dictionary ID.
     *
     * @param dictId The ID of the dictionary.
     * @return An optional entity containing the synonym file, or empty if not found.
     */
    public OptionalEntity<SynonymFile> getSynonymFile(final String dictId) {
        return dictionaryManager.getDictionaryFile(dictId)

    /**
     * Base-64 encodes the supplied block of data.  Line wrapping is not
     * applied on output.
     *
     * @param bytes The block of data that is to be Base-64 encoded.
     * @return A <code>String</code> containing the encoded data.
     */
    public static String encode(final byte[] bytes) {
        int length = bytes.length;
        if (length == 0) {
            return "";
        }

    return asByteSource(url).asCharSource(charset);
  }

  /**
   * Reads all bytes from a URL into a byte array.
   *
   * @param url the URL to read from
   * @return a byte array containing all the bytes from the URL
   * @throws IOException if an I/O error occurs
   */
  public static byte[] toByteArray(URL url) throws IOException {
    return asByteSource(url).read();
  }

  /**

        return asListHtml(this::saveToken);
    }

    /**
     * Processes uploaded search request files and executes them against the search engine.
     *
     * @param form the upload form containing the request file
     * @return action response with the search results or error page
     */
    @Execute
    @Secured({ ROLE })
    public ActionResponse upload(final UploadForm form) {

   */
  @SuppressWarnings("unchecked")
  public static <C extends Comparable> ImmutableRangeSet<C> of() {
    return (ImmutableRangeSet<C>) EMPTY;
  }

  /**
   * Returns an immutable range set containing the specified single range. If {@link Range#isEmpty()
   * range.isEmpty()}, this is equivalent to {@link ImmutableRangeSet#of()}.
   */
  public static <C extends Comparable> ImmutableRangeSet<C> of(Range<C> range) {

     * Extracts geo.{field}.point and geo.{field}.distance parameters to create
     * geo-distance queries for each configured geographic field.
     *
     * @param request the HTTP servlet request containing geographic parameters
     * @throws InvalidQueryException if geo point format is invalid or parsing fails
     */
    public GeoInfo(final HttpServletRequest request) {

 * execution timing, and highlighting parameters.
 */
public class SearchRenderData {

    /** List of search result documents. */
    protected List<Map<String, Object>> documentItems;

    /** Facet response containing aggregated search facets. */
    protected FacetResponse facetResponse;

    /** Additional highlight parameters to append to URLs. */
    protected String appendHighlightParams;

 * <li>{@code classDocbookDir} - A directory that should contain docbook template for each class referenced in main docbook template.</li>
 * </ul>
 *
 * Produces the following:
 * <ul>
 * <li>A docbook book XML file containing the reference.</li>

     *
     * @return URL-encoded query string containing facet parameters
     */
    public static String facetQuery() {
        return createQuery(Constants.FACET_QUERY, FACET_PREFIX);
    }

    /**
     * Generates URL query parameters for geographic filtering.
     *
     * @return URL-encoded query string containing geographic parameters
     */
    public static String geoQuery() {