Amasethi edatha

export interface AvailableDatasets {
    /**
     * Uhlu lwamasethi edatha.
     */
    datasets: Dataset[];
}

export interface Dataset {
    /**
     * I-ID yesethi yedatha.
     */
    id: string;

    /**
     * Igama lesethi yedatha.
     */
    name: string;

    /**
     * Iwebhusayithi yesethi yedatha.
     */
    website: string;

    /**
     * I-URL lapho ilayisensi yesethi yedatha ingatholakala khona.
     */
    licenseUrl: string;

    /**
     * Igama lesiNgisi lesethi yedatha.
     */
    englishName: string;

    /**
     * Ithegi yolimi lwezinhlamvu ezintathu ye-ISO 639 lapho isethi yedatha itholakala khona ngokuyinhloko.
     */
    language: string;

    /**
     * Isiqondiso ulimi olubhalwe ngaso.
     * "ltr" ikhombisa ukuthi umbhalo ubhalwe kusukela ohlangothini lwesobunxele lwekhasi kuya kwesokudla.
     * "rtl" ikhombisa ukuthi umbhalo ubhalwe kusukela kwesokudla sekhasi kuya kwesobunxele.
     */
    textDirection: 'ltr' | 'rtl';

    /**
     * Isixhumanisi se-API sohlu lwezincwadi ezitholakalayo zale sethi yedatha.
     */
    listOfBooksApiLink: string;

    /**
     * Uhlu olutholakalayo lwamafomethi.
     */
    availableFormats: ('json' | 'usfm')[];

    /**
     * Inani lezincwadi eziqukethwe kule datha.
     */
    numberOfBooks: number;

    /**
     * Inani eliphelele lezahluko eziqukethwe kule sethi yedatha.
     */
    totalNumberOfChapters: number;

    /**
     * Inani eliphelele lamavesi aqukethwe kule sethi yedatha.
     */
    totalNumberOfVerses: number;

    /**
     * Inani eliphelele lezinkomba ezihlanganisiwe eziqukethwe kule sethi yedatha.
     */
    totalNumberOfReferences: number;

    /**
     * Ithola igama lolimi okukulo isethi yedatha.
     * Akunamsebenzi noma akuchaziwe uma igama lolimi lingaziwa.
     */
    languageName?: string;

    /**
     * Uthola igama lolimi ngesiNgisi.
     * Akunamsebenzi noma akuchaziwe uma ulimi lungenalo igama lesiNgisi.
     */
    languageEnglishName?: string;

    /**
     * Izixhumanisi ze-API zohlu lwezinhlangano kusethi yedatha.
     * Kushiywe uma isethi yedatha ingenazo izinto ezihambisanayo.
     */
    listOfPeopleApiLink?: string;
    listOfPlacesApiLink?: string;
    listOfEventsApiLink?: string;
    listOfPeopleGroupsApiLink?: string;

    /**
     * Inani eliphelele lezinhlangano eziqukethwe kusethi yedatha.
     * Kushiywe uma isethi yedatha ingenazo izinto ezihambisanayo.
     */
    totalNumberOfPeople?: number;
    totalNumberOfPlaces?: number;
    totalNumberOfEvents?: number;
    totalNumberOfPeopleGroups?: number;
}

export interface DatasetBooks {
    /**
     * Ulwazi lweqoqo ledatha lezincwadi.
     */
    dataset: Dataset;

    /**
     * Uhlu lwezincwadi ezitholakalayo zedatha.
     */
    books: DatasetBook[];
}

interface DatasetBook {
    /**
     * I-ID yencwadi.
     * Ihambisana nobunikazi bencwadi ehambisanayo eBhayibhelini (GEN, EXO, njll.).
     */
    id: string;

    /**
     * Ukuhleleka kwencwadi eBhayibhelini.
     */
    order: number;

    /**
     * Inombolo yesahluko sokuqala encwadini.
     */
    firstChapterNumber: number;

    /**
     * Isixhumanisi sesahluko sokuqala sencwadi.
     */
    firstChapterApiLink: string | null;

    /**
     * Inombolo yesahluko sokugcina encwadini.
     */
    lastChapterNumber: number | null;

    /**
     * Isixhumanisi sesahluko sokugcina sencwadi.
     */
    lastChapterApiLink: string | null;

    /**
     * Inani lezahluko eziqukethwe yile ncwadi.
     */
    numberOfChapters: number;

    /**
     * Inani lamavesi aqukethwe yile ncwadi.
     */
    totalNumberOfVerses: number;

