refactor(random)!: remove deprecated random module (#2678)

docs/.vitepress/api-pages.ts

@@ -30,7 +30,6 @@ export const apiPages = [
       { text: 'Number', link: '/api/number.html' },
       { text: 'Person', link: '/api/person.html' },
       { text: 'Phone', link: '/api/phone.html' },
-      { text: 'Random', link: '/api/random.html' },
       { text: 'Science', link: '/api/science.html' },
       { text: 'String', link: '/api/string.html' },
       { text: 'System', link: '/api/system.html' },

docs/guide/upgrading_v9/2678.md

@@ -0,0 +1,12 @@
+### Remove deprecated random module
+
+Removed deprecated random module
+
+| old                           | replacement                                     |
+| ----------------------------- | ----------------------------------------------- |
+| `faker.random.alpha()`        | `faker.string.alpha()`                          |
+| `faker.random.alphaNumeric()` | `faker.string.alphanumeric()`                   |
+| `faker.random.locale()`       | `faker.helpers.objectKey(allLocales/allFakers)` |
+| `faker.random.numeric()`      | `faker.string.numeric()`                        |
+| `faker.random.word()`         | `faker.lorem.word()` or `faker.word.sample()`   |
+| `faker.random.words()`        | `faker.lorem.words()` or `faker.word.words()`   |

src/faker.ts

@@ -24,7 +24,6 @@ import { MusicModule } from './modules/music';
 import type { PersonModule as NameModule } from './modules/person';
 import { PersonModule } from './modules/person';
 import { PhoneModule } from './modules/phone';
-import { RandomModule } from './modules/random';
 import { ScienceModule } from './modules/science';
 import { SystemModule } from './modules/system';
 import { VehicleModule } from './modules/vehicle';
@@ -62,12 +61,6 @@ export class Faker extends SimpleFaker {
   readonly rawDefinitions: LocaleDefinition;
   readonly definitions: LocaleProxy;
 
-  /**
-   * @deprecated Use the modules specific to the type of data you want to generate instead.
-   */
-  // eslint-disable-next-line deprecation/deprecation
-  readonly random: RandomModule = new RandomModule(this);
-
   readonly airline: AirlineModule = new AirlineModule(this);
   readonly animal: AnimalModule = new AnimalModule(this);
   readonly color: ColorModule = new ColorModule(this);

src/index.ts

@@ -124,8 +124,6 @@ export type {
   SexType,
 } from './modules/person';
 export type { PhoneModule } from './modules/phone';
-// eslint-disable-next-line deprecation/deprecation
-export type { RandomModule } from './modules/random';
 export type { ChemicalElement, ScienceModule, Unit } from './modules/science';
 export type { StringModule } from './modules/string';
 export type { SystemModule } from './modules/system';