quran-meta/lib_cjs/isSurahAyahJuzFirst.cjs

Library with meta data and functionality related to Holy Quran

const require_validation = require('./validation.cjs');
const require_findAyahIdBySurah = require('./findAyahIdBySurah.cjs');
const require_juzList = require('./lists/juzList.cjs');
const require_utils = require('./utils.cjs');

//#region src/isSurahAyahJuzFirst.ts
/**
* Determines if a given Surah and Ayah combination marks the beginning of a Juz.
*
* @param surah - The Surah number to check
* @param ayah - The Ayah number within the Surah to check
* @returns The Juz number if the combination marks the start of a Juz, -1 otherwise
* @throws Error When the provided Surah number is invalid
*
* @example
* ```typescript
* isSurahAyahJuzFirst(2, 142) // Returns 2
* isSurahAyahJuzFirst(2, 143) // Returns -1
* ```
*/
function isSurahAyahJuzFirst(surah, ayah) {
	require_validation.checkValidSurah(surah);
	const ayahId = require_findAyahIdBySurah.findAyahIdBySurah(surah, ayah);
	return require_utils.binarySearch(require_juzList.JuzList, ayahId);
}

//#endregion
exports.isSurahAyahJuzFirst = isSurahAyahJuzFirst;