loadWordMap()

export const loadWordMap = async (): Promise<WordMap>

type WordMap = {
  [key: string]: {
    lemma?: string;
    root?: string;
  };
};

import { loadWordMap, type WordMap } from 'quran-search-engine';

const wordMap: WordMap = await loadWordMap();

// Look up a specific word
console.log(wordMap['الله']);
// => { lemma: 'الله', root: 'ا ل ه' }

console.log(wordMap['الرحمن']);
// => { lemma: 'الرحمن', root: 'ر ح م' }

// Total unique words in the map
console.log(Object.keys(wordMap).length);
// => (varies by dataset version)

import {
  search,
  loadQuranData,
  loadMorphology,
  loadWordMap,
} from 'quran-search-engine';

const [quranData, morphologyMap, wordMap] = await Promise.all([
  loadQuranData(),
  loadMorphology(),
  loadWordMap(),
]);

// When you search for 'الله الرحمن', the search function:
// 1. Normalizes the query tokens
// 2. Looks up each token in wordMap to find its lemma/root
// 3. Uses those forms to match against verse morphology data

const response = search('الله الرحمن', quranData, morphologyMap, wordMap, {
  lemma: true,  // Uses wordMap to resolve query lemmas
  root: true,   // Uses wordMap to resolve query roots
});

// User searches for a word
const query = 'الله';

// 1. Query is normalized
// 2. Lookup in wordMap
const mapping = wordMap['الله'];
// => { lemma: 'الله', root: 'ا ل ه' }

// 3. Search can now match:
//    - Exact: 'الله'
//    - Lemma: any word with lemma 'الله'
//    - Root: any word with root 'ا ل ه'

try {
  const wordMap = await loadWordMap();
} catch (error) {
  console.error('Failed to load word map:', error);
  // Error: Could not load word map data. Ensure src/data/word-map.json exists.
}

import { search, loadQuranData } from 'quran-search-engine';

const quranData = await loadQuranData();

// Use empty object if word map not needed
const response = search('الله', quranData, new Map(), {}, {
  lemma: false,
  root: false,
});
// Only exact text matching will be performed