quran-meta/src/findSurahByAyahId.ts

Library with meta data and functionality related to Holy Quran

import { SurahList as findSurahByAyahIdModule } from "./lists/surahList"
import { AyahId, Surah, SurahAyah } from "./types"
import { checkValidAyahId } from "./validation"

/**
 * Finds the Surah (chapter) and Ayah (verse) numbers that the given Ayah ID belongs to.
 *
 * @param ayaId - The Ayah ID to find the Surah and Ayah numbers for.
 * @returns An array containing the Surah number and the Ayah number within that Surah.
 */
export function findSurahByAyahId(ayaId: AyahId): SurahAyah {
  checkValidAyahId(ayaId)

  const suraNum: Surah = findSurahByAyahIdModule.findIndex(x => x[0] > ayaId) - 1
  return [suraNum, ayaId - findSurahByAyahIdModule[suraNum][0] + 1]
}