quran-meta/lib_es/findThumunAlHizb.mjs

Library with meta data and functionality related to Holy Quran

import { checkValidSurah } from "./validation.mjs";
import { findAyahIdBySurah } from "./findAyahIdBySurah.mjs";
import { findThumunAlHizbByAyahId } from "./findThumunAlHizbByAyahId.mjs";

//#region src/findThumunAlHizb.ts
/**
* Finds the Juz (part) and thumun-ul-Hizb (Eighth section) of the Quran that the given Ayah (verse) belongs to.
*
* @param surah - The Surah (chapter) number.
* @param ayah - The Ayah (verse) number. Defaults to 1 if not provided.
*  @param riwaya - The riwaya. Defaults to "Qalun" if not provided.
* @returns An object containing the Juz (part) number, Hizb (section) number, and the index of the Hizb that the given Ayah belongs to.
*/
function findThumunAlHizb(surah, ayah = 1, data) {
	checkValidSurah(surah, data.meta);
	return findThumunAlHizbByAyahId(findAyahIdBySurah(surah, ayah, data), data);
}

//#endregion
export { findThumunAlHizb };