quran-search-engine

quran-search-engine Stateless, UI-agnostic Quran (Qur'an) search engine for Arabic text in pure TypeScript: Boolean Search: logic operators (AND, OR, NOT) and grouping (...) to create complex queries Arabic normalization Exact text search Lemma + root matching (via morphology + word map) Inverted index for O(1) lemma/root lookups (buildInvertedIndex / loadInvertedIndex) Semantic search (concept-based mapping) Phonetic search with fuzzy fallback (e.g. "Bismillah" -> "بسم الله") Regex search with ReDoS safety validation (validateRegex for UI-side input checking) Range search by sura/aya coordinates (e.g. 2:255, 1:1-7, 2:) Highlight ranges (UI-agnostic) Built-in LRU cache for repeated queries Table of contents Why this library Installation Development Setup Quickstart Public API Error Handling How scoring works Multi-word search Caching with LRUCache Performance Optimization Web Worker Offloading Core types Non-goals Example apps Testing Development Contributing Acknowledgments License Why this library Most Quran search solutions are: tightly coupled to a UI server-bound or stateful hard to customize or extend weakly typed quran-search-engine is designed to be: