import { RiwayaData } from "./lists/types.cjs";
import { AyahNo, Juz, Surah } from "./types.cjs";

//#region src/isSurahAyahJuzFirst.d.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
 * @param data - The Lists object for the riwaya.
 * @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, HafsLists) // Returns 2
 * isSurahAyahJuzFirst(2, 143, HafsLists) // Returns -1
 * ```
 */
declare function isSurahAyahJuzFirst(surah: Surah, ayah: AyahNo, data: RiwayaData): Juz | number;
//#endregion
export { isSurahAyahJuzFirst };