Traducciones, libros y capítulos

export interface AvailableTranslations {
    /**
     * La lista de traducciones.
     */
    translations: Translation[];
}

interface Translation {
    /**
     * El ID de la traducción.
     */
    id: string;

    /**
     * El nombre de la traducción.
     * Normalmente, este es el nombre de la traducción en el idioma de la traducción.
     */
    name: string;

    /**
     * El nombre en inglés de la traducción.
     */
    englishName: string;

    /**
     * El sitio web para la traducción.
     */
    website: string;

    /**
     * La URL donde se puede encontrar la licencia de la traducción.
     */
    licenseUrl: string;

    /**
     * El nombre abreviado de la traducción.
     */
    shortName: string;

    /**
     * La etiqueta de idioma de 3 letras ISO 639 en la que se encuentra principalmente la traducción.
     */
    language: string;

    /**
     * Obtiene el nombre del idioma en el que está la traducción.
     * Nulo o indefinido si se desconoce el nombre del idioma.
     */
    languageName?: string;

    /**
     * Obtiene el nombre del idioma en inglés.
     * Nulo o indefinido si el idioma no tiene un nombre en inglés.
     */
    languageEnglishName?: string;

    /**
     * La dirección en la que está escrito el idioma.
     * "ltr" indica que el texto se escribe desde el lado izquierdo de la página hacia la derecha.
     * "rtl" indica que el texto se escribe desde el lado derecho de la página hacia la izquierda.
     */
    textDirection: 'ltr' | 'rtl';

    /**
     * La lista de formatos disponibles.
     */
    availableFormats: ('json' | 'usfm')[];

    /**
     * Enlace API para la lista de libros disponibles para esta traducción.
     */
    listOfBooksApiLink: string;

    /**
     * El número de libros que contiene esta traducción.
     *
     * Las traducciones completas deberían tener el mismo número de libros que la Biblia (66).
     */
    numberOfBooks: number;

    /**
     * El número total de capítulos que contiene esta traducción.
     *
     * Las traducciones completas deberían tener el mismo número de capítulos que la Biblia (1.189).
     */
    totalNumberOfChapters: number;

    /**
     * El número total de versículos que contiene esta traducción.
     *
     * Las traducciones completas deberían tener el mismo número de versículos que la Biblia (alrededor de 31.102; algunas traducciones excluyen versículos basándose en la aparente probabilidad de que existan en los textos originales).
     */
    totalNumberOfVerses: number;

    /**
     * El número total de libros apócrifos que contiene esta traducción.
     * Se omite si la traducción no incluye los apócrifos.
     */
    numberOfApocryphalBooks?: number;

    /**
     * El número total de capítulos apócrifos que contiene esta traducción.
     * Se omite si la traducción no incluye los apócrifos.
     */
    totalNumberOfApocryphalChapters?: number;

    /**
     * el número total de versículos apócrifos que contiene esta traducción.
     * Se omite si la traducción no incluye los apócrifos.
     */
    totalNumberOfApocryphalVerses?: number;
}

export interface TranslationBooks {
    /**
     * La información de traducción de los libros.
     */
    translation: Translation;

    /**
     * Lista de libros disponibles para su traducción.
     */
    books: TranslationBook[];
}

interface TranslationBook {
    /**
     * La identificación del libro.
     */
    id: string;

    /**
     * El nombre que la traducción proporcionó para el libro.
     */
    name: string;

    /**
     * El nombre común del libro.
     */
    commonName: string;

    /**
     * El título del libro.
     * Normalmente, esta es una versión más descriptiva del título del libro.
     * Si no está disponible, entonces no fue proporcionada por la traducción.
     */
    title: string | null;

    /**
     * El orden numérico del libro en la traducción.
     */
    order: number;

    /**
     * El número de capítulos que contiene el libro.
     */
    numberOfChapters: number;

    /**
     * El número del primer capítulo del libro.
     */
    firstChapterNumber: number;

    /**
     * Enlace al primer capítulo del libro.
     */
    firstChapterApiLink: string;

    /**
     * El número del último capítulo del libro.
     */
    lastChapterNumber: number;

    /**
     * El enlace al último capítulo del libro.
     */
    lastChapterApiLink: string;

    /**
     * El número de versículos que contiene el libro.
     */
    totalNumberOfVerses: number;

    /**
     * Si el libro es apócrifo o no.
     * Se omite si la traducción es canónica.
     */
    isApocryphal?: boolean;
}