@guillaume-docquier/tools-ts 7.0.0 → 7.1.0

package/README.md

@@ -58,11 +58,12 @@ Use this tool when code needs shared ordering helpers.
 Use these tools when code needs injectable randomness or deterministic
 pseudo-random sequences.
 
-| Export           | What it is                                                           | Use it when                                                                               |
-| ---------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
-| `Rng`            | Builds an RNG facade from a generator that returns values in [0, 1). | You need range-aware random numbers, shuffling, or draws backed by injectable randomness. |
-| `Generator`      | Type for raw generators that return values in [0, 1).                | You accept or provide the primitive random source used to construct an `Rng`.             |
-| `mulberry32Prng` | Deterministic seeded pseudo-random generator factory.                | Tests, simulations, or generation code need repeatable pseudo-random sequences.           |
+| Export           | What it is                                                        | Use it when                                                                           |
+| ---------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
+| `Rng`            | Builds a stateful RNG facade from a serializable generator.       | You need range-aware random numbers, shuffling, draws, or resumable random sequences. |
+| `RngState`       | Serializable generator and cached-normal state captured by `Rng`. | You need to persist an `Rng` and resume its exact sequence later.                     |
+| `Generator`      | Contract for random sources that expose their serializable state. | You provide the primitive, resumable random source used to construct an `Rng`.        |
+| `mulberry32Prng` | Deterministic, resumable Mulberry32 generator factory.            | Tests, simulations, or generation code need repeatable pseudo-random sequences.       |
 
 ### Utility Types
 

package/dist/entry.tools-ts.d.ts

@@ -26,7 +26,8 @@ export type { LoggerContext } from "./logging/log-context/LoggerContext.js";
 export type { LogContextProvider } from "./logging/log-context/LogContextProvider.js";
 export { debounce } from "./debounce.js";
 export { Sort } from "./Sort.js";
-export { Rng, type Generator } from "./rng/Rng.js";
+export { Rng, type RngState } from "./rng/Rng.js";
+export type { Generator } from "./rng/Generator.js";
 export { mulberry32Prng } from "./rng/mulberry32prng.js";
 export { Datetime } from "./Datetime.js";
 export { Angle, UnitOfAngle } from "./measurements/Angle.js";

package/dist/entry.tools-ts.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.tools-ts.js","sourceRoot":"","sources":["../src/entry.tools-ts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAI5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAA8B,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAA;AAEtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAKvE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,GAAG,EAAkB,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,OAAO,EAAW,MAAM,2BAA2B,CAAA;AAC5D,OAAO,EAAE,OAAO,EAAY,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAgB,OAAO,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"entry.tools-ts.js","sourceRoot":"","sources":["../src/entry.tools-ts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAI5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAA8B,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAA;AAEtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAKvE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,GAAG,EAAiB,MAAM,cAAc,CAAA;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,OAAO,EAAW,MAAM,2BAA2B,CAAA;AAC5D,OAAO,EAAE,OAAO,EAAY,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAgB,OAAO,EAAE,MAAM,YAAY,CAAA"}

package/dist/rng/Generator.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A stateful generator that returns numbers in the range [0, 1).
+ * Its state must be serializable so the generated sequence can be resumed.
+ */
+export type Generator<TState = unknown> = {
+    next: () => number;
+    getState: () => TState;
+};

package/dist/rng/Generator.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Generator.js.map

package/dist/rng/Generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Generator.js","sourceRoot":"","sources":["../../src/rng/Generator.ts"],"names":[],"mappings":""}

package/dist/rng/Generator.stub.d.ts

@@ -0,0 +1,2 @@
+import type { Generator } from "./Generator.js";
+export declare function createGeneratorStub(value: number | (() => number)): Generator<null>;

package/dist/rng/Generator.stub.js

@@ -0,0 +1,8 @@
+import { TypeGuard } from "../TypeGuard.js";
+export function createGeneratorStub(value) {
+    return {
+        next: TypeGuard.isNumber(value) ? () => value : value,
+        getState: () => null,
+    };
+}
+//# sourceMappingURL=Generator.stub.js.map

package/dist/rng/Generator.stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Generator.stub.js","sourceRoot":"","sources":["../../src/rng/Generator.stub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAG3C,MAAM,UAAU,mBAAmB,CAAC,KAA8B;IAChE,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;QACrD,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;KACrB,CAAA;AACH,CAAC"}

package/dist/rng/Rng.d.ts

@@ -1,9 +1,10 @@
 import type { Range } from "../Range.js";
