feat(phone)!: add new style parameter (#2578)

Author: matthewmayer

docs/guide/upgrading_v9/2578.md

@@ -12,5 +12,18 @@ export type PhoneNumberDefinition = LocaleEntry<{
    *
    * @see faker.helpers.replaceSymbolWithNumber(format): For more information about how the patterns are used.
    */
-  formats: string[];
+  format: {
+    /**
+     * Formats for a human-input phone number, e.g. `555-770-7727` or `555.770.7727 x1234`
+     */
+    human: string[];
+    /**
+     * Formats for a phone number in a standardized national format, e.g. `(555) 123-4567`.
+     */
+    national: string[];
+    /**
+     * Formats for a phone number in the standardised E.123 format, e.g. `+15551234567`
+     */
+    international: string[];
+  };
 }>;

src/definitions/phone_number.ts

@@ -0,0 +1,16 @@
+/*
+ * This file is automatically generated.
+ * Run 'pnpm run generate:locales' to update.
+ */
+import type { PhoneNumberDefinition } from '../../../..';
+import human from './human';
+import international from './international';
+import national from './national';
+
+const format: PhoneNumberDefinition['format'] = {
+  human,
+  international,
+  national,
+};
+
+export default format;

src/locales/af_ZA/phone_number/formats.ts …cales/af_ZA/phone_number/format/human.tssrc/locales/af_ZA/phone_number/formats.ts renamed to src/locales/af_ZA/phone_number/format/human.ts src/locales/af_ZA/phone_number/formats.ts renamed to src/locales/af_ZA/phone_number/format/human.ts

@@ -0,0 +1,9 @@
+export default [
+  '+271#########',
+  '+272#########',
+  '+273#########',
+  '+274#########',
+  '+275#########',
+  '+27800######',
+  '+27860######',
+];

src/locales/af_ZA/phone_number/format/index.ts

@@ -0,0 +1,9 @@
+export default [
+  '1#########',
+  '2#########',
+  '3#########',
+  '4#########',
+  '5#########',
+  '080 0## ####',
+  '0860 ### ###',
+];

src/locales/af_ZA/phone_number/format/international.ts

@@ -3,10 +3,10 @@
  * Run 'pnpm run generate:locales' to update.
  */
 import type { PhoneNumberDefinition } from '../../..';
-import formats from './formats';
+import format from './format';
 
 const phone_number: PhoneNumberDefinition = {
-  formats,
+  format,
 };
 
 export default phone_number;

src/locales/af_ZA/phone_number/format/national.ts

@@ -11,7 +11,6 @@ import location from './location';
 import lorem from './lorem';
 import metadata from './metadata';
 import person from './person';
-import phone_number from './phone_number';
 import team from './team';
 import vehicle from './vehicle';
 
@@ -24,7 +23,6 @@ const ar: LocaleDefinition = {
   lorem,
   metadata,
   person,
-  phone_number,
   team,
   vehicle,
 };