TypeScript types

import type {
  QuranText,
  ScoredQuranText,
  SearchResponse,
  SearchOptions,
  SearchCounts,
  MorphologyAya,
  WordMap,
  MatchType,
  HighlightRange,
  PaginationOptions,
} from 'quran-search-engine';

export type QuranText = {
  sura_id: number;
  aya_id_display: string;
  uthmani: string;
  gid: number;
  aya_id: number;
  page_id: number;
  juz_id: number;
  standard: string;
  standard_full: string;
  sura_name: string;
  sura_name_en: string;
  sura_name_romanization: string;
};

export type ScoredQuranText = QuranText & {
  matchScore: number;
  matchType: MatchType;
  matchedTokens: string[];
  tokenTypes?: Record<string, MatchType>;
};

export type SearchResponse = {
  results: ScoredQuranText[];
  counts: SearchCounts;
  pagination: {
    totalResults: number;
    totalPages: number;
    currentPage: number;
    limit: number;
  };
};

export type SearchOptions = {
  lemma: boolean;
  root: boolean;
  fuzzy?: boolean;
};

export type SearchCounts = {
  simple: number;
  lemma: number;
  root: number;
  fuzzy: number;
  total: number;
};

export type MorphologyAya = {
  gid: number;
  lemmas: string[];
  roots: string[];
};

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

const wordMap: WordMap = await loadWordMap();
// wordMap['الله'] => { lemma: 'الله', root: 'ا ل ه' }

export type MatchType = 'exact' | 'lemma' | 'root' | 'fuzzy' | 'none';

export type HighlightRange = {
  start: number;
  end: number;
  token: string;
  matchType: MatchType;
};

export type PaginationOptions = {
  page?: number;
  limit?: number;
};

const response = search(
  'الله الرحمن',
  quranData,
  morphologyMap,
  wordMap,
  { lemma: true, root: true },
  { page: 2, limit: 20 } // Get page 2 with 20 results per page
);

export type VerseInput = {
  gid: number;
  uthmani: string;
  standard: string;
};

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

type MyVerse = VerseInput & {
  sura: number;
  aya: number;
  translation_en?: string;
};

const myQuranData: MyVerse[] = [
  {
    gid: 1,
    standard: 'بسم الله الرحمن الرحيم',
    uthmani: 'بِسْمِ ٱللَّهِ ٱلرَّحْمَٰنِ ٱلرَّحِيمِ',
    sura: 1,
    aya: 1,
    translation_en: 'In the name of Allah, the Entirely Merciful, the Especially Merciful.',
  },
];

const morphologyMap = new Map<number, MorphologyAya>();
const wordMap: WordMap = {};

const response = search('الله الرحمن', myQuranData, morphologyMap, wordMap, {
  lemma: false,
  root: false,
});
// response.results[0] => { gid: 1, sura: 1, aya: 1, matchType: 'exact', matchScore: 6, ... }