Merge branch 'next' into da-locale-person

docs/about/team/members.json

@@ -94,7 +94,10 @@
       "name": "Matt Mayer",
       "title": "Contributor",
       "desc": "",
-      "links": [{ "icon": "github", "link": "https://github.com/matthewmayer" }]
+      "links": [
+        { "icon": "github", "link": "https://github.com/matthewmayer" }
+      ],
+      "sponsor": "https://github.com/sponsors/matthewmayer"
     },
     {
       "avatar": "https://github.com/pkuczynski.png",

docs/guide/frameworks.md

@@ -18,8 +18,8 @@ import { faker } from '@faker-js/faker/locale/en';
 
 describe('reverse array', () => {
   it('should reverse the array', () => {
-    const title = faker.name.jobTitle();
-    const name = faker.name.fullName();
+    const title = faker.person.jobTitle();
+    const name = faker.person.fullName();
     const animal = faker.animal.bear();
 
     const array = [title, name, animal];
@@ -36,7 +36,7 @@ These are especially useful in tests that are meant to be deterministic, such as
 - [Snapshots in Jest](https://jestjs.io/docs/snapshot-testing)
 
 ```ts
-import { describe, it, expect } from 'vitest';
+import { afterEach, describe, it, expect } from 'vitest';
 import { faker } from '@faker-js/faker/locale/en';
 
 // We might want other tests to *not* be seeded. This will re-seed our faker instance after each test.
@@ -48,8 +48,8 @@ describe('reverse array', () => {
   it('should reverse the array', () => {
     // Seed our faker instance with some static number.
     faker.seed(1234);
-    const title = faker.name.jobTitle();
-    const name = faker.name.fullName();
+    const title = faker.person.jobTitle();
+    const name = faker.person.fullName();
     const animal = faker.animal.bear();
 
     const array = [title, name, animal];

docs/guide/localization.md

@@ -4,11 +4,11 @@
 
 Did you know Faker supports many different locales?  
 When using our default instance `import { faker } from '@faker-js/faker'` you get English data.
-However, we also provide pre-built instances for more than 50 other locales.
+However, we also provide pre-built instances for [more than 60 available locales](#available-locales).
 
-`import { fakerDE as faker } from '@faker-js/faker'`
+For example, you can import the German locale:
 
-See below for a list of available locales.
+`import { fakerDE as faker } from '@faker-js/faker'`
 
 ::: tip Note
 You can also build your own Faker instances, with custom locales/overwrites.
@@ -98,6 +98,7 @@ In this example there are 5 locales. Each of these is checked in order, and the
 | `en_NG`       | English (Nigeria)         | `fakerEN_NG`       |
 | `en_US`       | English (United States)   | `fakerEN_US`       |
 | `en_ZA`       | English (South Africa)    | `fakerEN_ZA`       |
+| `eo`          | Esperanto                 | `fakerEO`          |
 | `es`          | Spanish                   | `fakerES`          |
 | `es_MX`       | Spanish (Mexico)          | `fakerES_MX`       |
 | `fa`          | Farsi/Persian             | `fakerFA`          |

package.json

@@ -90,13 +90,13 @@
     "@actions/github": "~5.1.1",
     "@algolia/client-search": "~4.19.1",
     "@types/markdown-it": "~13.0.0",
-    "@types/node": "~20.5.0",
+    "@types/node": "~20.5.4",
     "@types/sanitize-html": "~2.9.0",
     "@types/semver": "~7.5.0",
     "@types/validator": "~13.11.1",
     "@typescript-eslint/eslint-plugin": "~6.4.0",
     "@typescript-eslint/parser": "~6.4.0",
-    "@vitest/coverage-v8": "~0.34.1",
+    "@vitest/coverage-v8": "~0.34.2",
     "@vitest/ui": "~0.34.2",
     "@vueuse/core": "~10.3.0",
     "conventional-changelog-cli": "~3.0.0",
@@ -107,7 +107,7 @@
     "eslint-define-config": "~1.23.0",
     "eslint-gitignore": "~0.1.0",
     "eslint-plugin-deprecation": "~1.5.0",
-    "eslint-plugin-jsdoc": "~46.4.6",
+    "eslint-plugin-jsdoc": "~46.5.0",
     "eslint-plugin-prettier": "~5.0.0",
     "eslint-plugin-vitest": "~0.2.8",
     "glob": "~10.3.3",

src/locale/eo.ts

@@ -0,0 +1,13 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
+import { Faker } from '../faker';
+import base from '../locales/base';
+import en from '../locales/en';
+import eo from '../locales/eo';
+
+export const faker = new Faker({
+  locale: [eo, en, base],
+});

src/locale/index.ts

@@ -27,6 +27,7 @@ import { faker as fakerEN_IN } from './en_IN';
 import { faker as fakerEN_NG } from './en_NG';
 import { faker as fakerEN_US } from './en_US';
 import { faker as fakerEN_ZA } from './en_ZA';
+import { faker as fakerEO } from './eo';
 import { faker as fakerES } from './es';
 import { faker as fakerES_MX } from './es_MX';
 import { faker as fakerFA } from './fa';
@@ -94,6 +95,7 @@ export {
   fakerEN_NG,
   fakerEN_US,
   fakerEN_ZA,
+  fakerEO,
   fakerES,
   fakerES_MX,
   fakerFA,
@@ -162,6 +164,7 @@ export const allFakers = {
   en_NG: fakerEN_NG,
   en_US: fakerEN_US,
   en_ZA: fakerEN_ZA,
+  eo: fakerEO,
   es: fakerES,
   es_MX: fakerES_MX,
   fa: fakerFA,

src/locales/eo/animal/bear.ts

@@ -0,0 +1,10 @@
+export default [
+  'amerika nigra urso',
+  'azia nigra urso',
+  'blanka urso',
+  'bruna urso',
+  'granda pando',
+  'longlipa urso',
+  'malaja urso',
+  'okulvitra urso',
+];

src/locales/eo/animal/crocodilia.ts

@@ -0,0 +1,18 @@
+export default [
+  'amerika krokodilo',
+  'aŭstralia krokodilo',
+  'ĉina aligatoro',
+  'filipina krokodilo',
+  'gavialo',
+  'kuba krokodilo',
+  'mara krokodilo',
+  'marĉa krokodilo',
+  'meksika krokodilo',
+  'misisipa aligatoro',
+  'nana krokodilo',
+  'nigra kajmano',
+  'nila krokodilo',
+  'okcidentafrika krokodilo',
+  'orinoka krokodilo',
+  'siama krokodilo',
+];

src/locales/eo/animal/index.ts

@@ -0,0 +1,18 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+import type { AnimalDefinition } from '../../..';
+import bear from './bear';
+import crocodilia from './crocodilia';
+import lion from './lion';
+import type_ from './type';
+
+const animal: AnimalDefinition = {
+  bear,
+  crocodilia,
+  lion,
+  type: type_,
+};
+
+export default animal;

src/locales/eo/animal/lion.ts

@@ -0,0 +1,9 @@
+export default [
+  'azia leono',
+  'berbera leono',
+  'kaba leono',
+  'masaja leono',
+  'okcidentafrika leono',
+  'senegala leono',
+  'transvala leono',
+];

src/locales/eo/animal/type.ts

@@ -0,0 +1,15 @@
+export default [
+  'birdo',
+  'bovo',
+  'cetaco',
+  'ĉevalo',
+  'fiŝo',
+  'hundo',
+  'insekto',
+  'kato',
+  'krokodilulo',
+  'kuniklo',
+  'leono',
+  'serpento',
+  'urso',
+];