refactor(person)!: flatten jobs definitions (#2505)

docs/guide/upgrading_v9/2505.md

@@ -0,0 +1,9 @@
+### Jobs definitions reorganized
+
+The locale definitions used by `faker.person.jobTitle()`, `faker.person.jobDescriptor()`, `faker.person.jobArea()` and `faker.person.jobType()` have been reorganized and are no longer nested under `definitions.person.title`. If you are using the public methods, no changes are required. You only need to change your code if you are accessing the raw definitions e.g. in `faker.helpers.fake()`.
+
+| Before                    | After                   |
+| ------------------------- | ----------------------- |
+| `person.title.descriptor` | `person.job_descriptor` |
+| `person.title.level`      | `person.job_area`       |
+| `person.title.job`        | `person.job_type`       |

src/definitions/index.ts

@@ -17,7 +17,7 @@ export type { LocationDefinition } from './location';
 export type { LoremDefinition } from './lorem';
 export type { MetadataDefinition } from './metadata';
 export type { MusicDefinition } from './music';
-export type { PersonDefinition, PersonTitleDefinition } from './person';
+export type { PersonDefinition } from './person';
 export type { PhoneNumberDefinition } from './phone_number';
 export type { ScienceDefinition } from './science';
 export type { SystemDefinition, SystemMimeTypeEntryDefinition } from './system';

src/definitions/person.ts

@@ -39,18 +39,11 @@ export type PersonDefinition = LocaleEntry<{
 
   bio_pattern: string[];
 
-  title: PersonTitleDefinition;
+  job_descriptor: string[];
+  job_area: string[];
+  job_type: string[];
 
   job_title_pattern: string[];
 
   western_zodiac_sign: string[];
 }>;
-
-/**
- * The possible definitions related to people's titles.
- */
-export type PersonTitleDefinition = LocaleEntry<{
-  descriptor: string[];
-  job: string[];
-  level: string[];
-}>;

src/index.ts

@@ -49,10 +49,7 @@ export type {
   MusicDefinition as MusicDefinitions,
   /** @deprecated Use PersonDefinitions instead */
   PersonDefinition as NameDefinitions,
-  /** @deprecated Use PersonTitleDefinitions instead */
-  PersonTitleDefinition as NameTitleDefinitions,
   PersonDefinition,
-  PersonTitleDefinition,
   PhoneNumberDefinition,
   /** @deprecated Use PhoneNumberDefinition instead */
   PhoneNumberDefinition as PhoneNumberDefinitions,

src/locales/ar/person/index.ts

@@ -6,27 +6,27 @@ import type { PersonDefinition } from '../../..';
 import female_first_name from './female_first_name';
 import female_prefix from './female_prefix';
 import first_name from './first_name';
+import job_type from './job_type';
 import last_name from './last_name';
 import last_name_pattern from './last_name_pattern';
 import male_first_name from './male_first_name';
 import male_prefix from './male_prefix';
 import name_ from './name';
 import prefix from './prefix';
 import suffix from './suffix';
-import title from './title';
 
 const person: PersonDefinition = {
   female_first_name,
   female_prefix,
   first_name,
+  job_type,
   last_name,
   last_name_pattern,
   male_first_name,
   male_prefix,
   name: name_,
   prefix,
   suffix,
-  title,
 };
 
 export default person;

src/locales/ar/person/job_type.ts

@@ -0,0 +1,20 @@
+export default [
+  'مشرف',
+  'تنفيذي',
+  'مدير',
+  'مهندس',
+  'متخصص',
+  'رئيس مؤسسة',
+  'منسق',
+  'إداري',
+  'مخطط',
+  'محلل',
+  'مصمم',
+  'تقني',
+  'مبرمج',
+  'منتج',
+  'مستشار',
+  'مساعد',
+  'وكيل',
+  'متدرب',
+];

src/locales/el/person/index.ts

@@ -6,25 +6,29 @@ import type { PersonDefinition } from '../../..';
 import female_first_name from './female_first_name';
 import female_prefix from './female_prefix';
 import first_name from './first_name';
+import job_area from './job_area';
+import job_descriptor from './job_descriptor';
+import job_type from './job_type';
 import last_name from './last_name';
 import last_name_pattern from './last_name_pattern';
 import male_first_name from './male_first_name';
 import male_prefix from './male_prefix';
 import name_ from './name';
 import prefix from './prefix';
-import title from './title';
 
 const person: PersonDefinition = {
   female_first_name,
   female_prefix,
   first_name,
+  job_area,
+  job_descriptor,
+  job_type,
   last_name,
   last_name_pattern,
   male_first_name,
   male_prefix,
   name: name_,
   prefix,
-  title,
 };
 
 export default person;

src/locales/el/person/job_area.ts

@@ -0,0 +1,32 @@
+export default [
+  'Λύσεις',
+  'Πρόγραμμα',
+  'Μάρκα',
+  'Ασφάλεια',
+  'Έρευνα',
+  'Μάρκετινγκ',
+  'Οδηγιών',
+  'Εφαρμογή',
+  'Ενσωμάτωση',
+  'Λειτουργικότητα',
+  'Τακτική',
+  'Ταυτότητα',
+  'Αγορές',
+  'Όμιλος',
+  'Εφαρμογές',
+  'Βελτιστοποίηση',
+  'Δραστηριότητες',
+  'Υποδομή',
+  'Intranet',
+  'Επικοινωνίες',
+  'Web',
+  'Branding',
+  'Ποιότητα',
+  'Διασφάλιση',
+  'Κινητικότητα',
+  'Λογαριασμοί',
+  'Δεδομένα',
+  'Δημιουργική',
+  'Διαμόρφωση',
+  'Μετρήσεις',
+];

src/locales/el/person/job_descriptor.ts

@@ -0,0 +1,8 @@
+export default [
+  'Senior',
+  'Εταιρείες',
+  'Πελάτης',
+  'Επενδυτής',
+  'Εσωτερικό',
+  'Κύριος',
+];

src/locales/el/person/job_type.ts

@@ -0,0 +1,19 @@
+export default [
+  'Επόπτης',
+  'Συνεργάτης',
+  'Σύμβουλος',
+  'Διευθυντής',
+  'Μηχανικός',
+  'Ειδικός',
+  'Συντονιστή',
+  'Διαχειριστής',
+  'Αναλυτής',
+  'Designer',
+  'Τεχνικός',
+  'Προγραμματιστής',
+  'Παραγωγός',
+  'Βοηθός',
+  'Συντονιστής',
+  'Εκπρόσωπος',
+  'Αντιπρόσωπος',
+];

src/locales/en/person/index.ts

@@ -11,7 +11,10 @@ import female_middle_name from './female_middle_name';
 import female_prefix from './female_prefix';
 import first_name from './first_name';
 import gender from './gender';
+import job_area from './job_area';
+import job_descriptor from './job_descriptor';
 import job_title_pattern from './job_title_pattern';
+import job_type from './job_type';
 import last_name from './last_name';
 import last_name_pattern from './last_name_pattern';
 import male_first_name from './male_first_name';
@@ -22,7 +25,6 @@ import name_ from './name';
 import prefix from './prefix';
 import sex from './sex';
 import suffix from './suffix';
-import title from './title';
 import western_zodiac_sign from './western_zodiac_sign';
 
 const person: PersonDefinition = {
@@ -34,7 +36,10 @@ const person: PersonDefinition = {
   female_prefix,
   first_name,
   gender,
+  job_area,
+  job_descriptor,
   job_title_pattern,
+  job_type,
   last_name,
   last_name_pattern,
   male_first_name,
@@ -45,7 +50,6 @@ const person: PersonDefinition = {
   prefix,
   sex,
   suffix,
-  title,
   western_zodiac_sign,
 };
 

src/locales/en/person/job_area.ts

@@ -0,0 +1,39 @@
+export default [
+  'Solutions',
+  'Program',
+  'Brand',
+  'Security',
+  'Research',
+  'Marketing',
+  'Directives',
+  'Implementation',
+  'Integration',
+  'Functionality',
+  'Response',
+  'Paradigm',
+  'Tactics',
+  'Identity',
+  'Markets',
+  'Group',
+  'Division',
+  'Applications',
+  'Optimization',
+  'Operations',
+  'Infrastructure',
+  'Intranet',
+  'Communications',
+  'Web',
+  'Branding',
+  'Quality',
+  'Assurance',
+  'Mobility',
+  'Accounts',
+  'Data',
+  'Creative',
+  'Configuration',
+  'Accountability',
+  'Interactions',
+  'Factors',
+  'Usability',
+  'Metrics',
+];

src/locales/en/person/job_descriptor.ts

@@ -0,0 +1,23 @@
+export default [
+  'Lead',
+  'Senior',
+  'Direct',
+  'Corporate',
+  'Dynamic',
+  'Future',
+  'Product',
+  'National',
+  'Regional',
+  'District',
+  'Central',
+  'Global',
+  'Customer',
+  'Investor',
+  'International',
+  'Legacy',
+  'Forward',
+  'Internal',
+  'Human',
+  'Chief',
+  'Principal',
+];