@elaraai/east-node-std 0.0.1-beta.0

package/dist/random/xorshift128.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Seedable RNG implementation using xorshift128+ algorithm.
+ *
+ * Fast, high-quality PRNG suitable for simulations.
+ * Period: 2^128 - 1
+ */
+import RNG, { type SeedType } from "./rng.js";
+export default class XorShift128RNG extends RNG {
+    private state0;
+    private state1;
+    constructor(seed?: SeedType);
+    get name(): string;
+    /**
+     * Generate next random number in [0, 1)
+     */
+    next(): number;
+    /**
+     * Seed the RNG for reproducible sequences
+     */
+    seed(seed?: SeedType, _opts?: Record<string, unknown>): void;
+    /**
+     * Clone this RNG with optional new seed
+     */
+    clone(seed?: SeedType, opts?: Record<string, unknown>): RNG;
+    /**
+     * SplitMix64 for state initialization
+     * Ensures good distribution even from sequential seeds
+     */
+    private splitmix64;
+}
+//# sourceMappingURL=xorshift128.d.ts.map

package/dist/random/xorshift128.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xorshift128.d.ts","sourceRoot":"","sources":["../../src/random/xorshift128.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,GAAG,EAAE,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,GAAG;IAC3C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,CAAC,EAAE,QAAQ;IAc3B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,IAAI,MAAM;IAgBd;;OAEG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAmC5D;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG;IAY3D;;;OAGG;IACH,OAAO,CAAC,UAAU;CAMrB"}

package/dist/random/xorshift128.js

@@ -0,0 +1,112 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Seedable RNG implementation using xorshift128+ algorithm.
+ *
+ * Fast, high-quality PRNG suitable for simulations.
+ * Period: 2^128 - 1
+ */
+import RNG, {} from "./rng.js";
+export default class XorShift128RNG extends RNG {
+    state0;
+    state1;
+    constructor(seed) {
+        super();
+        // Initialize with default state
+        this.state0 = 0n;
+        this.state1 = 0n;
+        if (seed !== undefined) {
+            this.seed(seed);
+        }
+        else {
+            // Default seed based on current time
+            this.seed(Date.now());
+        }
+    }
+    get name() {
+        return "xorshift128+";
+    }
+    /**
+     * Generate next random number in [0, 1)
+     */
+    next() {
+        // xorshift128+ algorithm
+        let s1 = this.state0;
+        const s0 = this.state1;
+        const result = s0 + s1;
+        this.state0 = s0;
+        s1 ^= s1 << 23n;
+        this.state1 = s1 ^ s0 ^ (s1 >> 17n) ^ (s0 >> 26n);
+        // Convert to [0, 1) range
+        // Use upper 53 bits for double precision
+        const upper53 = (result >> 11n) & ((1n << 53n) - 1n);
+        return Number(upper53) / (2 ** 53);
+    }
+    /**
+     * Seed the RNG for reproducible sequences
+     */
+    seed(seed, _opts) {
+        let seedNum;
+        if (typeof seed === "bigint") {
+            seedNum = seed;
+        }
+        else if (typeof seed === "number") {
+            seedNum = BigInt(Math.floor(seed));
+        }
+        else if (typeof seed === "string") {
+            // Hash the string to a number
+            let hash = 0n;
+            for (let i = 0; i < seed.length; i++) {
+                hash = ((hash << 5n) - hash) + BigInt(seed.charCodeAt(i));
+                hash = hash & 0xffffffffffffffffn; // Keep as 64-bit
+            }
+            seedNum = hash;
+        }
+        else if (seed instanceof RNG) {
+            // Use another RNG to generate seed
+            seedNum = BigInt(Math.floor(seed.next() * Number.MAX_SAFE_INTEGER));
+        }
+        else if (typeof seed === "function") {
+            seedNum = BigInt(Math.floor(seed() * Number.MAX_SAFE_INTEGER));
+        }
+        else {
+            seedNum = BigInt(Date.now());
+        }
+        // Initialize state using splitmix64 to ensure good initial state
+        // even from poor seeds
+        this.state0 = this.splitmix64(seedNum);
+        this.state1 = this.splitmix64(this.state0);
+        // Ensure state is never all zeros
+        if (this.state0 === 0n && this.state1 === 0n) {
+            this.state0 = 1n;
+        }
+    }
+    /**
+     * Clone this RNG with optional new seed
+     */
+    clone(seed, opts) {
+        const cloned = new XorShift128RNG();
+        if (seed !== undefined) {
+            cloned.seed(seed, opts);
+        }
+        else {
+            // Copy current state
+            cloned.state0 = this.state0;
+            cloned.state1 = this.state1;
+        }
+        return cloned;
+    }
+    /**
+     * SplitMix64 for state initialization
+     * Ensures good distribution even from sequential seeds
+     */
+    splitmix64(x) {
+        x = (x + 0x9e3779b97f4a7c15n) & 0xffffffffffffffffn;
+        x = ((x ^ (x >> 30n)) * 0xbf58476d1ce4e5b9n) & 0xffffffffffffffffn;
+        x = ((x ^ (x >> 27n)) * 0x94d049bb133111ebn) & 0xffffffffffffffffn;
+        return (x ^ (x >> 31n)) & 0xffffffffffffffffn;
+    }
+}
+//# sourceMappingURL=xorshift128.js.map

package/dist/random/xorshift128.js.map

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