import java.util.Iterator;
import java.util.List;
import java.util.ListIterator;
import java.util.Map;

/**
 * A response list that extends List functionality and includes pagination and search metadata.
 * This class wraps search results with pagination information, facet responses, and query statistics.
 * It implements the List interface to provide standard list operations while adding search-specific

import org.codelibs.fess.util.FacetResponse;

/**
 * Data container for search results rendering.
 *
 * This class holds all the data needed to render search results in the UI,
 * including the actual search results, pagination information, facet data,
 * execution timing, and highlighting parameters.
 */
public class SearchRenderData {

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

                                    </div>
                                    <div class="col-sm-10">
                                        <ul class="pagination pagination-sm m-0 float-right">
                                            <c:if test="${pager.existPrePage}">
                                                <li class="page-item"><la:link

    @Resource
    private KeyMatchHelper keyMatchHelper;

    /** Service for key match operations. */
    @Resource
    private KeyMatchService keyMatchService;

    /** Pager for key match list pagination. */
    @Resource
    private KeyMatchPager keyMatchPager;

    // ===================================================================================

            searchPaging(data, form);
        });
    }

    /**
     * Set up pagination data for search results.
     *
     * @param data the render data to populate
     * @param form the search form containing pagination parameters
     */
    protected void searchPaging(final RenderData data, final SearchForm form) {
        // page navi

     * Extracts a subset of documents from the full result list based on pagination parameters.
     * Applies proper bounds checking to ensure the extracted range is within the document list size.
     *
     * @param docs the full list of search result documents
     * @param pageSize the number of documents to include in the page
     * @param startPosition the starting position for pagination
     * @return sublist of documents for the requested page

                                    <div class="row">
                                        <div class="col-sm-12 text-center">
                                            <ul class="pagination pagination-sm justify-content-center">
                                                <c:if test="${existPrevPage}">
                                                    <li class="page-item"><la:link

                                    </div>
                                    <div class="col-sm-10">
                                        <ul class="pagination pagination-sm m-0 float-right">
                                            <c:if test="${pager.existPrePage}">
                                                <li class="page-item"><la:link

     */
    @Execute
    @Secured({ ROLE, ROLE + VIEW })
    public HtmlResponse index(final SearchForm form) {
        return asListHtml();
    }

    /**
     * Displays the duplicate host list with pagination.
     *
     * @param pageNumber the page number to display
     * @param form the search form
     * @return HTML response for the duplicate host list page
     */
    @Execute

                                    </div>
                                    <div class="col-sm-10">
                                        <ul class="pagination pagination-sm m-0 float-right">
                                            <c:if test="${pager.existPrePage}">
                                                <li class="page-item"><la:link