@patterkit/runtime 0.7.1 → 0.8.0

package/dist/index.d.cts

@@ -678,7 +678,13 @@ declare class Flow {
     private conditionAst;
     /** Record an entry of a node (entered-only; spec §7): bumps the flow + world counts. */
     private enter;
-    /** Next float in [0, 1): the shared custom PRNG, or this flow's serialisable mulberry32. */
+    /** Next float in [0, 1): the shared custom PRNG, or this flow's serialisable mulberry32.
+     *
+     *  The mixing is @wildwinter/expr's makePrng, not a copy inline here. It is a
+     *  fixed published algorithm that both product families need and neither
+     *  owns, and it existed thirteen times across the two of them. `rngState` is
+     *  still the serialisable position, so saves are unaffected: a generator is
+     *  made from it, drawn once, and the new state written back. */
     private readonly rng;
     private beatResult;
     /**

package/dist/index.d.ts

@@ -678,7 +678,13 @@ declare class Flow {
     private conditionAst;
     /** Record an entry of a node (entered-only; spec §7): bumps the flow + world counts. */
     private enter;
-    /** Next float in [0, 1): the shared custom PRNG, or this flow's serialisable mulberry32. */
+    /** Next float in [0, 1): the shared custom PRNG, or this flow's serialisable mulberry32.
+     *
+     *  The mixing is @wildwinter/expr's makePrng, not a copy inline here. It is a
+     *  fixed published algorithm that both product families need and neither
+     *  owns, and it existed thirteen times across the two of them. `rngState` is
+     *  still the serialisable position, so saves are unaffected: a generator is
+     *  made from it, drawn once, and the new state written back. */
     private readonly rng;
     private beatResult;
     /**

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/engine.ts
-import { evaluate, deserialiseAst } from "@wildwinter/expr";
+import { evaluate, deserialiseAst, makePrng, toUint32 } from "@wildwinter/expr";
 import { matchedSpecificity as scoreSpecificity } from "@wildwinter/expr-specificity";
 import { ScopeRegistry } from "@wildwinter/scoperegistry";
 import { patterDialect, interpolate, splitRef, stripCaptions } from "@patterkit/dialect";
@@ -615,7 +615,7 @@ var Flow = class {
   constructor(id, host, seed) {
     this.id = id;
     this.host = host;
-    this.rngState = seed >>> 0;
+    this.rngState = toUint32(seed);
     this.local = this.freshLocal();
     const scopes = { ...host.shared.toEvalContext().scopes };
     scopes["patter"] = this.patterResolver;
@@ -913,7 +913,7 @@ var Flow = class {
   }
   /** @internal Restore this flow from a snapshot. */
   restore(snap) {
-    this.rngState = snap.rngState >>> 0;
+    this.rngState = toUint32(snap.rngState);
     this.visitCounts = new Map(Object.entries(snap.visits ?? {}));
     const c = snap.cursor;
     this.started = true;
@@ -1228,14 +1228,19 @@ var Flow = class {
     this.visitCounts.set(id, (this.visitCounts.get(id) ?? 0) + 1);
     this.host.sharedVisits.set(id, (this.host.sharedVisits.get(id) ?? 0) + 1);
   }
-  /** Next float in [0, 1): the shared custom PRNG, or this flow's serialisable mulberry32. */
+  /** Next float in [0, 1): the shared custom PRNG, or this flow's serialisable mulberry32.
+   *
+   *  The mixing is @wildwinter/expr's makePrng, not a copy inline here. It is a
+   *  fixed published algorithm that both product families need and neither
+   *  owns, and it existed thirteen times across the two of them. `rngState` is
+   *  still the serialisable position, so saves are unaffected: a generator is
+   *  made from it, drawn once, and the new state written back. */
   rng = () => {
     if (this.host.customRng) return this.host.customRng();
-    const a = this.rngState + 1831565813 | 0;
-    this.rngState = a;
-    let t = Math.imul(a ^ a >>> 15, 1 | a);
-    t = t + Math.imul(t ^ t >>> 7, 61 | t) ^ t;
-    return ((t ^ t >>> 14) >>> 0) / 4294967296;
+    const prng = makePrng(this.rngState);
+    const draw = prng.next();
+    this.rngState = prng.state();
+    return draw;
   };
   // -- Strings / beats ------------------------------------------------------
   beatResult(beat) {