}

    }

    /**
     * Sets the encoding for the output.
     * @param outputEncoding The output encoding to set.
     */
    public void setOutputEncoding(final String outputEncoding) {
        this.outputEncoding = outputEncoding;
    }

    /**
     * Sets the output file extension.
     * @param outputExtension The output file extension to set.
     */

            if (expand) {
                queue.add(synonym);
            }

            // enqueue synonyms
            bytesReader.reset(synonym.output.bytes, synonym.output.offset, synonym.output.length);
            final int code = bytesReader.readVInt();
            final int count = code >>> 1;
            for (int i = 0; i < count; i++) {

    /** Temporary directory for file operations. */
    protected File tempDir = null;

    /** Output encoding for extracted text. */
    protected String outputEncoding = Constants.UTF_8;

    /** Map of input file extensions to output extensions. */
    private final Map<String, String> extensionMap = new HashMap<>();

    /** Map of output extensions to their corresponding extractors. */

            return mimeTypeHelper.getContentType(is, filename);
        }
    }

    /**
     * Gets an input stream for the content in the deferred file output stream.
     *
     * @param out the deferred file output stream
     * @return the input stream for the content
     * @throws IOException if an I/O error occurs
     */

        return parseContext;
    }

    /**
     * Returns an input stream from a deferred file output stream.
     *
     * @param dfos A deferred file output stream.
     * @return An input stream.
     * @throws IOException if an I/O error occurs.
     */

 * to parse the HTML content, evaluate XPath expressions, and generate the XML output.
 * </p>
 * <p>
 * The class supports various XPath result types, including BOOLEAN, NUMBER, STRING, NODESET, and NODE.
 * It also provides options to trim whitespace from extracted values and to specify the character encoding for the output.
 * </p>
 * <p>

 * </p>
 *
 * <p>
 * The class also utilizes ICU4J's {@link com.ibm.icu.text.Transliterator} to convert full-width characters
 * to half-width and to convert any characters to lowercase, ensuring consistency in the output.
 * </p>
 *
 * <p>
 * Example:
 * For the input "キャ", the converter might return a list containing "kya".
 * For the input "ジュ", the converter might return a list containing "zyu", "ju", and "jyu".
 * </p>
 *

The project uses JUnit 4 with embedded OpenSearch for integration testing:

```bash
# Run all tests
mvn test

# Run specific test class
mvn test -Dtest=SuggesterTest

# Run with verbose output
mvn surefire:test -Dmaven.surefire.debug=true
```

### Running Tests with Coverage

```bash
mvn clean jacoco:prepare-agent test jacoco:report
```