protected class LangAnalyzerNormalizer implements Normalizer {
        /**
         * The language used for normalization.
         */
        protected final String lang;

        /**
         * Constructs a LangAnalyzerNormalizer with the specified language.
         *
         * @param lang the language to use for normalization
         */
        protected LangAnalyzerNormalizer(final String lang) {
            this.lang = lang;

/**
 * ICUNormalizer is a class that implements the Normalizer interface and provides
 * functionality to normalize text using ICU4J's Transliterator.
 *
 * <p>This class uses a specified Transliterator to perform text normalization.
 * The Transliterator is initialized with a given ID during the construction of
 * the ICUNormalizer instance.</p>
 *
 * <p>Example usage:</p>
 * <pre>

  testImplementation(libs.junit)
  testImplementation(libs.kotlin.test.common)
  testImplementation(libs.kotlin.test.junit)
  testImplementation(libs.assertk)

  testImplementation(libs.aqute.resolve)
}

normalization {
  runtimeClasspath {
    /*
       - The below two ignored files are generated during test execution
       by the test: okhttp/src/test/java/okhttp3/osgi/OsgiTest.java

import jakarta.annotation.PostConstruct;

/**
 * Creator for character mapping dictionary files.
 * Handles the creation and management of character mapping dictionaries used for text normalization.
 */
public class CharMappingCreator extends DictionaryCreator {
    private static final Logger logger = LogManager.getLogger(CharMappingCreator.class);

    /**

tasks.register("downloadDependencies") {
  description = "Download all dependencies to the Gradle cache"
  doLast {
    for (configuration in resolvableConfigurations) {
      configuration.files
    }
  }
}

normalization {
  runtimeClasspath {
    metaInf {
      ignoreAttribute("Bnd-LastModified")
    }
  }

/**
 * Helper class for document processing and manipulation in the Fess search system.
 * This class provides utilities for processing document content, titles, and digests,
 * handling text normalization, content extraction, and similar document hash encoding/decoding.
 * It also manages document processing requests and integrates with the crawler system.
 *
 */
public class DocumentHelper {

 * It also handles the conversion of voiced and semi-voiced sound marks.
 *
 * <p>This class provides the following functionalities:</p>
 * <ul>
 *   <li>Normalization of a string containing Hankaku Kana to Zenkaku Kana.</li>
 *   <li>Conversion of individual Hankaku Kana characters to Zenkaku Kana characters.</li>

- **SitemapsHelper**: Sitemap XML parsing, index handling
- **MimeTypeHelper**: MIME detection via Tika
- **EncodingHelper**: Charset detection with BOM
- **UrlConvertHelper**: URL normalization
- **ContentLengthHelper**: Content length limits per MIME type

---

## Development Workflow

### Build Commands

```bash
mvn clean install              # Build all

    private final Supplier<String[]> badWordsSupplier;

    /**
     * Constructor.
     *
     * @param settings The suggest settings
     * @param normalizer The normalizer for word normalization
     * @param indexingOps The indexing operations for writing items
     * @param deletionOps The deletion operations for removing items

Aliases:
├── Search Alias: {baseIndex}          (read operations)
└── Update Alias: {baseIndex}.update   (write operations)
```

### Text Processing Pipeline

```
Input Text
    ↓
[Normalization] - NormalizerChain
    ↓
[Reading Conversion] - ReadingConverterChain
    ↓
[Analysis] - SuggestAnalyzer
```

Note: Suggester has TWO ReadingConverter instances:
- `readingConverter` - For query/metadata fields