* <li>Field names and keys used throughout the application</li>
 * <li>Date/time format patterns</li>
 * <li>Authentication type identifiers</li>
 * <li>Reserved words and regex patterns for query processing</li>
 * </ul>
 */
public class Constants extends CoreLibConstants {

    /**
     * Private constructor to prevent instantiation of this utility class.

  PrimitiveSink putUnencodedChars(CharSequence charSequence);

  /**
   * Puts a string into this sink using the given charset.
   *
   * <p><b>Warning:</b> This method, which reencodes the input before processing it, is useful only
   * for cross-language compatibility. For other use cases, prefer {@link #putUnencodedChars}, which
   * is faster, produces the same output across Java releases, and processes every {@code char} in

 *
 * <p>
 * A Sitemap file provides search engines with a list of URLs available for crawling.
 * This class encapsulates the essential attributes of a Sitemap entry, allowing for efficient management
 * and processing of Sitemap data.
 * </p>
 *
 * <p>
 * The {@code loc} attribute specifies the URL of the Sitemap, while the {@code lastmod} attribute

        assertSame(clock, newClock, "withZone() should return the same clock instance");
    }

    @Test
    @DisplayName("MonotonicClock should maintain monotonic time progression")
    void testMonotonicBehavior() throws InterruptedException {
        Instant first = MonotonicClock.now();
        Thread.sleep(10); // Small delay
        Instant second = MonotonicClock.now();

                if (edge == null) { // no edges - don't need this vertex anymore
                    if (entry.equals(v)) { // unless it's an entry point.
                        // currently processing the entry point - it should not have any entry incident edges
                        res.getEntry().getMd().setWhy("This is a graph entry point. No links.");
                    }
                } else {

/**
 * Base search form class that extends SearchRequestParams.
 * Provides form fields and methods for handling search requests in the web interface.
 * Contains validation constraints and convenience methods for parameter processing.
 */
public class SearchForm extends SearchRequestParams {

    /**
     * Map of additional search fields with their values.
     */
    public Map<String, String[]> fields = new HashMap<>();

    /**

import org.xml.sax.InputSource;

import jakarta.annotation.PostConstruct;

/**
 * A transformer implementation for processing HTML documents using XPath expressions.
 * This class extends XpathTransformer to provide Fess-specific document processing capabilities
 * including content extraction, metadata processing, and robots tag handling.
 */
public class FessXpathTransformer extends XpathTransformer implements FessTransformer {

import jakarta.annotation.Resource;

/**
 * The {@code CrawlerThread} class represents a thread that executes the crawling process.
 * It is responsible for fetching URLs from the queue, accessing the content,
 * processing the response, and extracting child URLs.
 *
 * <p>
 * This class implements the {@link Runnable} interface, allowing it to be executed in a separate thread.

        CHILD_URLS,
        /** Indicates that a URL was evaluated for crawling eligibility. */
        EVALUATED,
        /** Indicates that a general exception occurred during processing. */
        EXCEPTION,
        /** Indicates that processing of a URL has finished. */
        FINISHED,
        /** Indicates that content was successfully parsed. */
        PARSED,
        /** Indicates that a URL was prepared for crawling. */

     * Each thread handles crawling for a single data configuration,
     * processing documents and updating the search index.
     *
     * <p>The thread manages:</p>
     * <ul>
     *   <li>Data store initialization and document processing</li>
     *   <li>Index update operations through callbacks</li>
     *   <li>Error handling and failure logging</li>