}

    @Test
    public void test_getNum() throws Exception {
        List<String> words = new ArrayList<>();
        words.add("word1");
        words.add("word2");
        words.add("word3");
        words.add("word4");

        PopularWordsResponse response = new PopularWordsResponse("test-index", 100, words, 20, new ArrayList<>());

        assertEquals(4, response.getNum());
    }

    @Test

    /**
     * Returns the list of suggested words.
     * @return The list of words.
     */
    public List<String> getWords() {
        return words;
    }

    /**
     * Returns the number of suggested words.
     * @return The number of words.
     */
    public int getNum() {
        return num;
    }

    /**
     * Returns the total number of hits.
     * @return The total number of hits.
     */

    }

    @Test
    public void test_getNum() throws Exception {
        List<String> words = new ArrayList<>();
        words.add("word1");
        words.add("word2");
        words.add("word3");

        SuggestResponse response = new SuggestResponse("test-index", 100, words, 20, new ArrayList<>());

        assertEquals(3, response.getNum());
    }

    @Test

    }

    /**
     * Gets the new input words.
     * Returns a defensive copy to prevent external modification.
     *
     * @return The new input words (defensive copy).
     */
    public String[] getNewInputs() {
        return newInputs == null ? null : newInputs.clone();
    }

    /**
     * Sets the new input words.
     *
     * @param newInputs The new input words.
     */

     * @param words the list of popular words
     * @param total the total number of words
     * @param items the list of suggested items
     */
    public PopularWordsResponse(final String index, final long tookMs, final List<String> words, final long total,
            final List<SuggestItem> items) {
        this.index = index;
        this.tookMs = tookMs;
        this.words = words;
        num = words.size();

                    logger.warn("Failed to generate popular words.", e);
                }

                return wordList;
            });
        } catch (final ExecutionException e) {
            logger.warn("Failed to load popular words.", e);
        }
        return Collections.emptyList();
    }

    /**
     * Clears all cached popular word lists.
     */
    public void clearCache() {

                final String[] words = SuggestUtil.parseQuery(queryString, field);
                if (words.length == 0) {
                    continue;
                }

                final String[][] readings = new String[words.length][];
                for (int j = 0; j < words.length; j++) {
                    words[j] = normalizer.normalize(words[j], field, "");

import org.junit.jupiter.api.Tag;
import org.junit.jupiter.api.Test;

import io.restassured.RestAssured;
import io.restassured.path.json.JsonPath;

/**
 * Integration tests for the Suggest Words API (/api/v1/suggest-words)
 */
@Tag("it")
public class SuggestWordsApiTests extends ITBase {

    @BeforeAll
    protected static void initAll() {
        RestAssured.baseURI = getFessUrl();
        settingTestToken();

                parser.parseSearchWords(words, null, fields, null, null, 1, defaultReadingConverter, defaultNormalizer, analyzer, null);

        assertNotNull(item);
        assertEquals("test", item.getText());
    }

    @Test
    public void test_parseSearchWords_withPartialReadings() throws Exception {
        String[] words = new String[] { "word1", "word2", "word3" };
        // Only provide readings for first word

import org.lastaflute.web.validation.theme.conversion.ValidateTypeFailure;

import jakarta.validation.constraints.Size;

/**
 * Form class for creating protected words dictionary entries.
 * Protected words are terms that should not be modified or analyzed during
 * text processing, preserving their original form in search indexes.
 *
 */
public class CreateForm {

    /**