*
 * <p>The extractor runs text extraction in a separate thread with a configurable timeout
 * to prevent hanging on problematic PDF files. It also extracts metadata from the PDF
 * document and includes it in the extraction result.
 *
 * <p>Features:
 * <ul>
 *   <li>Text extraction from PDF pages</li>
 *   <li>Embedded document extraction</li>
 *   <li>Annotation extraction (file attachments)</li>

    }

    /**
     * Test extraction with null parameters map.
     */
    public void test_getText_withNullParams() {
        final InputStream in = new ByteArrayInputStream(new byte[0]);

        final ExtractData result = filenameExtractor.getText(in, null);

        assertNotNull(result);
        assertEquals("", result.getContent());
    }

    /**
     * Test extraction with empty parameters map.
     */

            assertTrue("Error message should indicate extraction failure", e.getMessage().contains("Failed to extract"));
        } finally {
            // Reset to default encoding
            textExtractor.setEncoding("UTF-8");
        }
    }

    /**
     * Test extraction with empty input stream.
     */
    public void test_getText_emptyInputStream_returnsEmptyContent() {

 * This extractor provides better structured data extraction compared to Tika's generic text extraction.
 *
 * <p>Features:
 * <ul>
 *   <li>Structured text extraction with key-value pairs</li>
 *   <li>Top-level field extraction as metadata</li>
 *   <li>Nested structure flattening with configurable depth</li>
 *   <li>Array element extraction</li>
 *   <li>Configurable field separator and array formatting</li>
 * </ul>

 * The builder allows setting parameters such as MIME type, filename, extractor name, maximum content length,
 * and cache file size to optimize the extraction process.
 *
 * <p>
 * The main purpose of this class is to simplify the extraction process by providing a fluent interface
 * for configuring the extraction parameters and handling the underlying complexities of content processing,

 * This extractor provides better structured data extraction compared to Tika's generic text extraction.
 *
 * <p>Features:
 * <ul>
 *   <li>YAML front matter metadata extraction</li>
 *   <li>Heading structure extraction</li>
 *   <li>Link URL extraction</li>
 *   <li>Code block content extraction</li>
 *   <li>Clean text conversion from Markdown</li>
 *   <li>Configurable encoding</li>

                .singleton("textExtractor", TextExtractor.class);
    }

    /**
     * Test that MsWordExtractor properly closes resources on successful extraction.
     */
    public void test_MsWordExtractor_closesResourcesOnSuccess() throws IOException {
        final MsWordExtractor extractor = container.getComponent("msWordExtractor");

     *
     * @param in the input stream containing the LHA archive
     * @param params extraction parameters
     * @return the extracted text data
     * @throws CrawlerSystemException if the input stream is null
     * @throws ExtractException if an error occurs during extraction
     * @throws MaxLengthExceededException if the extracted content size exceeds the maximum limit
     */
    @Override

    /**
     * Default character encoding for content extraction.
     */
    protected String encoding = Constants.UTF_8;

    /**
     * The preload size for charset detection.
     */
    protected int preloadSizeForCharset = 2048;

    /**
     * Indicates whether comment tags should be ignored during extraction.
     */
    protected boolean ignoreCommentTag = false;

    /**

**Key Test Areas**:
- Resource closure on successful extraction (MS Office extractors)
- Resource closure on failed extraction
- Improved error messages with context
- Input validation using `validateInputStream()`

**Covered Extractors**:
- MsWordExtractor
- MsExcelExtractor
- MsPowerPointExtractor
- TextExtractor

**Test Count**: 8 tests

**Key Scenarios**:
- ✅ Successful extraction closes resources properly