arabic-text-normalizer

Normalize Quranic/Arabic text by removing diacritics, markers, and decorative characters.

Installation

npm install arabic-text-normalizer

Usage

import { normalize } from "arabic-text-normalizer";

// Full normalization (default)
normalize("بِسْمِ اللَّهِ الرَّحْمَٰنِ الرَّحِيمِ");
// => "بسم الله الرحمن الرحيم"

normalize("۞ الْحَمْدُ لِلَّهِ رَبِّ الْعَالَمِينَ ﴿٢﴾");
// => "الحمد لله رب العالمين"

// Selective normalization
normalize("بِسْمِ", { diacritics: false });
// => "بِسْمِ"

Options

All options default to true for full normalization:

| Option | Description | |--------|-------------| | diacritics | Remove harakat/tashkeel; normalize alif madda (آ→ا) and alif wasla (ٱ→ا) | | markers | Remove Quranic markers (sajdah, rub el hizb, end of ayah) | | verseNumbers | Remove verse numbers and ornate brackets | | tatweel | Remove tatweel/kashida elongation character | | smallLetters | Remove small/superscript letters (small alif, waw, ya) | | punctuation | Remove punctuation (periods, commas, colons, semicolons, Arabic punctuation) | | collapseWhitespace | Collapse multiple spaces to single, trim |

What's Preserved

• Hamza forms (أ إ ؤ ئ ء) remain distinct
• Alif maqsura (ى) vs ya (ي) remain distinct
• Teh marbuta (ة) vs heh (ه) remain distinct

License

MIT