@hyperframes/producer 0.9.22 → 0.9.25

package/dist/index.js

@@ -286,9 +286,24 @@ function parseRangeHeader(header, size, contentType = "application/octet-stream"
   const end = Math.min(requestedEnd, size - 1);
   return { kind: "satisfiable", start, end };
 }
-function buildVirtualTimeShim(options) {
-  const seedRandomFromFrame = options.seedRandomFromFrame === true;
-  const seededRandomBlock = seedRandomFromFrame ? String.raw`
+var VIRTUAL_TIME_SHIM = String.raw`(function() {
+  if (window.__HF_VIRTUAL_TIME__) return;
+
+  var virtualNowMs = 0;
+  var rafId = 1;
+  var rafQueue = [];
+  var OriginalDate = Date;
+  var originalSetTimeout = window.setTimeout.bind(window);
+  var originalClearTimeout = window.clearTimeout.bind(window);
+  var originalSetInterval = window.setInterval.bind(window);
+  var originalClearInterval = window.clearInterval.bind(window);
+  var originalRequestAnimationFrame = window.requestAnimationFrame
+    ? window.requestAnimationFrame.bind(window)
+    : null;
+  var originalCancelAnimationFrame = window.cancelAnimationFrame
+    ? window.cancelAnimationFrame.bind(window)
+    : null;
+
   // Seeded Math.random / crypto.getRandomValues, keyed by virtual time.
   // Mulberry32: single uint32 state, deterministic, fast.
   var rngState = 0;
@@ -330,26 +345,7 @@ function buildVirtualTimeShim(options) {
       window.crypto.getRandomValues = __seededGetRandomValues;
     } catch (e) {}
   }
-` : "";
-  const seekToTimeReseedCall = seedRandomFromFrame ? "reseedRngFromTime(safeTimeMs);\n    " : "";
-  return String.raw`(function() {
-  if (window.__HF_VIRTUAL_TIME__) return;
 
-  var virtualNowMs = 0;
-  var rafId = 1;
-  var rafQueue = [];
-  var OriginalDate = Date;
-  var originalSetTimeout = window.setTimeout.bind(window);
-  var originalClearTimeout = window.clearTimeout.bind(window);
-  var originalSetInterval = window.setInterval.bind(window);
-  var originalClearInterval = window.clearInterval.bind(window);
-  var originalRequestAnimationFrame = window.requestAnimationFrame
-    ? window.requestAnimationFrame.bind(window)
-    : null;
-  var originalCancelAnimationFrame = window.cancelAnimationFrame
-    ? window.cancelAnimationFrame.bind(window)
-    : null;
-${seededRandomBlock}
   function flushAnimationFrame() {
     if (!rafQueue.length) return;
     var current = rafQueue.slice();
@@ -480,7 +476,8 @@ ${seededRandomBlock}
       // page starts there keep the schedule a one-worker render gives them.
       if (safeTimeMs > 0) seekToTime(0);
     }
-    ${seekToTimeReseedCall}fireDueTimers(safeTimeMs);
+    reseedRngFromTime(safeTimeMs);
+    fireDueTimers(safeTimeMs);
     virtualNowMs = safeTimeMs;
     flushAnimationFrame();
     return virtualNowMs;
@@ -499,8 +496,6 @@ ${seededRandomBlock}
     },
   };
 })();`;
-}
-var VIRTUAL_TIME_SHIM = buildVirtualTimeShim({ seedRandomFromFrame: false });
 var RENDER_SEEK_MODE = process.env.PRODUCER_RUNTIME_RENDER_SEEK_MODE === "strict-boundary" ? "strict-boundary" : "preview-phase";
 var RENDER_SEEK_DIAGNOSTICS = process.env.PRODUCER_DEBUG_SEEK_DIAGNOSTICS === "true";
 var RENDER_SEEK_STEP = Math.max(
@@ -17060,7 +17055,7 @@ async function measurePlanSecondsPerFrame(input) {
     projectDir: compiledDir,
     compiledDir,
     port: 0,
-    preHeadScripts: [buildVirtualTimeShim({ seedRandomFromFrame: true })],
+    preHeadScripts: [VIRTUAL_TIME_SHIM],
     fps: fpsRatio
   });
   let session = null;
@@ -19988,7 +19983,7 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath, options) {
       projectDir: compiledDir,
       compiledDir,
       port: 0,
-      preHeadScripts: [buildVirtualTimeShim({ seedRandomFromFrame: true })],
+      preHeadScripts: [VIRTUAL_TIME_SHIM],
       // These dimensions are frozen by the controller from the render job, so
       // chunk runtime seek quantization stays on the same fps grid as capture.
       fps: { num: plan2.dimensions.fpsNum, den: plan2.dimensions.fpsDen }

package/dist/public-server.js

@@ -303,9 +303,24 @@ function parseRangeHeader(header, size, contentType = "application/octet-stream"
   const end = Math.min(requestedEnd, size - 1);
   return { kind: "satisfiable", start, end };
 }
-function buildVirtualTimeShim(options) {
-  const seedRandomFromFrame = options.seedRandomFromFrame === true;
-  const seededRandomBlock = seedRandomFromFrame ? String.raw`
+var VIRTUAL_TIME_SHIM = String.raw`(function() {
+  if (window.__HF_VIRTUAL_TIME__) return;
+
+  var virtualNowMs = 0;
+  var rafId = 1;
+  var rafQueue = [];
+  var OriginalDate = Date;
+  var originalSetTimeout = window.setTimeout.bind(window);
+  var originalClearTimeout = window.clearTimeout.bind(window);
+  var originalSetInterval = window.setInterval.bind(window);
+  var originalClearInterval = window.clearInterval.bind(window);
+  var originalRequestAnimationFrame = window.requestAnimationFrame
+    ? window.requestAnimationFrame.bind(window)
+    : null;
+  var originalCancelAnimationFrame = window.cancelAnimationFrame
+    ? window.cancelAnimationFrame.bind(window)
+    : null;
+
   // Seeded Math.random / crypto.getRandomValues, keyed by virtual time.
   // Mulberry32: single uint32 state, deterministic, fast.
   var rngState = 0;
@@ -347,26 +362,7 @@ function buildVirtualTimeShim(options) {
       window.crypto.getRandomValues = __seededGetRandomValues;
     } catch (e) {}
   }
-` : "";
-  const seekToTimeReseedCall = seedRandomFromFrame ? "reseedRngFromTime(safeTimeMs);\n    " : "";
-  return String.raw`(function() {
-  if (window.__HF_VIRTUAL_TIME__) return;
 
-  var virtualNowMs = 0;
-  var rafId = 1;
-  var rafQueue = [];
-  var OriginalDate = Date;
-  var originalSetTimeout = window.setTimeout.bind(window);
-  var originalClearTimeout = window.clearTimeout.bind(window);
-  var originalSetInterval = window.setInterval.bind(window);
-  var originalClearInterval = window.clearInterval.bind(window);
-  var originalRequestAnimationFrame = window.requestAnimationFrame
-    ? window.requestAnimationFrame.bind(window)
-    : null;
-  var originalCancelAnimationFrame = window.cancelAnimationFrame
-    ? window.cancelAnimationFrame.bind(window)
-    : null;
-${seededRandomBlock}
   function flushAnimationFrame() {
     if (!rafQueue.length) return;
     var current = rafQueue.slice();
@@ -497,7 +493,8 @@ ${seededRandomBlock}
       // page starts there keep the schedule a one-worker render gives them.
       if (safeTimeMs > 0) seekToTime(0);
     }
-    ${seekToTimeReseedCall}fireDueTimers(safeTimeMs);
+    reseedRngFromTime(safeTimeMs);
+    fireDueTimers(safeTimeMs);
     virtualNowMs = safeTimeMs;
     flushAnimationFrame();
     return virtualNowMs;
@@ -516,8 +513,6 @@ ${seededRandomBlock}
     },
   };
 })();`;