    /**
     * Inani eliphelele lezikhombo ezihambisanayo eziqukethwe yile ncwadi.
     */
    totalNumberOfReferences: number;
}

export interface DatasetBookChapter {
    /**
     * Ulwazi lweqoqo ledatha lesahluko sencwadi.
     */
    dataset: Dataset;

    /**
     * Ulwazi lwencwadi lwesahluko sencwadi.
     */
    book: DatasetBook;

    /**
     * Isixhumanisi salesi sahluko.
     */
    thisChapterLink: string;

    /**
     * Isixhumanisi sesahluko esilandelayo.
     * Akunamsebenzi uma lesi kuyisahluko sokugcina kusethi yedatha.
     */
    nextChapterApiLink: string | null;

    /**
     * Isixhumanisi sesahluko esedlule.
     * Akunamsebenzi uma lesi kuyisahluko sokuqala kusethi yedatha.
     */
    previousChapterApiLink: string | null;

    /**
     * Inani lamavesi aqukethwe yisahluko.
     */
    numberOfVerses: number;

    /**
     * Ulwazi lwesahluko.
     */
    chapter: DatasetChapterData;
}

interface DatasetChapterData {
    /**
     * Inombolo yesahluko.
     */
    number: number;

    /**
     * Okuqukethwe kwesahluko.
     */
    content: DatasetVerse[];
}

interface DatasetVerse {
    /**
     * Inombolo yevesi.
     */
    verse: number;

    /**
     * Izinkomba zevesi.
     *
     * Kuhlungwe ngesilinganiso, kwehle.
     */
    references: DatasetReference[];
}

interface DatasetReference {
    /**
     * I-ID yencwadi okubhekiselwa kuyo.
     */
    book: string;

    /**
     * Inombolo yesahluko.
     */
    chapter: number;

    /**
     * Inombolo yevesi.
     * Uma `endVerse` ekhona, khona-ke leli yivesi lapho inkomba iqala khona.
     */
    verse: number;

    /**
     * Ivesi okukhulunywa ngalo liphetha ngalo.
     */
    endVerse?: number;

    /**
     * Isilinganiso sokufaneleka sereferensi.
     */
    score?: number;
}

export interface DatasetEntityRef {
    /**
     * I-ID yebhizinisi okubhekiselwa kulo.
     */
    id: string;

    /**
     * Uhlobo lwenhlangano okubhekiselwa kuyo.
     * Ifanisa ingxenye yeqoqo lesixhumanisi se-API senhlangano, ngakho-ke isixhumanisi singakhiwa njenge- `/api/d/{dataset}/{type}/{id}.json` .
     */
    type: 'people' | 'places' | 'events' | 'groups';

    /**
     * Igama lenhlangano okubhekiselwa kuyo.
     */
    name?: string;

    /**
     * Isixhumanisi se-API senhlangano okubhekiselwa kuyo.
     */
    apiLink?: string;
}

export interface VerseRef {
    /**
     * I-ID yencwadi (i-GEN, i-EXO, njll.).
     */
    book: string;

    /**
     * Inombolo yesahluko lapho ireferensi iqala khona.
     */
    chapter: number;

    /**
     * Inombolo yevesi lapho ireferensi iqala khona.
     */
    verse: number;

    /**
     * Ivesi okukhulunywa ngalo liphetha ngalo.
     * Amavesi alandelanayo esahlukweni esifanayo aqoqwe abe yinkomba eyodwa.
     */
    endVerse?: number;
}

export interface DatasetEntityBookChapter {
    /**
     * Ulwazi lweqoqo ledatha lesahluko sencwadi.
     */
    dataset: Dataset;

    /**
     * Ulwazi lwencwadi lwesahluko sencwadi.
     */
    book: DatasetBook;

    /**
     * Idatha yenhlangano yesahluko.
     */
    chapter: DatasetEntityChapterData;

    /**
     * Isixhumanisi salesi sahluko.
     */
    thisChapterLink: string;

    /**
     * Isixhumanisi sesahluko esilandelayo.
     * Akunamsebenzi uma lesi kuyisahluko sokugcina kusethi yedatha.
     */
    nextChapterApiLink: string | null;

    /**
     * Isixhumanisi sesahluko esedlule.
     * Akunamsebenzi uma lesi kuyisahluko sokuqala kusethi yedatha.
     */
    previousChapterApiLink: string | null;

    /**
     * Inani labantu, izindawo, kanye nemicimbi evela esahlukweni.
     */
    numberOfPeople: number;
    numberOfPlaces: number;
    numberOfEvents: number;
}

