feat: add book module

docs/.vitepress/api-pages.ts

@@ -11,6 +11,7 @@ export const apiPages = [
     items: [
       { text: 'Airline', link: '/api/airline.html' },
       { text: 'Animal', link: '/api/animal.html' },
+      { text: 'Book', link: '/api/book.html' },
       { text: 'Color', link: '/api/color.html' },
       { text: 'Commerce', link: '/api/commerce.html' },
       { text: 'Company', link: '/api/company.html' },

scripts/generate-locales.ts

@@ -52,6 +52,7 @@ type DefinitionType = {
 const definitionsTypes: DefinitionType = {
   airline: 'AirlineDefinition',
   animal: 'AnimalDefinition',
+  book: 'BookDefinition',
   color: 'ColorDefinition',
   commerce: 'CommerceDefinition',
   company: 'CompanyDefinition',

src/definitions/book.ts

@@ -0,0 +1,36 @@
+import type { LocaleEntry } from './definitions';
+
+/**
+ * The possible definitions related to books.
+ */
+export type BookDefinition = LocaleEntry<{
+  /**
+   * The names of actual book authors.
+   */
+  author: string[];
+
+  /**
+   * The formats of a book.
+   */
+  format: string[];
+
+  /**
+   * The names of some book genres.
+   */
+  genre: string[];
+
+  /**
+   * The names of actual book series.
+   */
+  series: string[];
+
+  /**
+   * The names of actual book titles.
+   */
+  title: string[];
+
+  /**
+   * The names of actual book publishers.
+   */
+  publisher: string[];
+}>;

src/definitions/definitions.ts

@@ -1,5 +1,6 @@
 import type { AirlineDefinition } from './airline';
 import type { AnimalDefinition } from './animal';
+import type { BookDefinition } from './book';
 import type { ColorDefinition } from './color';
 import type { CommerceDefinition } from './commerce';
 import type { CompanyDefinition } from './company';
@@ -34,6 +35,7 @@ export type LocaleDefinition = {
   metadata?: MetadataDefinition;
   airline?: AirlineDefinition;
   animal?: AnimalDefinition;
+  book?: BookDefinition;
   color?: ColorDefinition;
   commerce?: CommerceDefinition;
   company?: CompanyDefinition;

src/definitions/index.ts

@@ -1,5 +1,6 @@
 export type { AirlineDefinition } from './airline';
 export type { AnimalDefinition } from './animal';
+export type { BookDefinition } from './book';
 export type { ColorDefinition } from './color';
 export type {
   CommerceDefinition,

src/faker.ts

@@ -5,6 +5,7 @@ import type { LocaleProxy } from './locale-proxy';
 import { createLocaleProxy } from './locale-proxy';
 import { AirlineModule } from './modules/airline';
 import { AnimalModule } from './modules/animal';
+import { BookModule } from './modules/book';
 import { ColorModule } from './modules/color';
 import { CommerceModule } from './modules/commerce';
 import { CompanyModule } from './modules/company';
@@ -63,6 +64,7 @@ export class Faker extends SimpleFaker {
 
   readonly airline: AirlineModule = new AirlineModule(this);
   readonly animal: AnimalModule = new AnimalModule(this);
+  readonly book: BookModule = new BookModule(this);
   readonly color: ColorModule = new ColorModule(this);
   readonly commerce: CommerceModule = new CommerceModule(this);
   readonly company: CompanyModule = new CompanyModule(this);

src/index.ts

@@ -1,6 +1,7 @@
 export type {
   AirlineDefinition,
   AnimalDefinition,
+  BookDefinition,
   ColorDefinition,
   CommerceDefinition,
   CommerceProductNameDefinition,
@@ -39,6 +40,7 @@ export * from './locales';
 export { Aircraft } from './modules/airline';
 export type { AircraftType, AirlineModule } from './modules/airline';
 export type { AnimalModule } from './modules/animal';
+export type { BookModule } from './modules/book';
 export { CssFunction, CssSpace } from './modules/color';
 export type {
   Casing,

src/locales/en/book/author.ts

@@ -0,0 +1,127 @@
+export default [
+  'A. A. Milne',
+  'Agatha Christie',
+  'Alexander Pope',
+  'Alexandre Dumas',
+  'Alice Walker',
+  'Andrew Lang',
+  'Anton Pavlovich Chekhov',
+  'Arthur Conan Doyle',
+  'Arthur Schopenhauer',
+  'Aylmer Maude',
+  'Beatrix Potter',
+  'Benjamin Jowett',
+  'Bernard Shaw',
+  'Bertrand Russell',
+  'Bhagavanlal Indrajit',
+  'Bram Stoker',
+  'Brian Evenson',
+  'C. E. Brock',
+  'Charles Dickens',
+  'Charles E. Derbyshire',
+  'Charlotte Brontë',
+  'Charlotte Perkins Gilman',
+  'Clifford R. Adams',
+  'Constance Garnett',
+  'Dan Brown',
+  'Daniel Defoe',
+  'Dante Alighieri',
+  'David Widger',
+  'David Wyllie',
+  'Dean Koontz',
+  'E. M. Forster',
+  'Edgar Allan Poe',
+  'Edgar Rice Burroughs',
+  'Elizabeth Cleghorn Gaskell',
+  'Elizabeth Von Arnim',
+  'F. Scott Fitzgerald',
+  'Frances Hodgson Burnett',
+  'Frank T. Merrill',
+  'Franz Kafka',
+  'Friedrich Wilhelm Nietzsche',
+  'Fyodor Dostoyevsky',
+  'G. K. Chesterton',
+  'George Eliot',
+  'George R. R. Martin',
+  'George Saunders',
+  'Grady Ward',
+  'Gustave Doré',
+  'Guy de Maupassant',
+  'H. G. Wells',
+  'H. P. Lovecraft',
+  'Haruki Murakami',
+  'Henrik Ibsen',
+  'Henry David Thoreau',
+  'Henry Fielding',
+  'Henry James',
+  'Henry Morley',
+  'Herman Melville',
+  'Homer',
+  'Honoré de Balzac',
+  'Ian McEwan',
+  'Isabel Florence Hapgood',
+  'J. K. Rowling',
+  'J. M. Barrie',
+  'Jack London',
+  'Jacob Grimm',
+  'Jacqueline Crooks',
+  'James Joyce',
+  'James Patterson',
+  'Jane Austen',
+  'Johann Wolfgang von Goethe',
+  'John Camden Hotten',
+  'John Green',
+  'John Grisham',
+  'John Ormsby',
+  'Jonathan Franzen',
+  'Jonathan Swift',
+  'Joseph Conrad',
+  'José Rizal',
+  'Jules Verne',
+  'Karl Marx',
+  'Kazuo Ishiguro',
+  'Khaled Hosseini',
+  'L. Frank Baum',
+  'L. M. Montgomery',
+  'Leo Tolstoy',
+  'Lewis Carroll',
+  'Louisa May Alcott',
+  'Louise Maude',
+  'Margaret Atwood',
+  'Mark Twain',
+  'Mary Wollstonecraft Shelley',
+  'Michael Chabon',
+  'Miguel de Cervantes Saavedra',
+  'Nathaniel Hawthorne',
+  'Neil Gaiman',
+  'Niccolò Machiavelli',
+  'Oscar Levy',
+  'Oscar Wilde',
+  'P. G. Wodehouse',
+  'Plato',
+  'R. L. Stine',
+  'Rachel Kushner',
+  'Richard Wagner',
+  'Robert E. Howard',
+  'Robert Louis Stevenson',
+  'Robert W. Chambers',
+  'Rudyard Kipling',
+  'Samuel Butler',
+  'Shivaram Parashuram Bhide',
+  'Sir Richard Francis Burton',
+  'Stephen King',
+  'Suzanne Collins',
+  'T. S. Eliot',
+  'T. Smollett',
+  'Theodore Alois Buckley',
+  'Thomas Hardy',
+  'Toni Morrison',
+  'Vance Packard',
+  'Vatsyayana',
+  'Victor Hugo',
+  'W. K. Marriott',
+  'Walter Scott',
+  'Wilhelm Grimm',
+  'William Shakespeare',
+  'Zadie Smith',
+];

src/locales/en/book/format.ts

@@ -0,0 +1 @@
+export default ['Audiobook', 'Ebook', 'Hardcover', 'Paperback'];

src/locales/en/book/genre.ts

@@ -0,0 +1,27 @@
+export default [
+  'Adventure',
+  'Biography',
+  'Business',
+  "Children's Literature",
+  'Classic',
+  'Comedy',
+  'Comic',
+  'Detective',
+  'Drama',
+  'Fantasy',
+  'Graphic Novel',
+  'Historical Fiction',
+  'Horror',
+  'Memoir',
+  'Mystery',
+  'Mythology',
+  'Philosophy',
+  'Poetry',
+  'Psychology',
+  'Religion',
+  'Romance',
+  'Science Fiction',
+  'Thriller',
+  'Western',
+  'Young Adult',
+];

src/locales/en/book/index.ts

@@ -0,0 +1,22 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+import type { BookDefinition } from '../../..';
+import author from './author';
+import format from './format';
+import genre from './genre';
+import publisher from './publisher';
+import series from './series';
+import title from './title';
+
+const book: BookDefinition = {
+  author,
+  format,
+  genre,
+  publisher,
+  series,
+  title,
+};
+
+export default book;