@helloao/tools 0.3.0 → 0.4.0

package/dist/esm/generation/api.js

@@ -6,6 +6,10 @@ import {
   CommentaryProfileSchema,
   DatasetBookChapterSchema,
   DatasetBookSchema,
+  DatasetEventSchema,
+  DatasetPeopleGroupSchema,
+  DatasetPersonSchema,
+  DatasetPlaceSchema,
   DatasetSchema,
   TranslationSchema,
   TranslationBookSchema,
@@ -22,6 +26,7 @@ import {
   simplifyCommentaryChapter
 } from "./simple.js";
 import { BookIdSchema } from "../utils.js";
+import { bookOrderMap } from "./book-order.js";
 export const ApiAvailableTranslationsSchema = z.object({
   /**
    * The list of translations.
@@ -100,6 +105,62 @@ export const ApiDatasetSchema = DatasetSchema.extend({
    */
   languageEnglishName: z.string().optional().meta({
     description: "Gets the name of the language in English. Null or undefined if the language doesn't have an english name."
+  }),
+  /**
+   * The API link for the list of people for this dataset.
+   * Omitted if the dataset doesn't contain people.
+   */
+  listOfPeopleApiLink: z.string().optional().meta({
+    description: "The API link for the list of people for this dataset. Relative to the API origin. Omitted if the dataset doesn't contain people."
+  }),
+  /**
+   * The API link for the list of places for this dataset.
+   * Omitted if the dataset doesn't contain places.
+   */
+  listOfPlacesApiLink: z.string().optional().meta({
+    description: "The API link for the list of places for this dataset. Relative to the API origin. Omitted if the dataset doesn't contain places."
+  }),
+  /**
+   * The API link for the list of events for this dataset.
+   * Omitted if the dataset doesn't contain events.
+   */
+  listOfEventsApiLink: z.string().optional().meta({
+    description: "The API link for the list of events for this dataset. Relative to the API origin. Omitted if the dataset doesn't contain events."
+  }),
+  /**
+   * The API link for the list of people groups for this dataset.
+   * Omitted if the dataset doesn't contain people groups.
+   */
+  listOfPeopleGroupsApiLink: z.string().optional().meta({
+    description: "The API link for the list of people groups for this dataset. Relative to the API origin. Omitted if the dataset doesn't contain people groups."
+  }),
+  /**
+   * The total number of people that are contained in this dataset.
+   * Omitted if the dataset doesn't contain people.
+   */
+  totalNumberOfPeople: z.number().optional().meta({
+    description: "The total number of people that are contained in this dataset. Omitted if the dataset doesn't contain people."
+  }),
+  /**
+   * The total number of places that are contained in this dataset.
+   * Omitted if the dataset doesn't contain places.
+   */
+  totalNumberOfPlaces: z.number().optional().meta({
+    description: "The total number of places that are contained in this dataset. Omitted if the dataset doesn't contain places."
+  }),
+  /**
+   * The total number of events that are contained in this dataset.
+   * Omitted if the dataset doesn't contain events.
+   */
+  totalNumberOfEvents: z.number().optional().meta({
+    description: "The total number of events that are contained in this dataset. Omitted if the dataset doesn't contain events."
+  }),
+  /**
+   * The total number of people groups that are contained in this dataset.
+   * Omitted if the dataset doesn't contain people groups.
+   */
+  totalNumberOfPeopleGroups: z.number().optional().meta({
+    description: "The total number of people groups that are contained in this dataset. Omitted if the dataset doesn't contain people groups."
   })
 }).meta({
   id: "ApiDataset",
@@ -210,23 +271,37 @@ export const ApiTranslationCompleteSchema = z.object({
   id: "ApiTranslationComplete",
   description: "Defines the complete translation download data. Maps to the /api/:translationId/complete.json endpoint."
 });
-export const TranslationCompleteChapterSchema = TranslationBookChapterSchema.extend({
+export const TranslationCompleteChapterSchema = TranslationBookChapterSchema.omit({ thisChapterWords: true }).extend({
   /**
    * The number of verses that the chapter contains.
    */
   numberOfVerses: z.number().meta({
     description: "The number of verses that the chapter contains."
+  }),
+  /**
+   * The link to the word-level annotations for the chapter.
+   * Omitted if the chapter doesn't have any word-level annotations.
+   */
+  thisChapterWordsLink: z.string().optional().meta({
+    description: "The link to the word-level annotations for this chapter. Relative to the API origin. Omitted if the chapter doesn't have any word-level annotations."
   })
 }).meta({
   id: "TranslationCompleteChapter",
   description: "A chapter in the complete translation download."
 });
-export const SimpleTranslationCompleteChapterSchema = SimpleTranslationBookChapterSchema.extend({
+export const SimpleTranslationCompleteChapterSchema = SimpleTranslationBookChapterSchema.omit({ thisChapterWords: true }).extend({
   /**
    * The number of verses that the chapter contains.
    */
   numberOfVerses: z.number().meta({
     description: "The number of verses that the chapter contains."
+  }),
+  /**
+   * The link to the word-level annotations for the chapter.
+   * Omitted if the chapter doesn't have any word-level annotations.
+   */
+  thisChapterWordsLink: z.string().optional().meta({
+    description: "The link to the word-level annotations for this chapter. Relative to the API origin. Omitted if the chapter doesn't have any word-level annotations."
   })
 }).meta({
   id: "SimpleTranslationCompleteChapter",
@@ -401,6 +476,571 @@ export const ApiDatasetBooksSchema = z.object({
   id: "ApiDatasetBooks",
   description: "Defines an interface that contains information about the books that are available for a dataset."
 });
+export const ApiDatasetPersonSummarySchema = z.object({
+  /**
+   * The ID of the person.
+   */
+  id: z.string().meta({
+    description: "The ID of the person."
+  }),
+  /**
+   * The name of the person.
+   */
+  name: z.string().meta({
+    description: "The name of the person."
+  }),
+  /**
+   * Whether the name of the person is a proper name.
+   */
+  isProperName: z.boolean().optional().meta({
+    description: "Whether the name of the person is a proper name."
+  }),
+  /**
+   * The gender of the person.
+   */
+  gender: z.string().optional().meta({
+    description: "The gender of the person."
+  }),
+  /**
+   * The number of Bible references that mention the person.
+   */
+  numberOfReferences: z.number().meta({
+    description: "The number of Bible references that mention the person."
+  }),
+  /**
+   * The API link for the person.
+   */
+  thisPersonApiLink: z.string().meta({
+    description: "The API link for the person. Relative to the API origin."
+  })
+}).meta({
+  id: "ApiDatasetPersonSummary",
+  description: "Defines a summary of a person in a dataset."
+});
+export const ApiDatasetPeopleSchema = z.object({
+  /**
+   * The dataset information for the people.
+   */
+  dataset: z.lazy(() => ApiDatasetSchema).meta({
+    description: "The dataset information for the people."
+  }),
+  /**
+   * The list of people that are available for the dataset.
+   */
+  people: z.array(ApiDatasetPersonSummarySchema).meta({
+    description: "The list of people that are available for the dataset."
+  })
+}).meta({
+  id: "ApiDatasetPeople",
+  description: "The list of people in a dataset. Maps to the /api/d/:datasetId/people.json endpoint."
+});
+export const ApiDatasetPersonSchema = z.object({
+  /**
+   * The dataset information for the person.
+   */
+  dataset: z.lazy(() => ApiDatasetSchema).meta({
+    description: "The dataset information for the person."
+  }),
+  /**
+   * The information about the person.
+   */
+  person: DatasetPersonSchema.meta({
+    description: "The information about the person."
+  }),
+  /**
+   * The API link for this person.
+   */
+  thisPersonApiLink: z.string().meta({
+    description: "The API link for this person. Relative to the API origin."
+  })
+}).meta({
+  id: "ApiDatasetPerson",
+  description: "The information about a person in a dataset. Maps to the /api/d/:datasetId/people/:personId.json endpoint."
+});
+export const ApiDatasetPlaceSummarySchema = z.object({
+  /**
+   * The ID of the place.
+   */
+  id: z.string().meta({
+    description: "The ID of the place."
+  }),
+  /**
+   * The name of the place.
+   */
+  name: z.string().meta({
+    description: "The name of the place."
+  }),
+  /**
+   * The type of geographical feature that the place is.
+   */
+  featureType: z.string().optional().meta({
+    description: 'The type of geographical feature that the place is. For example, "City", "Region", "Mountain", "Water", etc.'
+  }),
+  /**
+   * The latitude of the place.
+   */
+  latitude: z.number().optional().meta({
+    description: "The latitude of the place."
+  }),
+  /**
+   * The longitude of the place.
+   */
+  longitude: z.number().optional().meta({
+    description: "The longitude of the place."
+  }),
+  /**
+   * The number of Bible references that mention the place.
+   */
+  numberOfReferences: z.number().meta({
+    description: "The number of Bible references that mention the place."
+  }),
+  /**
+   * The API link for the place.
+   */
+  thisPlaceApiLink: z.string().meta({
+    description: "The API link for the place. Relative to the API origin."
+  })
+}).meta({
+  id: "ApiDatasetPlaceSummary",
+  description: "Defines a summary of a place in a dataset."
+});
+export const ApiDatasetPlacesSchema = z.object({
+  /**
+   * The dataset information for the places.
+   */
+  dataset: z.lazy(() => ApiDatasetSchema).meta({
+    description: "The dataset information for the places."
+  }),
+  /**
+   * The list of places that are available for the dataset.
+   */
+  places: z.array(ApiDatasetPlaceSummarySchema).meta({
+    description: "The list of places that are available for the dataset."
+  })
+}).meta({
+  id: "ApiDatasetPlaces",
+  description: "The list of places in a dataset. Maps to the /api/d/:datasetId/places.json endpoint."
+});
+export const ApiDatasetPlaceSchema = z.object({
+  /**
+   * The dataset information for the place.
+   */
+  dataset: z.lazy(() => ApiDatasetSchema).meta({
+    description: "The dataset information for the place."
+  }),
+  /**
+   * The information about the place.
+   */
+  place: DatasetPlaceSchema.meta({
+    description: "The information about the place."
+  }),
+  /**
+   * The API link for this place.
+   */
+  thisPlaceApiLink: z.string().meta({
+    description: "The API link for this place. Relative to the API origin."
+  })
+}).meta({
+  id: "ApiDatasetPlace",
+  description: "The information about a place in a dataset. Maps to the /api/d/:datasetId/places/:placeId.json endpoint."
+});
+export const ApiDatasetEventSummarySchema = z.object({
+  /**
+   * The ID of the event.
+   */
+  id: z.string().meta({
+    description: "The ID of the event."
+  }),
+  /**
+   * The name of the event.
+   */
+  name: z.string().meta({
+    description: "The name of the event."
+  }),
+  /**
+   * The date that the event started at.
+   */
+  startDate: z.string().optional().meta({
+    description: "The date that the event started at. Negative numbers are years BC. Positive numbers are years AD. More specific dates use the `YYYY-MM-DD` format."
+  }),
+  /**
+   * The number of Bible references that describe the event.
+   */
+  numberOfReferences: z.number().meta({
+    description: "The number of Bible references that describe the event."
+  }),
+  /**
+   * The API link for the event.
+   */
+  thisEventApiLink: z.string().meta({
+    description: "The API link for the event. Relative to the API origin."
+  })
+}).meta({
+  id: "ApiDatasetEventSummary",
+  description: "Defines a summary of an event in a dataset."
+});
+export const ApiDatasetEventsSchema = z.object({
+  /**
+   * The dataset information for the events.
+   */
+  dataset: z.lazy(() => ApiDatasetSchema).meta({
+    description: "The dataset information for the events."
+  }),
+  /**
+   * The list of events that are available for the dataset.
+   */
+  events: z.array(ApiDatasetEventSummarySchema).meta({
+    description: "The list of events that are available for the dataset."
+  })
+}).meta({
+  id: "ApiDatasetEvents",
+  description: "The list of events in a dataset. Maps to the /api/d/:datasetId/events.json endpoint."
+});
+export const ApiDatasetEventSchema = z.object({
+  /**
+   * The dataset information for the event.
+   */
+  dataset: z.lazy(() => ApiDatasetSchema).meta({
+    description: "The dataset information for the event."
+  }),
+  /**
+   * The information about the event.
+   */
+  event: DatasetEventSchema.meta({
+    description: "The information about the event."
+  }),
+  /**
+   * The API link for this event.
+   */
+  thisEventApiLink: z.string().meta({
+    description: "The API link for this event. Relative to the API origin."
+  })
+}).meta({
+  id: "ApiDatasetEvent",
+  description: "The information about an event in a dataset. Maps to the /api/d/:datasetId/events/:eventId.json endpoint."
+});
+export const ApiDatasetPeopleGroupSummarySchema = z.object({
+  /**
+   * The ID of the people group.
+   */
+  id: z.string().meta({
+    description: "The ID of the people group."
+  }),
+  /**
+   * The name of the people group.
+   */
+  name: z.string().meta({
+    description: "The name of the people group."
+  }),
+  /**
+   * The number of people that are members of the people group.
+   */
+  numberOfMembers: z.number().meta({
+    description: "The number of people that are members of the people group."
+  }),
+  /**
+   * The API link for the people group.
+   */
+  thisPeopleGroupApiLink: z.string().meta({
+    description: "The API link for the people group. Relative to the API origin."
+  })
+}).meta({
+  id: "ApiDatasetPeopleGroupSummary",
+  description: "Defines a summary of a people group in a dataset."
+});
+export const ApiDatasetPeopleGroupsSchema = z.object({
+  /**
+   * The dataset information for the people groups.
+   */
+  dataset: z.lazy(() => ApiDatasetSchema).meta({
+    description: "The dataset information for the people groups."
+  }),
+  /**
+   * The list of people groups that are available for the dataset.
+   */
+  groups: z.array(ApiDatasetPeopleGroupSummarySchema).meta({
+    description: "The list of people groups that are available for the dataset."
+  })
+}).meta({
+  id: "ApiDatasetPeopleGroups",
+  description: "The list of people groups in a dataset. Maps to the /api/d/:datasetId/groups.json endpoint."
+});
+export const ApiDatasetPeopleGroupSchema = z.object({
+  /**
+   * The dataset information for the people group.
+   */
+  dataset: z.lazy(() => ApiDatasetSchema).meta({
+    description: "The dataset information for the people group."
+  }),
+  /**
+   * The information about the people group.
+   */
+  group: DatasetPeopleGroupSchema.meta({
+    description: "The information about the people group."
+  }),
+  /**
+   * The API link for this people group.
+   */
+  thisPeopleGroupApiLink: z.string().meta({
+    description: "The API link for this people group. Relative to the API origin."
+  })
+}).meta({
+  id: "ApiDatasetPeopleGroup",
+  description: "The information about a people group in a dataset. Maps to the /api/d/:datasetId/groups/:groupId.json endpoint."
+});
+export const ApiDatasetChapterPersonSchema = z.object({
+  /**
+   * The ID of the person.
+   */
+  id: z.string().meta({
+    description: "The ID of the person."
+  }),
+  /**
+   * The name of the person.
+   */
+  name: z.string().meta({
+    description: "The name of the person."
+  }),
+  /**
+   * Whether the name of the person is a proper name.
+   */
+  isProperName: z.boolean().optional().meta({
+    description: "Whether the name of the person is a proper name."
+  }),
+  /**
+   * The gender of the person.
+   */
+  gender: z.string().optional().meta({
+    description: "The gender of the person."
+  }),
+  /**
+   * The year that the person was born.
+   * Negative numbers are years BC. Positive numbers are years AD.
+   */
+  birthYear: z.number().optional().meta({
+    description: "The year that the person was born. Negative numbers are years BC. Positive numbers are years AD."
+  }),
+  /**
+   * The year that the person died.
+   * Negative numbers are years BC. Positive numbers are years AD.
+   */
+  deathYear: z.number().optional().meta({
+    description: "The year that the person died. Negative numbers are years BC. Positive numbers are years AD."
+  }),
+  /**
+   * The API link for the person.
+   */
+  apiLink: z.string().meta({
+    description: "The API link for the person. Relative to the API origin."
+  }),
+  /**
+   * The numbers of the verses in the chapter that mention the person.
+   * Sorted in ascending order.
+   */
+  verses: z.array(z.number()).meta({
+    description: "The numbers of the verses in the chapter that mention the person. Sorted in ascending order."
+  })
+}).meta({
+  id: "ApiDatasetChapterPerson",
+  description: "Defines a person that appears in a chapter of a dataset."
+});
+export const ApiDatasetChapterPlaceSchema = z.object({
+  /**
+   * The ID of the place.
+   */
+  id: z.string().meta({
+    description: "The ID of the place."
+  }),
+  /**
+   * The name of the place.
+   */
+  name: z.string().meta({
+    description: "The name of the place."
+  }),
+  /**
+   * The type of geographical feature that the place is.
+   */
+  featureType: z.string().optional().meta({
+    description: 'The type of geographical feature that the place is. For example, "City", "Region", "Mountain", "Water", etc.'
+  }),
+  /**
+   * The latitude of the place.
+   */
+  latitude: z.number().optional().meta({
+    description: "The latitude of the place."
+  }),
+  /**
+   * The longitude of the place.
+   */
+  longitude: z.number().optional().meta({
+    description: "The longitude of the place."
+  }),
+  /**
+   * The API link for the place.
+   */
+  apiLink: z.string().meta({
+    description: "The API link for the place. Relative to the API origin."
+  }),
+  /**
+   * The numbers of the verses in the chapter that mention the place.
+   * Sorted in ascending order.
+   */
+  verses: z.array(z.number()).meta({
+    description: "The numbers of the verses in the chapter that mention the place. Sorted in ascending order."
+  })
+}).meta({
+  id: "ApiDatasetChapterPlace",
+  description: "Defines a place that appears in a chapter of a dataset."
+});
+export const ApiDatasetChapterEventSchema = z.object({
+  /**
+   * The ID of the event.
+   */
+  id: z.string().meta({
+    description: "The ID of the event."
+  }),
+  /**
+   * The name of the event.
+   */
+  name: z.string().meta({
+    description: "The name of the event."
+  }),
+  /**
+   * The date that the event started at.
+   */
+  startDate: z.string().optional().meta({
+    description: "The date that the event started at. Negative numbers are years BC. Positive numbers are years AD. More specific dates use the `YYYY-MM-DD` format."
+  }),
+  /**
+   * The API link for the event.
+   */
+  apiLink: z.string().meta({
+    description: "The API link for the event. Relative to the API origin."
+  }),
+  /**
+   * The numbers of the verses in the chapter that describe the event.
+   * Sorted in ascending order.
+   */
+  verses: z.array(z.number()).meta({
+    description: "The numbers of the verses in the chapter that describe the event. Sorted in ascending order."
+  })
+}).meta({
+  id: "ApiDatasetChapterEvent",
+  description: "Defines an event that appears in a chapter of a dataset."
+});
+export const ApiDatasetEntityChapterDataSchema = z.object({
+  /**
+   * The number of the chapter.
+   */
+  number: z.number().meta({
+    description: "The number of the chapter."
+  }),
+  /**
+   * The people that appear in the chapter.
+   * Sorted by the first verse that they appear in.
+   */
+  people: z.array(ApiDatasetChapterPersonSchema).meta({
+    description: "The people that appear in the chapter. Sorted by the first verse that they appear in."
+  }),
+  /**
+   * The places that appear in the chapter.
+   * Sorted by the first verse that they appear in.
+   */
+  places: z.array(ApiDatasetChapterPlaceSchema).meta({
+    description: "The places that appear in the chapter. Sorted by the first verse that they appear in."
+  }),
+  /**
+   * The events that appear in the chapter.
+   * Sorted by the first verse that they appear in.
+   */
+  events: z.array(ApiDatasetChapterEventSchema).meta({
+    description: "The events that appear in the chapter. Sorted by the first verse that they appear in."
+  })
+}).meta({
+  id: "ApiDatasetEntityChapterData",
+  description: "Defines the entity data for a chapter in a dataset. Contains the people, places, and events that appear in the chapter."
+});
+export const ApiDatasetEntityBookChapterSchema = z.object({
+  /**
+   * The dataset information for the book chapter.
+   */
+  dataset: z.lazy(() => ApiDatasetSchema).meta({
+    description: "The dataset information for the book chapter."
+  }),
+  /**
+   * The book information for the book chapter.
+   */
+  book: z.lazy(() => ApiDatasetBookSchema).meta({
+    description: "The book information for the book chapter."
+  }),
+  /**
+   * The entity data for the chapter.
+   */
+  chapter: ApiDatasetEntityChapterDataSchema.meta({
+    description: "The entity data for the chapter."
+  }),
+  /**
+   * The link to this chapter.
+   */
+  thisChapterLink: z.string().meta({
+    description: "The link to this chapter. Relative to the API origin."
+  }),
+  /**
+   * The reference for this chapter.
+   */
+  thisChapterReference: z.lazy(() => DatasetChapterReferenceSchema).meta({
+    description: "The reference for this chapter."
+  }),
+  /**
+   * The link to the next chapter.
+   * Null if this is the last chapter in the dataset.
+   */
+  nextChapterApiLink: z.string().nullable().meta({
+    description: "The link to the next chapter. Relative to the API origin. Null if this is the last chapter in the dataset."
+  }),
+  /**
+   * The reference for the next chapter.
+   * Null if this is the last chapter in the dataset.
+   */
+  nextChapterReference: z.lazy(() => DatasetChapterReferenceSchema).nullable().meta({
+    description: "The reference for the next chapter. Null if this is the last chapter in the dataset."
+  }),
+  /**
+   * The link to the previous chapter.
+   * Null if this is the first chapter in the dataset.
+   */
+  previousChapterApiLink: z.string().nullable().meta({
+    description: "The link to the previous chapter. Relative to the API origin. Null if this is the first chapter in the dataset."
+  }),
+  /**
+   * The reference for the previous chapter.
+   * Null if this is the first chapter in the dataset.
+   */
+  previousChapterReference: z.lazy(() => DatasetChapterReferenceSchema).nullable().meta({
+    description: "The reference for the previous chapter. Null if this is the first chapter in the dataset."
+  }),
+  /**
+   * The number of people that appear in the chapter.
+   */
+  numberOfPeople: z.number().meta({
+    description: "The number of people that appear in the chapter."
+  }),
+  /**
+   * The number of places that appear in the chapter.
+   */
+  numberOfPlaces: z.number().meta({
+    description: "The number of places that appear in the chapter."
+  }),
+  /**
+   * The number of events that appear in the chapter.
+   */
+  numberOfEvents: z.number().meta({
+    description: "The number of events that appear in the chapter."
+  })
+}).meta({
+  id: "ApiDatasetEntityBookChapter",
+  description: "The entities (people, places, and events) that appear in a chapter of a book for a dataset. Maps to the /api/d/:datasetId/:bookId/:chapterNumber.json endpoint for datasets that contain entities."
+});
 export const ApiCommentaryProfilesSchema = z.object({
   /**
    * The commentary information for the books.
@@ -1148,12 +1788,19 @@ export function generateApiForDataset(dataset, options = {}) {
   };
   if (generateSimpleChapterFiles) {
     api.simpleTranslationBookChapters = [];
-    api.simpleTranslationBookChapterWords = [];
     api.simpleCommentaryBookChapters = [];
   }
+  if (generateSimpleChapterFiles || options.generateCompleteTranslationFiles) {
+    api.simpleTranslationBookChapterWords = [];
+  }
   const getNativeName = options.getNativeName;
   const getEnglishName = options.getEnglishName;
   for (let { books, ...translation } of dataset.translations) {
+    let hasSimpleWords2 = function(chapter) {
+      const words = simplifiedChapters.get(chapter)?.words;
+      return !!words && Object.keys(words).length > 0;
+    };
+    var hasSimpleWords = hasSimpleWords2;
     let numberOfBooks = 0;
     let numberOfApocryphalBooks = 0;
     for (let book of books) {
@@ -1396,72 +2043,74 @@ export function generateApiForDataset(dataset, options = {}) {
         );
       }
     }
-    if (api.simpleTranslationBookChapters) {
-      let hasSimpleWords2 = function(chapter) {
-        const words = simplifiedChapters.get(chapter)?.words;
-        return !!words && Object.keys(words).length > 0;
-      };
-      var hasSimpleWords = hasSimpleWords2;
-      const simpleChapterLink = (chapter) => bookChapterApiLink(
-        translation.id,
-        getBookLink(chapter.book),
-        chapter.chapter.number,
-        SIMPLE_JSON_EXTENSION,
-        apiPathPrefix
-      );
-      const simpleWordsLink = (chapter) => hasSimpleWords2(chapter) ? bookChapterWordsApiLink(
-        translation.id,
-        getBookLink(chapter.book),
-        chapter.chapter.number,
-        apiPathPrefix,
-        SIMPLE_JSON_EXTENSION
-      ) : void 0;
+    const simpleChapterLink = (chapter) => bookChapterApiLink(
+      translation.id,
+      getBookLink(chapter.book),
+      chapter.chapter.number,
+      SIMPLE_JSON_EXTENSION,
+      apiPathPrefix
+    );
+    const simpleWordsLink = (chapter) => hasSimpleWords2(chapter) ? bookChapterWordsApiLink(
+      translation.id,
+      getBookLink(chapter.book),
+      chapter.chapter.number,
+      apiPathPrefix,
+      SIMPLE_JSON_EXTENSION
+    ) : void 0;
+    if (api.simpleTranslationBookChapters || api.simpleTranslationBookChapterWords) {
       for (let i = 0; i < translationChapters.length; i++) {
         const currentChapter = translationChapters[i];
-        const {
-          chapter,
-          simpleChapterApiLink,
-          thisChapterWordsLink,
-          nextChapterWordsLink,
-          previousChapterWordsLink,
-          ...rest
-        } = currentChapter;
         const previousChapter = translationChapters[i - 1];
         const nextChapter = translationChapters[i + 1];
         const simplified = simplifiedChapters.get(currentChapter);
-        const simpleChapter = {
-          ...rest,
-          chapter: simplified.chapter,
-          thisChapterLink: simpleChapterLink(currentChapter),
-          fullChapterApiLink: rest.thisChapterLink,
-          previousChapterApiLink: previousChapter ? simpleChapterLink(previousChapter) : null,
-          nextChapterApiLink: nextChapter ? simpleChapterLink(nextChapter) : null
-        };
+        let simpleChapter;
+        if (api.simpleTranslationBookChapters) {
+          const {
+            chapter,
+            simpleChapterApiLink,
+            thisChapterWordsLink,
+            nextChapterWordsLink,
+            previousChapterWordsLink,
+            ...rest
+          } = currentChapter;
+          simpleChapter = {
+            ...rest,
+            chapter: simplified.chapter,
+            thisChapterLink: simpleChapterLink(currentChapter),
+            fullChapterApiLink: rest.thisChapterLink,
+            previousChapterApiLink: previousChapter ? simpleChapterLink(previousChapter) : null,
+            nextChapterApiLink: nextChapter ? simpleChapterLink(nextChapter) : null
+          };
+        }
         const thisWordsLink = simpleWordsLink(currentChapter);
         if (thisWordsLink) {
-          simpleChapter.thisChapterWordsLink = thisWordsLink;
+          if (simpleChapter) {
+            simpleChapter.thisChapterWordsLink = thisWordsLink;
+          }
           api.simpleTranslationBookChapterWords?.push({
             translationId: translation.id,
             bookId: currentChapter.book.id,
             chapterNumber: currentChapter.chapter.number,
-            thisChapterLink: simpleChapter.thisChapterLink,
-            nextChapterLink: simpleChapter.nextChapterApiLink,
-            previousChapterLink: simpleChapter.previousChapterApiLink,
+            thisChapterLink: simpleChapter?.thisChapterLink ?? currentChapter.thisChapterLink,
+            nextChapterLink: simpleChapter?.nextChapterApiLink ?? currentChapter.nextChapterApiLink,
+            previousChapterLink: simpleChapter?.previousChapterApiLink ?? currentChapter.previousChapterApiLink,
             thisChapterWordsLink: thisWordsLink,
             nextChapterWordsLink: nextChapter ? simpleWordsLink(nextChapter) ?? null : null,
             previousChapterWordsLink: previousChapter ? simpleWordsLink(previousChapter) ?? null : null,
             verses: simplified.words
           });
         }
-        const nextWordsLink = nextChapter ? simpleWordsLink(nextChapter) : void 0;
-        if (nextWordsLink) {
-          simpleChapter.nextChapterWordsLink = nextWordsLink;
-        }
-        const previousWordsLink = previousChapter ? simpleWordsLink(previousChapter) : void 0;
-        if (previousWordsLink) {
-          simpleChapter.previousChapterWordsLink = previousWordsLink;
+        if (simpleChapter) {
+          const nextWordsLink = nextChapter ? simpleWordsLink(nextChapter) : void 0;
+          if (nextWordsLink) {
+            simpleChapter.nextChapterWordsLink = nextWordsLink;
+          }
+          const previousWordsLink = previousChapter ? simpleWordsLink(previousChapter) : void 0;
+          if (previousWordsLink) {
+            simpleChapter.previousChapterWordsLink = previousWordsLink;
+          }
+          api.simpleTranslationBookChapters.push(simpleChapter);
         }
-        api.simpleTranslationBookChapters.push(simpleChapter);
       }
     }
     for (let { reader, verses, apiBookChapter } of pendingAudioTimings) {
@@ -1530,16 +2179,16 @@ export function generateApiForDataset(dataset, options = {}) {
         books: completeBooks.map(
           ({ book, chapters }) => completeBook(
             book,
-            chapters.map((ch) => {
-              const words = rawWordsByChapter.get(ch);
-              return {
-                ...completeChapter(ch),
-                // The complete files also contain the word annotations
-                // themselves rather than links to them.
-                ...words ? { thisChapterWords: words } : {},
-                chapter: ch.chapter
-              };
-            })
+            chapters.map((ch) => ({
+              ...completeChapter(ch),
+              // The complete files link to the word annotations
+              // rather than embedding them, same as the regular
+              // per-chapter endpoint.
+              ...ch.thisChapterWordsLink ? {
+                thisChapterWordsLink: ch.thisChapterWordsLink
+              } : {},
+              chapter: ch.chapter
+            }))
           )
         )
       };
@@ -1551,10 +2200,10 @@ export function generateApiForDataset(dataset, options = {}) {
             book,
             chapters.map((ch) => {
               const simplified = simplifiedChapters.get(ch);
-              const hasWords = Object.keys(simplified.words).length > 0;
+              const wordsLink = simpleWordsLink(ch);
               return {
                 ...completeChapter(ch),
-                ...hasWords ? { thisChapterWords: simplified.words } : {},
+                ...wordsLink ? { thisChapterWordsLink: wordsLink } : {},
                 chapter: simplified.chapter
               };
             })
@@ -1756,7 +2405,14 @@ export function generateApiForDataset(dataset, options = {}) {
     api.commentaryBooks.push(commentaryBooks);
     api.commentaryProfiles.push(commentaryProfiles);
   }
-  for (let { books, ...datasetInfo } of dataset.datasets ?? []) {
+  for (let {
+    books,
+    people,
+    places,
+    events,
+    peopleGroups,
+    ...datasetInfo
+  } of dataset.datasets ?? []) {
     const apiDataset = {
       ...datasetInfo,
       availableFormats: ["json"],
@@ -1881,6 +2537,447 @@ export function generateApiForDataset(dataset, options = {}) {
         };
       }
     }
+    const linkEntityRef = (collection, ref) => ref ? {
+      ...ref,
+      type: collection,
+      apiLink: datasetEntityApiLink(
+        datasetInfo.id,
+        collection,
+        ref.id,
+        "json",
+        apiPathPrefix
+      )
+    } : void 0;
+    const linkEntityRefs = (collection, refs) => refs?.map((ref) => linkEntityRef(collection, ref));
+    if (people) {
+      const datasetPeople = {
+        dataset: apiDataset,
+        people: []
+      };
+      for (let person of people) {
+        const thisPersonApiLink = datasetEntityApiLink(
+          datasetInfo.id,
+          "people",
+          person.id,
+          "json",
+          apiPathPrefix
+        );
+        datasetPeople.people.push({
+          id: person.id,
+          name: person.name,
+          isProperName: person.isProperName,
+          gender: person.gender,
+          numberOfReferences: person.references.length,
+          thisPersonApiLink
+        });
+        const apiPerson = {
+          dataset: apiDataset,
+          person: {
+            ...person,
+            birthPlace: linkEntityRef("places", person.birthPlace),
+            deathPlace: linkEntityRef("places", person.deathPlace),
+            father: linkEntityRefs("people", person.father),
+            mother: linkEntityRefs("people", person.mother),
+            partners: linkEntityRefs("people", person.partners),
+            children: linkEntityRefs("people", person.children),
+            siblings: linkEntityRefs("people", person.siblings),
+            halfSiblingsSameMother: linkEntityRefs(
+              "people",
+              person.halfSiblingsSameMother
+            ),
+            halfSiblingsSameFather: linkEntityRefs(
+              "people",
+              person.halfSiblingsSameFather
+            ),
+            memberOf: linkEntityRefs("groups", person.memberOf),
+            events: linkEntityRefs("events", person.events)
+          },
+          thisPersonApiLink
+        };
+        if (!api.datasetPeopleContents) {
+          api.datasetPeopleContents = [];
+        }
+        api.datasetPeopleContents.push(apiPerson);
+      }
+      apiDataset.listOfPeopleApiLink = listOfDatasetEntitiesApiLink(
+        datasetInfo.id,
+        "people",
+        "json",
+        apiPathPrefix
+      );
+      apiDataset.totalNumberOfPeople = people.length;
+      if (!api.datasetPeople) {
+        api.datasetPeople = [];
+      }
+      api.datasetPeople.push(datasetPeople);
+    }
+    if (places) {
+      const datasetPlaces = {
+        dataset: apiDataset,
+        places: []
+      };
+      for (let place of places) {
+        const thisPlaceApiLink = datasetEntityApiLink(
+          datasetInfo.id,
+          "places",
+          place.id,
+          "json",
+          apiPathPrefix
+        );
+        datasetPlaces.places.push({
+          id: place.id,
+          name: place.name,
+          featureType: place.featureType,
+          latitude: place.latitude,
+          longitude: place.longitude,
+          numberOfReferences: place.references.length,
+          thisPlaceApiLink
+        });
+        const apiPlace = {
+          dataset: apiDataset,
+          place: {
+            ...place,
+            rootPlace: linkEntityRef("places", place.rootPlace),
+            duplicateOf: linkEntityRef("places", place.duplicateOf),
+            people: linkEntityRefs("people", place.people),
+            peopleBorn: linkEntityRefs("people", place.peopleBorn),
+            peopleDied: linkEntityRefs("people", place.peopleDied),
+            events: linkEntityRefs("events", place.events)
+          },
+          thisPlaceApiLink
+        };
+        if (!api.datasetPlaceContents) {
+          api.datasetPlaceContents = [];
+        }
+        api.datasetPlaceContents.push(apiPlace);
+      }
+      apiDataset.listOfPlacesApiLink = listOfDatasetEntitiesApiLink(
+        datasetInfo.id,
+        "places",
+        "json",
+        apiPathPrefix
+      );
+      apiDataset.totalNumberOfPlaces = places.length;
+      if (!api.datasetPlaces) {
+        api.datasetPlaces = [];
+      }
+      api.datasetPlaces.push(datasetPlaces);
+    }
+    if (events) {
+      const datasetEvents = {
+        dataset: apiDataset,
+        events: []
+      };
+      for (let event of events) {
+        const thisEventApiLink = datasetEntityApiLink(
+          datasetInfo.id,
+          "events",
+          event.id,
+          "json",
+          apiPathPrefix
+        );
+        datasetEvents.events.push({
+          id: event.id,
+          name: event.name,
+          startDate: event.startDate,
+          numberOfReferences: event.references.length,
+          thisEventApiLink
+        });
+        const apiEvent = {
+          dataset: apiDataset,
+          event: {
+            ...event,
+            participants: linkEntityRefs(
+              "people",
+              event.participants
+            ),
+            locations: linkEntityRefs("places", event.locations),
+            groups: linkEntityRefs("groups", event.groups),
+            partOf: linkEntityRef("events", event.partOf),
+            predecessor: linkEntityRef("events", event.predecessor)
+          },
+          thisEventApiLink
+        };
+        if (!api.datasetEventContents) {
+          api.datasetEventContents = [];
+        }
+        api.datasetEventContents.push(apiEvent);
+      }
+      apiDataset.listOfEventsApiLink = listOfDatasetEntitiesApiLink(
+        datasetInfo.id,
+        "events",
+        "json",
+        apiPathPrefix
+      );
+      apiDataset.totalNumberOfEvents = events.length;
+      if (!api.datasetEvents) {
+        api.datasetEvents = [];
+      }
+      api.datasetEvents.push(datasetEvents);
+    }
+    if (peopleGroups) {
+      const datasetPeopleGroups = {
+        dataset: apiDataset,
+        groups: []
+      };
+      for (let group of peopleGroups) {
+        const thisPeopleGroupApiLink = datasetEntityApiLink(
+          datasetInfo.id,
+          "groups",
+          group.id,
+          "json",
+          apiPathPrefix
+        );
+        datasetPeopleGroups.groups.push({
+          id: group.id,
+          name: group.name,
+          numberOfMembers: group.members?.length ?? 0,
+          thisPeopleGroupApiLink
+        });
+        const apiGroup = {
+          dataset: apiDataset,
+          group: {
+            ...group,
+            members: linkEntityRefs("people", group.members),
+            events: linkEntityRefs("events", group.events)
+          },
+          thisPeopleGroupApiLink
+        };
+        if (!api.datasetPeopleGroupContents) {
+          api.datasetPeopleGroupContents = [];
+        }
+        api.datasetPeopleGroupContents.push(apiGroup);
+      }
+      apiDataset.listOfPeopleGroupsApiLink = listOfDatasetEntitiesApiLink(
+        datasetInfo.id,
+        "groups",
+        "json",
+        apiPathPrefix
+      );
+      apiDataset.totalNumberOfPeopleGroups = peopleGroups.length;
+      if (!api.datasetPeopleGroups) {
+        api.datasetPeopleGroups = [];
+      }
+      api.datasetPeopleGroups.push(datasetPeopleGroups);
+    }
+    if (books.length <= 0 && (people || places || events)) {
+      let addEntityVerses2 = function(collection, references, createEntry) {
+        for (let reference of references) {
+          let bookChapters = chapterMap.get(reference.book);
+          if (!bookChapters) {
+            bookChapters = /* @__PURE__ */ new Map();
+            chapterMap.set(reference.book, bookChapters);
+          }
+          let chapterEntities = bookChapters.get(reference.chapter);
+          if (!chapterEntities) {
+            chapterEntities = {
+              people: /* @__PURE__ */ new Map(),
+              places: /* @__PURE__ */ new Map(),
+              events: /* @__PURE__ */ new Map()
+            };
+            bookChapters.set(reference.chapter, chapterEntities);
+          }
+          const entry = createEntry();
+          const entities = chapterEntities[collection];
+          let existing = entities.get(entry.id);
+          if (!existing) {
+            existing = { ...entry, verses: [] };
+            entities.set(entry.id, existing);
+          }
+          const endVerse = reference.endVerse ?? reference.verse;
+          for (let verse = reference.verse; verse <= endVerse; verse++) {
+            existing.verses.push(verse);
+          }
+        }
+      }, sortEntities2 = function(entities) {
+        const list = [...entities.values()];
+        for (let entity of list) {
+          entity.verses.sort((a, b) => a - b);
+        }
+        return list.sort(
+          (a, b) => a.verses[0] - b.verses[0] || a.id.localeCompare(b.id)
+        );
+      };
+      var addEntityVerses = addEntityVerses2, sortEntities = sortEntities2;
+      const chapterMap = /* @__PURE__ */ new Map();
+      for (let person of people ?? []) {
+        addEntityVerses2(
+          "people",
+          person.references,
+          () => ({
+            id: person.id,
+            name: person.name,
+            isProperName: person.isProperName,
+            gender: person.gender,
+            birthYear: person.birthYear,
+            deathYear: person.deathYear,
+            apiLink: datasetEntityApiLink(
+              datasetInfo.id,
+              "people",
+              person.id,
+              "json",
+              apiPathPrefix
+            )
+          })
+        );
+      }
+      for (let place of places ?? []) {
+        addEntityVerses2(
+          "places",
+          place.references,
+          () => ({
+            id: place.id,
+            name: place.name,
+            featureType: place.featureType,
+            latitude: place.latitude,
+            longitude: place.longitude,
+            apiLink: datasetEntityApiLink(
+              datasetInfo.id,
+              "places",
+              place.id,
+              "json",
+              apiPathPrefix
+            )
+          })
+        );
+      }
+      for (let event of events ?? []) {
+        addEntityVerses2(
+          "events",
+          event.references,
+          () => ({
+            id: event.id,
+            name: event.name,
+            startDate: event.startDate,
+            apiLink: datasetEntityApiLink(
+              datasetInfo.id,
+              "events",
+              event.id,
+              "json",
+              apiPathPrefix
+            )
+          })
+        );
+      }
+      const sortedBooks = [...chapterMap.keys()].sort(
+        (a, b) => (bookOrderMap.get(a) ?? 9999) - (bookOrderMap.get(b) ?? 9999)
+      );
+      const entityChapters = [];
+      for (let bookId of sortedBooks) {
+        const bookChapters = chapterMap.get(bookId);
+        const chapterNumbers = [...bookChapters.keys()].sort(
+          (a, b) => a - b
+        );
+        const firstChapterNumber = chapterNumbers[0];
+        const lastChapterNumber = chapterNumbers[chapterNumbers.length - 1];
+        const apiBook = {
+          id: bookId,
+          order: bookOrderMap.get(bookId) ?? 9999,
+          firstChapterNumber,
+          firstChapterApiLink: bookDatasetChapterApiLink(
+            datasetInfo.id,
+            bookId,
+            firstChapterNumber,
+            "json",
+            apiPathPrefix
+          ),
+          firstChapterReference: {
+            datasetId: datasetInfo.id,
+            book: bookId,
+            chapter: firstChapterNumber
+          },
+          lastChapterNumber,
+          lastChapterApiLink: bookDatasetChapterApiLink(
+            datasetInfo.id,
+            bookId,
+            lastChapterNumber,
+            "json",
+            apiPathPrefix
+          ),
+          lastChapterReference: {
+            datasetId: datasetInfo.id,
+            book: bookId,
+            chapter: lastChapterNumber
+          },
+          numberOfChapters: chapterNumbers.length,
+          totalNumberOfVerses: 0,
+          totalNumberOfReferences: 0
+        };
+        for (let chapterNumber of chapterNumbers) {
+          const chapterEntities = bookChapters.get(chapterNumber);
+          const chapterPeople = sortEntities2(chapterEntities.people);
+          const chapterPlaces = sortEntities2(chapterEntities.places);
+          const chapterEvents = sortEntities2(chapterEntities.events);
+          const distinctVerses = /* @__PURE__ */ new Set();
+          let numberOfReferences = 0;
+          for (let list of [
+            chapterPeople,
+            chapterPlaces,
+            chapterEvents
+          ]) {
+            for (let entity of list) {
+              numberOfReferences += entity.verses.length;
+              for (let verse of entity.verses) {
+                distinctVerses.add(verse);
+              }
+            }
+          }
+          apiBook.totalNumberOfVerses += distinctVerses.size;
+          apiBook.totalNumberOfReferences += numberOfReferences;
+          const apiChapter = {
+            dataset: apiDataset,
+            book: apiBook,
+            chapter: {
+              number: chapterNumber,
+              people: chapterPeople,
+              places: chapterPlaces,
+              events: chapterEvents
+            },
+            thisChapterLink: bookDatasetChapterApiLink(
+              datasetInfo.id,
+              bookId,
+              chapterNumber,
+              "json",
+              apiPathPrefix
+            ),
+            thisChapterReference: {
+              datasetId: datasetInfo.id,
+              book: bookId,
+              chapter: chapterNumber
+            },
+            nextChapterApiLink: null,
+            nextChapterReference: null,
+            previousChapterApiLink: null,
+            previousChapterReference: null,
+            numberOfPeople: chapterPeople.length,
+            numberOfPlaces: chapterPlaces.length,
+            numberOfEvents: chapterEvents.length
+          };
+          entityChapters.push(apiChapter);
+        }
+        datasetBooks.books.push(apiBook);
+        apiDataset.totalNumberOfChapters += apiBook.numberOfChapters;
+        apiDataset.totalNumberOfVerses += apiBook.totalNumberOfVerses;
+        apiDataset.totalNumberOfReferences += apiBook.totalNumberOfReferences;
+      }
+      apiDataset.numberOfBooks = datasetBooks.books.length;
+      for (let i = 0; i < entityChapters.length; i++) {
+        if (i > 0) {
+          entityChapters[i].previousChapterApiLink = entityChapters[i - 1].thisChapterLink;
+          entityChapters[i].previousChapterReference = entityChapters[i - 1].thisChapterReference;
+        }
+        if (i < entityChapters.length - 1) {
+          entityChapters[i].nextChapterApiLink = entityChapters[i + 1].thisChapterLink;
+          entityChapters[i].nextChapterReference = entityChapters[i + 1].thisChapterReference;
+        }
+      }
+      if (entityChapters.length > 0) {
+        if (!api.datasetEntityBookChapters) {
+          api.datasetEntityBookChapters = [];
+        }
+        api.datasetEntityBookChapters.push(...entityChapters);
+      }
+    }
     if (!api.availableDatasets) {
       api.availableDatasets = {
         datasets: []
@@ -2009,6 +3106,44 @@ export function generateFilesForApi(api) {
       );
     }
   }
+  for (let entityChapter of api.datasetEntityBookChapters ?? []) {
+    files.push(jsonFile(entityChapter.thisChapterLink, entityChapter));
+  }
+  for (let datasetPeople of api.datasetPeople ?? []) {
+    files.push(
+      jsonFile(datasetPeople.dataset.listOfPeopleApiLink, datasetPeople)
+    );
+  }
+  for (let person of api.datasetPeopleContents ?? []) {
+    files.push(jsonFile(person.thisPersonApiLink, person));
+  }
+  for (let datasetPlaces of api.datasetPlaces ?? []) {
+    files.push(
+      jsonFile(datasetPlaces.dataset.listOfPlacesApiLink, datasetPlaces)
+    );
+  }
+  for (let place of api.datasetPlaceContents ?? []) {
+    files.push(jsonFile(place.thisPlaceApiLink, place));
+  }
+  for (let datasetEvents of api.datasetEvents ?? []) {
+    files.push(
+      jsonFile(datasetEvents.dataset.listOfEventsApiLink, datasetEvents)
+    );
+  }
+  for (let event of api.datasetEventContents ?? []) {
+    files.push(jsonFile(event.thisEventApiLink, event));
+  }
+  for (let datasetPeopleGroups of api.datasetPeopleGroups ?? []) {
+    files.push(
+      jsonFile(
+        datasetPeopleGroups.dataset.listOfPeopleGroupsApiLink,
+        datasetPeopleGroups
+      )
+    );
+  }
+  for (let group of api.datasetPeopleGroupContents ?? []) {
+    files.push(jsonFile(group.thisPeopleGroupApiLink, group));
+  }
   return files;
 }
 export async function* generateOutputFilesFromDatasets(datasets, options) {
@@ -2030,6 +3165,14 @@ export function listOfCommentaryBooksApiLink(commentaryId, prefix = "") {
 export function listOfDatasetBooksApiLink(datasetId, prefix = "") {
   return `${prefix}/api/d/${datasetId}/books.json`;
 }
+export function listOfDatasetEntitiesApiLink(datasetId, collection, extension = "json", prefix = "") {
+  return `${prefix}/api/d/${datasetId}/${collection}.${extension}`;
+}
+export function datasetEntityApiLink(datasetId, collection, entityId, extension = "json", prefix = "") {
+  return `${prefix}/api/d/${datasetId}/${collection}/${replaceSpacesWithUnderscores(
+    entityId
+  )}.${extension}`;
+}
 export const SIMPLE_JSON_EXTENSION = "simple.json";
 export function bookChapterApiLink(translationId, commonName, chapterNumber, extension, prefix = "") {
   return `${prefix}/api/${translationId}/${replaceSpacesWithUnderscores(