interface DatasetEntityChapterData {
    /**
     * Inombolo yesahluko.
     */
    number: number;

    /**
     * Abantu abavela esahlukweni.
     * Kuhlelwe ngokwevesi lokuqala ezivela kulo.
     */
    people: ChapterPerson[];

    /**
     * Izindawo ezivela esahlukweni.
     * Kuhlelwe ngokwevesi lokuqala ezivela kulo.
     */
    places: ChapterPlace[];

    /**
     * Izehlakalo ezivela esahlukweni.
     * Kuhlelwe ngokwevesi lokuqala ezivela kulo.
     */
    events: ChapterEvent[];
}

interface ChapterPerson {
    /**
     * I-ID yomuntu.
     */
    id: string;

    /**
     * Igama lomuntu.
     */
    name: string;

    /**
     * Ukuthi igama lomuntu liyigama elifanele yini.
     */
    isProperName?: boolean;

    /**
     * Ubulili bomuntu.
     */
    gender?: string;

    /**
     * Unyaka umuntu azalwa ngawo kanye nonyaka ashona ngawo.
     * Izinombolo ezingezinhle ziyiminyaka BC. Izinombolo ezingezinhle ziyiminyaka AD.
     */
    birthYear?: number;
    deathYear?: number;

    /**
     * Isixhumanisi se-API somuntu.
     */
    apiLink: string;

    /**
     * Izinombolo zamavesi esahlukweni akhuluma ngomuntu.
     * Kuhlelwe ngokulandelana okukhuphukayo.
     */
    verses: number[];
}

interface ChapterPlace {
    /**
     * I-ID yendawo.
     */
    id: string;

    /**
     * Igama lendawo.
     */
    name: string;

    /**
     * Uhlobo lwesici sendawo indawo eyiyo.
     */
    featureType?: string;

    /**
     * I-latitude kanye ne-longitude yendawo.
     */
    latitude?: number;
    longitude?: number;

    /**
     * Isixhumanisi se-API sendawo.
     */
    apiLink: string;

    /**
     * Izinombolo zamavesi esahlukweni akhuluma ngendawo.
     * Kuhlelwe ngokulandelana okukhuphukayo.
     */
    verses: number[];
}

interface ChapterEvent {
    /**
     * I-ID yomcimbi.
     */
    id: string;

    /**
     * Igama lomcimbi.
     */
    name: string;

    /**
     * Usuku umcimbi oqale ngalo.
     */
    startDate?: string;

    /**
     * Isixhumanisi se-API somcimbi.
     */
    apiLink: string;

    /**
     * Izinombolo zamavesi esahlukweni achaza lesi senzakalo.
     * Kuhlelwe ngokulandelana okukhuphukayo.
     */
    verses: number[];
}

export interface DatasetPeople {
    /**
     * Ulwazi lwedatha lwabantu.
     */
    dataset: Dataset;

    /**
     * Uhlu lwabantu abatholakalayo kusethi yedatha.
     */
    people: DatasetPersonSummary[];
}

interface DatasetPersonSummary {
    /**
     * I-ID yomuntu.
     */
    id: string;

    /**
     * Igama lomuntu.
     */
    name: string;

    /**
     * Ukuthi igama lomuntu liyigama elifanele yini.
     */
    isProperName?: boolean;

    /**
     * Ubulili bomuntu.
     */
    gender?: string;

    /**
     * Inani lezinkomba zeBhayibheli ezikhuluma ngomuntu.
     */
    numberOfReferences: number;

    /**
     * Isixhumanisi se-API somuntu.
     */
    thisPersonApiLink: string;
}

export interface DatasetPersonResponse {
    /**
     * Ulwazi lwesethi yedatha lomuntu.
     */
    dataset: Dataset;

    /**
     * Ulwazi mayelana nomuntu.
     */
    person: DatasetPerson;

    /**
     * Isixhumanisi se-API salo muntu.
     */
    thisPersonApiLink: string;
}

interface DatasetPerson {
    /**
     * I-ID yomuntu.
     */
    id: string;

    /**
     * Igama lomuntu.
     */
    name: string;

    /**
     * Amanye amagama umuntu abizwa ngawo.
     */
    alsoCalled?: string[];

    /**
     * Ukuthi igama lomuntu liyigama elifanele yini.
     */
    isProperName?: boolean;

    /**
     * Ubulili bomuntu.
     */
    gender?: string;

    /**
     * Incazelo yomuntu. Intambo ngayinye iyisigaba.
     */
    description?: string[];

    /**
     * Unyaka umuntu azalwa ngawo kanye nonyaka ashona ngawo.
     * Izinombolo ezingezinhle ziyiminyaka BC. Izinombolo ezingezinhle ziyiminyaka AD.
     */
    birthYear?: number;
    deathYear?: number;

    /**
     * Iminyaka yokuqala neyamuva lapho umuntu okukhulunywa ngaye.
     */
    minYear?: number;
    maxYear?: number;

    /**
     * Indawo lapho umuntu azalelwa khona futhi wafela khona.
     */
    birthPlace?: DatasetEntityRef;
    deathPlace?: DatasetEntityRef;

    /**
     * Ubudlelwano bomndeni womuntu.
     */
    father?: DatasetEntityRef[];
    mother?: DatasetEntityRef[];
    partners?: DatasetEntityRef[];
    children?: DatasetEntityRef[];
    siblings?: DatasetEntityRef[];
    halfSiblingsSameMother?: DatasetEntityRef[];
    halfSiblingsSameFather?: DatasetEntityRef[];

    /**
     * Amaqembu abantu umuntu ayilungu lawo.
     */
    memberOf?: DatasetEntityRef[];

    /**
     * Imicimbi umuntu ahlanganyele kuyo.
     */
    events?: DatasetEntityRef[];

    /**
     * Uhlu lwezikhombo zeBhayibheli ezikhuluma ngalowo muntu.
     * Kuhlelwe ngokulandelana kwezincwadi, isahluko, namavesi.
     */
    references: VerseRef[];
}

export interface DatasetPlaces {
    /**
     * Ulwazi lwedatha lwezindawo.
     */
    dataset: Dataset;

    /**
     * Uhlu lwezindawo ezitholakalayo kusethi yedatha.
     */
    places: DatasetPlaceSummary[];
}

interface DatasetPlaceSummary {
    /**
     * I-ID yendawo.
     */
    id: string;

    /**
     * Igama lendawo.
     */
    name: string;

    /**
     * Uhlobo lwesici sendawo indawo eyiyo.
     * Isibonelo, "Idolobha", "Isifunda", "Intaba", "Amanzi", njll.
     */
    featureType?: string;

    /**
     * I-latitude kanye ne-longitude yendawo.
     */
    latitude?: number;
    longitude?: number;

    /**
     * Inani lezinkomba zeBhayibheli ezikhuluma ngale ndawo.
     */
    numberOfReferences: number;

    /**
     * Isixhumanisi se-API sendawo.
     */
    thisPlaceApiLink: string;
}

export interface DatasetPlaceResponse {
    /**
     * Ulwazi lwesethi yedatha yendawo.
     */
    dataset: Dataset;

    /**
     * Ulwazi mayelana nendawo.
     */
    place: DatasetPlace;

    /**
     * Isixhumanisi se-API sale ndawo.
     */
    thisPlaceApiLink: string;
}

interface DatasetPlace {
    /**
     * I-ID yendawo.
     */
    id: string;

    /**
     * Igama lendawo.
     */
    name: string;

    /**
     * Igama lendawo njengoba livela ku-King James Version kanye ne-English Standard Version.
     */
    kjvName?: string;
    esvName?: string;

    /**
     * Amanye amagama abizwa ngawo le ndawo.
     */
    aliases?: string[];

    /**
     * Uhlobo lwesici sendawo indawo eyiyo.
     */
    featureType?: string;
    featureSubType?: string;

    /**
     * I-latitude kanye ne-longitude yendawo, nokuthi zinembile kangakanani.
     */
    latitude?: number;
    longitude?: number;
    precision?: string;

    /**
     * Incazelo yendawo. Intambo ngayinye iyisigaba.
     */
    description?: string[];

    /**
     * Amazwana ngendawo avela kubabhali besethi yedatha.
     */
    comment?: string;

    /**
     * Indawo eyinhloko yale ndawo.
     * Amagama ahlukene endawo efanayo anendawo efanayo.
     */
    rootPlace?: DatasetEntityRef;

    /**
     * Indawo lapho le ndawo iyimpinda yayo.
     */
    duplicateOf?: DatasetEntityRef;

    /**
     * Abantu abake baba khona, bazalelwa khona, noma bashona khona.
     */
    people?: DatasetEntityRef[];
    peopleBorn?: DatasetEntityRef[];
    peopleDied?: DatasetEntityRef[];

    /**
     * Izehlakalo ezenzeka endaweni.
     */
    events?: DatasetEntityRef[];

    /**
     * Uhlu lwezikhombo zeBhayibheli ezikhuluma ngale ndawo.
     * Kuhlelwe ngokulandelana kwezincwadi, isahluko, namavesi.
     */
    references: VerseRef[];
}

