hyperframes 0.4.5 → 0.4.6

package/dist/cli.js

@@ -54,7 +54,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.4.5" : "0.0.0-dev";
+    VERSION = true ? "0.4.6" : "0.0.0-dev";
   }
 });
 
@@ -20938,6 +20938,15 @@ function isFontResourceError(type, text, locationUrl) {
     `${locationUrl} ${text}`
   );
 }
+async function pollPageExpression(page, expression, timeoutMs, intervalMs = 100) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const ready = Boolean(await page.evaluate(expression));
+    if (ready) return true;
+    await new Promise((resolve35) => setTimeout(resolve35, intervalMs));
+  }
+  return Boolean(await page.evaluate(expression));
+}
 async function initializeSession(session) {
   const { page, serverUrl } = session;
   page.on("console", (msg) => {
@@ -20967,14 +20976,26 @@ async function initializeSession(session) {
   if (session.captureMode === "screenshot") {
     await page.goto(url, { waitUntil: "domcontentloaded", timeout: 6e4 });
     const pageReadyTimeout2 = session.config?.playerReadyTimeout ?? DEFAULT_CONFIG2.playerReadyTimeout;
-    await page.waitForFunction(
+    const pageReady2 = await pollPageExpression(
+      page,
       `!!(window.__hf && typeof window.__hf.seek === "function" && window.__hf.duration > 0)`,
-      { timeout: pageReadyTimeout2 }
+      pageReadyTimeout2
     );
-    await page.waitForFunction(
+    if (!pageReady2) {
+      throw new Error(
+        `[FrameCapture] window.__hf not ready after ${pageReadyTimeout2}ms. Page must expose window.__hf = { duration, seek }.`
+      );
+    }
+    const videosReady = await pollPageExpression(
+      page,
       `document.querySelectorAll("video").length === 0 || Array.from(document.querySelectorAll("video")).every(v => v.readyState >= 1)`,
-      { timeout: pageReadyTimeout2 }
+      pageReadyTimeout2
     );
+    if (!videosReady) {
+      throw new Error(
+        `[FrameCapture] video metadata not ready after ${pageReadyTimeout2}ms. Video elements must load metadata before capture starts.`
+      );
+    }
     await page.evaluate(`document.fonts?.ready`);
     session.isInitialized = true;
     return;
@@ -24079,8 +24100,22 @@ function injectScriptsIntoHtml2(html, headScripts, bodyScripts, stripEmbedded) {
   }
   return html;
 }
+function injectScriptsAtHeadStart(html, scripts) {
+  if (scripts.length === 0) return html;
+  const headTags = scripts.map((src) => `<script>${src}</script>`).join("\n");
+  if (html.includes("<head")) {
+    return html.replace(/<head\b[^>]*>/i, (match) => `${match}
+${headTags}`);
+  }
+  if (html.includes("<body")) {
+    return html.replace("<body", () => `${headTags}
+<body`);
+  }
+  return headTags + "\n" + html;
+}
 function createFileServer2(options) {
   const { projectDir, compiledDir, port = 0, stripEmbeddedRuntime = true } = options;
+  const preHeadScripts = options.preHeadScripts ?? [];
   const headScripts = options.headScripts ?? [getVerifiedHyperframeRuntimeSource()];
   const bodyScripts = options.bodyScripts ?? [RENDER_MODE_SCRIPT, HF_BRIDGE_SCRIPT];
   const app = new Hono3();
@@ -24104,7 +24139,11 @@ function createFileServer2(options) {
     if (ext === ".html") {
       const rawHtml = readFileSync17(filePath, "utf-8");
       const isIndex = relativePath === "index.html";
-      const html = isIndex ? injectScriptsIntoHtml2(rawHtml, headScripts, bodyScripts, stripEmbeddedRuntime) : rawHtml;
+      let html = rawHtml;
+      if (preHeadScripts.length > 0) {
+        html = injectScriptsAtHeadStart(html, preHeadScripts);
+      }
+      html = isIndex ? injectScriptsIntoHtml2(html, headScripts, bodyScripts, stripEmbeddedRuntime) : html;
       return c2.text(html, 200, { "Content-Type": contentType });
     }
     const content = readFileSync17(filePath);
@@ -24132,7 +24171,7 @@ function createFileServer2(options) {
     });
   });
 }
-var MIME_TYPES3, RENDER_SEEK_MODE, RENDER_SEEK_DIAGNOSTICS, RENDER_SEEK_STEP, RENDER_SEEK_OFFSET_FRACTION, RENDER_MODE_SCRIPT, HF_BRIDGE_SCRIPT;
+var MIME_TYPES3, VIRTUAL_TIME_SHIM, RENDER_SEEK_MODE, RENDER_SEEK_DIAGNOSTICS, RENDER_SEEK_STEP, RENDER_SEEK_OFFSET_FRACTION, RENDER_MODE_SCRIPT, HF_BRIDGE_SCRIPT;
 var init_fileServer2 = __esm({
   "../producer/src/services/fileServer.ts"() {
     "use strict";
@@ -24159,6 +24198,102 @@ var init_fileServer2 = __esm({
       ".ttf": "font/ttf",
       ".otf": "font/otf"
     };
+    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;
+
+  function flushAnimationFrame() {
+    if (!rafQueue.length) return;
+    var current = rafQueue.slice();
+    rafQueue.length = 0;
+    for (var i = 0; i < current.length; i++) {
+      var entry = current[i];
+      if (entry.cancelled) continue;
+      try {
+        entry.callback(virtualNowMs);
+      } catch {}
+    }
+  }
+
+  function VirtualDate() {
+    var args = Array.prototype.slice.call(arguments);
+    if (!(this instanceof VirtualDate)) {
+      return OriginalDate.apply(null, args.length ? args : [virtualNowMs]);
+    }
+    var instance = args.length ? new (Function.prototype.bind.apply(OriginalDate, [null].concat(args)))() : new OriginalDate(virtualNowMs);
+    Object.setPrototypeOf(instance, VirtualDate.prototype);
+    return instance;
+  }
+
+  VirtualDate.prototype = OriginalDate.prototype;
+  Object.setPrototypeOf(VirtualDate, OriginalDate);
+  VirtualDate.now = function() { return virtualNowMs; };
+  VirtualDate.parse = OriginalDate.parse.bind(OriginalDate);
+  VirtualDate.UTC = OriginalDate.UTC.bind(OriginalDate);
+
+  try {
+    Object.defineProperty(window, "Date", {
+      configurable: true,
+      writable: true,
+      value: VirtualDate,
+    });
+  } catch {}
+
+  if (window.performance && typeof window.performance.now === "function") {
+    try {
+      Object.defineProperty(window.performance, "now", {
+        configurable: true,
+        value: function() { return virtualNowMs; },
+      });
+    } catch {}
+  }
+
+  window.requestAnimationFrame = function(callback) {
+    if (typeof callback !== "function") return 0;
+    var entry = { id: rafId++, callback: callback, cancelled: false };
+    rafQueue.push(entry);
+    return entry.id;
+  };
+  window.cancelAnimationFrame = function(id) {
+    for (var i = 0; i < rafQueue.length; i++) {
+      if (rafQueue[i].id === id) {
+        rafQueue[i].cancelled = true;
+      }
+    }
+  };
+
+  window.__HF_VIRTUAL_TIME__ = {
+    originalSetTimeout: originalSetTimeout,
+    originalClearTimeout: originalClearTimeout,
+    originalSetInterval: originalSetInterval,
+    originalClearInterval: originalClearInterval,
+    originalRequestAnimationFrame: originalRequestAnimationFrame,
+    originalCancelAnimationFrame: originalCancelAnimationFrame,
+    seekToTime: function(nextTimeMs) {
+      var safeTimeMs = Math.max(0, Number(nextTimeMs) || 0);
+      virtualNowMs = safeTimeMs;
+      flushAnimationFrame();
+      return virtualNowMs;
+    },
+    getTime: function() {
+      return virtualNowMs;
+    },
+  };
+})();`;
     RENDER_SEEK_MODE = process.env.PRODUCER_RUNTIME_RENDER_SEEK_MODE === "strict-boundary" ? "strict-boundary" : "preview-phase";
     RENDER_SEEK_DIAGNOSTICS = process.env.PRODUCER_DEBUG_SEEK_DIAGNOSTICS === "true";
     RENDER_SEEK_STEP = Math.max(
@@ -24170,6 +24305,10 @@ var init_fileServer2 = __esm({
       Math.min(0.95, Number(process.env.PRODUCER_RUNTIME_RENDER_SEEK_OFFSET_FRACTION || 0.5))
     );
     RENDER_MODE_SCRIPT = `(function() {
+  var __realSetTimeout =
+    window.__HF_VIRTUAL_TIME__ && typeof window.__HF_VIRTUAL_TIME__.originalSetTimeout === "function"
+      ? window.__HF_VIRTUAL_TIME__.originalSetTimeout
+      : window.setTimeout.bind(window);
   var __seekMode = ${JSON.stringify(RENDER_SEEK_MODE)};
   var __seekDiagnostics = ${RENDER_SEEK_DIAGNOSTICS ? "true" : "false"};
   var __seekStep = ${RENDER_SEEK_STEP};
@@ -24263,23 +24402,56 @@ var init_fileServer2 = __esm({
         window.__renderReady = true;
         return;
       }
-      setTimeout(waitForPlayer, 50);
+      __realSetTimeout(waitForPlayer, 50);
       return;
     }
     if (installMediaFallbackPlayer()) {
       return;
     }
-    setTimeout(waitForPlayer, 50);
+    __realSetTimeout(waitForPlayer, 50);
   }
   waitForPlayer();
 })();`;
     HF_BRIDGE_SCRIPT = `(function() {
+  var __realSetInterval =
+    window.__HF_VIRTUAL_TIME__ && typeof window.__HF_VIRTUAL_TIME__.originalSetInterval === "function"
+      ? window.__HF_VIRTUAL_TIME__.originalSetInterval
+      : window.setInterval.bind(window);
+  var __realClearInterval =
+    window.__HF_VIRTUAL_TIME__ && typeof window.__HF_VIRTUAL_TIME__.originalClearInterval === "function"
+      ? window.__HF_VIRTUAL_TIME__.originalClearInterval
+      : window.clearInterval.bind(window);
   function getDeclaredDuration() {
     var root = document.querySelector('[data-composition-id]');
     if (!root) return 0;
     var d = Number(root.getAttribute('data-duration'));
     return Number.isFinite(d) && d > 0 ? d : 0;
   }
+  function seekSameOriginChildFrames(frameWindow, nextTimeMs) {
+    var frames;
+    try {
+      frames = frameWindow.frames;
+    } catch (_error) {
+      return;
+    }
+    if (!frames || typeof frames.length !== "number") return;
+    for (var i = 0; i < frames.length; i++) {
+      var childWindow = null;
+      try {
+        childWindow = frames[i];
+        if (!childWindow || childWindow === frameWindow) continue;
+        if (
+          childWindow.__HF_VIRTUAL_TIME__ &&
+          typeof childWindow.__HF_VIRTUAL_TIME__.seekToTime === "function"
+        ) {
+          childWindow.__HF_VIRTUAL_TIME__.seekToTime(nextTimeMs);
+        }
+      } catch (_error) {
+        continue;
+      }
+      seekSameOriginChildFrames(childWindow, nextTimeMs);
+    }
+  }
   function bridge() {
     var p = window.__player;
     if (!p || typeof p.renderSeek !== "function" || typeof p.getDuration !== "function") {
@@ -24290,13 +24462,20 @@ var init_fileServer2 = __esm({
         var d = p.getDuration();
         return d > 0 ? d : getDeclaredDuration();
       },
-      seek: function(t) { p.renderSeek(t); },
+      seek: function(t) {
+        p.renderSeek(t);
+        var nextTimeMs = (Math.max(0, Number(t) || 0)) * 1000;
+        if (window.__HF_VIRTUAL_TIME__ && typeof window.__HF_VIRTUAL_TIME__.seekToTime === "function") {
+          window.__HF_VIRTUAL_TIME__.seekToTime(nextTimeMs);
+        }
+        seekSameOriginChildFrames(window, nextTimeMs);
+      },
     };
     return true;
   }
   if (bridge()) return;
-  var iv = setInterval(function() {
-    if (bridge()) clearInterval(iv);
+  var iv = __realSetInterval(function() {
+    if (bridge()) __realClearInterval(iv);
   }, 50);
 })();`;
   }
@@ -24753,6 +24932,36 @@ function dedupeElementsById(elements) {
   }
   return Array.from(deduped.values());
 }
+function stripJsComments(source) {
+  return source.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
+}
+function detectRenderModeHints(html) {
+  const reasons = [];
+  const { document: document2 } = parseHTML(html);
+  if (document2.querySelector("iframe")) {
+    reasons.push({
+      code: "iframe",
+      message: "Detected <iframe> in the composition DOM. Nested iframe animation is routed through screenshot capture mode for compatibility."
+    });
+  }
+  let scriptMatch;
+  const scriptPattern = new RegExp(INLINE_SCRIPT_PATTERN.source, INLINE_SCRIPT_PATTERN.flags);
+  while ((scriptMatch = scriptPattern.exec(html)) !== null) {
+    const attrs = scriptMatch[1] || "";
+    if (/\bsrc\s*=/i.test(attrs)) continue;
+    const content = stripJsComments(scriptMatch[2] || "");
+    if (!/requestAnimationFrame\s*\(/.test(content)) continue;
+    reasons.push({
+      code: "requestAnimationFrame",
+      message: "Detected raw requestAnimationFrame() in an inline script. This render is routed through screenshot capture mode with virtual time enabled."
+    });
+    break;
+  }
+  return {
+    recommendScreenshot: reasons.length > 0,
+    reasons
+  };
+}
 async function resolveMediaDuration(src, mediaStart, baseDir, downloadDir, tagName19) {
   let filePath = src;
   if (isHttpUrl(src)) {
@@ -25316,6 +25525,7 @@ async function compileForRender(projectDir, htmlPath, downloadDir) {
     /(<(?:video|audio)\b[^>]*?)\s+preload\s*=\s*["']none["']/gi,
     "$1"
   );
+  const renderModeHints = detectRenderModeHints(sanitizedHtml);
   const coalescedHtml = await injectDeterministicFontFaces(
     coalesceHeadStylesAndBodyScripts2(promoteCssImportsToLinkTags(sanitizedHtml))
   );
@@ -25359,7 +25569,8 @@ async function compileForRender(projectDir, htmlPath, downloadDir) {
     externalAssets,
     width,
     height,
-    staticDuration
+    staticDuration,
+    renderModeHints
   };
 }
 async function discoverMediaFromBrowser(page) {
@@ -25453,9 +25664,11 @@ async function recompileWithResolutions(compiled, resolutions, projectDir, downl
     subCompositions,
     videos,
     audios,
-    unresolvedCompositions: remaining
+    unresolvedCompositions: remaining,
+    renderModeHints: compiled.renderModeHints
   };
 }
+var INLINE_SCRIPT_PATTERN;
 var init_htmlCompiler2 = __esm({
   "../producer/src/services/htmlCompiler.ts"() {
     "use strict";
@@ -25466,6 +25679,7 @@ var init_htmlCompiler2 = __esm({
     init_src2();
     init_urlDownloader2();
     init_deterministicFonts();
+    INLINE_SCRIPT_PATTERN = /<script\b([^>]*)>([\s\S]*?)<\/script>/gi;
   }
 });
 
@@ -25613,11 +25827,20 @@ function writeCompiledArtifacts(compiled, workDir, includeSummary) {
         end: a.end,
         mediaStart: a.mediaStart
       })),
-      subCompositions: Array.from(compiled.subCompositions.keys())
+      subCompositions: Array.from(compiled.subCompositions.keys()),
+      renderModeHints: compiled.renderModeHints
     };
     writeFileSync10(join30(compileDir, "summary.json"), JSON.stringify(summary, null, 2), "utf-8");
   }
 }
+function applyRenderModeHints(cfg, compiled, log = defaultLogger) {
+  if (cfg.forceScreenshot || !compiled.renderModeHints.recommendScreenshot) return;
+  cfg.forceScreenshot = true;
+  log.warn("Auto-selected screenshot capture mode for render compatibility", {
+    reasonCodes: compiled.renderModeHints.reasons.map((reason) => reason.code),
+    reasons: compiled.renderModeHints.reasons.map((reason) => reason.message)
+  });
+}
 function createRenderJob(config) {
   return {
     id: randomUUID2(),
@@ -25730,6 +25953,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     let compiled = await compileForRender(projectDir, htmlPath, join30(workDir, "downloads"));
     assertNotAborted();
     perfStages.compileOnlyMs = Date.now() - compileStart;
+    applyRenderModeHints(cfg, compiled, log);
     writeCompiledArtifacts(compiled, workDir, Boolean(job.config.debug));
     log.info("Compiled composition metadata", {
       entryFile,
@@ -25737,7 +25961,8 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       width: compiled.width,
       height: compiled.height,
       videoCount: compiled.videos.length,
-      audioCount: compiled.audios.length
+      audioCount: compiled.audios.length,
+      renderModeHints: compiled.renderModeHints
     });
     const composition = {
       duration: compiled.staticDuration,
@@ -25757,7 +25982,8 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       fileServer = await createFileServer2({
         projectDir,
         compiledDir: join30(workDir, "compiled"),
-        port: 0
+        port: 0,
+        preHeadScripts: [VIRTUAL_TIME_SHIM]
       });
       assertNotAborted();
       const captureOpts = {
@@ -26000,7 +26226,8 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       fileServer = await createFileServer2({
         projectDir,
         compiledDir: join30(workDir, "compiled"),
-        port: 0
+        port: 0,
+        preHeadScripts: [VIRTUAL_TIME_SHIM]
       });
       assertNotAborted();
     }