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 {

    /**

    /**
     * Gets a specific protected words item by ID.
     * @param dictId the dictionary ID
     * @param id the item ID
     * @return the protected words item if found
     */
    public OptionalEntity<ProtwordsItem> getProtwordsItem(final String dictId, final long id) {
        return getProtwordsFile(dictId).map(file -> file.get(id).get());
    }

    /**
     * Stores a protected words item (insert or update).

     *
     * @param word        The elevate word.
     * @param reading     The reading of the word.
     * @param tags        The tags associated with the word.
     * @param permissions The permissions for the word.
     * @param boost       The boost value for the word.
     * @param apply       true to apply the changes immediately.
     */

/**
 * Form for uploading protected words files to the Fess search engine.
 * Protected words are terms that should not be stemmed or modified during text analysis.
 * This form is used in the admin interface to upload custom protected words dictionary files.
 */
public class UploadForm {

    /**
     * The dictionary ID that identifies which protected words dictionary configuration to update.

    /**
     * Shows the main elevate word management page.
     *
     * @return HTML response for the elevate word list page
     */
    @Execute
    @Secured({ ROLE, ROLE + VIEW })
    public HtmlResponse index() {
        return asListHtml();
    }

    /**
     * Lists elevate words with pagination support.
     *

          $ref: '#/components/responses/InternalServerError'

  /popular-words:
    get:
      tags:
        - popularword
      summary: List popular words
      description: Returns available labels
      operationId: listPopularWords
      parameters:
        - name: seed
          in: query
          description: Random seed to return popular words
          required: false
          schema:
            type: string

import org.lastaflute.web.validation.Required;

/**
 * The download form for protected words dictionary.
 * This form is used for downloading protected words dictionary files from the admin interface.
 *
 */
public class DownloadForm {

    /**
     * Dictionary ID for identifying the protected words dictionary to download.
     */
    @Required
    public String dictId;

    /**

/**
 * Form for uploading bad word files to the Fess search engine.
 * This form is used in the admin interface to upload bad word dictionary files
 * that contain words to be filtered from search results.
 */
public class UploadForm {

    /**
     * The multipart file containing bad words to be uploaded.
     * This file should contain a list of words that will be filtered from search results.
     */

 * <li>{@link #addBadWord(String, boolean)} - Add a bad word and optionally apply it.
 * <li>{@link #deleteBadWord(String)} - Delete a bad word.
 * <li>{@link #addElevateWord(ElevateWord, boolean)} - Add an elevate word and optionally apply it.
 * <li>{@link #deleteElevateWord(String, boolean)} - Delete an elevate word and optionally apply it.

                    logger.warn("Failed to read a suggest elevate word: {}", list, e);
                }
            }
            elevateWordBhv.refresh();
        } catch (final IOException e) {
            logger.warn("Failed to read a suggest elevate word.", e);
        }
    }

    /**
     * Exports elevate words to a CSV file.
     * CSV format: SuggestWord, Reading, Permissions, Labels, Boost