diff --git a/scripts/generate-locales.ts b/scripts/generate-locales.ts index e18bdb716fd..13fe70fd26f 100644 --- a/scripts/generate-locales.ts +++ b/scripts/generate-locales.ts @@ -112,6 +112,21 @@ function escapeField(parent: string, module: string): string { return module; } +async function loadMetadata(locale: string): Promise { + const imported = await import( + `file:${resolve(pathLocales, locale, 'metadata.ts')}` + ); + return imported.default as MetadataDefinition; +} + +async function tryLoadMetadata(locale: string): Promise { + try { + return await loadMetadata(locale); + } catch { + return {}; + } +} + async function generateLocaleFile(locale: string): Promise { const parts = locale.split('_'); const locales = [locale]; @@ -135,14 +150,33 @@ async function generateLocaleFile(locale: string): Promise { locales.push('base'); } - let content = ` + const metadata = await tryLoadMetadata(locale); + + const imports = `import { Faker } from '../faker'; +${locales.map((imp) => `import ${imp} from '../locales/${imp}';`).join('\n')}`; + + const jsdoc = + locale === 'base' + ? `The faker instance for the \`base\` locale. + +The base locale contains data that is shared across all locales such as ISO codes, time zones, and more.` + : `The faker instance for the \`${locale}\` locale. + +- Language: ${metadata.title} +- Endonym: ${metadata.endonym} + +This instance uses the following locales internally (in descending precedence): + +${locales.map((locale) => `- \`${locale}\``).join('\n')}`; + + const content = ` ${autoGeneratedCommentHeader} - import { Faker } from '../faker'; - ${locales - .map((imp) => `import ${imp} from '../locales/${imp}';`) - .join('\n')} + ${imports} + /** + * ${jsdoc.replaceAll('\n', '\n * ')} + */ export const faker = new Faker({ locale: ${ locales.length === 1 ? locales[0] : `[${locales.join(', ')}]` @@ -150,8 +184,10 @@ async function generateLocaleFile(locale: string): Promise { }); `; - content = await formatTypescript(content); - return writeFile(resolve(pathLocale, `${locale}.ts`), content); + return writeFile( + resolve(pathLocale, `${locale}.ts`), + await formatTypescript(content) + ); } async function generateLocalesIndexFile( @@ -166,6 +202,24 @@ async function generateLocalesIndexFile( modules = removeTsSuffix(modules); modules.sort(); + const metadata = depth === 1 ? await tryLoadMetadata(name) : {}; + + const jsdoc = + depth === 1 + ? name === 'base' + ? `/** + * The locale data for the \`base\` locale. + * + * The base locale contains data that is shared across all locales such as ISO codes, time zones, and more. + */` + : `/** + * The locale data for the \`${name}\` locale. + * + * - Language: ${metadata.title} + * - Endonym: ${metadata.endonym} + */` + : ''; + const content = [autoGeneratedCommentHeader]; let fieldType = ''; if (type !== 'any') { @@ -182,6 +236,7 @@ async function generateLocalesIndexFile( (module) => `import ${escapeImport(name, module)} from './${module}';` ), '', + jsdoc, `const ${name}${fieldType} = { ${modules.map((module) => `${escapeField(name, module)},`).join('\n')} };`, @@ -385,8 +440,7 @@ for (const locale of locales) { const pathMetadata = resolve(pathModules, 'metadata.ts'); let localeTitle = 'No title found'; try { - const metadataImport = await import(`file:${pathMetadata}`); - const metadata: MetadataDefinition = metadataImport.default; + const metadata: MetadataDefinition = await loadMetadata(locale); const { title } = metadata; if (!title) { throw new Error(`No title property found on ${JSON.stringify(metadata)}`); diff --git a/src/locale/af_ZA.ts b/src/locale/af_ZA.ts index 61dc3819ad0..4169c76a84f 100644 --- a/src/locale/af_ZA.ts +++ b/src/locale/af_ZA.ts @@ -8,6 +8,18 @@ import af_ZA from '../locales/af_ZA'; import base from '../locales/base'; import en from '../locales/en'; +/** + * The faker instance for the `af_ZA` locale. + * + * - Language: Afrikaans (South Africa) + * - Endonym: Afrikaans (Suid-Afrika) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `af_ZA` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [af_ZA, en, base], }); diff --git a/src/locale/ar.ts b/src/locale/ar.ts index 343d2e19bde..3edf2b36e64 100644 --- a/src/locale/ar.ts +++ b/src/locale/ar.ts @@ -8,6 +8,18 @@ import ar from '../locales/ar'; import base from '../locales/base'; import en from '../locales/en'; +/** + * The faker instance for the `ar` locale. + * + * - Language: Arabic + * - Endonym: اَلْعَرَبِيَّةُ + * + * This instance uses the following locales internally (in descending precedence): + * + * - `ar` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [ar, en, base], }); diff --git a/src/locale/az.ts b/src/locale/az.ts index 6366b82896c..58a78b90212 100644 --- a/src/locale/az.ts +++ b/src/locale/az.ts @@ -8,6 +8,18 @@ import az from '../locales/az'; import base from '../locales/base'; import en from '../locales/en'; +/** + * The faker instance for the `az` locale. + * + * - Language: Azerbaijani + * - Endonym: azərbaycan dili + * + * This instance uses the following locales internally (in descending precedence): + * + * - `az` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [az, en, base], }); diff --git a/src/locale/base.ts b/src/locale/base.ts index 67db0218531..00224714b32 100644 --- a/src/locale/base.ts +++ b/src/locale/base.ts @@ -6,6 +6,11 @@ import { Faker } from '../faker'; import base from '../locales/base'; +/** + * The faker instance for the `base` locale. + * + * The base locale contains data that is shared across all locales such as ISO codes, time zones, and more. + */ export const faker = new Faker({ locale: base, }); diff --git a/src/locale/cs_CZ.ts b/src/locale/cs_CZ.ts index 4e56c6d410c..c651f5cc4c7 100644 --- a/src/locale/cs_CZ.ts +++ b/src/locale/cs_CZ.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import cs_CZ from '../locales/cs_CZ'; import en from '../locales/en'; +/** + * The faker instance for the `cs_CZ` locale. + * + * - Language: Czech (Czechia) + * - Endonym: čeština (Česká republika) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `cs_CZ` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [cs_CZ, en, base], }); diff --git a/src/locale/da.ts b/src/locale/da.ts index c5be891942f..854c670228c 100644 --- a/src/locale/da.ts +++ b/src/locale/da.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import da from '../locales/da'; import en from '../locales/en'; +/** + * The faker instance for the `da` locale. + * + * - Language: Danish + * - Endonym: Dansk + * + * This instance uses the following locales internally (in descending precedence): + * + * - `da` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [da, en, base], }); diff --git a/src/locale/de.ts b/src/locale/de.ts index 67801f85572..5d98e1b9cf1 100644 --- a/src/locale/de.ts +++ b/src/locale/de.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import de from '../locales/de'; import en from '../locales/en'; +/** + * The faker instance for the `de` locale. + * + * - Language: German + * - Endonym: Deutsch + * + * This instance uses the following locales internally (in descending precedence): + * + * - `de` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [de, en, base], }); diff --git a/src/locale/de_AT.ts b/src/locale/de_AT.ts index a964ee7e05d..e86cfef3f73 100644 --- a/src/locale/de_AT.ts +++ b/src/locale/de_AT.ts @@ -9,6 +9,19 @@ import de from '../locales/de'; import de_AT from '../locales/de_AT'; import en from '../locales/en'; +/** + * The faker instance for the `de_AT` locale. + * + * - Language: German (Austria) + * - Endonym: Deutsch (Österreich) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `de_AT` + * - `de` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [de_AT, de, en, base], }); diff --git a/src/locale/de_CH.ts b/src/locale/de_CH.ts index b3d0937a401..ec789feb4b7 100644 --- a/src/locale/de_CH.ts +++ b/src/locale/de_CH.ts @@ -9,6 +9,19 @@ import de from '../locales/de'; import de_CH from '../locales/de_CH'; import en from '../locales/en'; +/** + * The faker instance for the `de_CH` locale. + * + * - Language: German (Switzerland) + * - Endonym: Deutsch (Schweiz) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `de_CH` + * - `de` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [de_CH, de, en, base], }); diff --git a/src/locale/dv.ts b/src/locale/dv.ts index dcf8bf4d34c..d9ca8952a90 100644 --- a/src/locale/dv.ts +++ b/src/locale/dv.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import dv from '../locales/dv'; import en from '../locales/en'; +/** + * The faker instance for the `dv` locale. + * + * - Language: Maldivian + * - Endonym: ދިވެހި + * + * This instance uses the following locales internally (in descending precedence): + * + * - `dv` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [dv, en, base], }); diff --git a/src/locale/el.ts b/src/locale/el.ts index c687598970a..383c7d5dd2f 100644 --- a/src/locale/el.ts +++ b/src/locale/el.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import el from '../locales/el'; import en from '../locales/en'; +/** + * The faker instance for the `el` locale. + * + * - Language: Greek + * - Endonym: Ελληνικά + * + * This instance uses the following locales internally (in descending precedence): + * + * - `el` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [el, en, base], }); diff --git a/src/locale/en.ts b/src/locale/en.ts index fc5abe42161..8d4dafb45d2 100644 --- a/src/locale/en.ts +++ b/src/locale/en.ts @@ -7,6 +7,17 @@ import { Faker } from '../faker'; import base from '../locales/base'; import en from '../locales/en'; +/** + * The faker instance for the `en` locale. + * + * - Language: English + * - Endonym: English + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en, base], }); diff --git a/src/locale/en_AU.ts b/src/locale/en_AU.ts index 10c90dbe419..e802c4b09e2 100644 --- a/src/locale/en_AU.ts +++ b/src/locale/en_AU.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import en_AU from '../locales/en_AU'; +/** + * The faker instance for the `en_AU` locale. + * + * - Language: English (Australia) + * - Endonym: English (Australia) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en_AU` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en_AU, en, base], }); diff --git a/src/locale/en_AU_ocker.ts b/src/locale/en_AU_ocker.ts index 1b30265487c..337305c3555 100644 --- a/src/locale/en_AU_ocker.ts +++ b/src/locale/en_AU_ocker.ts @@ -9,6 +9,19 @@ import en from '../locales/en'; import en_AU from '../locales/en_AU'; import en_AU_ocker from '../locales/en_AU_ocker'; +/** + * The faker instance for the `en_AU_ocker` locale. + * + * - Language: English (Australia Ocker) + * - Endonym: English (Australia) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en_AU_ocker` + * - `en_AU` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en_AU_ocker, en_AU, en, base], }); diff --git a/src/locale/en_BORK.ts b/src/locale/en_BORK.ts index 5f357c685ad..334ff28592e 100644 --- a/src/locale/en_BORK.ts +++ b/src/locale/en_BORK.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import en_BORK from '../locales/en_BORK'; +/** + * The faker instance for the `en_BORK` locale. + * + * - Language: English (Bork) + * - Endonym: English (Bork) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en_BORK` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en_BORK, en, base], }); diff --git a/src/locale/en_CA.ts b/src/locale/en_CA.ts index 40c86fcee89..8478315ad0e 100644 --- a/src/locale/en_CA.ts +++ b/src/locale/en_CA.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import en_CA from '../locales/en_CA'; +/** + * The faker instance for the `en_CA` locale. + * + * - Language: English (Canada) + * - Endonym: English (Canada) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en_CA` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en_CA, en, base], }); diff --git a/src/locale/en_GB.ts b/src/locale/en_GB.ts index 4551d568d1f..cbe9db5d669 100644 --- a/src/locale/en_GB.ts +++ b/src/locale/en_GB.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import en_GB from '../locales/en_GB'; +/** + * The faker instance for the `en_GB` locale. + * + * - Language: English (Great Britain) + * - Endonym: English (Great Britain) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en_GB` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en_GB, en, base], }); diff --git a/src/locale/en_GH.ts b/src/locale/en_GH.ts index 8c81794fe91..2886d41fd5a 100644 --- a/src/locale/en_GH.ts +++ b/src/locale/en_GH.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import en_GH from '../locales/en_GH'; +/** + * The faker instance for the `en_GH` locale. + * + * - Language: English (Ghana) + * - Endonym: English (Ghana) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en_GH` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en_GH, en, base], }); diff --git a/src/locale/en_HK.ts b/src/locale/en_HK.ts index a1d9494780a..19206a76df4 100644 --- a/src/locale/en_HK.ts +++ b/src/locale/en_HK.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import en_HK from '../locales/en_HK'; +/** + * The faker instance for the `en_HK` locale. + * + * - Language: English (Hong Kong) + * - Endonym: English (Hong Kong) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en_HK` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en_HK, en, base], }); diff --git a/src/locale/en_IE.ts b/src/locale/en_IE.ts index 96ed78a9d2e..53815627af4 100644 --- a/src/locale/en_IE.ts +++ b/src/locale/en_IE.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import en_IE from '../locales/en_IE'; +/** + * The faker instance for the `en_IE` locale. + * + * - Language: English (Ireland) + * - Endonym: English (Ireland) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en_IE` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en_IE, en, base], }); diff --git a/src/locale/en_IN.ts b/src/locale/en_IN.ts index 75112107b7c..001769e9beb 100644 --- a/src/locale/en_IN.ts +++ b/src/locale/en_IN.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import en_IN from '../locales/en_IN'; +/** + * The faker instance for the `en_IN` locale. + * + * - Language: English (India) + * - Endonym: English (India) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en_IN` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en_IN, en, base], }); diff --git a/src/locale/en_NG.ts b/src/locale/en_NG.ts index 6e9a5dc01fb..ff7490d0368 100644 --- a/src/locale/en_NG.ts +++ b/src/locale/en_NG.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import en_NG from '../locales/en_NG'; +/** + * The faker instance for the `en_NG` locale. + * + * - Language: English (Nigeria) + * - Endonym: English (Nigeria) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en_NG` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en_NG, en, base], }); diff --git a/src/locale/en_US.ts b/src/locale/en_US.ts index d54d8e497bc..6f87cb3ab99 100644 --- a/src/locale/en_US.ts +++ b/src/locale/en_US.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import en_US from '../locales/en_US'; +/** + * The faker instance for the `en_US` locale. + * + * - Language: English (United States) + * - Endonym: English (United States) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en_US` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en_US, en, base], }); diff --git a/src/locale/en_ZA.ts b/src/locale/en_ZA.ts index a5de8756b86..31f8d164979 100644 --- a/src/locale/en_ZA.ts +++ b/src/locale/en_ZA.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import en_ZA from '../locales/en_ZA'; +/** + * The faker instance for the `en_ZA` locale. + * + * - Language: English (South Africa) + * - Endonym: English (South Africa) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `en_ZA` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [en_ZA, en, base], }); diff --git a/src/locale/eo.ts b/src/locale/eo.ts index c2344b4caba..0db814cbeaa 100644 --- a/src/locale/eo.ts +++ b/src/locale/eo.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import eo from '../locales/eo'; +/** + * The faker instance for the `eo` locale. + * + * - Language: Esperanto + * - Endonym: Esperanto + * + * This instance uses the following locales internally (in descending precedence): + * + * - `eo` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [eo, en, base], }); diff --git a/src/locale/es.ts b/src/locale/es.ts index f206bec081d..762207aeb10 100644 --- a/src/locale/es.ts +++ b/src/locale/es.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import es from '../locales/es'; +/** + * The faker instance for the `es` locale. + * + * - Language: Spanish + * - Endonym: Español + * + * This instance uses the following locales internally (in descending precedence): + * + * - `es` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [es, en, base], }); diff --git a/src/locale/es_MX.ts b/src/locale/es_MX.ts index d59a239b27d..c1dd879b9a7 100644 --- a/src/locale/es_MX.ts +++ b/src/locale/es_MX.ts @@ -9,6 +9,19 @@ import en from '../locales/en'; import es from '../locales/es'; import es_MX from '../locales/es_MX'; +/** + * The faker instance for the `es_MX` locale. + * + * - Language: Spanish (Mexico) + * - Endonym: Español (México) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `es_MX` + * - `es` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [es_MX, es, en, base], }); diff --git a/src/locale/fa.ts b/src/locale/fa.ts index 9d3325270bb..5efb1da5eae 100644 --- a/src/locale/fa.ts +++ b/src/locale/fa.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import fa from '../locales/fa'; +/** + * The faker instance for the `fa` locale. + * + * - Language: Farsi/Persian + * - Endonym: فارسی + * + * This instance uses the following locales internally (in descending precedence): + * + * - `fa` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [fa, en, base], }); diff --git a/src/locale/fi.ts b/src/locale/fi.ts index 1125d54bf4f..d9c410b4c89 100644 --- a/src/locale/fi.ts +++ b/src/locale/fi.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import fi from '../locales/fi'; +/** + * The faker instance for the `fi` locale. + * + * - Language: Finnish + * - Endonym: suomi + * + * This instance uses the following locales internally (in descending precedence): + * + * - `fi` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [fi, en, base], }); diff --git a/src/locale/fr.ts b/src/locale/fr.ts index f9a76f46453..c0352eff467 100644 --- a/src/locale/fr.ts +++ b/src/locale/fr.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import fr from '../locales/fr'; +/** + * The faker instance for the `fr` locale. + * + * - Language: French + * - Endonym: Français + * + * This instance uses the following locales internally (in descending precedence): + * + * - `fr` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [fr, en, base], }); diff --git a/src/locale/fr_BE.ts b/src/locale/fr_BE.ts index d0a6536f4c6..58fcccfa74a 100644 --- a/src/locale/fr_BE.ts +++ b/src/locale/fr_BE.ts @@ -9,6 +9,19 @@ import en from '../locales/en'; import fr from '../locales/fr'; import fr_BE from '../locales/fr_BE'; +/** + * The faker instance for the `fr_BE` locale. + * + * - Language: French (Belgium) + * - Endonym: Français (Belgique) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `fr_BE` + * - `fr` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [fr_BE, fr, en, base], }); diff --git a/src/locale/fr_CA.ts b/src/locale/fr_CA.ts index cb30f751024..2f9e4d28644 100644 --- a/src/locale/fr_CA.ts +++ b/src/locale/fr_CA.ts @@ -9,6 +9,19 @@ import en from '../locales/en'; import fr from '../locales/fr'; import fr_CA from '../locales/fr_CA'; +/** + * The faker instance for the `fr_CA` locale. + * + * - Language: French (Canada) + * - Endonym: Français (Canada) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `fr_CA` + * - `fr` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [fr_CA, fr, en, base], }); diff --git a/src/locale/fr_CH.ts b/src/locale/fr_CH.ts index 6301439a368..86774f881ff 100644 --- a/src/locale/fr_CH.ts +++ b/src/locale/fr_CH.ts @@ -9,6 +9,19 @@ import en from '../locales/en'; import fr from '../locales/fr'; import fr_CH from '../locales/fr_CH'; +/** + * The faker instance for the `fr_CH` locale. + * + * - Language: French (Switzerland) + * - Endonym: Français (Suisse) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `fr_CH` + * - `fr` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [fr_CH, fr, en, base], }); diff --git a/src/locale/fr_LU.ts b/src/locale/fr_LU.ts index b2d5a0e74d9..5a0bd9c2e16 100644 --- a/src/locale/fr_LU.ts +++ b/src/locale/fr_LU.ts @@ -9,6 +9,19 @@ import en from '../locales/en'; import fr from '../locales/fr'; import fr_LU from '../locales/fr_LU'; +/** + * The faker instance for the `fr_LU` locale. + * + * - Language: French (Luxembourg) + * - Endonym: Français (Luxembourg) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `fr_LU` + * - `fr` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [fr_LU, fr, en, base], }); diff --git a/src/locale/fr_SN.ts b/src/locale/fr_SN.ts index 13f50a4e715..2d724d1bbb1 100644 --- a/src/locale/fr_SN.ts +++ b/src/locale/fr_SN.ts @@ -9,6 +9,19 @@ import en from '../locales/en'; import fr from '../locales/fr'; import fr_SN from '../locales/fr_SN'; +/** + * The faker instance for the `fr_SN` locale. + * + * - Language: French (Senegal) + * - Endonym: Français (Sénégal) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `fr_SN` + * - `fr` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [fr_SN, fr, en, base], }); diff --git a/src/locale/he.ts b/src/locale/he.ts index fb8557cc81f..63eb99a503d 100644 --- a/src/locale/he.ts +++ b/src/locale/he.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import he from '../locales/he'; +/** + * The faker instance for the `he` locale. + * + * - Language: Hebrew + * - Endonym: עברית + * + * This instance uses the following locales internally (in descending precedence): + * + * - `he` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [he, en, base], }); diff --git a/src/locale/hr.ts b/src/locale/hr.ts index b5ed8516319..6aa1458f98a 100644 --- a/src/locale/hr.ts +++ b/src/locale/hr.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import hr from '../locales/hr'; +/** + * The faker instance for the `hr` locale. + * + * - Language: Croatian + * - Endonym: Hrvatski + * + * This instance uses the following locales internally (in descending precedence): + * + * - `hr` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [hr, en, base], }); diff --git a/src/locale/hu.ts b/src/locale/hu.ts index 72b31b177e9..26dc4dda85a 100644 --- a/src/locale/hu.ts +++ b/src/locale/hu.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import hu from '../locales/hu'; +/** + * The faker instance for the `hu` locale. + * + * - Language: Hungarian + * - Endonym: magyar + * + * This instance uses the following locales internally (in descending precedence): + * + * - `hu` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [hu, en, base], }); diff --git a/src/locale/hy.ts b/src/locale/hy.ts index c908e938e8c..7f71a0c50fd 100644 --- a/src/locale/hy.ts +++ b/src/locale/hy.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import hy from '../locales/hy'; +/** + * The faker instance for the `hy` locale. + * + * - Language: Armenian + * - Endonym: Հայերեն + * + * This instance uses the following locales internally (in descending precedence): + * + * - `hy` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [hy, en, base], }); diff --git a/src/locale/id_ID.ts b/src/locale/id_ID.ts index 076fe67e67b..0a423400db4 100644 --- a/src/locale/id_ID.ts +++ b/src/locale/id_ID.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import id_ID from '../locales/id_ID'; +/** + * The faker instance for the `id_ID` locale. + * + * - Language: Indonesian (Indonesia) + * - Endonym: Bahasa Indonesia (Indonesia) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `id_ID` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [id_ID, en, base], }); diff --git a/src/locale/it.ts b/src/locale/it.ts index 4dc16ac1419..822a24fb9ea 100644 --- a/src/locale/it.ts +++ b/src/locale/it.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import it from '../locales/it'; +/** + * The faker instance for the `it` locale. + * + * - Language: Italian + * - Endonym: Italiano + * + * This instance uses the following locales internally (in descending precedence): + * + * - `it` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [it, en, base], }); diff --git a/src/locale/ja.ts b/src/locale/ja.ts index 1a204077ff2..6760a982718 100644 --- a/src/locale/ja.ts +++ b/src/locale/ja.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import ja from '../locales/ja'; +/** + * The faker instance for the `ja` locale. + * + * - Language: Japanese + * - Endonym: 日本語 + * + * This instance uses the following locales internally (in descending precedence): + * + * - `ja` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [ja, en, base], }); diff --git a/src/locale/ka_GE.ts b/src/locale/ka_GE.ts index 8f32405f0c1..89c43309a52 100644 --- a/src/locale/ka_GE.ts +++ b/src/locale/ka_GE.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import ka_GE from '../locales/ka_GE'; +/** + * The faker instance for the `ka_GE` locale. + * + * - Language: Georgian (Georgia) + * - Endonym: ქართული (საქართველო) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `ka_GE` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [ka_GE, en, base], }); diff --git a/src/locale/ko.ts b/src/locale/ko.ts index baf5593d98c..b28291ce3e6 100644 --- a/src/locale/ko.ts +++ b/src/locale/ko.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import ko from '../locales/ko'; +/** + * The faker instance for the `ko` locale. + * + * - Language: Korean + * - Endonym: 한국어 + * + * This instance uses the following locales internally (in descending precedence): + * + * - `ko` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [ko, en, base], }); diff --git a/src/locale/lv.ts b/src/locale/lv.ts index 486d5e16dfb..ebc30d35dbf 100644 --- a/src/locale/lv.ts +++ b/src/locale/lv.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import lv from '../locales/lv'; +/** + * The faker instance for the `lv` locale. + * + * - Language: Latvian + * - Endonym: latviešu valoda + * + * This instance uses the following locales internally (in descending precedence): + * + * - `lv` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [lv, en, base], }); diff --git a/src/locale/mk.ts b/src/locale/mk.ts index 18c2562b61c..e6ef1b03bc8 100644 --- a/src/locale/mk.ts +++ b/src/locale/mk.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import mk from '../locales/mk'; +/** + * The faker instance for the `mk` locale. + * + * - Language: Macedonian + * - Endonym: македонски јазик + * + * This instance uses the following locales internally (in descending precedence): + * + * - `mk` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [mk, en, base], }); diff --git a/src/locale/nb_NO.ts b/src/locale/nb_NO.ts index d1d417b6452..e46c03356cc 100644 --- a/src/locale/nb_NO.ts +++ b/src/locale/nb_NO.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import nb_NO from '../locales/nb_NO'; +/** + * The faker instance for the `nb_NO` locale. + * + * - Language: Norwegian (Norway) + * - Endonym: Norsk bokmål (Norge) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `nb_NO` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [nb_NO, en, base], }); diff --git a/src/locale/ne.ts b/src/locale/ne.ts index 4343180be4a..8c071562452 100644 --- a/src/locale/ne.ts +++ b/src/locale/ne.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import ne from '../locales/ne'; +/** + * The faker instance for the `ne` locale. + * + * - Language: Nepali + * - Endonym: नेपाली + * + * This instance uses the following locales internally (in descending precedence): + * + * - `ne` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [ne, en, base], }); diff --git a/src/locale/nl.ts b/src/locale/nl.ts index 19768256062..32db5f3779d 100644 --- a/src/locale/nl.ts +++ b/src/locale/nl.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import nl from '../locales/nl'; +/** + * The faker instance for the `nl` locale. + * + * - Language: Dutch + * - Endonym: Nederlands + * + * This instance uses the following locales internally (in descending precedence): + * + * - `nl` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [nl, en, base], }); diff --git a/src/locale/nl_BE.ts b/src/locale/nl_BE.ts index 55c24d0a256..cac435473a5 100644 --- a/src/locale/nl_BE.ts +++ b/src/locale/nl_BE.ts @@ -9,6 +9,19 @@ import en from '../locales/en'; import nl from '../locales/nl'; import nl_BE from '../locales/nl_BE'; +/** + * The faker instance for the `nl_BE` locale. + * + * - Language: Dutch (Belgium) + * - Endonym: Nederlands (België) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `nl_BE` + * - `nl` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [nl_BE, nl, en, base], }); diff --git a/src/locale/pl.ts b/src/locale/pl.ts index 86cec2e83e3..8ddb0b88f79 100644 --- a/src/locale/pl.ts +++ b/src/locale/pl.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import pl from '../locales/pl'; +/** + * The faker instance for the `pl` locale. + * + * - Language: Polish + * - Endonym: Polski + * + * This instance uses the following locales internally (in descending precedence): + * + * - `pl` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [pl, en, base], }); diff --git a/src/locale/pt_BR.ts b/src/locale/pt_BR.ts index 31617b6cc59..20a9aa215de 100644 --- a/src/locale/pt_BR.ts +++ b/src/locale/pt_BR.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import pt_BR from '../locales/pt_BR'; +/** + * The faker instance for the `pt_BR` locale. + * + * - Language: Portuguese (Brazil) + * - Endonym: Português (Brasil) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `pt_BR` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [pt_BR, en, base], }); diff --git a/src/locale/pt_PT.ts b/src/locale/pt_PT.ts index b8a1298b6de..9eb090e6ce3 100644 --- a/src/locale/pt_PT.ts +++ b/src/locale/pt_PT.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import pt_PT from '../locales/pt_PT'; +/** + * The faker instance for the `pt_PT` locale. + * + * - Language: Portuguese (Portugal) + * - Endonym: Português (Portugal) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `pt_PT` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [pt_PT, en, base], }); diff --git a/src/locale/ro.ts b/src/locale/ro.ts index 94d593ed03c..d692a4426ae 100644 --- a/src/locale/ro.ts +++ b/src/locale/ro.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import ro from '../locales/ro'; +/** + * The faker instance for the `ro` locale. + * + * - Language: Romanian + * - Endonym: Română + * + * This instance uses the following locales internally (in descending precedence): + * + * - `ro` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [ro, en, base], }); diff --git a/src/locale/ro_MD.ts b/src/locale/ro_MD.ts index c67c7025f9b..da49ee1daec 100644 --- a/src/locale/ro_MD.ts +++ b/src/locale/ro_MD.ts @@ -9,6 +9,19 @@ import en from '../locales/en'; import ro from '../locales/ro'; import ro_MD from '../locales/ro_MD'; +/** + * The faker instance for the `ro_MD` locale. + * + * - Language: Romanian (Moldova) + * - Endonym: Română (Moldova) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `ro_MD` + * - `ro` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [ro_MD, ro, en, base], }); diff --git a/src/locale/ru.ts b/src/locale/ru.ts index f97df2216c9..c5bd2750d44 100644 --- a/src/locale/ru.ts +++ b/src/locale/ru.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import ru from '../locales/ru'; +/** + * The faker instance for the `ru` locale. + * + * - Language: Russian + * - Endonym: Русский + * + * This instance uses the following locales internally (in descending precedence): + * + * - `ru` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [ru, en, base], }); diff --git a/src/locale/sk.ts b/src/locale/sk.ts index 59271d5a7a4..3cd7e6c410a 100644 --- a/src/locale/sk.ts +++ b/src/locale/sk.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import sk from '../locales/sk'; +/** + * The faker instance for the `sk` locale. + * + * - Language: Slovak + * - Endonym: slovenčina + * + * This instance uses the following locales internally (in descending precedence): + * + * - `sk` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [sk, en, base], }); diff --git a/src/locale/sr_RS_latin.ts b/src/locale/sr_RS_latin.ts index 692928f83be..6122541d279 100644 --- a/src/locale/sr_RS_latin.ts +++ b/src/locale/sr_RS_latin.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import sr_RS_latin from '../locales/sr_RS_latin'; +/** + * The faker instance for the `sr_RS_latin` locale. + * + * - Language: Serbian (Serbia, Latin) + * - Endonym: srpski (Srbija, latinica) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `sr_RS_latin` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [sr_RS_latin, en, base], }); diff --git a/src/locale/sv.ts b/src/locale/sv.ts index 1df3eb173c6..372250f98f2 100644 --- a/src/locale/sv.ts +++ b/src/locale/sv.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import sv from '../locales/sv'; +/** + * The faker instance for the `sv` locale. + * + * - Language: Swedish + * - Endonym: Svenska + * + * This instance uses the following locales internally (in descending precedence): + * + * - `sv` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [sv, en, base], }); diff --git a/src/locale/th.ts b/src/locale/th.ts index 73ff56adee4..0e0015d3cf1 100644 --- a/src/locale/th.ts +++ b/src/locale/th.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import th from '../locales/th'; +/** + * The faker instance for the `th` locale. + * + * - Language: Thai + * - Endonym: ไทย + * + * This instance uses the following locales internally (in descending precedence): + * + * - `th` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [th, en, base], }); diff --git a/src/locale/tr.ts b/src/locale/tr.ts index ee359ae5260..9ac44f3962a 100644 --- a/src/locale/tr.ts +++ b/src/locale/tr.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import tr from '../locales/tr'; +/** + * The faker instance for the `tr` locale. + * + * - Language: Turkish + * - Endonym: Türkçe + * + * This instance uses the following locales internally (in descending precedence): + * + * - `tr` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [tr, en, base], }); diff --git a/src/locale/uk.ts b/src/locale/uk.ts index 8a6db1f723a..1881c9cd51f 100644 --- a/src/locale/uk.ts +++ b/src/locale/uk.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import uk from '../locales/uk'; +/** + * The faker instance for the `uk` locale. + * + * - Language: Ukrainian + * - Endonym: Українська + * + * This instance uses the following locales internally (in descending precedence): + * + * - `uk` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [uk, en, base], }); diff --git a/src/locale/ur.ts b/src/locale/ur.ts index f7f5bf20215..57769cf3bf2 100644 --- a/src/locale/ur.ts +++ b/src/locale/ur.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import ur from '../locales/ur'; +/** + * The faker instance for the `ur` locale. + * + * - Language: Urdu + * - Endonym: اردو + * + * This instance uses the following locales internally (in descending precedence): + * + * - `ur` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [ur, en, base], }); diff --git a/src/locale/uz_UZ_latin.ts b/src/locale/uz_UZ_latin.ts index 5bddc232879..0c4aebbd50b 100644 --- a/src/locale/uz_UZ_latin.ts +++ b/src/locale/uz_UZ_latin.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import uz_UZ_latin from '../locales/uz_UZ_latin'; +/** + * The faker instance for the `uz_UZ_latin` locale. + * + * - Language: Uzbek (Uzbekistan, Latin) + * - Endonym: O'zbekcha + * + * This instance uses the following locales internally (in descending precedence): + * + * - `uz_UZ_latin` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [uz_UZ_latin, en, base], }); diff --git a/src/locale/vi.ts b/src/locale/vi.ts index 8ec561a8f26..47785ab9815 100644 --- a/src/locale/vi.ts +++ b/src/locale/vi.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import vi from '../locales/vi'; +/** + * The faker instance for the `vi` locale. + * + * - Language: Vietnamese + * - Endonym: Tiếng Việt + * + * This instance uses the following locales internally (in descending precedence): + * + * - `vi` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [vi, en, base], }); diff --git a/src/locale/yo_NG.ts b/src/locale/yo_NG.ts index 27e03f5642a..bceb9b6f942 100644 --- a/src/locale/yo_NG.ts +++ b/src/locale/yo_NG.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import yo_NG from '../locales/yo_NG'; +/** + * The faker instance for the `yo_NG` locale. + * + * - Language: Yoruba (Nigeria) + * - Endonym: Yoruba (Naijiria) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `yo_NG` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [yo_NG, en, base], }); diff --git a/src/locale/zh_CN.ts b/src/locale/zh_CN.ts index 8a6a4073f3d..b92ae23b023 100644 --- a/src/locale/zh_CN.ts +++ b/src/locale/zh_CN.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import zh_CN from '../locales/zh_CN'; +/** + * The faker instance for the `zh_CN` locale. + * + * - Language: Chinese (China) + * - Endonym: 中文 (中国) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `zh_CN` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [zh_CN, en, base], }); diff --git a/src/locale/zh_TW.ts b/src/locale/zh_TW.ts index 00df2c62fdb..97dfc2ea52e 100644 --- a/src/locale/zh_TW.ts +++ b/src/locale/zh_TW.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import zh_TW from '../locales/zh_TW'; +/** + * The faker instance for the `zh_TW` locale. + * + * - Language: Chinese (Taiwan) + * - Endonym: 中文 (臺灣) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `zh_TW` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [zh_TW, en, base], }); diff --git a/src/locale/zu_ZA.ts b/src/locale/zu_ZA.ts index 5da3d828b5e..4286e9c4005 100644 --- a/src/locale/zu_ZA.ts +++ b/src/locale/zu_ZA.ts @@ -8,6 +8,18 @@ import base from '../locales/base'; import en from '../locales/en'; import zu_ZA from '../locales/zu_ZA'; +/** + * The faker instance for the `zu_ZA` locale. + * + * - Language: Zulu (South Africa) + * - Endonym: isiZulu (Iningizimu Afrika) + * + * This instance uses the following locales internally (in descending precedence): + * + * - `zu_ZA` + * - `en` + * - `base` + */ export const faker = new Faker({ locale: [zu_ZA, en, base], }); diff --git a/src/locales/af_ZA/index.ts b/src/locales/af_ZA/index.ts index 3bde3758c49..e1d1a8f9ce1 100644 --- a/src/locales/af_ZA/index.ts +++ b/src/locales/af_ZA/index.ts @@ -11,6 +11,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `af_ZA` locale. + * + * - Language: Afrikaans (South Africa) + * - Endonym: Afrikaans (Suid-Afrika) + */ const af_ZA: LocaleDefinition = { cell_phone, company, diff --git a/src/locales/ar/index.ts b/src/locales/ar/index.ts index 6d7b46e0c4b..62a98aefdef 100644 --- a/src/locales/ar/index.ts +++ b/src/locales/ar/index.ts @@ -14,6 +14,12 @@ import person from './person'; import team from './team'; import vehicle from './vehicle'; +/** + * The locale data for the `ar` locale. + * + * - Language: Arabic + * - Endonym: اَلْعَرَبِيَّةُ + */ const ar: LocaleDefinition = { cell_phone, color, diff --git a/src/locales/az/index.ts b/src/locales/az/index.ts index 923480de035..9155e1257f1 100644 --- a/src/locales/az/index.ts +++ b/src/locales/az/index.ts @@ -13,6 +13,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `az` locale. + * + * - Language: Azerbaijani + * - Endonym: azərbaycan dili + */ const az: LocaleDefinition = { color, commerce, diff --git a/src/locales/base/index.ts b/src/locales/base/index.ts index 0a031fbbb50..2e260172763 100644 --- a/src/locales/base/index.ts +++ b/src/locales/base/index.ts @@ -12,6 +12,11 @@ import location from './location'; import metadata from './metadata'; import system from './system'; +/** + * The locale data for the `base` locale. + * + * The base locale contains data that is shared across all locales such as ISO codes, time zones, and more. + */ const base: LocaleDefinition = { color, database, diff --git a/src/locales/cs_CZ/index.ts b/src/locales/cs_CZ/index.ts index c3770c00b37..3f1be31508f 100644 --- a/src/locales/cs_CZ/index.ts +++ b/src/locales/cs_CZ/index.ts @@ -12,6 +12,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `cs_CZ` locale. + * + * - Language: Czech (Czechia) + * - Endonym: čeština (Česká republika) + */ const cs_CZ: LocaleDefinition = { company, date, diff --git a/src/locales/da/index.ts b/src/locales/da/index.ts index d233541326e..d454db43f45 100644 --- a/src/locales/da/index.ts +++ b/src/locales/da/index.ts @@ -13,6 +13,12 @@ import person from './person'; import phone_number from './phone_number'; import word from './word'; +/** + * The locale data for the `da` locale. + * + * - Language: Danish + * - Endonym: Dansk + */ const da: LocaleDefinition = { commerce, company, diff --git a/src/locales/de/index.ts b/src/locales/de/index.ts index 4bdeb76fb4e..a64e7755d49 100644 --- a/src/locales/de/index.ts +++ b/src/locales/de/index.ts @@ -16,6 +16,12 @@ import person from './person'; import phone_number from './phone_number'; import word from './word'; +/** + * The locale data for the `de` locale. + * + * - Language: German + * - Endonym: Deutsch + */ const de: LocaleDefinition = { cell_phone, color, diff --git a/src/locales/de_AT/index.ts b/src/locales/de_AT/index.ts index 8ed90a8d152..3b3f5c0e384 100644 --- a/src/locales/de_AT/index.ts +++ b/src/locales/de_AT/index.ts @@ -12,6 +12,12 @@ import person from './person'; import phone_number from './phone_number'; import word from './word'; +/** + * The locale data for the `de_AT` locale. + * + * - Language: German (Austria) + * - Endonym: Deutsch (Österreich) + */ const de_AT: LocaleDefinition = { cell_phone, company, diff --git a/src/locales/de_CH/index.ts b/src/locales/de_CH/index.ts index ec19b44c968..22c6465cc74 100644 --- a/src/locales/de_CH/index.ts +++ b/src/locales/de_CH/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `de_CH` locale. + * + * - Language: German (Switzerland) + * - Endonym: Deutsch (Schweiz) + */ const de_CH: LocaleDefinition = { company, internet, diff --git a/src/locales/dv/index.ts b/src/locales/dv/index.ts index 1c534b6c54b..bddb4fc42ef 100644 --- a/src/locales/dv/index.ts +++ b/src/locales/dv/index.ts @@ -13,6 +13,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `dv` locale. + * + * - Language: Maldivian + * - Endonym: ދިވެހި + */ const dv: LocaleDefinition = { cell_phone, color, diff --git a/src/locales/el/index.ts b/src/locales/el/index.ts index 42a1f59a726..80c132d60a2 100644 --- a/src/locales/el/index.ts +++ b/src/locales/el/index.ts @@ -18,6 +18,12 @@ import person from './person'; import phone_number from './phone_number'; import team from './team'; +/** + * The locale data for the `el` locale. + * + * - Language: Greek + * - Endonym: Ελληνικά + */ const el: LocaleDefinition = { app, cell_phone, diff --git a/src/locales/en/index.ts b/src/locales/en/index.ts index 7c932075665..c84e786dc7c 100644 --- a/src/locales/en/index.ts +++ b/src/locales/en/index.ts @@ -28,6 +28,12 @@ import team from './team'; import vehicle from './vehicle'; import word from './word'; +/** + * The locale data for the `en` locale. + * + * - Language: English + * - Endonym: English + */ const en: LocaleDefinition = { airline, animal, diff --git a/src/locales/en_AU/index.ts b/src/locales/en_AU/index.ts index ee3bf460bf4..cab310d2837 100644 --- a/src/locales/en_AU/index.ts +++ b/src/locales/en_AU/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `en_AU` locale. + * + * - Language: English (Australia) + * - Endonym: English (Australia) + */ const en_AU: LocaleDefinition = { company, internet, diff --git a/src/locales/en_AU_ocker/index.ts b/src/locales/en_AU_ocker/index.ts index 0a15fa0d37c..c599542e7ef 100644 --- a/src/locales/en_AU_ocker/index.ts +++ b/src/locales/en_AU_ocker/index.ts @@ -9,6 +9,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `en_AU_ocker` locale. + * + * - Language: English (Australia Ocker) + * - Endonym: English (Australia) + */ const en_AU_ocker: LocaleDefinition = { internet, location, diff --git a/src/locales/en_BORK/index.ts b/src/locales/en_BORK/index.ts index c214e7ae974..2c0e46e06b6 100644 --- a/src/locales/en_BORK/index.ts +++ b/src/locales/en_BORK/index.ts @@ -7,6 +7,12 @@ import lorem from './lorem'; import metadata from './metadata'; import person from './person'; +/** + * The locale data for the `en_BORK` locale. + * + * - Language: English (Bork) + * - Endonym: English (Bork) + */ const en_BORK: LocaleDefinition = { lorem, metadata, diff --git a/src/locales/en_CA/index.ts b/src/locales/en_CA/index.ts index cb6dbd35dbb..a2a690b8358 100644 --- a/src/locales/en_CA/index.ts +++ b/src/locales/en_CA/index.ts @@ -9,6 +9,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `en_CA` locale. + * + * - Language: English (Canada) + * - Endonym: English (Canada) + */ const en_CA: LocaleDefinition = { internet, location, diff --git a/src/locales/en_GB/index.ts b/src/locales/en_GB/index.ts index ae59fada47b..5ef7c081ca2 100644 --- a/src/locales/en_GB/index.ts +++ b/src/locales/en_GB/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `en_GB` locale. + * + * - Language: English (Great Britain) + * - Endonym: English (Great Britain) + */ const en_GB: LocaleDefinition = { cell_phone, internet, diff --git a/src/locales/en_GH/index.ts b/src/locales/en_GH/index.ts index c4ca5da3e7e..178e4ac7408 100644 --- a/src/locales/en_GH/index.ts +++ b/src/locales/en_GH/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `en_GH` locale. + * + * - Language: English (Ghana) + * - Endonym: English (Ghana) + */ const en_GH: LocaleDefinition = { company, internet, diff --git a/src/locales/en_HK/index.ts b/src/locales/en_HK/index.ts index cbbfed81797..d164a40fb3d 100644 --- a/src/locales/en_HK/index.ts +++ b/src/locales/en_HK/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `en_HK` locale. + * + * - Language: English (Hong Kong) + * - Endonym: English (Hong Kong) + */ const en_HK: LocaleDefinition = { company, internet, diff --git a/src/locales/en_IE/index.ts b/src/locales/en_IE/index.ts index c54df5435dc..76f87a93697 100644 --- a/src/locales/en_IE/index.ts +++ b/src/locales/en_IE/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `en_IE` locale. + * + * - Language: English (Ireland) + * - Endonym: English (Ireland) + */ const en_IE: LocaleDefinition = { cell_phone, internet, diff --git a/src/locales/en_IN/index.ts b/src/locales/en_IN/index.ts index df86966d882..f5d51b53cd5 100644 --- a/src/locales/en_IN/index.ts +++ b/src/locales/en_IN/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `en_IN` locale. + * + * - Language: English (India) + * - Endonym: English (India) + */ const en_IN: LocaleDefinition = { company, internet, diff --git a/src/locales/en_NG/index.ts b/src/locales/en_NG/index.ts index 5831d9e16b5..e7b1567c508 100644 --- a/src/locales/en_NG/index.ts +++ b/src/locales/en_NG/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `en_NG` locale. + * + * - Language: English (Nigeria) + * - Endonym: English (Nigeria) + */ const en_NG: LocaleDefinition = { company, internet, diff --git a/src/locales/en_US/index.ts b/src/locales/en_US/index.ts index ddadf9c823e..ee9f825ca07 100644 --- a/src/locales/en_US/index.ts +++ b/src/locales/en_US/index.ts @@ -9,6 +9,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `en_US` locale. + * + * - Language: English (United States) + * - Endonym: English (United States) + */ const en_US: LocaleDefinition = { internet, location, diff --git a/src/locales/en_ZA/index.ts b/src/locales/en_ZA/index.ts index 43199703d1f..80fd9d8afa4 100644 --- a/src/locales/en_ZA/index.ts +++ b/src/locales/en_ZA/index.ts @@ -11,6 +11,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `en_ZA` locale. + * + * - Language: English (South Africa) + * - Endonym: English (South Africa) + */ const en_ZA: LocaleDefinition = { cell_phone, company, diff --git a/src/locales/eo/index.ts b/src/locales/eo/index.ts index 83141fb2217..5b5e4ed24e8 100644 --- a/src/locales/eo/index.ts +++ b/src/locales/eo/index.ts @@ -15,6 +15,12 @@ import person from './person'; import science from './science'; import vehicle from './vehicle'; +/** + * The locale data for the `eo` locale. + * + * - Language: Esperanto + * - Endonym: Esperanto + */ const eo: LocaleDefinition = { animal, color, diff --git a/src/locales/es/index.ts b/src/locales/es/index.ts index 880d4dee8a9..f7fef2c7afb 100644 --- a/src/locales/es/index.ts +++ b/src/locales/es/index.ts @@ -14,6 +14,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `es` locale. + * + * - Language: Spanish + * - Endonym: Español + */ const es: LocaleDefinition = { cell_phone, color, diff --git a/src/locales/es_MX/index.ts b/src/locales/es_MX/index.ts index 334e8e5a401..425632d0642 100644 --- a/src/locales/es_MX/index.ts +++ b/src/locales/es_MX/index.ts @@ -15,6 +15,12 @@ import person from './person'; import phone_number from './phone_number'; import team from './team'; +/** + * The locale data for the `es_MX` locale. + * + * - Language: Spanish (Mexico) + * - Endonym: Español (México) + */ const es_MX: LocaleDefinition = { cell_phone, color, diff --git a/src/locales/fa/index.ts b/src/locales/fa/index.ts index 910711bea5f..0b07f4faf37 100644 --- a/src/locales/fa/index.ts +++ b/src/locales/fa/index.ts @@ -19,6 +19,12 @@ import phone_number from './phone_number'; import vehicle from './vehicle'; import word from './word'; +/** + * The locale data for the `fa` locale. + * + * - Language: Farsi/Persian + * - Endonym: فارسی + */ const fa: LocaleDefinition = { cell_phone, color, diff --git a/src/locales/fi/index.ts b/src/locales/fi/index.ts index 73dabe6f9aa..b8e287d3390 100644 --- a/src/locales/fi/index.ts +++ b/src/locales/fi/index.ts @@ -7,6 +7,12 @@ import location from './location'; import metadata from './metadata'; import person from './person'; +/** + * The locale data for the `fi` locale. + * + * - Language: Finnish + * - Endonym: suomi + */ const fi: LocaleDefinition = { location, metadata, diff --git a/src/locales/fr/index.ts b/src/locales/fr/index.ts index 2c8874fa696..f1de23008fe 100644 --- a/src/locales/fr/index.ts +++ b/src/locales/fr/index.ts @@ -19,6 +19,12 @@ import phone_number from './phone_number'; import vehicle from './vehicle'; import word from './word'; +/** + * The locale data for the `fr` locale. + * + * - Language: French + * - Endonym: Français + */ const fr: LocaleDefinition = { animal, color, diff --git a/src/locales/fr_BE/index.ts b/src/locales/fr_BE/index.ts index fb4ad6490f6..8503bac8559 100644 --- a/src/locales/fr_BE/index.ts +++ b/src/locales/fr_BE/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `fr_BE` locale. + * + * - Language: French (Belgium) + * - Endonym: Français (Belgique) + */ const fr_BE: LocaleDefinition = { cell_phone, internet, diff --git a/src/locales/fr_CA/index.ts b/src/locales/fr_CA/index.ts index 0d4a749efbe..18843cea582 100644 --- a/src/locales/fr_CA/index.ts +++ b/src/locales/fr_CA/index.ts @@ -9,6 +9,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `fr_CA` locale. + * + * - Language: French (Canada) + * - Endonym: Français (Canada) + */ const fr_CA: LocaleDefinition = { internet, location, diff --git a/src/locales/fr_CH/index.ts b/src/locales/fr_CH/index.ts index 36c67c18e2f..9eec70e562e 100644 --- a/src/locales/fr_CH/index.ts +++ b/src/locales/fr_CH/index.ts @@ -11,6 +11,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `fr_CH` locale. + * + * - Language: French (Switzerland) + * - Endonym: Français (Suisse) + */ const fr_CH: LocaleDefinition = { cell_phone, internet, diff --git a/src/locales/fr_LU/index.ts b/src/locales/fr_LU/index.ts index 63c2151d411..4bcd15138ba 100644 --- a/src/locales/fr_LU/index.ts +++ b/src/locales/fr_LU/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `fr_LU` locale. + * + * - Language: French (Luxembourg) + * - Endonym: Français (Luxembourg) + */ const fr_LU: LocaleDefinition = { cell_phone, internet, diff --git a/src/locales/fr_SN/index.ts b/src/locales/fr_SN/index.ts index 7b766e772ef..60a2608eba6 100644 --- a/src/locales/fr_SN/index.ts +++ b/src/locales/fr_SN/index.ts @@ -8,6 +8,12 @@ import location from './location'; import metadata from './metadata'; import person from './person'; +/** + * The locale data for the `fr_SN` locale. + * + * - Language: French (Senegal) + * - Endonym: Français (Sénégal) + */ const fr_SN: LocaleDefinition = { internet, location, diff --git a/src/locales/he/index.ts b/src/locales/he/index.ts index b6e5dd8bfb6..96af387dea9 100644 --- a/src/locales/he/index.ts +++ b/src/locales/he/index.ts @@ -15,6 +15,12 @@ import music from './music'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `he` locale. + * + * - Language: Hebrew + * - Endonym: עברית + */ const he: LocaleDefinition = { cell_phone, color, diff --git a/src/locales/hr/index.ts b/src/locales/hr/index.ts index 5225cbc6bd5..20cd5c6d2de 100644 --- a/src/locales/hr/index.ts +++ b/src/locales/hr/index.ts @@ -11,6 +11,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `hr` locale. + * + * - Language: Croatian + * - Endonym: Hrvatski + */ const hr: LocaleDefinition = { cell_phone, date, diff --git a/src/locales/hu/index.ts b/src/locales/hu/index.ts index 8ae89f488c8..2154c6d06fe 100644 --- a/src/locales/hu/index.ts +++ b/src/locales/hu/index.ts @@ -16,6 +16,12 @@ import person from './person'; import phone_number from './phone_number'; import word from './word'; +/** + * The locale data for the `hu` locale. + * + * - Language: Hungarian + * - Endonym: magyar + */ const hu: LocaleDefinition = { animal, color, diff --git a/src/locales/hy/index.ts b/src/locales/hy/index.ts index 2b8aef3ec59..592e5d90c00 100644 --- a/src/locales/hy/index.ts +++ b/src/locales/hy/index.ts @@ -12,6 +12,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `hy` locale. + * + * - Language: Armenian + * - Endonym: Հայերեն + */ const hy: LocaleDefinition = { color, date, diff --git a/src/locales/id_ID/index.ts b/src/locales/id_ID/index.ts index 4b9e7ad9d15..4b864625263 100644 --- a/src/locales/id_ID/index.ts +++ b/src/locales/id_ID/index.ts @@ -11,6 +11,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `id_ID` locale. + * + * - Language: Indonesian (Indonesia) + * - Endonym: Bahasa Indonesia (Indonesia) + */ const id_ID: LocaleDefinition = { company, date, diff --git a/src/locales/it/index.ts b/src/locales/it/index.ts index 5e2af4e8d53..c97c7261e07 100644 --- a/src/locales/it/index.ts +++ b/src/locales/it/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `it` locale. + * + * - Language: Italian + * - Endonym: Italiano + */ const it: LocaleDefinition = { company, internet, diff --git a/src/locales/ja/index.ts b/src/locales/ja/index.ts index b6d019614bd..8e6730c3b34 100644 --- a/src/locales/ja/index.ts +++ b/src/locales/ja/index.ts @@ -11,6 +11,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `ja` locale. + * + * - Language: Japanese + * - Endonym: 日本語 + */ const ja: LocaleDefinition = { cell_phone, company, diff --git a/src/locales/ka_GE/index.ts b/src/locales/ka_GE/index.ts index ea959663f60..b8146fddaa0 100644 --- a/src/locales/ka_GE/index.ts +++ b/src/locales/ka_GE/index.ts @@ -11,6 +11,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `ka_GE` locale. + * + * - Language: Georgian (Georgia) + * - Endonym: ქართული (საქართველო) + */ const ka_GE: LocaleDefinition = { cell_phone, company, diff --git a/src/locales/ko/index.ts b/src/locales/ko/index.ts index 48fc7bc9afa..3fd3a96b26d 100644 --- a/src/locales/ko/index.ts +++ b/src/locales/ko/index.ts @@ -14,6 +14,12 @@ import person from './person'; import phone_number from './phone_number'; import word from './word'; +/** + * The locale data for the `ko` locale. + * + * - Language: Korean + * - Endonym: 한국어 + */ const ko: LocaleDefinition = { color, company, diff --git a/src/locales/lv/index.ts b/src/locales/lv/index.ts index f9c9a72c180..cc91593a2f7 100644 --- a/src/locales/lv/index.ts +++ b/src/locales/lv/index.ts @@ -15,6 +15,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `lv` locale. + * + * - Language: Latvian + * - Endonym: latviešu valoda + */ const lv: LocaleDefinition = { cell_phone, color, diff --git a/src/locales/mk/index.ts b/src/locales/mk/index.ts index 68d5f6f43a2..78e543dd5b9 100644 --- a/src/locales/mk/index.ts +++ b/src/locales/mk/index.ts @@ -12,6 +12,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `mk` locale. + * + * - Language: Macedonian + * - Endonym: македонски јазик + */ const mk: LocaleDefinition = { cell_phone, company, diff --git a/src/locales/nb_NO/index.ts b/src/locales/nb_NO/index.ts index d9fa3d48875..a4747890031 100644 --- a/src/locales/nb_NO/index.ts +++ b/src/locales/nb_NO/index.ts @@ -14,6 +14,12 @@ import phone_number from './phone_number'; import science from './science'; import word from './word'; +/** + * The locale data for the `nb_NO` locale. + * + * - Language: Norwegian (Norway) + * - Endonym: Norsk bokmål (Norge) + */ const nb_NO: LocaleDefinition = { color, commerce, diff --git a/src/locales/ne/index.ts b/src/locales/ne/index.ts index 451ad1cf570..ab65258fea9 100644 --- a/src/locales/ne/index.ts +++ b/src/locales/ne/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `ne` locale. + * + * - Language: Nepali + * - Endonym: नेपाली + */ const ne: LocaleDefinition = { company, internet, diff --git a/src/locales/nl/index.ts b/src/locales/nl/index.ts index b7039fc2e99..e0032a22598 100644 --- a/src/locales/nl/index.ts +++ b/src/locales/nl/index.ts @@ -15,6 +15,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `nl` locale. + * + * - Language: Dutch + * - Endonym: Nederlands + */ const nl: LocaleDefinition = { color, commerce, diff --git a/src/locales/nl_BE/index.ts b/src/locales/nl_BE/index.ts index cc6da2f4059..5ed6b99ad1f 100644 --- a/src/locales/nl_BE/index.ts +++ b/src/locales/nl_BE/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `nl_BE` locale. + * + * - Language: Dutch (Belgium) + * - Endonym: Nederlands (België) + */ const nl_BE: LocaleDefinition = { company, internet, diff --git a/src/locales/pl/index.ts b/src/locales/pl/index.ts index b05c5f4eb31..bc0a36360d8 100644 --- a/src/locales/pl/index.ts +++ b/src/locales/pl/index.ts @@ -18,6 +18,12 @@ import phone_number from './phone_number'; import science from './science'; import team from './team'; +/** + * The locale data for the `pl` locale. + * + * - Language: Polish + * - Endonym: Polski + */ const pl: LocaleDefinition = { animal, book, diff --git a/src/locales/pt_BR/index.ts b/src/locales/pt_BR/index.ts index d654ab9d15b..00236a9a4c8 100644 --- a/src/locales/pt_BR/index.ts +++ b/src/locales/pt_BR/index.ts @@ -14,6 +14,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `pt_BR` locale. + * + * - Language: Portuguese (Brazil) + * - Endonym: Português (Brasil) + */ const pt_BR: LocaleDefinition = { color, commerce, diff --git a/src/locales/pt_PT/index.ts b/src/locales/pt_PT/index.ts index e60fe0aba5a..6f052da45f7 100644 --- a/src/locales/pt_PT/index.ts +++ b/src/locales/pt_PT/index.ts @@ -14,6 +14,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `pt_PT` locale. + * + * - Language: Portuguese (Portugal) + * - Endonym: Português (Portugal) + */ const pt_PT: LocaleDefinition = { cell_phone, color, diff --git a/src/locales/ro/index.ts b/src/locales/ro/index.ts index 87c61aa4494..27ca849ea8f 100644 --- a/src/locales/ro/index.ts +++ b/src/locales/ro/index.ts @@ -11,6 +11,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `ro` locale. + * + * - Language: Romanian + * - Endonym: Română + */ const ro: LocaleDefinition = { cell_phone, date, diff --git a/src/locales/ro_MD/index.ts b/src/locales/ro_MD/index.ts index 705ae65ec8b..451ea9be71e 100644 --- a/src/locales/ro_MD/index.ts +++ b/src/locales/ro_MD/index.ts @@ -11,6 +11,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `ro_MD` locale. + * + * - Language: Romanian (Moldova) + * - Endonym: Română (Moldova) + */ const ro_MD: LocaleDefinition = { cell_phone, date, diff --git a/src/locales/ru/index.ts b/src/locales/ru/index.ts index e2e7d0e6de6..a696c22fecf 100644 --- a/src/locales/ru/index.ts +++ b/src/locales/ru/index.ts @@ -15,6 +15,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `ru` locale. + * + * - Language: Russian + * - Endonym: Русский + */ const ru: LocaleDefinition = { color, commerce, diff --git a/src/locales/sk/index.ts b/src/locales/sk/index.ts index 3f274dbd0c8..f548144d697 100644 --- a/src/locales/sk/index.ts +++ b/src/locales/sk/index.ts @@ -11,6 +11,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `sk` locale. + * + * - Language: Slovak + * - Endonym: slovenčina + */ const sk: LocaleDefinition = { company, internet, diff --git a/src/locales/sr_RS_latin/index.ts b/src/locales/sr_RS_latin/index.ts index caaef34613c..eb1feed816c 100644 --- a/src/locales/sr_RS_latin/index.ts +++ b/src/locales/sr_RS_latin/index.ts @@ -11,6 +11,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `sr_RS_latin` locale. + * + * - Language: Serbian (Serbia, Latin) + * - Endonym: srpski (Srbija, latinica) + */ const sr_RS_latin: LocaleDefinition = { cell_phone, date, diff --git a/src/locales/sv/index.ts b/src/locales/sv/index.ts index c851468f5bf..6eca718e29c 100644 --- a/src/locales/sv/index.ts +++ b/src/locales/sv/index.ts @@ -15,6 +15,12 @@ import person from './person'; import phone_number from './phone_number'; import team from './team'; +/** + * The locale data for the `sv` locale. + * + * - Language: Swedish + * - Endonym: Svenska + */ const sv: LocaleDefinition = { cell_phone, color, diff --git a/src/locales/th/index.ts b/src/locales/th/index.ts index fe9562c5fce..a28027ce802 100644 --- a/src/locales/th/index.ts +++ b/src/locales/th/index.ts @@ -12,6 +12,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `th` locale. + * + * - Language: Thai + * - Endonym: ไทย + */ const th: LocaleDefinition = { animal, color, diff --git a/src/locales/tr/index.ts b/src/locales/tr/index.ts index b72e18540f7..a6c6d5001b3 100644 --- a/src/locales/tr/index.ts +++ b/src/locales/tr/index.ts @@ -13,6 +13,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `tr` locale. + * + * - Language: Turkish + * - Endonym: Türkçe + */ const tr: LocaleDefinition = { cell_phone, color, diff --git a/src/locales/uk/index.ts b/src/locales/uk/index.ts index 31ba1899e67..4915b3c33fb 100644 --- a/src/locales/uk/index.ts +++ b/src/locales/uk/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `uk` locale. + * + * - Language: Ukrainian + * - Endonym: Українська + */ const uk: LocaleDefinition = { company, internet, diff --git a/src/locales/ur/index.ts b/src/locales/ur/index.ts index f9fcaec8556..4d5b367464b 100644 --- a/src/locales/ur/index.ts +++ b/src/locales/ur/index.ts @@ -18,6 +18,12 @@ import person from './person'; import team from './team'; import vehicle from './vehicle'; +/** + * The locale data for the `ur` locale. + * + * - Language: Urdu + * - Endonym: اردو + */ const ur: LocaleDefinition = { animal, app, diff --git a/src/locales/uz_UZ_latin/index.ts b/src/locales/uz_UZ_latin/index.ts index af7692b20ff..ba1a956f01a 100644 --- a/src/locales/uz_UZ_latin/index.ts +++ b/src/locales/uz_UZ_latin/index.ts @@ -11,6 +11,12 @@ import lorem from './lorem'; import metadata from './metadata'; import person from './person'; +/** + * The locale data for the `uz_UZ_latin` locale. + * + * - Language: Uzbek (Uzbekistan, Latin) + * - Endonym: O'zbekcha + */ const uz_UZ_latin: LocaleDefinition = { color, commerce, diff --git a/src/locales/vi/index.ts b/src/locales/vi/index.ts index 519f1490c22..26f05187d2a 100644 --- a/src/locales/vi/index.ts +++ b/src/locales/vi/index.ts @@ -13,6 +13,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `vi` locale. + * + * - Language: Vietnamese + * - Endonym: Tiếng Việt + */ const vi: LocaleDefinition = { cell_phone, company, diff --git a/src/locales/yo_NG/index.ts b/src/locales/yo_NG/index.ts index 967e785c2fd..33a18948e40 100644 --- a/src/locales/yo_NG/index.ts +++ b/src/locales/yo_NG/index.ts @@ -6,6 +6,12 @@ import type { LocaleDefinition } from '../..'; import metadata from './metadata'; import person from './person'; +/** + * The locale data for the `yo_NG` locale. + * + * - Language: Yoruba (Nigeria) + * - Endonym: Yoruba (Naijiria) + */ const yo_NG: LocaleDefinition = { metadata, person, diff --git a/src/locales/zh_CN/index.ts b/src/locales/zh_CN/index.ts index 9666df9a888..7f83558d578 100644 --- a/src/locales/zh_CN/index.ts +++ b/src/locales/zh_CN/index.ts @@ -22,6 +22,12 @@ import science from './science'; import vehicle from './vehicle'; import word from './word'; +/** + * The locale data for the `zh_CN` locale. + * + * - Language: Chinese (China) + * - Endonym: 中文 (中国) + */ const zh_CN: LocaleDefinition = { airline, animal, diff --git a/src/locales/zh_TW/index.ts b/src/locales/zh_TW/index.ts index d837b7e0c4a..17ae61eda75 100644 --- a/src/locales/zh_TW/index.ts +++ b/src/locales/zh_TW/index.ts @@ -10,6 +10,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `zh_TW` locale. + * + * - Language: Chinese (Taiwan) + * - Endonym: 中文 (臺灣) + */ const zh_TW: LocaleDefinition = { color, date, diff --git a/src/locales/zu_ZA/index.ts b/src/locales/zu_ZA/index.ts index 0e86ac702ec..740d594e9dd 100644 --- a/src/locales/zu_ZA/index.ts +++ b/src/locales/zu_ZA/index.ts @@ -11,6 +11,12 @@ import metadata from './metadata'; import person from './person'; import phone_number from './phone_number'; +/** + * The locale data for the `zu_ZA` locale. + * + * - Language: Zulu (South Africa) + * - Endonym: isiZulu (Iningizimu Afrika) + */ const zu_ZA: LocaleDefinition = { cell_phone, company,