@ac-kit/math-random 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## [0.1.0] - 2026-08-26
+
+### Added
+
+- Initial release.

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2024-2026 Anthony Champagne and contributors
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,35 @@
+# @ac-kit/math-random
+
+Seeded pseudo-random number generators: give one a seed and it produces the same
+sequence every time.
+
+That is exactly what `Math.random()` cannot do. A simulation you want to replay,
+a test that must fail the same way twice, a procedurally generated level that
+looks identical on every machine — all need the sequence to be a function of the
+seed.
+
+```ts
+import { xorshift32 } from "@ac-kit/math-random";
+
+const random = xorshift32(12345);
+random(); // same value on every run, every machine
+random();
+```
+
+Each generator is a factory taking a seed and returning a `RandomFn` — a
+zero-argument function yielding a float in `[0, 1)`, the same contract as
+`Math.random`, so it drops into anything accepting an injectable random source,
+such as `@ac-kit/algo`'s `shuffle`.
+
+Available: `mulberry32`, `pcg32`, `sfc32`, `splitmix64`, `xorshift32`,
+`xoshiro128p`, `xoshiro256p` — differing in state size, period and speed.
+
+**None of these is cryptographically secure.** Their output is predictable from
+a few samples by design. For keys, tokens or nonces use `@ac-kit/crypto-random`.
+
+Portable: no Node.js built-ins, so it runs unchanged in browsers, Deno, Bun and
+edge runtimes.
+
+See the
+[generated API docs](https://anthochamp.github.io/node-essentials/api/math-random/)
+for the full reference.

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./mulberry32.js";
+export * from "./pcg32.js";
+export * from "./sfc32.js";
+export * from "./splitmix64.js";
+export * from "./xorshift32.js";
+export * from "./xoshiro128p.js";
+export * from "./xoshiro256p.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./mulberry32.js";
+export * from "./pcg32.js";
+export * from "./sfc32.js";
+export * from "./splitmix64.js";
+export * from "./xorshift32.js";
+export * from "./xoshiro128p.js";
+export * from "./xoshiro256p.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/mulberry32.d.ts

@@ -0,0 +1,12 @@
+import type { RandomFn } from "@ac-kit/core";
+/**
+ * Creates a seeded pseudo-random number generator function using the Mulberry32
+ * algorithm.
+ *
+ * @param seed - The seed value to initialize the generator. It should be a
+ *   32-bit unsigned integer.
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export declare function mulberry32(seed: number): RandomFn;
+//# sourceMappingURL=mulberry32.d.ts.map

package/dist/mulberry32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mulberry32.d.ts","sourceRoot":"","sources":["../src/mulberry32.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAQjD"}

package/dist/mulberry32.js

@@ -0,0 +1,19 @@
+/**
+ * Creates a seeded pseudo-random number generator function using the Mulberry32
+ * algorithm.
+ *
+ * @param seed - The seed value to initialize the generator. It should be a
+ *   32-bit unsigned integer.
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export function mulberry32(seed) {
+    let s = seed >>> 0;
+    return () => {
+        s = (s + 0x6d2b79f5) | 0;
+        let t = Math.imul(s ^ (s >>> 15), 1 | s);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+//# sourceMappingURL=mulberry32.js.map

package/dist/mulberry32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mulberry32.js","sourceRoot":"","sources":["../src/mulberry32.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IACnB,OAAO,GAAG,EAAE;QACX,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IAC9C,CAAC,CAAC;AACH,CAAC"}

package/dist/pcg32.d.ts

@@ -0,0 +1,18 @@
+import { type RandomFn } from "@ac-kit/core";
+/**
+ * Creates a seeded pseudo-random number generator function using the PCG32
+ * algorithm (Permuted Congruential Generator, 32-bit output) by Melissa O'Neill
+ * (2014).
+ *
+ * Uses a 64-bit LCG state with a scrambled output function. Excellent
+ * statistical quality.
+ *
+ * The seed is accepted as a JS `number`; values above 2^53 may lose precision
+ * due to IEEE 754 double representation before the BigInt conversion.
+ *
+ * @param seed - The seed value to initialize the 64-bit internal state.
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export declare function pcg32(seed: number): RandomFn;
+//# sourceMappingURL=pcg32.d.ts.map

package/dist/pcg32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcg32.d.ts","sourceRoot":"","sources":["../src/pcg32.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAW5C"}

package/dist/pcg32.js

@@ -0,0 +1,28 @@
+import { MASK_64N, rotr32 } from "@ac-kit/core";
+/**
+ * Creates a seeded pseudo-random number generator function using the PCG32
+ * algorithm (Permuted Congruential Generator, 32-bit output) by Melissa O'Neill
+ * (2014).
+ *
+ * Uses a 64-bit LCG state with a scrambled output function. Excellent
+ * statistical quality.
+ *
+ * The seed is accepted as a JS `number`; values above 2^53 may lose precision
+ * due to IEEE 754 double representation before the BigInt conversion.
+ *
+ * @param seed - The seed value to initialize the 64-bit internal state.
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export function pcg32(seed) {
+    let state = BigInt(seed) & MASK_64N;
+    const multiplier = 6364136223846793005n;
+    const increment = 1442695040888963407n;
+    return () => {
+        state = (state * multiplier + increment) & MASK_64N;
+        const xorshifted = Number(((state >> 18n) ^ state) >> 27n) | 0;
+        const rot = Number(state >> 59n);
+        return rotr32(xorshifted, rot) / 4294967296;
+    };
+}
+//# sourceMappingURL=pcg32.js.map

package/dist/pcg32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcg32.js","sourceRoot":"","sources":["../src/pcg32.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAiB,MAAM,cAAc,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY;IACjC,IAAI,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;IACpC,MAAM,UAAU,GAAG,oBAAoB,CAAC;IACxC,MAAM,SAAS,GAAG,oBAAoB,CAAC;IAEvC,OAAO,GAAG,EAAE;QACX,KAAK,GAAG,CAAC,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC,GAAG,QAAQ,CAAC;QACpD,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,UAAU,CAAC;IAC7C,CAAC,CAAC;AACH,CAAC"}

package/dist/sfc32.d.ts

@@ -0,0 +1,17 @@
+import { type RandomFn } from "@ac-kit/core";
+/**
+ * Creates a seeded pseudo-random number generator function using the SFC32
+ * algorithm (Small Fast Counting, 32-bit output) by Chris Doty-Humphrey.
+ *
+ * Uses 128-bit state (four 32-bit words) and an internal counter for guaranteed
+ * long periods. Passes PractRand at very high lengths.
+ *
+ * @param a - First seed word (32-bit unsigned integer).
+ * @param b - Second seed word (32-bit unsigned integer).
+ * @param c - Third seed word (32-bit unsigned integer).
+ * @param d - Counter word (32-bit unsigned integer); start at 0 or any value.
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export declare function sfc32(a: number, b: number, c: number, d: number): RandomFn;
+//# sourceMappingURL=sfc32.d.ts.map

package/dist/sfc32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfc32.d.ts","sourceRoot":"","sources":["../src/sfc32.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,CAe1E"}

package/dist/sfc32.js

@@ -0,0 +1,32 @@
+import { rotl32 } from "@ac-kit/core";
+/**
+ * Creates a seeded pseudo-random number generator function using the SFC32
+ * algorithm (Small Fast Counting, 32-bit output) by Chris Doty-Humphrey.
+ *
+ * Uses 128-bit state (four 32-bit words) and an internal counter for guaranteed
+ * long periods. Passes PractRand at very high lengths.
+ *
+ * @param a - First seed word (32-bit unsigned integer).
+ * @param b - Second seed word (32-bit unsigned integer).
+ * @param c - Third seed word (32-bit unsigned integer).
+ * @param d - Counter word (32-bit unsigned integer); start at 0 or any value.
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export function sfc32(a, b, c, d) {
+    a = a >>> 0;
+    b = b >>> 0;
+    c = c >>> 0;
+    d = d >>> 0;
+    return () => {
+        const t = (a + b) | 0;
+        a = b ^ (b >>> 9);
+        b = (c + (c << 3)) | 0;
+        c = rotl32(c, 21);
+        d = (d + 1) | 0;
+        const result = (t + d) | 0;
+        c = (c + result) | 0;
+        return (result >>> 0) / 4294967296;
+    };
+}
+//# sourceMappingURL=sfc32.js.map

package/dist/sfc32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfc32.js","sourceRoot":"","sources":["../src/sfc32.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,KAAK,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS;IAC/D,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACZ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACZ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACZ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACZ,OAAO,GAAG,EAAE;QACX,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAClB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IACpC,CAAC,CAAC;AACH,CAAC"}

package/dist/splitmix64.d.ts

@@ -0,0 +1,18 @@
+import { type RandomFn } from "@ac-kit/core";
+/**
+ * Creates a seeded pseudo-random number generator function using the SplitMix64
+ * algorithm by Guy Steele and Sebastiano Vigna. Single 64-bit state word,
+ * 64-bit output.
+ *
+ * Commonly used to expand a single integer seed into an initial state for
+ * multi-word generators such as xoshiro256+. Fast and passes BigCrush.
+ *
+ * The seed is accepted as a JS `number`; values above 2^53 may lose precision
+ * due to IEEE 754 double representation before the BigInt conversion.
+ *
+ * @param seed - The seed value to initialize the 64-bit internal state.
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export declare function splitmix64(seed: number): RandomFn;
+//# sourceMappingURL=splitmix64.d.ts.map

package/dist/splitmix64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitmix64.d.ts","sourceRoot":"","sources":["../src/splitmix64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAUjD"}

package/dist/splitmix64.js

@@ -0,0 +1,27 @@
+import { MASK_64N } from "@ac-kit/core";
+/**
+ * Creates a seeded pseudo-random number generator function using the SplitMix64
+ * algorithm by Guy Steele and Sebastiano Vigna. Single 64-bit state word,
+ * 64-bit output.
+ *
+ * Commonly used to expand a single integer seed into an initial state for
+ * multi-word generators such as xoshiro256+. Fast and passes BigCrush.
+ *
+ * The seed is accepted as a JS `number`; values above 2^53 may lose precision
+ * due to IEEE 754 double representation before the BigInt conversion.
+ *
+ * @param seed - The seed value to initialize the 64-bit internal state.
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export function splitmix64(seed) {
+    let x = BigInt(seed) & MASK_64N;
+    return () => {
+        x = (x + 0x9e3779b97f4a7c15n) & MASK_64N;
+        let z = x;
+        z = ((z ^ (z >> 30n)) * 0xbf58476d1ce4e5b9n) & MASK_64N;
+        z = ((z ^ (z >> 27n)) * 0x94d049bb133111ebn) & MASK_64N;
+        return Number((z ^ (z >> 31n)) >> 11n) / 2 ** 53;
+    };
+}
+//# sourceMappingURL=splitmix64.js.map

package/dist/splitmix64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitmix64.js","sourceRoot":"","sources":["../src/splitmix64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAiB,MAAM,cAAc,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;IAEhC,OAAO,GAAG,EAAE;QACX,CAAC,GAAG,CAAC,CAAC,GAAG,mBAAmB,CAAC,GAAG,QAAQ,CAAC;QACzC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,mBAAmB,CAAC,GAAG,QAAQ,CAAC;QACxD,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,mBAAmB,CAAC,GAAG,QAAQ,CAAC;QACxD,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC,CAAC;AACH,CAAC"}

package/dist/xorshift32.d.ts

@@ -0,0 +1,18 @@
+import type { RandomFn } from "@ac-kit/core";
+/**
+ * Creates a seeded pseudo-random number generator function using the xorshift32
+ * algorithm by George Marsaglia (2003). 32-bit state, 32-bit output.
+ *
+ * Note: Fails some PractRand tests at large sample sizes, so prefer
+ * {@link sfc32}/{@link xoshiro128p} for statistical work; fine for
+ * non-adversarial deterministic fixtures, and simple enough to reproduce
+ * bit-for-bit in another language (C, Python, Rust, ...) when a fixture must
+ * match across an FFI or subprocess boundary.
+ *
+ * @param seed - The seed value to initialize the 32-bit state. Must be nonzero
+ *   (an all-zero state never changes).
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export declare function xorshift32(seed: number): RandomFn;
+//# sourceMappingURL=xorshift32.d.ts.map

package/dist/xorshift32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xorshift32.d.ts","sourceRoot":"","sources":["../src/xorshift32.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CASjD"}

package/dist/xorshift32.js

@@ -0,0 +1,25 @@
+/**
+ * Creates a seeded pseudo-random number generator function using the xorshift32
+ * algorithm by George Marsaglia (2003). 32-bit state, 32-bit output.
+ *
+ * Note: Fails some PractRand tests at large sample sizes, so prefer
+ * {@link sfc32}/{@link xoshiro128p} for statistical work; fine for
+ * non-adversarial deterministic fixtures, and simple enough to reproduce
+ * bit-for-bit in another language (C, Python, Rust, ...) when a fixture must
+ * match across an FFI or subprocess boundary.
+ *
+ * @param seed - The seed value to initialize the 32-bit state. Must be nonzero
+ *   (an all-zero state never changes).
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export function xorshift32(seed) {
+    let state = seed >>> 0;
+    return () => {
+        state = (state ^ (state << 13)) >>> 0;
+        state = (state ^ (state >>> 17)) >>> 0;
+        state = (state ^ (state << 5)) >>> 0;
+        return state / 4294967296;
+    };
+}
+//# sourceMappingURL=xorshift32.js.map

package/dist/xorshift32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xorshift32.js","sourceRoot":"","sources":["../src/xorshift32.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC;IAEvB,OAAO,GAAG,EAAE;QACX,KAAK,GAAG,CAAC,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QACtC,KAAK,GAAG,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QACvC,KAAK,GAAG,CAAC,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,KAAK,GAAG,UAAU,CAAC;IAC3B,CAAC,CAAC;AACH,CAAC"}

package/dist/xoshiro128p.d.ts

@@ -0,0 +1,15 @@
+import { type RandomFn } from "@ac-kit/core";
+/**
+ * Creates a seeded pseudo-random number generator function using the
+ * xoshiro128+ algorithm by Blackman & Vigna (2018). 128-bit state, 32-bit
+ * output.
+ *
+ * Recommended for floating-point generation. Passes PractRand. Faster than the
+ * `**` variant.
+ *
+ * @param seed - The seed value used to derive the four 32-bit state words.
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export declare function xoshiro128p(seed: number): RandomFn;
+//# sourceMappingURL=xoshiro128p.d.ts.map

package/dist/xoshiro128p.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xoshiro128p.d.ts","sourceRoot":"","sources":["../src/xoshiro128p.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAiBlD"}

package/dist/xoshiro128p.js

@@ -0,0 +1,31 @@
+import { rotl32 } from "@ac-kit/core";
+/**
+ * Creates a seeded pseudo-random number generator function using the
+ * xoshiro128+ algorithm by Blackman & Vigna (2018). 128-bit state, 32-bit
+ * output.
+ *
+ * Recommended for floating-point generation. Passes PractRand. Faster than the
+ * `**` variant.
+ *
+ * @param seed - The seed value used to derive the four 32-bit state words.
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export function xoshiro128p(seed) {
+    let s0 = seed >>> 0;
+    let s1 = (seed ^ 0x6d2b79f5) >>> 0;
+    let s2 = (seed ^ 0x9e3779b9) >>> 0;
+    let s3 = (seed ^ 0x7f4a7c15) >>> 0;
+    return () => {
+        const result = (s0 + s3) >>> 0;
+        const t = s1 << 9;
+        s2 ^= s0;
+        s3 ^= s1;
+        s1 ^= s2;
+        s0 ^= s3;
+        s2 ^= t;
+        s3 = rotl32(s3, 11);
+        return result / 4294967296;
+    };
+}
+//# sourceMappingURL=xoshiro128p.js.map

package/dist/xoshiro128p.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xoshiro128p.js","sourceRoot":"","sources":["../src/xoshiro128p.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,IAAI,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;IACpB,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAEnC,OAAO,GAAG,EAAE;QACX,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClB,EAAE,IAAI,EAAE,CAAC;QACT,EAAE,IAAI,EAAE,CAAC;QACT,EAAE,IAAI,EAAE,CAAC;QACT,EAAE,IAAI,EAAE,CAAC;QACT,EAAE,IAAI,CAAC,CAAC;QACR,EAAE,GAAG,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACpB,OAAO,MAAM,GAAG,UAAU,CAAC;IAC5B,CAAC,CAAC;AACH,CAAC"}

package/dist/xoshiro256p.d.ts

@@ -0,0 +1,18 @@
+import { type RandomFn } from "@ac-kit/core";
+/**
+ * Creates a seeded pseudo-random number generator function using the
+ * xoshiro256+ algorithm by Blackman & Vigna (2018). 256-bit state, 64-bit
+ * output mapped to [0, 1).
+ *
+ * Recommended for floating-point generation. The top 53 bits of the 64-bit
+ * output are used to preserve IEEE 754 double precision.
+ *
+ * The seed is accepted as a JS `number`; values above 2^53 may lose precision
+ * due to IEEE 754 double representation before the BigInt conversion.
+ *
+ * @param seed - The seed value used to derive the four 64-bit state words.
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export declare function xoshiro256p(seed: number): RandomFn;
+//# sourceMappingURL=xoshiro256p.d.ts.map

package/dist/xoshiro256p.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xoshiro256p.d.ts","sourceRoot":"","sources":["../src/xoshiro256p.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAkBlD"}

package/dist/xoshiro256p.js

@@ -0,0 +1,35 @@
+import { MASK_64N, rotl64 } from "@ac-kit/core";
+/**
+ * Creates a seeded pseudo-random number generator function using the
+ * xoshiro256+ algorithm by Blackman & Vigna (2018). 256-bit state, 64-bit
+ * output mapped to [0, 1).
+ *
+ * Recommended for floating-point generation. The top 53 bits of the 64-bit
+ * output are used to preserve IEEE 754 double precision.
+ *
+ * The seed is accepted as a JS `number`; values above 2^53 may lose precision
+ * due to IEEE 754 double representation before the BigInt conversion.
+ *
+ * @param seed - The seed value used to derive the four 64-bit state words.
+ * @returns A function that generates pseudo-random numbers in the range [0, 1)
+ *   when called.
+ */
+export function xoshiro256p(seed) {
+    const seedBig = BigInt(seed);
+    let s0 = seedBig & MASK_64N;
+    let s1 = (seedBig ^ 0x6d2b79f5n) & MASK_64N;
+    let s2 = (seedBig ^ 0x9e3779b9n) & MASK_64N;
+    let s3 = (seedBig ^ 0x7f4a7c15n) & MASK_64N;
+    return () => {
+        const result = (s0 + s3) & MASK_64N;
+        const t = (s1 << 17n) & MASK_64N;
+        s2 ^= s0;
+        s3 ^= s1;
+        s1 ^= s2;
+        s0 ^= s3;
+        s2 ^= t;
+        s3 = rotl64(s3, 45n);
+        return Number(result >> 11n) / 2 ** 53;
+    };
+}
+//# sourceMappingURL=xoshiro256p.js.map

package/dist/xoshiro256p.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xoshiro256p.js","sourceRoot":"","sources":["../src/xoshiro256p.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAiB,MAAM,cAAc,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,EAAE,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5B,IAAI,EAAE,GAAG,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,QAAQ,CAAC;IAC5C,IAAI,EAAE,GAAG,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,QAAQ,CAAC;IAC5C,IAAI,EAAE,GAAG,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,QAAQ,CAAC;IAE5C,OAAO,GAAG,EAAE;QACX,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC;QACjC,EAAE,IAAI,EAAE,CAAC;QACT,EAAE,IAAI,EAAE,CAAC;QACT,EAAE,IAAI,EAAE,CAAC;QACT,EAAE,IAAI,EAAE,CAAC;QACT,EAAE,IAAI,CAAC,CAAC;QACR,EAAE,GAAG,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACrB,OAAO,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@ac-kit/math-random",
+  "version": "0.1.0",
+  "description": "Non-cryptographic pseudo-random number generators: mulberry32, pcg32, sfc32, splitmix64 and xoshiro.",
+  "keywords": [
+    "pcg",
+    "prng",
+    "random",
+    "splitmix",
+    "xoshiro"
+  ],
+  "homepage": "https://anthochamp.github.io/node-essentials/api/math-random/",
+  "bugs": {
+    "url": "https://github.com/anthochamp/node-essentials/issues"
+  },
+  "license": "BSD-3-Clause",
+  "author": "Anthony Champagne <dev@anthonychampagne.fr>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anthochamp/node-essentials.git",
+    "directory": "packages/math-random"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "publishConfig": {
+    "main": "./dist/index.js",
+    "exports": {
+      ".": "./dist/index.js"
+    },
+    "access": "public"
+  },
+  "scripts": {
+    "compile": "tsc -p ./tsconfig.build.json -outDir dist",
+    "compile:check": "tsc -noEmit -p ./tsconfig.json",
+    "clean": "rimraf dist",
+    "build": "yarn clean && yarn compile",
+    "test": "yarn run -T vitest run",
+    "prepack": "yarn build"
+  },
+  "dependencies": {
+    "@ac-kit/core": "^0.1.0",
+    "@types/web": "^0.0.354"
+  },
+  "devDependencies": {
+    "@ac-kit/tsconfig": "0.1.0",
+    "@ac-kit/typedoc-config": "0.1.0",
+    "@ac-kit/vitest-config": "0.1.0",
+    "@typescript/native": "typescript@7.0.2",
+    "rimraf": "6.1.3",
+    "typedoc": "0.28.20",
+    "typescript": "@typescript/typescript6@6.0.2"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}