docs: expose documentation for randomizers (#3221)

1 files changed, 22 insertions, 0 deletions

diff --git a/src/utils/mersenne.ts b/src/utils/mersenne.ts
index de415f91..315335ab 100644
--- a/src/utils/mersenne.ts
+++ b/src/utils/mersenne.ts
@@ -4,6 +4,17 @@ import type { Randomizer } from '../randomizer';
 /**
  * Generates a MersenneTwister19937 randomizer with 32 bits of precision.
  * This is the default randomizer used by faker prior to v9.0.
+ *
+ * @example
+ * import { de, en, generateMersenne32Randomizer, Faker } from '@faker-js/faker';
+ *
+ * const randomizer = generateMersenne32Randomizer();
+ * randomizer.seed(42);
+ * // Share the same randomizer between multiple instances
+ * const customFaker1 = new Faker({ locale: de, randomizer });
+ * const customFaker2 = new Faker({ locale: en, randomizer });
+ *
+ * @since 8.2.0
  */
 export function generateMersenne32Randomizer(): Randomizer {
   const twister = new MersenneTwister19937();
@@ -27,6 +38,17 @@ export function generateMersenne32Randomizer(): Randomizer {
 /**
  * Generates a MersenneTwister19937 randomizer with 53 bits of precision.
  * This is the default randomizer used by faker starting with v9.0.
+ *
+ * @example
+ * import { de, en, generateMersenne53Randomizer, Faker } from '@faker-js/faker';
+ *
+ * const randomizer = generateMersenne53Randomizer();
+ * randomizer.seed(42);
+ * // Share the same randomizer between multiple instances
+ * const customFaker1 = new Faker({ locale: de, randomizer });
+ * const customFaker2 = new Faker({ locale: en, randomizer });
+ *
+ * @since 9.0.0
  */
 export function generateMersenne53Randomizer(): Randomizer {
   const twister = new MersenneTwister19937();