refactor!: make mersenne internal (#1444)

src/faker.ts

@@ -1,5 +1,6 @@
 import type { LocaleDefinition } from './definitions';
 import { FakerError } from './errors/faker-error';
+import { MersenneModule } from './internal/mersenne/mersenne';
 import type { KnownLocale } from './locales';
 import { AddressModule } from './modules/address';
 import { AnimalModule } from './modules/animal';
@@ -16,7 +17,6 @@ import { HelpersModule } from './modules/helpers';
 import { ImageModule } from './modules/image';
 import { InternetModule } from './modules/internet';
 import { LoremModule } from './modules/lorem';
-import { MersenneModule } from './modules/mersenne';
 import { MusicModule } from './modules/music';
 import { NameModule } from './modules/name';
 import { PhoneModule } from './modules/phone';
@@ -74,10 +74,9 @@ export class Faker {
 
   readonly definitions: LocaleDefinition = this.initDefinitions();
 
-  /**
-   * @internal
-   */
-  readonly mersenne: MersenneModule = new MersenneModule();
+  /** @internal */
+  private readonly _mersenne: MersenneModule = new MersenneModule();
+
   readonly random: RandomModule = new RandomModule(this);
 
   readonly helpers: HelpersModule = new HelpersModule(this);
@@ -241,9 +240,9 @@ export class Faker {
     seed: number | number[] = Math.ceil(Math.random() * Number.MAX_SAFE_INTEGER)
   ): number | number[] {
     if (Array.isArray(seed) && seed.length) {
-      this.mersenne.seed_array(seed);
+      this._mersenne.seed_array(seed);
     } else if (!Array.isArray(seed) && !isNaN(seed)) {
-      this.mersenne.seed(seed);
+      this._mersenne.seed(seed);
     }
 
     return seed;

src/modules/mersenne/twister.ts → src/internal/mersenne/twister.ts

@@ -68,8 +68,9 @@
  * Any feedback is very welcome.
  *   http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/emt.html
  *   email: m-mat @ math.sci.hiroshima-u.ac.jp (remove space)
+ *
+ * @internal
  */
-
 export default class MersenneTwister19937 {
   private readonly N = 624;
   private readonly M = 397;

src/modules/datatype/index.ts

@@ -1,5 +1,6 @@
 import type { Faker } from '../..';
 import { FakerError } from '../../errors/faker-error';
+import type { MersenneModule } from '../../internal/mersenne/mersenne';
 
 /**
  * Module to generate various primitive values and data types.
@@ -54,8 +55,12 @@ export class DatatypeModule {
       throw new FakerError(`Max ${max} should be greater than min ${min}.`);
     }
 
+    const mersenne: MersenneModule =
+      // @ts-expect-error: access private member field
+      this.faker._mersenne;
+
     const randomNumber = Math.floor(
-      this.faker.mersenne.rand(max / precision + 1, min / precision)
+      mersenne.rand(max / precision + 1, min / precision)
     );
 
     // Workaround problem in float point arithmetics for e.g. 6681493 / 0.01

test/all_functional.spec.ts

@@ -8,7 +8,7 @@ const IGNORED_MODULES = [
   'definitions',
   'fake',
   'helpers',
-  'mersenne',
+  '_mersenne',
 ];
 
 function isTestableModule(mod: string) {

test/mersenne.spec.ts

@@ -1,6 +1,6 @@
 import { beforeAll, beforeEach, describe, expect, it } from 'vitest';
 import { FakerError } from '../src/errors/faker-error';
-import { MersenneModule } from '../src/modules/mersenne';
+import { MersenneModule } from '../src/internal/mersenne/mersenne';
 import { seededRuns } from './support/seededRuns';
 
 const minMaxTestCases = [

test/scripts/apidoc/examplesAndDeprecations.spec.ts

@@ -32,15 +32,13 @@ describe('examples and deprecations', () => {
 
   const modules: Record<string, DeclarationReflection[]> = selectApiModules(
     project
-  )
-    .filter((module) => module.name !== 'MersenneModule')
-    .reduce(
-      (a, v) => ({
-        ...a,
-        [v.name]: v.getChildrenByKind(ReflectionKind.Method),
-      }),
-      {}
-    );
+  ).reduce(
+    (a, v) => ({
+      ...a,
+      [v.name]: v.getChildrenByKind(ReflectionKind.Method),
+    }),
+    {}
+  );
 
   const consoleSpies: Array<SpyInstance> = Object.keys(console)
     .filter((key) => typeof console[key] === 'function')