-/**
- * A generator that returns numbers in the range [0, 1)
- */
-export type Generator = () => number;
-export type Rng = {
+import { type Generator } from "./Generator.js";
+export type RngState<TGeneratorState> = {
+    generatorState: TGeneratorState;
+    spareNormal: number | null;
+};
+export type Rng<TGeneratorState = unknown> = {
     /**
      * Generates a random number based on the given Range.
      * It will output an int given an int Range, or a float given a float Range.
@@ -36,11 +37,19 @@ export type Rng = {
      * The std is the spread of the distribution (default: 1)
      */
     normal: (mean?: number, std?: number) => number;
+    /**
+     * Returns the state required to resume the random sequence.
+     */
+    getState: () => RngState<TGeneratorState>;
 };
 export declare const Rng: {
     /**
      * Creates a random number generator based on your generator of choice.
      * @param generator The generator that returns numbers in the range [0, 1)
      */
-    create: (generator: Generator) => Rng;
+    create<TGeneratorState>(generator: Generator<TGeneratorState>): Rng<TGeneratorState>;
+    /**
+     * Restores a random number generator from previously captured state.
+     */
+    fromState<TGeneratorState>(state: RngState<TGeneratorState>, createGenerator: (state: TGeneratorState) => Generator<TGeneratorState>): Rng<TGeneratorState>;
 };

package/dist/rng/Rng.js

@@ -8,74 +8,90 @@ export const Rng = {
      * Creates a random number generator based on your generator of choice.
      * @param generator The generator that returns numbers in the range [0, 1)
      */
-    create: (generator) => {
-        function random(range) {
-            switch (range.numericType) {
-                case "float":
-                    // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- The fact we have to cast like this sucks a little bit, we'll see if we have to do this often or not.
-                    return float(range);
-                case "integer":
-                    // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- The fact we have to cast like this sucks a little bit, we'll see if we have to do this often or not.
-                    return int(range);
-            }
-        }
-        function float(range) {
-            if (range === undefined) {
-                return generator();
-            }
-            // Because of floating point errors, this is inclusive when min > 1, but that's statistically insignificant.
-            return range.min + generator() * (range.max - range.min);
-        }
-        function int(range) {
-            // We +1 the max because float is exclusive of the max, but for int we want the range to be inclusive.
-            // We floor before the addition, because the addition can lose precision and generate numbers that are out of bounds when float ~= 1.
-            // We don't use Math.floor(float(rangeWithMaxPlus1)) for the same reason
-            return range.min + Math.floor(float() * (range.max + intBoundsOffset[range.maxBoundType] - range.min));
+    create(generator) {
+        return createRng(generator, null);
+    },
+    /**
+     * Restores a random number generator from previously captured state.
+     */
+    fromState(state, createGenerator) {
+        return createRng(createGenerator(state.generatorState), state.spareNormal);
+    },
+};
+function createRng(generator, initialSpareNormal) {
+    function random(range) {
+        switch (range.numericType) {
+            case "float":
+                // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- The fact we have to cast like this sucks a little bit, we'll see if we have to do this often or not.
+                return float(range);
+            case "integer":
+                // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- The fact we have to cast like this sucks a little bit, we'll see if we have to do this often or not.
+                return int(range);
         }
-        /**
-         * Fisher-Yates shuffle in place.
-         */
-        function shuffle(values) {
-            for (let i = values.length - 1; i > 0; i--) {
-                const j = Math.floor(generator() * (i + 1));
-                [values[i], values[j]] = [values[j], values[i]];
-            }
-            return values;
+    }
+    function float(range) {
+        if (range === undefined) {
+            return generator.next();
         }
-        function draw(values, count) {
-            const shuffled = shuffle(values.slice());
-            return {
-                drawn: shuffled,
-                remaining: shuffled.splice(count),
-            };
+        // Because of floating point errors, this is inclusive when min > 1, but that's statistically insignificant.
+        return range.min + generator.next() * (range.max - range.min);
+    }
+    function int(range) {
+        // We +1 the max because float is exclusive of the max, but for int we want the range to be inclusive.
+        // We floor before the addition, because the addition can lose precision and generate numbers that are out of bounds when float ~= 1.
+        // We don't use Math.floor(float(rangeWithMaxPlus1)) for the same reason
+        return range.min + Math.floor(float() * (range.max + intBoundsOffset[range.maxBoundType] - range.min));
+    }
+    /**
+     * Fisher-Yates shuffle in place.
+     */
+    function shuffle(values) {
+        for (let i = values.length - 1; i > 0; i--) {
+            const j = Math.floor(generator.next() * (i + 1));
+            [values[i], values[j]] = [values[j], values[i]];
         }
-        /**
-         * box-muller outputs 2 numbers, so we keep the extra value that we can return instead of recomputing
-         */
-        let spareNormal;
-        function normal(mean = 0, std = 1) {
-            if (spareNormal !== undefined) {
-                const value = spareNormal;
-                spareNormal = undefined;
-                return mean + std * value;
-            }
-            // u1 must be non-zero
-            let u1;
-            do {
-                u1 = generator();
-            } while (u1 === 0);
-            const { z1, z2 } = boxMullerSample(u1, generator());
-            spareNormal = z1;
-            return mean + std * z2;
+        return values;
+    }
+    function draw(values, count) {
+        const shuffled = shuffle(values.slice());
+        return {
+            drawn: shuffled,
+            remaining: shuffled.splice(count),
+        };
+    }
+    /**
+     * box-muller outputs 2 numbers, so we keep the extra value that we can return instead of recomputing
+     */
+    let spareNormal = initialSpareNormal;
+    function normal(mean = 0, std = 1) {
+        if (spareNormal !== null) {
+            const value = spareNormal;
+            spareNormal = null;
+            return mean + std * value;
         }
+        // u1 must be non-zero
+        let u1;
+        do {
+            u1 = generator.next();
+        } while (u1 === 0);
+        const { z1, z2 } = boxMullerSample(u1, generator.next());
+        spareNormal = z1;
+        return mean + std * z2;
+    }
+    function getState() {
         return {
-            random,
-            float,
-            int,
-            shuffle,
-            draw,
-            normal,
+            generatorState: generator.getState(),
+            spareNormal,
         };
-    },
-};
+    }
+    return {
+        random,
+        float,
+        int,
+        shuffle,
+        draw,
+        normal,
+        getState,
+    };
+}
 //# sourceMappingURL=Rng.js.map

package/dist/rng/Rng.js.map

@@ -1 +1 @@
-{"version":3,"file":"Rng.js","sourceRoot":"","sources":["../../src/rng/Rng.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Rng.js","sourceRoot":"","sources":["../../src/rng/Rng.ts"],"names":[],"mappings":"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"}

package/dist/rng/mulberry32prng.d.ts

@@ -1,7 +1,7 @@
-import type { Generator } from "./Rng.js";
+import { type Generator } from "./Generator.js";
 /**
  * Creates a deterministic pseudo-random number generator based on a 32-bit integer seed using the mulberry32 algorithm.
  *
  * It generates floats in the range [0, 1)
  */
-export declare function mulberry32Prng(seed: number): Generator;
+export declare function mulberry32Prng(seed: number): Generator<number>;

package/dist/rng/mulberry32prng.js

@@ -5,12 +5,15 @@
  */
 export function mulberry32Prng(seed) {
     let state = seed >>> 0;
-    return () => {
-        state += 0x6d2b79f5;
-        let next = state;
-        next = Math.imul(next ^ (next >>> 15), next | 1);
-        next ^= next + Math.imul(next ^ (next >>> 7), next | 61);
-        return ((next ^ (next >>> 14)) >>> 0) / 4_294_967_296;
+    return {
+        next: () => {
+            state = (state + 0x6d2b79f5) >>> 0;
+            let next = state;
+            next = Math.imul(next ^ (next >>> 15), next | 1);
+            next ^= next + Math.imul(next ^ (next >>> 7), next | 61);
+            return ((next ^ (next >>> 14)) >>> 0) / 4_294_967_296;
+        },
+        getState: () => state,
     };
 }
 //# sourceMappingURL=mulberry32prng.js.map

package/dist/rng/mulberry32prng.js.map

@@ -1 +1 @@
-{"version":3,"file":"mulberry32prng.js","sourceRoot":"","sources":["../../src/rng/mulberry32prng.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,CAAA;IAEtB,OAAO,GAAG,EAAE;QACV,KAAK,IAAI,UAAU,CAAA;QAEnB,IAAI,IAAI,GAAG,KAAK,CAAA;QAChB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAA;QAChD,IAAI,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QAExD,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,aAAa,CAAA;IACvD,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"mulberry32prng.js","sourceRoot":"","sources":["../../src/rng/mulberry32prng.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,CAAA;IAEtB,OAAO;QACL,IAAI,EAAE,GAAG,EAAE;YACT,KAAK,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;YAElC,IAAI,IAAI,GAAG,KAAK,CAAA;YAChB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAA;YAChD,IAAI,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;YAExD,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,aAAa,CAAA;QACvD,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;KACtB,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guillaume-docquier/tools-ts",
-  "version": "7.0.0",
+  "version": "7.1.0",
   "description": "My personal collection of typescript tools",
   "homepage": "https://github.com/Guillaume-Docquier/tools-ts",
   "license": "MIT",