feat: auto generate/update locale files (#252)

62 files changed, 406 insertions, 5 deletions

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 2bc75f6d..65e70c47 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -13,6 +13,7 @@ If you want to make `Faker` a better, please read the following contribution gui
   Make sure you **build** the project before running the docs, cause some files depend on `dist`.
   Use `pnpm run docs:dev` to edit them in live mode.
 - The tests are executing `vitest` against `test/**/*.spec.ts`
+- If you update the locales, make sure to run `pnpm run generate:locales` to generate/update the related files.
 
 ## Architecture
 
diff --git a/docs/api/localization.md b/docs/api/localization.md
index 6152d32f..375e5e54 100644
--- a/docs/api/localization.md
+++ b/docs/api/localization.md
@@ -13,6 +13,10 @@ faker.setLocale('de');
 faker.locale = 'de';
 ```
 
+<!-- LOCALES-AUTO-GENERATED-START -->
+
+<!-- Run 'pnpm run generate:locales' to update. -->
+
 | Locale      | Name                      |
 | :---------- | :------------------------ |
 | af_ZA       | Afrikaans                 |
@@ -72,6 +76,8 @@ faker.locale = 'de';
 | zh_TW       | Chinese (Taiwan)          |
 | zu_ZA       | Zulu (South Africa)       |
 
+<!-- LOCALES-AUTO-GENERATED-END -->
+
 ## Individual Localization Packages
 
 As of version `v3.0.0` Faker supports incremental loading of locales.
diff --git a/package.json b/package.json
index 3146b704..008dd74d 100644
--- a/package.json
+++ b/package.json
@@ -56,7 +56,8 @@
     "build:code": "esno ./scripts/bundle.ts",
     "build:types": "tsc --emitDeclarationOnly --outDir dist/types",
     "build": "run-s build:clean build:code build:types",
-    "generate:api-docs": "esno scripts/apidoc.ts",
+    "generate:api-docs": "esno ./scripts/apidoc.ts",
+    "generate:locales": "esno ./scripts/generateLocales.ts",
     "docs:build": "run-s docs:prepare docs:build:run",
     "docs:build:run": "vitepress build docs",
     "docs:build:ci": "run-s build docs:build",
@@ -89,6 +90,7 @@
     "@types/node": "~16.11.21",
     "@typescript-eslint/eslint-plugin": "~5.10.1",
     "@typescript-eslint/parser": "~5.10.1",
+    "@types/prettier": "~2.4.3",
     "@types/validator": "~13.7.1",
     "@vitest/ui": "~0.2.5",
     "c8": "~7.11.0",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 70ac0bfa..caad896d 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -2,6 +2,7 @@ lockfileVersion: 5.3
 
 specifiers:
   '@types/node': ~16.11.21
+  '@types/prettier': ~2.4.3
   '@types/validator': ~13.7.1
   '@typescript-eslint/eslint-plugin': ~5.10.1
   '@typescript-eslint/parser': ~5.10.1
@@ -32,6 +33,7 @@ specifiers:
 
 devDependencies:
   '@types/node': 16.11.21
+  '@types/prettier': 2.4.3
   '@types/validator': 13.7.1
   '@typescript-eslint/eslint-plugin': 5.10.1_5bb2413551d07429e4087fb9ca3ae3ea
   '@typescript-eslint/parser': [email protected][email protected]
@@ -366,6 +368,10 @@ packages:
     resolution: {integrity: sha512-Gj7cI7z+98M282Tqmp2K5EIsoouUEzbBJhQQzDE3jSIRk6r9gsz0oUokqIUR4u1R3dMHo0pDHM7sNOHyhulypw==}
     dev: true
 
+  /@types/prettier/2.4.3:
+    resolution: {integrity: sha512-QzSuZMBuG5u8HqYz01qtMdg/Jfctlnvj1z/lYnIDXs/golxw0fxtRAHd9KrzjR7Yxz1qVeI00o0kiO3PmVdJ9w==}
+    dev: true
+
   /@types/sinonjs__fake-timers/8.1.1:
     resolution: {integrity: sha512-0kSuKjAS0TrGLJ0M/+8MaFkGsQhZpB6pxOmvS3K8FYI72K//YmdfoW9X2qPsAKh1mkwxGD5zib9s1FIFed6E8g==}
     dev: true
diff --git a/scripts/generateLocales.ts b/scripts/generateLocales.ts
new file mode 100644
index 00000000..0d3d2fd2
--- /dev/null
+++ b/scripts/generateLocales.ts
@@ -0,0 +1,101 @@
+import { readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { Options } from 'prettier';
+import { format } from 'prettier';
+import options from '../.prettierrc.cjs';
+import type { LocaleDefinition } from '../src';
+
+const pathRoot = resolve(__dirname, '..');
+const pathLocale = resolve(pathRoot, 'src', 'locale');
+const pathLocales = resolve(pathRoot, 'src', 'locales');
+const pathLocalesIndex = resolve(pathLocales, 'index.ts');
+const pathDocsApiLocalization = resolve(
+  pathRoot,
+  'docs',
+  'api',
+  'localization.md'
+);
+
+const scriptCommand = 'pnpm run generate:locales';
+const prettierTsOptions: Options = { ...options, parser: 'typescript' };
+const prettierMdOptions: Options = { ...options, parser: 'markdown' };
+
+const locales = readdirSync(pathLocales);
+locales.splice(locales.indexOf('index.ts'), 1);
+
+let localeIndexImports = "import type { LocaleDefinition } from '..';\n";
+let localeIndexType = 'export type KnownLocale =\n';
+let localeIndexLocales = 'const locales: KnownLocales = {\n';
+
+let localizationLocales = '| Locale | Name |\n| :--- | :--- |\n';
+
+const autoGeneratedCommentHeader = `/*
+ * This file is automatically generated.
+ * Run '${scriptCommand}' to update.
+ */`;
+
+for (const locale of locales) {
+  // eslint-disable-next-line @typescript-eslint/no-var-requires
+  const localeDef: LocaleDefinition = require('../src/locales/' +
+    locale).default;
+  const localeTitle = localeDef.title;
+
+  localeIndexImports += `import ${locale} from './${locale}';\n`;
+  localeIndexType += `  | '${locale}'\n`;
+  localeIndexLocales += `  ${locale},\n`;
+  localizationLocales += `| ${locale} | ${localeTitle} |\n`;
+
+  // src/locale/<locale>.ts
+  let content = `
+      ${autoGeneratedCommentHeader}
+
+      import { Faker } from '..';
+      import ${locale} from '../locales/${locale}';
+      ${locale !== 'en' ? "import en from '../locales/en';" : ''}
+
+      const faker = new Faker({
+        locale: '${locale}',
+        localeFallback: 'en',
+        locales: {
+          ${locale},
+          ${locale !== 'en' ? 'en,' : ''}
+        },
+      });
+
+      export = faker;
+      `;
+
+  content = format(content, prettierTsOptions);
+  writeFileSync(resolve(pathLocale, locale + '.ts'), content);
+}
+
+// src/locales/index.ts
+
+let indexContent = `
+  ${autoGeneratedCommentHeader}
+
+  ${localeIndexImports}
+
+  ${localeIndexType};
+
+  export type KnownLocales = Record<KnownLocale, LocaleDefinition>;
+
+  ${localeIndexLocales}};
+
+  export default locales;
+  `;
+
+indexContent = format(indexContent, prettierTsOptions);
+
+writeFileSync(pathLocalesIndex, indexContent);
+
+// docs/api/localization.md
+
+localizationLocales = format(localizationLocales, prettierMdOptions);
+
+let localizationContent = readFileSync(pathDocsApiLocalization, 'utf-8');
+localizationContent = localizationContent.replace(
+  /(^<!-- LOCALES-AUTO-GENERATED-START -->$).*(^<!-- LOCALES-AUTO-GENERATED-END -->$)/gms,
+  `$1\n\n<!-- Run '${scriptCommand}' to update. -->\n\n${localizationLocales}\n$2`
+);
+writeFileSync(pathDocsApiLocalization, localizationContent);
diff --git a/src/locale/af_ZA.ts b/src/locale/af_ZA.ts
index 0cda3c6e..2054b1ab 100644
--- a/src/locale/af_ZA.ts
+++ b/src/locale/af_ZA.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import af_ZA from '../locales/af_ZA';
 import en from '../locales/en';
diff --git a/src/locale/ar.ts b/src/locale/ar.ts
index 9407ec15..51b01285 100644
--- a/src/locale/ar.ts
+++ b/src/locale/ar.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import ar from '../locales/ar';
 import en from '../locales/en';
diff --git a/src/locale/az.ts b/src/locale/az.ts
index e0f0d125..b59c9cd2 100644
--- a/src/locale/az.ts
+++ b/src/locale/az.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import az from '../locales/az';
 import en from '../locales/en';
diff --git a/src/locale/cz.ts b/src/locale/cz.ts
index ddef6ee5..42be7557 100644
--- a/src/locale/cz.ts
+++ b/src/locale/cz.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import cz from '../locales/cz';
 import en from '../locales/en';
diff --git a/src/locale/de.ts b/src/locale/de.ts
index 414313a7..ed68f526 100644
--- a/src/locale/de.ts
+++ b/src/locale/de.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import de from '../locales/de';
 import en from '../locales/en';
diff --git a/src/locale/de_AT.ts b/src/locale/de_AT.ts
index 4c2d4bd6..56e5b932 100644
--- a/src/locale/de_AT.ts
+++ b/src/locale/de_AT.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import de_AT from '../locales/de_AT';
 import en from '../locales/en';
diff --git a/src/locale/de_CH.ts b/src/locale/de_CH.ts
index 44fc440b..91188431 100644
--- a/src/locale/de_CH.ts
+++ b/src/locale/de_CH.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import de_CH from '../locales/de_CH';
 import en from '../locales/en';
diff --git a/src/locale/el.ts b/src/locale/el.ts
index c1a33a5c..05485513 100644
--- a/src/locale/el.ts
+++ b/src/locale/el.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import el from '../locales/el';
 import en from '../locales/en';
diff --git a/src/locale/en.ts b/src/locale/en.ts
index 88445510..bbb7f2a4 100644
--- a/src/locale/en.ts
+++ b/src/locale/en.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import en from '../locales/en';
 
diff --git a/src/locale/en_AU.ts b/src/locale/en_AU.ts
index 613560aa..e83c755c 100644
--- a/src/locale/en_AU.ts
+++ b/src/locale/en_AU.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import en_AU from '../locales/en_AU';
 import en from '../locales/en';
diff --git a/src/locale/en_AU_ocker.ts b/src/locale/en_AU_ocker.ts
index 41620392..ef410ced 100644
--- a/src/locale/en_AU_ocker.ts
+++ b/src/locale/en_AU_ocker.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import en_AU_ocker from '../locales/en_AU_ocker';
 import en from '../locales/en';
diff --git a/src/locale/en_BORK.ts b/src/locale/en_BORK.ts
index f58b2df9..cc0eb5ad 100644
--- a/src/locale/en_BORK.ts
+++ b/src/locale/en_BORK.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import en_BORK from '../locales/en_BORK';
 import en from '../locales/en';
diff --git a/src/locale/en_CA.ts b/src/locale/en_CA.ts
index 089f003c..513eccba 100644
--- a/src/locale/en_CA.ts
+++ b/src/locale/en_CA.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import en_CA from '../locales/en_CA';
 import en from '../locales/en';
diff --git a/src/locale/en_GB.ts b/src/locale/en_GB.ts
index c1fe3a40..be8fbd9f 100644
--- a/src/locale/en_GB.ts
+++ b/src/locale/en_GB.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import en_GB from '../locales/en_GB';
 import en from '../locales/en';
diff --git a/src/locale/en_GH.ts b/src/locale/en_GH.ts
index ab9f2286..4bb0ef6b 100644
--- a/src/locale/en_GH.ts
+++ b/src/locale/en_GH.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import en_GH from '../locales/en_GH';
 import en from '../locales/en';
diff --git a/src/locale/en_IE.ts b/src/locale/en_IE.ts
index 8ed57e76..64e6001a 100644
--- a/src/locale/en_IE.ts
+++ b/src/locale/en_IE.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import en_IE from '../locales/en_IE';
 import en from '../locales/en';
diff --git a/src/locale/en_IND.ts b/src/locale/en_IND.ts
index c2d58083..55444519 100644
--- a/src/locale/en_IND.ts
+++ b/src/locale/en_IND.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import en_IND from '../locales/en_IND';
 import en from '../locales/en';
diff --git a/src/locale/en_NG.ts b/src/locale/en_NG.ts
index b5315df7..8f7be7ce 100644
--- a/src/locale/en_NG.ts
+++ b/src/locale/en_NG.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import en_NG from '../locales/en_NG';
 import en from '../locales/en';
diff --git a/src/locale/en_US.ts b/src/locale/en_US.ts
index 73f5e50b..24f38345 100644
--- a/src/locale/en_US.ts
+++ b/src/locale/en_US.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import en_US from '../locales/en_US';
 import en from '../locales/en';
diff --git a/src/locale/en_ZA.ts b/src/locale/en_ZA.ts
index 0c7f4c66..f7d1d519 100644
--- a/src/locale/en_ZA.ts
+++ b/src/locale/en_ZA.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import en_ZA from '../locales/en_ZA';
 import en from '../locales/en';
diff --git a/src/locale/es.ts b/src/locale/es.ts
index b812dc25..e1eb406b 100644
--- a/src/locale/es.ts
+++ b/src/locale/es.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import es from '../locales/es';
 import en from '../locales/en';
diff --git a/src/locale/es_MX.ts b/src/locale/es_MX.ts
index 6b6972c6..2d357df4 100644
--- a/src/locale/es_MX.ts
+++ b/src/locale/es_MX.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import es_MX from '../locales/es_MX';
 import en from '../locales/en';
diff --git a/src/locale/fa.ts b/src/locale/fa.ts
index 3611e3a1..778332b7 100644
--- a/src/locale/fa.ts
+++ b/src/locale/fa.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import fa from '../locales/fa';
 import en from '../locales/en';
diff --git a/src/locale/fi.ts b/src/locale/fi.ts
index 18e754d3..c44eb207 100644
--- a/src/locale/fi.ts
+++ b/src/locale/fi.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import fi from '../locales/fi';
 import en from '../locales/en';
diff --git a/src/locale/fr.ts b/src/locale/fr.ts
index e7d2e69d..503c98ff 100644
--- a/src/locale/fr.ts
+++ b/src/locale/fr.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import fr from '../locales/fr';
 import en from '../locales/en';
diff --git a/src/locale/fr_BE.ts b/src/locale/fr_BE.ts
index 9b41d9ed..7ac95179 100644
--- a/src/locale/fr_BE.ts
+++ b/src/locale/fr_BE.ts
@@ -1,13 +1,18 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
-import en from '../locales/en';
 import fr_BE from '../locales/fr_BE';
+import en from '../locales/en';
 
 const faker = new Faker({
   locale: 'fr_BE',
   localeFallback: 'en',
   locales: {
-    en,
     fr_BE,
+    en,
   },
 });
 
diff --git a/src/locale/fr_CA.ts b/src/locale/fr_CA.ts
index 8fd3ad97..35ffccc1 100644
--- a/src/locale/fr_CA.ts
+++ b/src/locale/fr_CA.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import fr_CA from '../locales/fr_CA';
 import en from '../locales/en';
diff --git a/src/locale/fr_CH.ts b/src/locale/fr_CH.ts
index a6e29307..fd8ecc41 100644
--- a/src/locale/fr_CH.ts
+++ b/src/locale/fr_CH.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import fr_CH from '../locales/fr_CH';
 import en from '../locales/en';
diff --git a/src/locale/ge.ts b/src/locale/ge.ts
index 1e859809..e8872a81 100644
--- a/src/locale/ge.ts
+++ b/src/locale/ge.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import ge from '../locales/ge';
 import en from '../locales/en';
diff --git a/src/locale/he.ts b/src/locale/he.ts
index d1905656..ed634c44 100644
--- a/src/locale/he.ts
+++ b/src/locale/he.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import he from '../locales/he';
 import en from '../locales/en';
diff --git a/src/locale/hr.ts b/src/locale/hr.ts
index a95d5052..9529dfd9 100644
--- a/src/locale/hr.ts
+++ b/src/locale/hr.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import hr from '../locales/hr';
 import en from '../locales/en';
diff --git a/src/locale/hy.ts b/src/locale/hy.ts
index fc1f710a..bd65f9a0 100644
--- a/src/locale/hy.ts
+++ b/src/locale/hy.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import hy from '../locales/hy';
 import en from '../locales/en';
diff --git a/src/locale/id_ID.ts b/src/locale/id_ID.ts
index c435d8d7..f306cb45 100644
--- a/src/locale/id_ID.ts
+++ b/src/locale/id_ID.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import id_ID from '../locales/id_ID';
 import en from '../locales/en';
diff --git a/src/locale/it.ts b/src/locale/it.ts
index 8cd45d62..f1816c87 100644
--- a/src/locale/it.ts
+++ b/src/locale/it.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import it from '../locales/it';
 import en from '../locales/en';
diff --git a/src/locale/ja.ts b/src/locale/ja.ts
index cb20528f..cc58410f 100644
--- a/src/locale/ja.ts
+++ b/src/locale/ja.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import ja from '../locales/ja';
 import en from '../locales/en';
diff --git a/src/locale/ko.ts b/src/locale/ko.ts
index 1a55af68..9b12ebd2 100644
--- a/src/locale/ko.ts
+++ b/src/locale/ko.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import ko from '../locales/ko';
 import en from '../locales/en';
diff --git a/src/locale/lv.ts b/src/locale/lv.ts
index 082e9cd5..d9ff9782 100644
--- a/src/locale/lv.ts
+++ b/src/locale/lv.ts
@@ -1,13 +1,18 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
-import en from '../locales/en';
 import lv from '../locales/lv';
+import en from '../locales/en';
 
 const faker = new Faker({
   locale: 'lv',
   localeFallback: 'en',
   locales: {
-    en,
     lv,
+    en,
   },
 });
 
diff --git a/src/locale/mk.ts b/src/locale/mk.ts
index c416ac4c..70bc4208 100644
--- a/src/locale/mk.ts
+++ b/src/locale/mk.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import mk from '../locales/mk';
 import en from '../locales/en';
diff --git a/src/locale/nb_NO.ts b/src/locale/nb_NO.ts
index 51e66c8c..e570db8d 100644
--- a/src/locale/nb_NO.ts
+++ b/src/locale/nb_NO.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import nb_NO from '../locales/nb_NO';
 import en from '../locales/en';
diff --git a/src/locale/ne.ts b/src/locale/ne.ts
index 1b64771b..d6f3461a 100644
--- a/src/locale/ne.ts
+++ b/src/locale/ne.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import ne from '../locales/ne';
 import en from '../locales/en';
diff --git a/src/locale/nl.ts b/src/locale/nl.ts
index 18b32cfe..9358c29b 100644
--- a/src/locale/nl.ts
+++ b/src/locale/nl.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import nl from '../locales/nl';
 import en from '../locales/en';
diff --git a/src/locale/nl_BE.ts b/src/locale/nl_BE.ts
index de1dde66..c0ed1e30 100644
--- a/src/locale/nl_BE.ts
+++ b/src/locale/nl_BE.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import nl_BE from '../locales/nl_BE';
 import en from '../locales/en';
diff --git a/src/locale/pl.ts b/src/locale/pl.ts
index af88fef8..476ed746 100644
--- a/src/locale/pl.ts
+++ b/src/locale/pl.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import pl from '../locales/pl';
 import en from '../locales/en';
diff --git a/src/locale/pt_BR.ts b/src/locale/pt_BR.ts
index 1d82ef4a..7e8bec15 100644
--- a/src/locale/pt_BR.ts
+++ b/src/locale/pt_BR.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import pt_BR from '../locales/pt_BR';
 import en from '../locales/en';
diff --git a/src/locale/pt_PT.ts b/src/locale/pt_PT.ts
index 35daac9e..ff3e1c77 100644
--- a/src/locale/pt_PT.ts
+++ b/src/locale/pt_PT.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import pt_PT from '../locales/pt_PT';
 import en from '../locales/en';
diff --git a/src/locale/ro.ts b/src/locale/ro.ts
index 50a31f96..908b1a98 100644
--- a/src/locale/ro.ts
+++ b/src/locale/ro.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import ro from '../locales/ro';
 import en from '../locales/en';
diff --git a/src/locale/ru.ts b/src/locale/ru.ts
index 76afbc64..6b140ba8 100644
--- a/src/locale/ru.ts
+++ b/src/locale/ru.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import ru from '../locales/ru';
 import en from '../locales/en';
diff --git a/src/locale/sk.ts b/src/locale/sk.ts
index ce9baca2..d97f29bc 100644
--- a/src/locale/sk.ts
+++ b/src/locale/sk.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import sk from '../locales/sk';
 import en from '../locales/en';
diff --git a/src/locale/sv.ts b/src/locale/sv.ts
index 3ece5709..eddb1806 100644
--- a/src/locale/sv.ts
+++ b/src/locale/sv.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import sv from '../locales/sv';
 import en from '../locales/en';
diff --git a/src/locale/tr.ts b/src/locale/tr.ts
index d915f4ac..580f7435 100644
--- a/src/locale/tr.ts
+++ b/src/locale/tr.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import tr from '../locales/tr';
 import en from '../locales/en';
diff --git a/src/locale/uk.ts b/src/locale/uk.ts
index 465a3887..e51c61eb 100644
--- a/src/locale/uk.ts
+++ b/src/locale/uk.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import uk from '../locales/uk';
 import en from '../locales/en';
diff --git a/src/locale/ur.ts b/src/locale/ur.ts
index 7ccb498d..3cfbeade 100644
--- a/src/locale/ur.ts
+++ b/src/locale/ur.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import ur from '../locales/ur';
 import en from '../locales/en';
diff --git a/src/locale/vi.ts b/src/locale/vi.ts
index 21ea52cb..2f9a0906 100644
--- a/src/locale/vi.ts
+++ b/src/locale/vi.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import vi from '../locales/vi';
 import en from '../locales/en';
diff --git a/src/locale/zh_CN.ts b/src/locale/zh_CN.ts
index 45f64495..4c8b3968 100644
--- a/src/locale/zh_CN.ts
+++ b/src/locale/zh_CN.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import zh_CN from '../locales/zh_CN';
 import en from '../locales/en';
diff --git a/src/locale/zh_TW.ts b/src/locale/zh_TW.ts
index 51c3cc1d..24ef4621 100644
--- a/src/locale/zh_TW.ts
+++ b/src/locale/zh_TW.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import zh_TW from '../locales/zh_TW';
 import en from '../locales/en';
diff --git a/src/locale/zu_ZA.ts b/src/locale/zu_ZA.ts
index bf3b018a..1ae6eab7 100644
--- a/src/locale/zu_ZA.ts
+++ b/src/locale/zu_ZA.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import { Faker } from '..';
 import zu_ZA from '../locales/zu_ZA';
 import en from '../locales/en';
diff --git a/src/locales/index.ts b/src/locales/index.ts
index 83c012f7..8b61eae6 100644
--- a/src/locales/index.ts
+++ b/src/locales/index.ts
@@ -1,3 +1,8 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+
 import type { LocaleDefinition } from '..';
 import af_ZA from './af_ZA';
 import ar from './ar';