Merge pull request #7946 from pistacchio/master

Added definition for random-js
2026-09-09 11:13:57 +08:00 · 2016-02-07 00:50:48 +09:00
parent abc15eb1bc a5665d15ab
commit 918844eef5
2 changed files with 91 additions and 0 deletions
@@ -0,0 +1,29 @@
+/// <reference path="random-js.d.ts"/>
+/// <reference path="../node/node.d.ts"/>
+
+// Examples taken from the documentation at https://github.com/ckknight/random-js
+// create a Mersenne Twister-19937 that is auto-seeded based on time and other random values
+import Engine = random.Engine;
+import Random = random.Random;
+
+var engine: Engine = Random.engines.mt19937().autoSeed();
+// create a distribution that will consistently produce integers within inclusive range [0, 99].
+var distribution: Function = Random.integer(0, 99);
+// generate a number that is guaranteed to be within [0, 99] without any particular bias.
+function generateNaturalLessThan100(): number {
+    return distribution(engine);
+}
+
+// using essentially Math.random()
+var engine2: Engine = Random.engines.nativeMath;
+// lower-case Hex string distribution
+var distribution2: Function = Random.hex(false);
+// generate a 40-character hex string
+function generateSHA1(): string {
+    return distribution(40);
+}
+
+var r: Random = new Random(Random.engines.mt19937().seedWithArray([0x12345678, 0x90abcdef]));
+var value = r.integer(0, 99);
+
+r = new Random(); // same as new Random(Random.engines.nativeMath)
@@ -0,0 +1,62 @@
+// Type definitions for random-js 1.0.8
+// Project: https://github.com/ckknight/random-js
+// Definitions by: Gustavo Di Pietro <https://github.com/pistacchio>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+declare module random {
+    export function Engine(): number;
+    export interface Engine {
+
+    }
+
+    export function MT19937 (): number;
+    export interface MT19937 extends Engine{
+        seed (value: number): Engine;
+        seedWithArray(array: Array<number>): Engine
+        autoSeed(): Engine;
+        discard(count: number): Engine;
+        getUseCount(): Engine;
+    }
+
+    export class Random {
+        constructor (engine?: Engine);
+
+        static engines: {
+            nativeMath: Engine,
+            browserCrypto: Engine,
+            mt19937: () => MT19937
+        }
+
+        static integer(min: number, max: number): (engine: Engine) => number;
+        static real(min: number, max: number, inclusive: boolean): (engine: Engine) => number;
+        static bool(percentage?: number): (engine: Engine) => boolean;
+        static bool(numerator: number, denominator: number): (engine: Engine) => boolean;
+        static pick<T>(engine: Engine, array: Array<T>, begin?: number, end?: number): T;
+        static picker<T>(array: Array<T>, begin?: number, end?: number): (engine: Engine) => T;
+        static shuffle<T>(engine: Engine, array: Array<T>): Array<T>;
+        static sample<T>(engine: Engine, population: Array<T>, sampleSize: number): Array<T>;
+        static die(sideCount: number): (engine: Engine) => number;
+        static dice(sideCount: number, dieCount: number): (engine: Engine) => number;
+        static uuid4(engine: Engine): string;
+        static string(engine: Engine, length: number): string;
+        static string(pool: string, length: number): (engine: Engine, length: number) => string;
+        static hex(upperCase?: boolean): (engine: Engine, length: number) => string;
+        static date(start: Date, end: Date): (engine: Engine) => Date;
+
+        integer(min: number, max: number): number;
+        real(min: number, max: number, inclusive: boolean): number;
+        bool(percentage?: number): (engine: Engine) => boolean;
+        bool(numerator: number, denominator: number): boolean;
+        pick<T>(engine: Engine, array: Array<T>, begin?: number, end?: number): T;
+        picker<T>(array: Array<T>, begin?: number, end?: number): (engine: Engine) => T;
+        shuffle<T>(engine: Engine, array: Array<T>): Array<T>;
+        sample<T>(engine: Engine, population: Array<T>, sampleSize: number): Array<T>;
+        die(sideCount: number): (engine: Engine) => number;
+        dice(sideCount: number, dieCount: number): number;
+        uuid4(engine: Engine): string;
+        string(engine: Engine, length: number): string;
+        string(pool: string, length: number): string;
+        hex(upperCase?: boolean): string;
+        date(start: Date, end: Date): Date;
+    }
+}