-}
-var VIRTUAL_TIME_SHIM = buildVirtualTimeShim({ seedRandomFromFrame: false });
 var RENDER_SEEK_MODE = process.env.PRODUCER_RUNTIME_RENDER_SEEK_MODE === "strict-boundary" ? "strict-boundary" : "preview-phase";
 var RENDER_SEEK_DIAGNOSTICS = process.env.PRODUCER_DEBUG_SEEK_DIAGNOSTICS === "true";
 var RENDER_SEEK_STEP = Math.max(

package/dist/services/distributed/renderChunk.d.ts

@@ -21,8 +21,7 @@
  *   - Browser is launched with `browserGpuMode: "software"` and verified
  *     against `chrome://gpu` via `assertSwiftShader` — a non-SwiftShader
  *     backend trips a non-retryable `BROWSER_GPU_NOT_SOFTWARE`.
- *   - The file server serves with the seeded-random shim
- *     (`buildVirtualTimeShim({ seedRandomFromFrame: true })`) so any
+ *   - The file server serves `VIRTUAL_TIME_SHIM`, as every render path does, so any
  *     composition that uses `Math.random` / `crypto.getRandomValues`
  *     produces byte-identical pixels per `(planDir, chunkIndex)`.
  *   - No `lastFrameCache` priming: every frame seeks fresh DOM so the
@@ -30,7 +29,7 @@
  *   - The chunk's encode runs with `lockGopForChunkConcat: true` and
  *     `gopSize === framesInChunk` so concat-copy at assemble time is safe.
  *
- * Every determinism toggle above is opt-in — only this primitive enables them.
+ * Every other determinism toggle above is opt-in — only this primitive enables them.
  * In-process renders (`executeRenderJob`) leave them off.
  */
 import { assertSwiftShader, type CaptureOptions, type CaptureMode, type CapturePerfSummary, type CaptureSession, closeCaptureSession, createCaptureSession, type EngineConfig, initializeSession, probeBeginFrameLiveness, readWebGlVendorInfoFromCanvas } from "@hyperframes/engine";

package/dist/services/fileServer.d.ts

@@ -76,42 +76,10 @@ export type RangeRequest = {
  */
 export declare function parseRangeHeader(header: string | null | undefined, size: number, contentType?: string): RangeRequest;
 /**
- * Options for {@link buildVirtualTimeShim}.
- */
-export interface VirtualTimeShimOptions {
-    /**
-     * When `true`, the shim additionally replaces `Math.random` and
-     * `crypto.getRandomValues` with a Mulberry32-seeded PRNG keyed by the
-     * current frame's virtual time. Compositions that call `Math.random()`
-     * during render then produce byte-identical pixels across machines and
-     * across replays of the same `(planDir, chunkIndex)` pair.
-     *
-     * Default `false`: leaves `Math.random` / `crypto.getRandomValues` native,
-     * preserving the in-process renderer's non-deterministic behavior for
-     * compositions that rely on it.
-     */
-    seedRandomFromFrame: boolean;
-}
-/**
- * Build the page-side virtual-time shim script.
- *
- * The shim freezes `Date.now`, `performance.now`, rAF, and the timers set
- * after the first seek, so a render seek can deterministically advance the
- * page's notion of "now". The renderer issues `__HF_VIRTUAL_TIME__.seekToTime(ms)`
- * before every frame capture; everything timing-related on the page sees
- * exactly `ms` until the next seek.
- *
- * When `options.seedRandomFromFrame` is `true`, the returned script also
- * installs a seeded `Math.random` / `crypto.getRandomValues` keyed by the
- * current virtual time — so compositions with stochastic visuals retry
- * identically. When `false`, the shim emits no random-override code; the
- * page's native `Math.random` is left alone (the in-process default).
- */
-export declare function buildVirtualTimeShim(options: VirtualTimeShimOptions): string;
-/**
- * Default in-process virtual-time shim — `seedRandomFromFrame: false`.
- * Existing call sites (`renderOrchestrator`, `probeStage`) import this
- * constant. Distributed callers build their own with seeding enabled.
+ * Page-side virtual-time shim, installed before page scripts on every render path.
+ * Holds Date.now, performance.now, rAF and later timers at the seek time, and seeds Math.random and
+ * crypto.getRandomValues from it, so a re-render repeats. Draws at page load or inside a frame also match
+ * across worker counts; a value resolved on a tween's first render depends on the frame a worker reaches first.
  */
 declare const VIRTUAL_TIME_SHIM: string;
 export declare function resolveRenderFpsConfig(fps: Fps | undefined): {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.9.22",
+  "version": "0.9.25",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
@@ -35,11 +35,11 @@
     "postcss": "^8.4.0",
     "puppeteer": "~25.11.0",
     "puppeteer-core": "^25.11.0",
-    "@hyperframes/core": "0.9.22",
-    "@hyperframes/parsers": "0.9.22",
-    "@hyperframes/lint": "0.9.22",
-    "@hyperframes/engine": "0.9.22",
-    "@hyperframes/studio-server": "0.9.22"
+    "@hyperframes/lint": "0.9.25",
+    "@hyperframes/engine": "0.9.25",
+    "@hyperframes/studio-server": "0.9.25",
+    "@hyperframes/core": "0.9.25",
+    "@hyperframes/parsers": "0.9.25"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",
@@ -48,7 +48,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.7.2",
     "vitest": "^4.1.11",
-    "@hyperframes/aws-lambda": "0.9.22"
+    "@hyperframes/aws-lambda": "0.9.25"
   },
   "engines": {
     "node": ">=22"