/**
     * Displays the main path mapping administration page.
     *
     * @param form the search form containing search criteria
     * @return HTML response for the path mapping list page
     */
    @Execute
    @Secured({ ROLE, ROLE + VIEW })
    public HtmlResponse index(final SearchForm form) {
        return asListHtml();
    }

    /**
     * Displays the path mapping list with pagination support.
     *

          "mapping": {
            "type": "text",
            "analyzer": "empty_analyzer"
          }
        }
      },
      {
        "lang_ca": {
          "match": "*_ca",
          "mapping": {
            "type": "text",
            "analyzer": "catalan_analyzer"
          }
        }
      },
      {
        "lang_ckb-iq": {
          "match": "*_ckb-iq",
          "mapping": {

    /** Service for managing path mapping configurations */
    @Resource
    private PathMappingService pathMappingService;

    // GET /api/admin/pathmap
    // PUT /api/admin/pathmap
    /**
     * Returns list of path mapping settings.
     * Supports both GET and PUT requests for retrieving paginated path mapping configurations.
     *

          "mapping": {
            "type": "text",
            "analyzer": "empty_analyzer"
          }
        }
      },
      {
        "lang_ca": {
          "match": "*_ca",
          "mapping": {
            "type": "text",
            "analyzer": "catalan_analyzer"
          }
        }
      },
      {
        "lang_ckb-iq": {
          "match": "*_ckb-iq",
          "mapping": {

internal fun mergeAdjacentRanges(mappings: List<Mapping>): List<Mapping> {
  var index = 0
  val result = mutableListOf<Mapping>()

  while (index < mappings.size) {
    val mapping = mappings[index]
    val type = canonicalizeType(mapping.type)
    val mappedTo = mapping.mappedTo

    var unionWith: Mapping = mapping
    index++

    while (index < mappings.size) {

    }

    /**
     * Retrieve a single character mapping entry by ID for the specified dictionary.
     *
     * @param dictId identifier of the dictionary
     * @param id identifier of the mapping entry
     * @return JSON response containing the mapping entry
     */
    // GET /api/admin/dict/mapping/setting/{dictId}/{id}
    @Execute

    /** Type identifier for character mapping dictionaries. */
    private static final String MAPPING = "mapping";

    /** List of character mapping items loaded from the mapping file. */
    List<CharMappingItem> mappingItemList;

    /**
     * Constructs a new CharMappingFile instance.
     *
     * @param id the unique identifier for this mapping file

          "mapping": {
            "type": "text",
            "analyzer": "empty_analyzer"
          }
        }
      },
      {
        "lang_ca": {
          "match": "*_ca",
          "mapping": {
            "type": "text",
            "analyzer": "catalan_analyzer"
          }
        }
      },
      {
        "lang_ckb-iq": {
          "match": "*_ckb-iq",
          "mapping": {

 */
public class UploadForm {

    /**
     * The dictionary ID that identifies which character mapping dictionary configuration to update.
     * This ID corresponds to a specific character mapping dictionary instance in the system.
     */
    @Required
    public String dictId;

    /**
     * The multipart file containing the character mapping rules to be uploaded.

    <dispatcher>INCLUDE</dispatcher>
  </filter-mapping>

  <filter-mapping>
    <filter-name>httpHeaderSecurity</filter-name>
    <url-pattern>/*</url-pattern>
    <dispatcher>REQUEST</dispatcher>
  </filter-mapping>

  <filter-mapping>
    <filter-name>rateLimitFilter</filter-name>
    <url-pattern>/*</url-pattern>
    <dispatcher>REQUEST</dispatcher>
  </filter-mapping>

  <filter-mapping>