hyperframes 0.8.34 → 0.8.36

package/dist/commands/layout-audit.browser.js

@@ -1689,7 +1689,13 @@
         axes && axes !== "normal" ? axes : ""
       }`;
     });
-    for (const media of root.querySelectorAll("canvas, video")) {
+    // img shares the same pixel-only-motion blind spot as canvas/video: an
+    // equal-size, equal-position opaque src/visibility swap moves no
+    // geometry and no opacity. mediaPixelHash already handles it generically
+    // (drawImage accepts any CanvasImageSource; width/height fall back to
+    // rect.width/height same as canvas/video), so only the element selector
+    // needed widening.
+    for (const media of root.querySelectorAll("canvas, video, img")) {
       if (!isVisibleElement(media)) continue;
       parts.push(`p:${mediaPixelHash(media)}`);
     }

package/dist/fontLocalizeCli.js

@@ -54532,6 +54532,34 @@ var init_pageNavigationTimeoutErrorHint = __esm({
   }
 });
 
+// ../engine/src/services/drawElementCaptureError.ts
+function isDrawElementCaptureError(error) {
+  let current2 = error;
+  for (let depth = 0; depth < 5 && typeof current2 === "object" && current2 !== null; depth++) {
+    if ("deCaptureFailure" in current2 && current2.deCaptureFailure === true) return true;
+    current2 = "cause" in current2 ? current2.cause : void 0;
+  }
+  return false;
+}
+var DrawElementCaptureError;
+var init_drawElementCaptureError = __esm({
+  "../engine/src/services/drawElementCaptureError.ts"() {
+    "use strict";
+    DrawElementCaptureError = class extends Error {
+      frameIndex;
+      constructor(frameIndex, reason, cause) {
+        super(
+          `drawElement capture failed at frame ${frameIndex}: ${reason}; fresh screenshot capture required`,
+          { cause }
+        );
+        this.name = "DrawElementCaptureError";
+        Object.defineProperty(this, "deCaptureFailure", { value: true, enumerable: true });
+        this.frameIndex = frameIndex;
+      }
+    };
+  }
+});
+
 // ../engine/src/services/screenshotService.ts
 async function getCdpSession(page) {
   let client = cdpSessionCache.get(page);
@@ -58596,7 +58624,10 @@ async function captureFrameCore(session, frameIndex, time) {
       else session.beginFrameNoDamageCount++;
       screenshotBuffer = result.buffer;
     } else if (session.captureMode === "drawelement" && session.clipBoundaryFrames?.has(frameIndex) && process.env.HF_FAST_CAPTURE_BOUNDARY_SS === "true") {
-      screenshotBuffer = await pageScreenshotCapture(page, options);
+      throw new DrawElementCaptureError(
+        frameIndex,
+        "boundary screenshot requested on an injected canvas page"
+      );
     } else if (session.captureMode === "drawelement") {
       if (session.beginFrameTimeTicks > 0) {
         const client = await getCdpSession(page);
@@ -58625,10 +58656,10 @@ async function captureFrameCore(session, frameIndex, time) {
           const median = sorted ? sorted[sorted.length >> 1] ?? 0 : 0;
           const floor = Math.max(2e4, median * 0.12);
           if (screenshotBuffer.length < floor) {
-            console.log(
-              `[engine] fast capture: frame ${frameIndex} \u2014 drawElement frame anomalously small (${screenshotBuffer.length}B < ${Math.round(floor)}B, likely a silent paint-record drop); screenshot fallback (see fast-capture-limitations.md)`
+            throw new DrawElementCaptureError(
+              frameIndex,
+              `suspect small frame (${screenshotBuffer.length}B < ${Math.round(floor)}B)`
             );
-            screenshotBuffer = await pageScreenshotCapture(page, options);
           } else {
             if (sizes.length >= 60) sizes.shift();
             sizes.push(screenshotBuffer.length);
@@ -58638,10 +58669,7 @@ async function captureFrameCore(session, frameIndex, time) {
         if (isRecoverableDrawElementError(err)) {
           session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
           const reason = isCanvasNotInitializedError(err) ? "drawElement canvas not initialized" : "No cached paint record";
-          console.log(
-            `[engine] fast capture: frame ${frameIndex} \u2014 ${reason}; screenshot fallback for this frame (see fast-capture-limitations.md)`
-          );
-          screenshotBuffer = await pageScreenshotCapture(page, options);
+          throw new DrawElementCaptureError(frameIndex, reason, err);
         } else {
           throw err;
         }
@@ -58730,21 +58758,10 @@ async function captureFrameToBufferPipelined(session, frameIndex, time) {
     );
     void quantizedTime;
     if (session.clipBoundaryFrames?.has(frameIndex) && process.env.HF_FAST_CAPTURE_BOUNDARY_SS === "true") {
-      const buffer = await pageScreenshotCapture(page, options);
-      session.capturePerf.frames += 1;
-      session.capturePerf.seekMs += seekMs;
-      session.capturePerf.beforeCaptureMs += beforeCaptureMs;
-      {
-        const boundaryMs = Date.now() - startTime;
-        session.capturePerf.totalMs += boundaryMs;
-        session.capturePerf.frameMs.push(boundaryMs);
-      }
-      const boundaryResult = Promise.resolve(buffer);
-      if (session.staticFrames) {
-        session.lastEncodeResult = boundaryResult;
-        session.lastEncodeResultFrame = frameIndex;
-      }
-      return { encodeResult: boundaryResult, captureTimeMs: Date.now() - startTime };
+      throw new DrawElementCaptureError(
+        frameIndex,
+        "boundary screenshot requested on an injected canvas page"
+      );
     }
     const { encodeResult } = await produceDrawElementFrame(
       page,
@@ -58766,15 +58783,6 @@ async function captureFrameToBufferPipelined(session, frameIndex, time) {
     }
     return { encodeResult, captureTimeMs };
   } catch (captureError) {
-    if (isRecoverableDrawElementError(captureError)) {
-      session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
-      const reason = isCanvasNotInitializedError(captureError) ? "drawElement canvas not initialized" : "No cached paint record";
-      console.log(
-        `[engine] fast capture: frame ${frameIndex} \u2014 ${reason}; screenshot fallback for this frame (see fast-capture-limitations.md)`
-      );
-      const buffer = await pageScreenshotCapture(page, options);
-      return { encodeResult: Promise.resolve(buffer), captureTimeMs: Date.now() - startTime };
-    }
     if (session.isInitialized) {
       await captureFrameErrorDiagnostics(
         session,
@@ -58783,6 +58791,11 @@ async function captureFrameToBufferPipelined(session, frameIndex, time) {
         captureError instanceof Error ? captureError : new Error(String(captureError))
       );
     }
+    if (isRecoverableDrawElementError(captureError)) {
+      session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
+      const reason = isCanvasNotInitializedError(captureError) ? "drawElement canvas not initialized" : "No cached paint record";
+      throw new DrawElementCaptureError(frameIndex, reason, captureError);
+    }
     throw captureError;
   }
 }
@@ -58816,6 +58829,8 @@ async function captureFramesBatchPipelined(session, frameIndices, times) {
     options.height,
     options.quality ?? 80
   );
+  for (const result of encodeResults) void result.catch(() => {
+  });
   const okCount = failedAt === null ? frameIndices.length : failedAt;
   const elapsed = Date.now() - startTime;
   session.capturePerf.frames += okCount;
@@ -58835,23 +58850,8 @@ async function captureFramesBatchPipelined(session, frameIndices, times) {
   if (failedAt !== null) {
     if (isRecoverableDrawElementError(error)) {
       const reason = isCanvasNotInitializedError(error) ? "drawElement canvas not initialized" : "No cached paint record";
-      console.log(
-        `[engine] fast capture: batch produce failed at frame ${frameIndices[failedAt] ?? "?"} (${reason}); screenshot fallback for ${frameIndices.length - failedAt} frame(s) (see fast-capture-limitations.md)`
-      );
-      for (let i = failedAt; i < frameIndices.length; i++) {
-        const frameIndex = frameIndices[i];
-        const time = times[i];
-        if (frameIndex === void 0 || time === void 0) break;
-        session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
-        await prepareFrameForCapture(session, frameIndex, time);
-        const buffer = await pageScreenshotCapture(page, options);
-        const encodeResult = Promise.resolve(buffer);
-        if (session.staticFrames) {
-          session.lastEncodeResult = encodeResult;
-          session.lastEncodeResultFrame = frameIndex;
-        }
-        results.push({ frameIndex, encodeResult });
-      }
+      session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
+      throw new DrawElementCaptureError(frameIndices[failedAt] ?? failedAt, reason, error);
     } else {
       console.log(
         `[engine] fast capture: batch produce failed at frame ${frameIndices[failedAt] ?? "?"} (${error ?? "?"}); re-capturing ${frameIndices.length - failedAt} frame(s) per-frame`
@@ -59024,7 +59024,7 @@ function getCapturePerfSummary(session) {
   if (frames > 0 && ncprFallbacks / frames > DE_FALLBACK_RATIO_WARN_THRESHOLD) {
     const pct = Math.round(ncprFallbacks / frames * 100);
     console.warn(
-      `[engine] fast capture: ${ncprFallbacks}/${frames} frame(s) (${pct}%) fell back to screenshot capture (canvas-not-initialized / no-cached-paint-record) \u2014 drawElement likely failed to engage for this render rather than recovering a few edge-case frames; see fast-capture-limitations.md.`
+      `[engine] fast capture: ${ncprFallbacks}/${frames} frame(s) (${pct}%) rejected due to missing canvas/paint records; fresh screenshot capture required.`
     );
   }
   return {
@@ -59074,6 +59074,7 @@ var init_frameCapture = __esm({
   "../engine/src/services/frameCapture.ts"() {
     "use strict";
     init_dist2();
+    init_drawElementCaptureError();
     init_browserManager();
     init_screenshotService();
     init_drawElementService();
@@ -68748,6 +68749,21 @@ function findRootTag(source, parsedTags) {
   }
   return null;
 }
+function hasUnquotedLessThan(attrs) {
+  let quote = null;
+  for (const ch of attrs) {
+    if (quote) {
+      if (ch === quote) quote = null;
+      continue;
+    }
+    if (ch === '"' || ch === "'") {
+      quote = ch;
+    } else if (ch === "<") {
+      return true;
+    }
+  }
+  return false;
+}
 function readAttr(tagSource, attr) {
   if (!tagSource) return null;
   const escaped = attr.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -71170,6 +71186,21 @@ var init_dist3 = __esm({
         }
         return findings;
       },
+      // unclosed_tag_swallowed_element
+      ({ tags }) => {
+        const findings = [];
+        for (const tag of tags) {
+          if (!hasUnquotedLessThan(tag.attrs)) continue;
+          findings.push({
+            code: "unclosed_tag_swallowed_element",
+            severity: "error",
+            message: `<${tag.name}> is missing its closing \`>\` before the next \`<\` \u2014 the following element is swallowed as bogus attribute text and never becomes a real node.`,
+            fixHint: "Close the previous tag's `>` before opening the next element.",
+            snippet: truncateSnippet(tag.raw)
+          });
+        }
+        return findings;
+      },
       // invalid_inline_script_syntax (malformed close tag)
       ({ source }) => {
         if (!INVALID_SCRIPT_CLOSE_PATTERN.test(source)) return [];
@@ -81878,6 +81909,7 @@ __export(src_exports, {
   DEFAULT_HDR10_MASTERING: () => DEFAULT_HDR10_MASTERING,
   DEFAULT_VP9_CPU_USED: () => DEFAULT_VP9_CPU_USED,
   DOM_LAYER_MASK_STYLE_ID: () => DOM_LAYER_MASK_STYLE_ID,
+  DrawElementCaptureError: () => DrawElementCaptureError,
   DrawElementVerificationError: () => DrawElementVerificationError,
   ENABLE_BROWSER_POOL: () => ENABLE_BROWSER_POOL,
   ENCODER_PRESETS: () => ENCODER_PRESETS,
@@ -81992,6 +82024,7 @@ __export(src_exports, {
   initializeSession: () => initializeSession,
   injectVideoFramesBatch: () => injectVideoFramesBatch,
   isBlockedNetworkHost: () => isBlockedNetworkHost,
+  isDrawElementCaptureError: () => isDrawElementCaptureError,
   isDrawElementVerificationError: () => isDrawElementVerificationError,
   isExternalFfmpegInterruption: () => isExternalFfmpegInterruption,
   isFatalCaptureFailure: () => isFatalCaptureFailure,
@@ -82107,6 +82140,7 @@ var init_src = __esm({
     init_videoFrameInjector();
     init_hdr();
     init_renderProvenance();
+    init_drawElementCaptureError();
   }
 });
 
@@ -86818,7 +86852,7 @@ function revertedRouting(routing) {
   return freezeRouting({ ...routing, state: "reverted" });
 }
 function replanAfterFailure(plan2, failure) {
-  if (plan2.kind === "sdr_disk" && failure.kind === "draw_element_verification") {
+  if (plan2.kind === "sdr_disk" && (failure.kind === "draw_element_verification" || failure.kind === "draw_element_capture")) {
     return createCapturePlan({
       ...plan2,
       forceScreenshot: true,
@@ -96523,7 +96557,7 @@ async function executeDiskCaptureWithAdaptiveRetry(options) {
       if (failure.kind === "cancelled") {
         throw error;
       }
-      if (isDrawElementVerificationError(error)) {
+      if (isDrawElementVerificationError(error) || isDrawElementCaptureError(error)) {
         throw error;
       }
       const remaining = findMissingFrameRanges(
@@ -96751,7 +96785,7 @@ function resolveParallelRouterRetryPlan(args) {
 }
 function shouldRetryViaPinnedFallback(args) {
   if (args.isCancellation || args.isEncoderInterrupted) return false;
-  if (args.isVerifyError) return true;
+  if (args.isVerifyError || args.isDeCaptureError) return true;
   if (args.isDeRendererStall === true || args.isSequentialCaptureStall === true) return true;
   return args.deWorkerInversion === "inverted" || args.deParallelRouter === "routed";
 }
@@ -96777,6 +96811,9 @@ async function closeOrphanedProbeForRetry(probe2, closer, log, retryContext) {
 function shouldStreamParallelCapture(args) {
   return args.routerEnabled && args.workerCount > 1 && !args.useDrawElement && args.outputFormat === "mp4" && args.streamingOk && !args.layeredOrEffectRoute;
 }
+function shouldClampDefaultDrawElement(args) {
+  return args.useDrawElement && !args.fastCaptureExplicitOptIn && (!args.useStreamingEncode || args.workerCount > 1) && !args.deParallelStreamVerified;
+}
 function resolveCaptureForceScreenshotForPageSideCompositing(args) {
   return args.usePageSideCompositing ? true : args.forceScreenshot;
 }
@@ -97519,6 +97556,32 @@ async function executeRenderPipeline(input) {
       deWorkerInversion: deWorkerInversion ?? "none",
       deParallelRouter: deParallelRouter ?? "none"
     });
+    let useStreamingEncode = shouldUseStreamingEncode(
+      cfg,
+      outputFormat,
+      workerCount,
+      job.duration,
+      deParallelStreamForced
+    );
+    const deParallelStreamVerified = (deParallelStreamForced || process.env.HF_DE_PARALLEL_STREAM === "true") && useStreamingEncode && workerCount > 1;
+    if (shouldClampDefaultDrawElement({
+      useDrawElement: cfg.useDrawElement,
+      fastCaptureExplicitOptIn: process.env.PRODUCER_EXPERIMENTAL_FAST_CAPTURE === "true",
+      useStreamingEncode,
+      workerCount,
+      deParallelStreamVerified
+    })) {
+      cfg.useDrawElement = false;
+      deClampReason = workerCount > 1 ? "parallel" : "disk_path";
+      log.info(
+        "[Render] Fast capture: default-on drawElement disabled for this render \u2014 " + (workerCount > 1 ? "parallel capture" : "the disk capture path") + " has no runtime self-verification. Set PRODUCER_EXPERIMENTAL_FAST_CAPTURE=true to override."
+      );
+      if (probeSession && probeSession.captureMode === "drawelement") {
+        lastBrowserConsole = probeSession.browserConsoleBuffer;
+        await closeCaptureSession(probeSession);
+        probeSession = null;
+      }
+    }
     const captureParallelStreamRouterEnabled = process.env.HF_CAPTURE_PARALLEL_STREAM === "true";
     const captureParallelStreamArgs = {
       workerCount,
@@ -97550,7 +97613,7 @@ async function executeRenderPipeline(input) {
       await closeCaptureSession(probeSession);
       probeSession = null;
     }
-    let useStreamingEncode = shouldUseStreamingEncode(
+    useStreamingEncode = shouldUseStreamingEncode(
       cfg,
       outputFormat,
       workerCount,
@@ -97565,18 +97628,6 @@ async function executeRenderPipeline(input) {
       durationSeconds: job.duration,
       maxDurationSeconds: cfg.streamingEncodeMaxDurationSeconds
     });
-    const deParallelStreamVerified = (deParallelStreamForced || process.env.HF_DE_PARALLEL_STREAM === "true") && useStreamingEncode && workerCount > 1;
-    if (cfg.useDrawElement && process.env.PRODUCER_EXPERIMENTAL_FAST_CAPTURE !== "true" && (!useStreamingEncode || workerCount > 1) && !deParallelStreamVerified) {
-      cfg.useDrawElement = false;
-      deClampReason = workerCount > 1 ? "parallel" : "disk_path";
-      log.info(
-        "[Render] Fast capture: default-on drawElement disabled for this render \u2014 " + (workerCount > 1 ? "parallel capture" : "the disk capture path") + " has no runtime self-verification. Set PRODUCER_EXPERIMENTAL_FAST_CAPTURE=true to override."
-      );
-      if (probeSession && probeSession.captureMode === "drawelement") {
-        await closeCaptureSession(probeSession);
-        probeSession = null;
-      }
-    }
     const FORMAT_EXT = {
       mp4: ".mp4",
       webm: ".webm",
@@ -97837,11 +97888,13 @@ async function executeRenderPipeline(input) {
           streamingRes = await invokeStreaming();
         } catch (err) {
           const isVerifyError = isDrawElementVerificationError(err);
+          const isDeCaptureError = isDrawElementCaptureError(err);
           const isDeStall = isDeRendererStallError(err);
           const isSequentialStall = isSequentialCaptureStallError(err);
           const isCancellation = err instanceof RenderCancelledError || executionSignal?.aborted === true;
           if (!shouldRetryViaPinnedFallback({
             isVerifyError,
+            isDeCaptureError,
             isCancellation,
             isEncoderInterrupted: err instanceof EncoderInterruptedError,
             deWorkerInversion,
@@ -97862,12 +97915,12 @@ async function executeRenderPipeline(input) {
             deFallbackReason = isMemoryExhaustion ? "oom" : isDeStall ? "de_renderer_stall" : "capture_error";
           }
           log.warn(
-            isVerifyError ? "[Render] drawElement self-verification failed; re-rendering via screenshot" : isDeStall ? "[Render] drawElement renderer stalled; re-rendering via screenshot" : isSequentialStall ? "[Render] sequential capture stalled; retrying on a fresh screenshot session" : "[Render] capture failed on the pinned worker count; re-rendering via screenshot",
+            isVerifyError ? "[Render] drawElement self-verification failed; re-rendering via screenshot" : isDeStall ? "[Render] drawElement renderer stalled; re-rendering via screenshot" : isSequentialStall ? "[Render] sequential capture stalled; retrying on a fresh screenshot session" : "[Render] capture failed; re-rendering via a fresh screenshot session",
             { error: err instanceof Error ? err.message : String(err) }
           );
           observability.checkpoint(
             "capture_streaming",
-            isVerifyError ? "drawElement self-verify failed; retrying with forceScreenshot" : isDeStall ? "drawElement renderer stalled; retrying with forceScreenshot" : isSequentialStall ? "sequential capture stalled; retrying with a fresh screenshot session" : "capture failed on pinned worker count; retrying with forceScreenshot"
+            isVerifyError ? "drawElement self-verify failed; retrying with forceScreenshot" : isDeStall ? "drawElement renderer stalled; retrying with forceScreenshot" : isSequentialStall ? "sequential capture stalled; retrying with a fresh screenshot session" : "capture failed; retrying with a fresh screenshot session"
           );
           const failedRouting = capturePlan.routing.kind;
           capturePlan = replanAfterFailure(
@@ -97980,22 +98033,22 @@ async function executeRenderPipeline(input) {
         try {
           captureRes = await invokeDiskCapture(capturePlan);
         } catch (err) {
-          if (!isDrawElementVerificationError(err) || err instanceof RenderCancelledError || executionSignal?.aborted === true) {
+          if (!isDrawElementVerificationError(err) && !isDrawElementCaptureError(err) || err instanceof RenderCancelledError || executionSignal?.aborted === true) {
             throw err;
           }
-          deSelfVerifyFallback = true;
+          deSelfVerifyFallback = isDrawElementVerificationError(err);
           const t = deVerifyFallbackTelemetry(err);
-          deFallbackReason = t.reason;
+          deFallbackReason = deSelfVerifyFallback ? t.reason : "capture_error";
           deFallbackFailedDb = t.failedDb;
           deFallbackFrameIndex = t.frameIndex;
           deFallbackThresholdDb = t.thresholdDb;
           log.warn(
-            "[Render] drawElement self-verification failed on the parallel disk path; re-rendering via screenshot",
+            "[Render] drawElement capture failed on the parallel disk path; re-rendering via screenshot",
             { error: err instanceof Error ? err.message : String(err) }
           );
           observability.checkpoint(
             "capture_disk",
-            "drawElement self-verify failed; retrying with forceScreenshot"
+            "drawElement capture failed; retrying with a fresh screenshot session"
           );
           rmSync14(framesDir, { recursive: true, force: true });
           mkdirSync17(framesDir, { recursive: true });
@@ -98008,7 +98061,9 @@ async function executeRenderPipeline(input) {
             probeSession = null;
             await closeOrphanedProbeForRetry(orphaned, closeCaptureSession, log, "disk verify");
           }
-          capturePlan = replanAfterFailure(capturePlan, { kind: "draw_element_verification" });
+          capturePlan = replanAfterFailure(capturePlan, {
+            kind: deSelfVerifyFallback ? "draw_element_verification" : "draw_element_capture"
+          });
           syncCapturePlan();
           updateCaptureObservability({
             forceScreenshot: capturePlan.forceScreenshot,
@@ -99571,8 +99626,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.34" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.34" : "0.0.0-dev";
+var VERSION = true ? "0.8.36" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.36" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {