insiemi di dati

export interface AvailableDatasets {
    /**
     * L'elenco dei set di dati.
     */
    datasets: Dataset[];
}

export interface Dataset {
    /**
     * L'ID del set di dati.
     */
    id: string;

    /**
     * Il nome del set di dati.
     */
    name: string;

    /**
     * Il sito web del dataset.
     */
    website: string;

    /**
     * L'URL dove è possibile trovare la licenza per il dataset.
     */
    licenseUrl: string;

    /**
     * Il nome in inglese del dataset.
     */
    englishName: string;

    /**
     * Il tag linguistico ISO 639 di 3 lettere in cui è principalmente contenuto il dataset.
     */
    language: string;

    /**
     * La direzione in cui è scritta la lingua.
     * "ltr" indica che il testo è scritto da sinistra a destra.
     * "rtl" indica che il testo viene scritto da destra a sinistra.
     */
    textDirection: 'ltr' | 'rtl';

    /**
     * Il link API per l'elenco dei libri disponibili per questo set di dati.
     */
    listOfBooksApiLink: string;

    /**
     * Elenco dei formati disponibili.
     */
    availableFormats: ('json' | 'usfm')[];

    /**
     * Il numero di libri contenuti in questo dataset.
     */
    numberOfBooks: number;

    /**
     * Il numero totale di capitoli contenuti in questo dataset.
     */
    totalNumberOfChapters: number;

    /**
     * Il numero totale di versi contenuti in questo dataset.
     */
    totalNumberOfVerses: number;

    /**
     * Il numero totale di riferimenti incrociati contenuti in questo dataset.
     */
    totalNumberOfReferences: number;

    /**
     * Restituisce il nome della lingua in cui si trova il dataset.
     * Valore nullo o indefinito se il nome della lingua non è noto.
     */
    languageName?: string;

    /**
     * Recupera il nome della lingua in inglese.
     * Valore nullo o indefinito se la lingua non ha un nome in inglese.
     */
    languageEnglishName?: string;

    /**
     * I link API per gli elenchi di entità presenti nel dataset.
     * Omesso se il dataset non contiene le entità corrispondenti.
     */
    listOfPeopleApiLink?: string;
    listOfPlacesApiLink?: string;
    listOfEventsApiLink?: string;
    listOfPeopleGroupsApiLink?: string;

    /**
     * Il numero totale di entità contenute nel dataset.
     * Omesso se il dataset non contiene le entità corrispondenti.
     */
    totalNumberOfPeople?: number;
    totalNumberOfPlaces?: number;
    totalNumberOfEvents?: number;
    totalNumberOfPeopleGroups?: number;
}

export interface DatasetBooks {
    /**
     * Le informazioni del dataset relative ai libri.
     */
    dataset: Dataset;

    /**
     * L'elenco dei libri disponibili per il dataset.
     */
    books: DatasetBook[];
}

interface DatasetBook {
    /**
     * L'ID del libro.
     * Corrisponde all'ID del libro corrispondente nella Bibbia (GEN, EXO, ecc.).
     */
    id: string;

    /**
     * L'ordine dei libri nella Bibbia.
     */
    order: number;

    /**
     * Il numero del primo capitolo del libro.
     */
    firstChapterNumber: number;

    /**
     * Il link al primo capitolo del libro.
     */
    firstChapterApiLink: string | null;

    /**
     * Il numero dell'ultimo capitolo del libro.
     */
    lastChapterNumber: number | null;

    /**
     * Il link all'ultimo capitolo del libro.
     */
    lastChapterApiLink: string | null;

    /**
     * Il numero di capitoli che il libro contiene.
     */
    numberOfChapters: number;

    /**
     * Il numero di versi contenuti nel libro.
     */
    totalNumberOfVerses: number;

    /**
     * Il numero totale di riferimenti incrociati contenuti in questo libro.
     */
    totalNumberOfReferences: number;
}

export interface DatasetBookChapter {
    /**
     * Informazioni sul dataset relative al capitolo del libro.
     */
    dataset: Dataset;

    /**
     * Informazioni sul capitolo del libro.
     */
    book: DatasetBook;

    /**
     * Il link a questo capitolo.
     */
    thisChapterLink: string;

    /**
     * Il link al capitolo successivo.
     * Valore nullo se si tratta dell'ultimo capitolo del dataset.
     */
    nextChapterApiLink: string | null;

    /**
     * Il link al capitolo precedente.
     * Valore nullo se si tratta del primo capitolo del dataset.
     */
    previousChapterApiLink: string | null;

    /**
     * Il numero di versetti contenuti nel capitolo.
     */
    numberOfVerses: number;

    /**
     * Le informazioni relative al capitolo.
     */
    chapter: DatasetChapterData;
}

interface DatasetChapterData {
    /**
     * Il numero del capitolo.
     */
    number: number;

    /**
     * Il contenuto del capitolo.
     */
    content: DatasetVerse[];
}

interface DatasetVerse {
    /**
     * Il numero del versetto.
     */
    verse: number;

    /**
     * I riferimenti incrociati per il versetto.
     *
     * Ordinati per punteggio, in ordine decrescente.
     */
    references: DatasetReference[];
}

interface DatasetReference {
    /**
     * L'ID del libro a cui si fa riferimento.
     */
    book: string;

    /**
     * Il numero del capitolo.
     */
    chapter: number;

    /**
     * Il numero del versetto.
     * Se è presente `endVerse` , allora questo è il verso da cui inizia il riferimento.
     */
    verse: number;

    /**
     * Il verso in cui termina il riferimento.
     */
    endVerse?: number;

    /**
     * Il punteggio di rilevanza per il riferimento.
     */
    score?: number;
}

export interface DatasetEntityRef {
    /**
     * L'ID dell'entità a cui si fa riferimento.
     */
    id: string;

    /**
     * Il tipo dell'entità a cui si fa riferimento.
     * Corrisponde al segmento di raccolta del collegamento API dell'entità, quindi il collegamento può essere costruito come `/api/d/{dataset}/{type}/{id}.json` .
     */
    type: 'people' | 'places' | 'events' | 'groups';

    /**
     * Il nome dell'entità a cui si fa riferimento.
     */
    name?: string;

    /**
     * Il link API per l'entità a cui si fa riferimento.
     */
    apiLink?: string;
}

export interface VerseRef {
    /**
     * L'ID del libro (GEN, EXO, ecc.).
     */
    book: string;

    /**
     * Il numero del capitolo da cui inizia il riferimento.
     */
    chapter: number;

    /**
     * Il numero del versetto da cui inizia il riferimento.
     */
    verse: number;

    /**
     * Il verso in cui termina il riferimento.
     * I versi consecutivi dello stesso capitolo sono raggruppati in un unico riferimento.
     */
    endVerse?: number;
}

export interface DatasetEntityBookChapter {
    /**
     * Informazioni sul dataset relative al capitolo del libro.
     */
    dataset: Dataset;

    /**
     * Informazioni sul capitolo del libro.
     */
    book: DatasetBook;

    /**
     * I dati relativi all'entità del capitolo.
     */
    chapter: DatasetEntityChapterData;

    /**
     * Il link a questo capitolo.
     */
    thisChapterLink: string;

    /**
     * Il link al capitolo successivo.
     * Valore nullo se si tratta dell'ultimo capitolo del dataset.
     */
    nextChapterApiLink: string | null;

    /**
     * Il link al capitolo precedente.
     * Valore nullo se si tratta del primo capitolo del dataset.
     */
    previousChapterApiLink: string | null;

    /**
     * Il numero di persone, luoghi ed eventi che compaiono nel capitolo.
     */
    numberOfPeople: number;
    numberOfPlaces: number;
    numberOfEvents: number;
}

interface DatasetEntityChapterData {
    /**
     * Il numero del capitolo.
     */
    number: number;

    /**
     * Le persone che compaiono nel capitolo.
     * Ordinati in base al primo verso in cui compaiono.
     */
    people: ChapterPerson[];

    /**
     * I luoghi che compaiono nel capitolo.
     * Ordinati in base al primo verso in cui compaiono.
     */
    places: ChapterPlace[];

    /**
     * Gli eventi che compaiono nel capitolo.
     * Ordinati in base al primo verso in cui compaiono.
     */
    events: ChapterEvent[];
}

interface ChapterPerson {
    /**
     * L'ID della persona.
     */
    id: string;

    /**
     * Il nome della persona.
     */
    name: string;

    /**
     * Se il nome della persona è un nome proprio.
     */
    isProperName?: boolean;

    /**
     * Il genere della persona.
     */
    gender?: string;

    /**
     * L'anno di nascita e l'anno di morte della persona.
     * I numeri negativi indicano anni a.C. I numeri positivi indicano anni d.C.
     */
    birthYear?: number;
    deathYear?: number;

    /**
     * Il link API per la persona.
     */
    apiLink: string;

    /**
     * I numeri dei versetti del capitolo che menzionano la persona.
     * Ordinati in ordine crescente.
     */
    verses: number[];
}

interface ChapterPlace {
    /**
     * L'identificativo del luogo.
     */
    id: string;

    /**
     * Il nome del luogo.
     */
    name: string;

    /**
     * Il tipo di caratteristica geografica che rappresenta il luogo.
     */
    featureType?: string;

    /**
     * La latitudine e la longitudine del luogo.
     */
    latitude?: number;
    longitude?: number;

    /**
     * Il link API per il luogo.
     */
    apiLink: string;

    /**
     * I numeri dei versetti del capitolo che menzionano il luogo.
     * Ordinati in ordine crescente.
     */
    verses: number[];
}

interface ChapterEvent {
    /**
     * L'ID dell'evento.
     */
    id: string;

    /**
     * Il nome dell'evento.
     */
    name: string;

    /**
     * La data di inizio dell'evento.
     */
    startDate?: string;

    /**
     * Il link API per l'evento.
     */
    apiLink: string;

    /**
     * I numeri dei versetti del capitolo che descrivono l'evento.
     * Ordinati in ordine crescente.
     */
    verses: number[];
}

export interface DatasetPeople {
    /**
     * Le informazioni del set di dati per le persone.
     */
    dataset: Dataset;

    /**
     * L'elenco delle persone disponibili per il dataset.
     */
    people: DatasetPersonSummary[];
}

interface DatasetPersonSummary {
    /**
     * L'ID della persona.
     */
    id: string;

    /**
     * Il nome della persona.
     */
    name: string;

    /**
     * Se il nome della persona è un nome proprio.
     */
    isProperName?: boolean;

    /**
     * Il genere della persona.
     */
    gender?: string;

    /**
     * Il numero di riferimenti biblici che menzionano la persona.
     */
    numberOfReferences: number;

    /**
     * Il link API per la persona.
     */
    thisPersonApiLink: string;
}

export interface DatasetPersonResponse {
    /**
     * Il set di dati contenente le informazioni relative alla persona.
     */
    dataset: Dataset;

    /**
     * Le informazioni sulla persona.
     */
    person: DatasetPerson;

    /**
     * Il link API per questa persona.
     */
    thisPersonApiLink: string;
}

interface DatasetPerson {
    /**
     * L'ID della persona.
     */
    id: string;

    /**
     * Il nome della persona.
     */
    name: string;

    /**
     * Altri nomi con cui la persona viene chiamata.
     */
    alsoCalled?: string[];

    /**
     * Se il nome della persona è un nome proprio.
     */
    isProperName?: boolean;

    /**
     * Il genere della persona.
     */
    gender?: string;

    /**
     * Descrizione della persona. Ogni stringa corrisponde a un paragrafo.
     */
    description?: string[];

    /**
     * L'anno di nascita e l'anno di morte della persona.
     * I numeri negativi indicano anni a.C. I numeri positivi indicano anni d.C.
     */
    birthYear?: number;
    deathYear?: number;

    /**
     * Gli anni in cui la persona viene menzionata, sia il primo che l'ultimo.
     */
    minYear?: number;
    maxYear?: number;

    /**
     * Il luogo in cui la persona è nata e morta.
     */
    birthPlace?: DatasetEntityRef;
    deathPlace?: DatasetEntityRef;

    /**
     * Le relazioni familiari della persona.
     */
    father?: DatasetEntityRef[];
    mother?: DatasetEntityRef[];
    partners?: DatasetEntityRef[];
    children?: DatasetEntityRef[];
    siblings?: DatasetEntityRef[];
    halfSiblingsSameMother?: DatasetEntityRef[];
    halfSiblingsSameFather?: DatasetEntityRef[];

    /**
     * I gruppi di persone di cui la persona fa parte.
     */
    memberOf?: DatasetEntityRef[];

    /**
     * Gli eventi a cui la persona ha partecipato.
     */
    events?: DatasetEntityRef[];

    /**
     * L'elenco dei riferimenti biblici che menzionano la persona.
     * Ordinati per libro, capitolo e versetto.
     */
    references: VerseRef[];
}

export interface DatasetPlaces {
    /**
     * Le informazioni del set di dati relative ai luoghi.
     */
    dataset: Dataset;

    /**
     * L'elenco dei luoghi disponibili per il dataset.
     */
    places: DatasetPlaceSummary[];
}

interface DatasetPlaceSummary {
    /**
     * L'identificativo del luogo.
     */
    id: string;

    /**
     * Il nome del luogo.
     */
    name: string;

    /**
     * Il tipo di caratteristica geografica che rappresenta il luogo.
     * Ad esempio, "Città", "Regione", "Montagna", "Acqua", ecc.
     */
    featureType?: string;

    /**
     * La latitudine e la longitudine del luogo.
     */
    latitude?: number;
    longitude?: number;

    /**
     * Il numero di riferimenti biblici che menzionano il luogo.
     */
    numberOfReferences: number;

    /**
     * Il link API per il luogo.
     */
    thisPlaceApiLink: string;
}

export interface DatasetPlaceResponse {
    /**
     * Le informazioni del dataset relative al luogo.
     */
    dataset: Dataset;

    /**
     * Informazioni sul luogo.
     */
    place: DatasetPlace;

    /**
     * Il link API per questo luogo.
     */
    thisPlaceApiLink: string;
}

interface DatasetPlace {
    /**
     * L'identificativo del luogo.
     */
    id: string;

    /**
     * Il nome del luogo.
     */
    name: string;

    /**
     * Il nome del luogo come appare nella versione di Re Giacomo e nella versione standard inglese.
     */
    kjvName?: string;
    esvName?: string;

    /**
     * Altri nomi con cui è conosciuto il luogo.
     */
    aliases?: string[];

    /**
     * Il tipo di caratteristica geografica che rappresenta il luogo.
     */
    featureType?: string;
    featureSubType?: string;

    /**
     * La latitudine e la longitudine del luogo, e la loro precisione.
     */
    latitude?: number;
    longitude?: number;
    precision?: string;

    /**
     * Descrizione del luogo. Ogni stringa corrisponde a un paragrafo.
     */
    description?: string[];

    /**
     * Il commento sul luogo da parte degli autori del dataset.
     */
    comment?: string;

    /**
     * Il luogo d'origine di questo posto.
     * Nomi diversi per la stessa località geografica condividono la stessa radice.
     */
    rootPlace?: DatasetEntityRef;

    /**
     * Il luogo di cui questo luogo è una copia.
     */
    duplicateOf?: DatasetEntityRef;

    /**
     * Le persone che sono state in quel luogo, che vi sono nate o che vi sono morte.
     */
    people?: DatasetEntityRef[];
    peopleBorn?: DatasetEntityRef[];
    peopleDied?: DatasetEntityRef[];

    /**
     * Gli eventi accaduti in quel luogo.
     */
    events?: DatasetEntityRef[];

    /**
     * L'elenco dei riferimenti biblici che menzionano il luogo.
     * Ordinati per libro, capitolo e versetto.
     */
    references: VerseRef[];
}

export interface DatasetEvents {
    /**
     * Le informazioni del dataset relative agli eventi.
     */
    dataset: Dataset;

    /**
     * Elenco degli eventi disponibili per il dataset.
     */
    events: DatasetEventSummary[];
}

interface DatasetEventSummary {
    /**
     * L'ID dell'evento.
     */
    id: string;

    /**
     * Il nome dell'evento.
     */
    name: string;

    /**
     * La data di inizio dell'evento.
     * I numeri negativi indicano anni a.C. I numeri positivi indicano anni d.C.
     * Per date più specifiche si utilizza il formato `YYYY-MM-DD` .
     */
    startDate?: string;

    /**
     * Il numero di riferimenti biblici che descrivono l'evento.
     */
    numberOfReferences: number;

    /**
     * Il link API per l'evento.
     */
    thisEventApiLink: string;
}

export interface DatasetEventResponse {
    /**
     * Le informazioni del set di dati relative all'evento.
     */
    dataset: Dataset;

    /**
     * Informazioni sull'evento.
     */
    event: DatasetEvent;

    /**
     * Il link API per questo evento.
     */
    thisEventApiLink: string;
}

interface DatasetEvent {
    /**
     * L'ID dell'evento.
     */
    id: string;

    /**
     * Il nome dell'evento.
     */
    name: string;

    /**
     * La data di inizio dell'evento.
     */
    startDate?: string;

    /**
     * La durata dell'evento.
     * Ad esempio, "1D" indica un giorno e "40Y" indica quaranta anni.
     */
    duration?: string;

    /**
     * Le persone che hanno partecipato all'evento.
     */
    participants?: DatasetEntityRef[];

    /**
     * I luoghi in cui si è svolto l'evento.
     */
    locations?: DatasetEntityRef[];

    /**
     * I gruppi etnici che hanno partecipato all'evento.
     */
    groups?: DatasetEntityRef[];

    /**
     * L'evento di cui questo evento fa parte.
     */
    partOf?: DatasetEntityRef;

    /**
     * L'evento accaduto prima di questo evento.
     */
    predecessor?: DatasetEntityRef;

    /**
     * L'elenco dei riferimenti biblici che descrivono l'evento.
     * Ordinati per libro, capitolo e versetto.
     */
    references: VerseRef[];
}

export interface DatasetPeopleGroups {
    /**
     * Il set di dati contenente le informazioni relative ai gruppi di persone.
     */
    dataset: Dataset;

    /**
     * Elenco dei gruppi di persone disponibili per il dataset.
     */
    groups: DatasetPeopleGroupSummary[];
}

interface DatasetPeopleGroupSummary {
    /**
     * L'identità del gruppo di persone.
     */
    id: string;

    /**
     * Il nome del gruppo etnico.
     */
    name: string;

    /**
     * Il numero di persone che appartengono al gruppo etnico.
     */
    numberOfMembers: number;

    /**
     * Il link API per il gruppo di persone.
     */
    thisPeopleGroupApiLink: string;
}

export interface DatasetPeopleGroupResponse {
    /**
     * Le informazioni contenute nel set di dati relative al gruppo di persone.
     */
    dataset: Dataset;

    /**
     * Informazioni sul gruppo etnico.
     */
    group: DatasetPeopleGroup;

    /**
     * Il link API per questo gruppo di persone.
     */
    thisPeopleGroupApiLink: string;
}

interface DatasetPeopleGroup {
    /**
     * L'identità del gruppo di persone.
     */
    id: string;

    /**
     * Il nome del gruppo etnico.
     */
    name: string;

    /**
     * Le persone che appartengono al gruppo etnico.
     */
    members?: DatasetEntityRef[];

    /**
     * Gli eventi a cui ha partecipato il gruppo etnico.
     */
    events?: DatasetEntityRef[];

    /**
     * Elenco dei riferimenti biblici che menzionano questo gruppo etnico.
     * Ordinati per libro, capitolo e versetto.
     */
    references: VerseRef[];
}