Quran book & Hadith books jsons

Content

quran.json : Contains the complete list of all 114 Surahs with detailed Ayah metadata.

the_9_books.json : Contains the major compilations of Hadith (Sahih al-Bukhari, Sahih Muslim, Sunan an-Nasa'i, etc.) fully categorized by book and chapter.

forties.json : Contains the specialized collections: Hadith al-Nawawi and Hadith Qudsi.

other_books.json : Contains additional famous compilations of Hadith that complement the primary nine collections.

Usage (type.ts)

/***** Quran json Types *****/

export class Surah {
    id: number;                // Unique ID of the Surah (1 to 114)
    name: string;              // Name of the Surah in Arabic
    type: 'مكية' | 'مدنية';      // Revelation type: Meccan ('مكية') or Medinan ('مدنية')
    total: number;             // Total number of Ayahs in this Surah
    ayahs: Ayah[];             // Array of Ayah objects containing text and metadata
}

export class Ayah {
    id: number;                // Sequential ID of the Ayah within the Surah
    text: string;              // Arabic text with diacritics (Tashkeel)
    text_simple: string;       // Plain Arabic text without diacritics for easier search indexing
    text_en: string;           // English transliteration text
    tafsir: string;            // Arabic textual explanation (Tafsir) of the Ayah
    part?: number;             // Optional: Indicates the start of a new Juz' (1 to 30)
    hizb?: number;             // Optional: Indicates the start of a new Hizb (1 to 60)
    sajda?: boolean;           // Optional: True if this Ayah is an Ayah of Sajda
}

// Usage :
const surahs: Surah[] = quran.json;


/***** Hadith Books json Types *****/

export class HadithsBook {
    id: number;                 // Unique ID of the Hadith book
    title: string;              // Arabic title of the book
    total: number;              // Total number of Hadiths contained
    chapters: HadithsChapter[]; // Array of chapters belonging to this book
}

export interface HadithsChapter {
    id: number;                 // Unique ID of the chapter within this book
    title: string;              // Arabic title of the chapter
    hadiths: Hadith[];          // Array of Hadiths belonging to this chapter
}

export interface Hadith {
    id: number;                 // Global sequential ID across the entire book
    text: string;               // Full Arabic text of the Hadith
}

// Usage :
const the_9_books: HadithsBook[] = the_9_books.json;