Tafsiri, Vitabu, na Sura

export interface AvailableTranslations {
    /**
     * Orodha ya tafsiri.
     */
    translations: Translation[];
}

interface Translation {
    /**
     * Kitambulisho cha tafsiri.
     */
    id: string;

    /**
     * Jina la tafsiri.
     * Kwa kawaida hili ndilo jina la tafsiri katika lugha ya tafsiri.
     */
    name: string;

    /**
     * Jina la tafsiri ya Kiingereza.
     */
    englishName: string;

    /**
     * Tovuti ya tafsiri.
     */
    website: string;

    /**
     * URL ambayo leseni ya tafsiri inaweza kupatikana.
     */
    licenseUrl: string;

    /**
     * Jina fupi la tafsiri.
     */
    shortName: string;

    /**
     * Lebo ya lugha ya ISO 639 yenye herufi 3 ambayo tafsiri hiyo inapatikana hasa.
     */
    language: string;

    /**
     * Hupata jina la lugha ambayo tafsiri ipo.
     * Haifafanuliwa au haijafafanuliwa ikiwa jina la lugha halijulikani.
     */
    languageName?: string;

    /**
     * Anapata jina la lugha hiyo kwa Kiingereza.
     * Haijafafanuliwa au haijafafanuliwa ikiwa lugha haina jina la Kiingereza.
     */
    languageEnglishName?: string;

    /**
     * Mwelekeo ambao lugha imeandikwa.
     * "ltr" inaonyesha kwamba maandishi yameandikwa kutoka upande wa kushoto wa ukurasa kwenda kulia.
     * "rtl" inaonyesha kwamba maandishi yameandikwa kutoka upande wa kulia wa ukurasa kwenda kushoto.
     */
    textDirection: 'ltr' | 'rtl';

    /**
     * Orodha inayopatikana ya miundo.
     */
    availableFormats: ('json' | 'usfm')[];

    /**
     * Kiungo cha API cha orodha ya vitabu vinavyopatikana kwa tafsiri hii.
     */
    listOfBooksApiLink: string;

    /**
     * Idadi ya vitabu vilivyomo katika tafsiri hii.
     *
     * Tafsiri kamili zinapaswa kuwa na idadi sawa ya vitabu kama Biblia (66).
     */
    numberOfBooks: number;

    /**
     * Jumla ya idadi ya sura zilizomo katika tafsiri hii.
     *
     * Tafsiri kamili zinapaswa kuwa na idadi sawa ya sura na Biblia (1,189).
     */
    totalNumberOfChapters: number;

    /**
     * Jumla ya mistari iliyomo katika tafsiri hii.
     *
     * Tafsiri kamili zinapaswa kuwa na idadi sawa ya mistari kama Biblia (karibu 31,102 - baadhi ya tafsiri huondoa mistari kulingana na uwezekano wa kuwepo katika maandishi asilia ya asili).
     */
    totalNumberOfVerses: number;

    /**
     * Jumla ya vitabu vya apokrifa vilivyomo katika tafsiri hii.
     * Imeachwa ikiwa tafsiri haijumuishi apokrifa.
     */
    numberOfApocryphalBooks?: number;

    /**
     * Jumla ya sura za apokrifa zilizomo katika tafsiri hii.
     * Imeachwa ikiwa tafsiri haijumuishi apokrifa.
     */
    totalNumberOfApocryphalChapters?: number;

    /**
     * jumla ya mistari ya apokrifa iliyomo katika tafsiri hii.
     * Imeachwa ikiwa tafsiri haijumuishi apokrifa.
     */
    totalNumberOfApocryphalVerses?: number;
}

export interface TranslationBooks {
    /**
     * Taarifa za tafsiri ya vitabu.
     */
    translation: Translation;

    /**
     * Orodha ya vitabu vinavyopatikana kwa ajili ya tafsiri.
     */
    books: TranslationBook[];
}

interface TranslationBook {
    /**
     * Kitambulisho cha kitabu.
     */
    id: string;

    /**
     * Jina ambalo tafsiri hiyo ilitoa kwa ajili ya kitabu hicho.
     */
    name: string;

    /**
     * Jina la kawaida la kitabu.
     */
    commonName: string;

    /**
     * Kichwa cha kitabu.
     * Kwa kawaida hii ni toleo linaloelezea zaidi jina la kitabu.
     * Kama haipatikani, basi tafsiri haikutoa moja.
     */
    title: string | null;

    /**
     * Mpangilio wa nambari wa kitabu katika tafsiri.
     */
    order: number;

    /**
     * Idadi ya sura ambazo kitabu kina.
     */
    numberOfChapters: number;

    /**
     * Nambari ya sura ya kwanza katika kitabu.
     */
    firstChapterNumber: number;

    /**
     * Kiungo cha sura ya kwanza ya kitabu.
     */
    firstChapterApiLink: string;

    /**
     * Nambari ya sura ya mwisho katika kitabu.
     */
    lastChapterNumber: number;

    /**
     * Kiungo cha sura ya mwisho ya kitabu.
     */
    lastChapterApiLink: string;

    /**
     * Idadi ya mistari iliyomo katika kitabu hicho.
     */
    totalNumberOfVerses: number;

    /**
     * Kama kitabu hicho ni kitabu cha apokrifa.
     * Imeachwa ikiwa tafsiri ni ya kisheria.
     */
    isApocryphal?: boolean;
}