export interface DatasetEvents {
    /**
     * Ulwazi lwesethi yedatha yemicimbi.
     */
    dataset: Dataset;

    /**
     * Uhlu lwemicimbi etholakalayo kusethi yedatha.
     */
    events: DatasetEventSummary[];
}

interface DatasetEventSummary {
    /**
     * I-ID yomcimbi.
     */
    id: string;

    /**
     * Igama lomcimbi.
     */
    name: string;

    /**
     * Usuku umcimbi oqale ngalo.
     * Izinombolo ezingezinhle ziyiminyaka BC. Izinombolo ezingezinhle ziyiminyaka AD.
     * Izinsuku ezithile zisebenzisa ifomethi ethi `YYYY-MM-DD` .
     */
    startDate?: string;

    /**
     * Inani lezinkomba zeBhayibheli ezichaza lesi senzakalo.
     */
    numberOfReferences: number;

    /**
     * Isixhumanisi se-API somcimbi.
     */
    thisEventApiLink: string;
}

export interface DatasetEventResponse {
    /**
     * Ulwazi lwesethi yedatha lomcimbi.
     */
    dataset: Dataset;

    /**
     * Ulwazi mayelana nomcimbi.
     */
    event: DatasetEvent;

    /**
     * Isixhumanisi se-API salo mcimbi.
     */
    thisEventApiLink: string;
}

interface DatasetEvent {
    /**
     * I-ID yomcimbi.
     */
    id: string;

    /**
     * Igama lomcimbi.
     */
    name: string;

    /**
     * Usuku umcimbi oqale ngalo.
     */
    startDate?: string;

    /**
     * Ubude bomcimbi.
     * Isibonelo, "1D" usuku olulodwa kanti "40Y" iminyaka engamashumi amane.
     */
    duration?: string;

    /**
     * Abantu abahlanganyele kulo mcimbi.
     */
    participants?: DatasetEntityRef[];

    /**
     * Izindawo lapho umcimbi wenzeke khona.
     */
    locations?: DatasetEntityRef[];

    /**
     * Amaqembu abantu abahlanganyele kulo mcimbi.
     */
    groups?: DatasetEntityRef[];

    /**
     * Umcimbi lo mcimbi oyingxenye yawo.
     */
    partOf?: DatasetEntityRef;

    /**
     * Isenzakalo esenzeka ngaphambi kwalesi senzakalo.
     */
    predecessor?: DatasetEntityRef;

    /**
     * Uhlu lwezikhombo zeBhayibheli ezichaza lesi senzakalo.
     * Kuhlelwe ngokulandelana kwezincwadi, isahluko, namavesi.
     */
    references: VerseRef[];
}

export interface DatasetPeopleGroups {
    /**
     * Ulwazi lweqoqo ledatha lamaqembu abantu.
     */
    dataset: Dataset;

    /**
     * Uhlu lwamaqembu abantu atholakalayo kusethi yedatha.
     */
    groups: DatasetPeopleGroupSummary[];
}

interface DatasetPeopleGroupSummary {
    /**
     * I-ID yeqembu labantu.
     */
    id: string;

    /**
     * Igama leqembu labantu.
     */
    name: string;

    /**
     * Inani labantu abangamalungu eqembu labantu.
     */
    numberOfMembers: number;

    /**
     * Isixhumanisi se-API seqembu labantu.
     */
    thisPeopleGroupApiLink: string;
}

export interface DatasetPeopleGroupResponse {
    /**
     * Ulwazi lwesethi yedatha yeqembu labantu.
     */
    dataset: Dataset;

    /**
     * Ulwazi mayelana neqembu labantu.
     */
    group: DatasetPeopleGroup;

    /**
     * Isixhumanisi se-API saleli qembu labantu.
     */
    thisPeopleGroupApiLink: string;
}

interface DatasetPeopleGroup {
    /**
     * I-ID yeqembu labantu.
     */
    id: string;

    /**
     * Igama leqembu labantu.
     */
    name: string;

    /**
     * Abantu abangamalungu eqembu labantu.
     */
    members?: DatasetEntityRef[];

    /**
     * Imicimbi iqembu labantu elalihlanganyela kuyo.
     */
    events?: DatasetEntityRef[];

    /**
     * Uhlu lwezikhombo zeBhayibheli ezikhuluma ngeqembu labantu.
     * Kuhlelwe ngokulandelana kwezincwadi, isahluko, namavesi.
     */
    references: VerseRef[];
}