译文、书籍和章节

export interface AvailableTranslations {
    /**
     * 译文列表。
     */
    translations: Translation[];
}

interface Translation {
    /**
     * 翻译的ID。
     */
    id: string;

    /**
     * 译文名称。
     * 这通常是译文在译文语言中的名称。
     */
    name: string;

    /**
     * 译文的英文名称。
     */
    englishName: string;

    /**
     * 翻译网站。
     */
    website: string;

    /**
     * 翻译许可证的网址。
     */
    licenseUrl: string;

    /**
     * 翻译的简称。
     */
    shortName: string;

    /**
     * 翻译主要使用的 ISO 639 三字母语言标签。
     */
    language: string;

    /**
     * 获取翻译所使用的语言名称。
     * 如果语言名称未知，则返回 null 或 undefined。
     */
    languageName?: string;

    /**
     * 获取该语言的英文名称。
     * 如果该语言没有英文名称，则返回 null 或 undefined。
     */
    languageEnglishName?: string;

    /**
     * 语言的书写方向。
     * “ltr”表示文本是从页面左侧向右侧书写的。
     * “rtl”表示文本是从页面右侧向左侧书写的。
     */
    textDirection: 'ltr' | 'rtl';

    /**
     * 可用的格式列表。
     */
    availableFormats: ('json' | 'usfm')[];

    /**
     * 此译本可用书籍列表的 API 链接。
     */
    listOfBooksApiLink: string;

    /**
     * 本译本包含的书籍数量。
     *
     * 完整的译本应该与圣经的卷数相同（66卷）。
     */
    numberOfBooks: number;

    /**
     * 本译本共包含章节总数。
     *
     * 完整的译本应该与圣经的章节数相同（1,189）。
     */
    totalNumberOfChapters: number;

    /**
     * 本译本共包含的诗节总数。
     *
     * 完整的译本应该与圣经的经文数量相同（大约 31,102 节——有些译本根据原文中可能存在的经文数量排除了某些经文）。
     */
    totalNumberOfVerses: number;

    /**
     * 此译本中包含的伪经总数。
     * 如果译文不包含伪经，则省略。
     */
    numberOfApocryphalBooks?: number;

    /**
     * 本译本中包含的伪经章节总数。
     * 如果译文不包含伪经，则省略。
     */
    totalNumberOfApocryphalChapters?: number;

    /**
     * 本译本中包含的伪经经文总数。
     * 如果译文不包含伪经，则省略。
     */
    totalNumberOfApocryphalVerses?: number;
}

export interface TranslationBooks {
    /**
     * 书籍的翻译信息。
     */
    translation: Translation;

    /**
     * 可供翻译的书籍清单。
     */
    books: TranslationBook[];
}

interface TranslationBook {
    /**
     * 这本书的ID。
     */
    id: string;

    /**
     * 译者为这本书提供的书名。
     */
    name: string;

    /**
     * 这本书的通用名称。
     */
    commonName: string;

    /**
     * 书名。
     * 这通常是书名的更具描述性的版本。
     * 如果没有，则表示翻译过程中没有提供相关信息。
     */
    title: string | null;

    /**
     * 译本中书籍的编号顺序。
     */
    order: number;

    /**
     * 这本书包含的章节数量。
     */
    numberOfChapters: number;

    /**
     * 本书第一章的编号。
     */
    firstChapterNumber: number;

    /**
     * 本书第一章的链接。
     */
    firstChapterApiLink: string;

    /**
     * 书中最后一章的章号。
     */
    lastChapterNumber: number;

    /**
     * 本书最后一章的链接。
     */
    lastChapterApiLink: string;

    /**
     * 这本书包含的诗节数量。
     */
    totalNumberOfVerses: number;

    /**
     * 这本书是否是伪经？
     * 如果译文为权威译文，则省略。
     */
    isApocryphal?: boolean;
}