hyperframes 0.8.71 → 0.8.73

package/dist/fontLocalizeCli.js

@@ -65139,7 +65139,7 @@ function classifyDownloadFailure(error) {
       return new UrlDownloadError(
         "network",
         true,
-        "Download failed due to a transient network error"
+        `Download failed due to a transient network error${describeCause(current2)}`
       );
     }
     current2 = typeof current2 === "object" && current2 !== null && "cause" in current2 ? current2.cause : void 0;
@@ -65147,9 +65147,16 @@ function classifyDownloadFailure(error) {
   return new UrlDownloadError(
     "filesystem",
     false,
-    "Download failed while writing the local artifact"
+    `Download failed while writing the local artifact${describeCause(error)}`
   );
 }
+function describeCause(error) {
+  const name = error instanceof Error && /^[A-Za-z]{1,40}$/.test(error.name) ? error.name : "";
+  const rawCode = typeof error === "object" && error !== null && "code" in error ? error.code : void 0;
+  const code = typeof rawCode === "string" && /^[A-Z0-9_]{1,40}$/.test(rawCode) ? rawCode : "";
+  const tag = [name, code].filter(Boolean).join(" ");
+  return tag ? ` (${tag})` : "";
+}
 function isRetryableNetworkCause(error) {
   const message = error instanceof Error ? error.message : String(error);
   const code = typeof error === "object" && error !== null && "code" in error && typeof error.code === "string" ? error.code : "";
@@ -89223,6 +89230,38 @@ function updateJobStatus(job, status, stage, progress, onProgress) {
   }
   if (onProgress) void onProgress(job, stage);
 }
+var PROGRESS_REPORT_INTERVAL_MS = 250;
+var lastFrameReportAt = /* @__PURE__ */ new WeakMap();
+var lastStartupReportAt = /* @__PURE__ */ new WeakMap();
+function reportThrottled(lastReportAt, job, stage, progress, onProgress, force) {
+  const now = Date.now();
+  const last = lastReportAt.get(job);
+  const due = force || last === void 0 || now - last >= PROGRESS_REPORT_INTERVAL_MS;
+  if (due) lastReportAt.set(job, now);
+  updateJobStatus(job, "rendering", stage, progress, due ? onProgress : void 0);
+}
+function reportFrameProgress(job, stage, progress, onProgress, isLastFrame) {
+  reportThrottled(lastFrameReportAt, job, stage, progress, onProgress, isLastFrame);
+}
+var workerPhasesByJob = /* @__PURE__ */ new WeakMap();
+function reportWorkerStartup(job, progress, onProgress) {
+  const phase = progress.latestWorkerPhase;
+  if (!phase) return;
+  const phases = workerPhasesByJob.get(job) ?? /* @__PURE__ */ new Map();
+  workerPhasesByJob.set(job, phases);
+  phases.set(phase.workerId, phase.phase);
+  const ready = [...phases].filter(
+    ([id, p]) => id < progress.activeWorkers && (p === "frame_capture" || p === "frame_encode")
+  ).length;
+  reportThrottled(
+    lastStartupReportAt,
+    job,
+    `Starting browsers (${ready}/${progress.activeWorkers} ready)`,
+    job.progress,
+    onProgress,
+    false
+  );
+}
 var materializePathModule = {
   resolve: resolve8,
   join: join22,
@@ -91541,12 +91580,12 @@ async function runWorkerEncodePipelineLoop(session, totalFrames, job, currentEnc
     reorderBuffer.advanceTo(prev.idx + 1);
     job.framesRendered = prev.idx + 1;
     lastProgressAt = Date.now();
-    updateJobStatus(
+    reportFrameProgress(
       job,
-      "rendering",
       `Streaming frame ${prev.idx + 1}/${totalFrames}`,
       Math.round(25 + (prev.idx + 1) / totalFrames * 55),
-      onProgress
+      onProgress,
+      prev.idx + 1 === totalFrames
     );
   };
   const batchNRaw = Number(process.env.HF_DE_BATCH ?? "4");
@@ -91560,12 +91599,12 @@ async function runWorkerEncodePipelineLoop(session, totalFrames, job, currentEnc
       reorderBuffer.advanceTo(item.idx + 1);
       job.framesRendered = item.idx + 1;
       lastProgressAt = Date.now();
-      updateJobStatus(
+      reportFrameProgress(
         job,
-        "rendering",
         `Streaming frame ${item.idx + 1}/${totalFrames}`,
         Math.round(25 + (item.idx + 1) / totalFrames * 55),
-        onProgress
+        onProgress,
+        item.idx + 1 === totalFrames
       );
     }
   };
@@ -91762,6 +91801,7 @@ async function runCaptureStreamingStage(input) {
                 canvasDrawElement: phase.canvasDrawElement,
                 gpuBackend: phase.gpuBackend
               });
+              if (progress.capturedFrames === 0) reportWorkerStartup(job, progress, onProgress);
               return;
             }
             if (progress.capturedFrames > lastCapturedFrames) {
@@ -91771,16 +91811,13 @@ async function runCaptureStreamingStage(input) {
             }
             job.framesRendered = progress.capturedFrames;
             const frameProgress = progress.capturedFrames / progress.totalFrames;
-            const progressPct = 25 + frameProgress * 55;
-            if (progress.capturedFrames % 30 === 0 || progress.capturedFrames === progress.totalFrames) {
-              updateJobStatus(
-                job,
-                "rendering",
-                `Streaming frame ${progress.capturedFrames}/${progress.totalFrames} (${workerCount} workers)`,
-                Math.round(progressPct),
-                onProgress
-              );
-            }
+            reportFrameProgress(
+              job,
+              `Streaming frame ${progress.capturedFrames}/${progress.totalFrames} (${workerCount} workers)`,
+              Math.round(25 + frameProgress * 55),
+              onProgress,
+              progress.capturedFrames === progress.totalFrames
+            );
           },
           onFrameBuffer,
           // Interleaved DE workers each need their own browser PROCESS:
@@ -91892,12 +91929,12 @@ async function runCaptureStreamingStage(input) {
             lastProgressAt = Date.now();
             const frameProgress = (i + 1) / totalFrames;
             const progress = 25 + frameProgress * 55;
-            updateJobStatus(
+            reportFrameProgress(
               job,
-              "rendering",
               `Streaming frame ${i + 1}/${totalFrames}`,
               Math.round(progress),
-              onProgress
+              onProgress,
+              i + 1 === totalFrames
             );
           }
         }
@@ -91976,12 +92013,12 @@ async function captureSegmentFrames(ctx, segment, encoder) {
     ensureFrameWritten(await encoder.writeFrame(buffer), i, encoder);
     ctx.job.framesRendered = i + 1;
     lastProgressAt = Date.now();
-    updateJobStatus(
+    reportFrameProgress(
       ctx.job,
-      "rendering",
       `Streaming frame ${i + 1}/${ctx.totalFrames} (segment ${segment.index + 1}/${ctx.segmentCount}` + (ctx.skipped > 0 ? `, skipped ${ctx.skipped}` : "") + ")",
       Math.round(25 + (i + 1) / ctx.totalFrames * 55),
-      ctx.onProgress
+      ctx.onProgress,
+      i + 1 === ctx.totalFrames
     );
   }
 }
@@ -98125,19 +98162,20 @@ async function runCaptureStage(input) {
       frameRangeStart: frameRange?.startFrame,
       dedupPerfs,
       onProgress: (progress) => {
+        if (progress.latestWorkerPhase) {
+          if (progress.capturedFrames === 0) reportWorkerStartup(job, progress, onProgress);
+          return;
+        }
         job.framesRendered = progress.capturedFrames;
         checkDiskProjection(progress.capturedFrames);
         const frameProgress = progress.capturedFrames / progress.totalFrames;
-        const progressPct = 25 + frameProgress * 45;
-        if (progress.capturedFrames % 30 === 0 || progress.capturedFrames === progress.totalFrames) {
-          updateJobStatus(
-            job,
-            "rendering",
-            `Capturing frame ${progress.capturedFrames}/${progress.totalFrames} (${progress.activeWorkers} workers)`,
-            Math.round(progressPct),
-            onProgress
-          );
-        }
+        reportFrameProgress(
+          job,
+          `Capturing frame ${progress.capturedFrames}/${progress.totalFrames} (${progress.activeWorkers} workers)`,
+          Math.round(25 + frameProgress * 45),
+          onProgress,
+          progress.capturedFrames === progress.totalFrames
+        );
       },
       cfg: captureCfg,
       log
@@ -98267,12 +98305,12 @@ async function captureSessionFrames(session, { input, rangeStart, rangeEnd, resu
   const reportFrame = (fileIndex) => {
     job.framesRendered = fileIndex + 1;
     checkDiskProjection(fileIndex + 1);
-    updateJobStatus(
+    reportFrameProgress(
       job,
-      "rendering",
       `Capturing frame ${fileIndex + 1}/${rangeFrames}`,
       Math.round(25 + (fileIndex + 1) / rangeFrames * 45),
-      onProgress
+      onProgress,
+      fileIndex + 1 === rangeFrames
     );
   };
   if (session.workerEncodeEnabled) {
@@ -98525,16 +98563,13 @@ async function runSequentialLayeredFrameLoop(input) {
       log
     });
     job.framesRendered = i + 1;
-    if ((i + 1) % 10 === 0 || i + 1 === totalFrames) {
-      const frameProgress = (i + 1) / totalFrames;
-      updateJobStatus(
-        job,
-        "rendering",
-        `Layered composite frame ${i + 1}/${job.totalFrames}`,
-        Math.round(25 + frameProgress * 55),
-        onProgress
-      );
-    }
+    reportFrameProgress(
+      job,
+      `Layered composite frame ${i + 1}/${job.totalFrames}`,
+      Math.round(25 + (i + 1) / totalFrames * 55),
+      onProgress,
+      i + 1 === totalFrames
+    );
   }
 }
 
@@ -98826,16 +98861,13 @@ async function runHybridLayeredFrameLoop(input) {
       reorderBuffer.advanceTo(frameIdx + 1);
       framesWritten += 1;
       job.framesRendered = framesWritten;
-      if (framesWritten % 10 === 0 || framesWritten === totalFrames) {
-        const frameProgress = framesWritten / totalFrames;
-        updateJobStatus(
-          job,
-          "rendering",
-          `Layered composite frame ${framesWritten}/${job.totalFrames}`,
-          Math.round(25 + frameProgress * 55),
-          onProgress
-        );
-      }
+      reportFrameProgress(
+        job,
+        `Layered composite frame ${framesWritten}/${job.totalFrames}`,
+        Math.round(25 + framesWritten / totalFrames * 55),
+        onProgress,
+        framesWritten === totalFrames
+      );
     };
     const poolRef = shaderPool;
     const workerTaskOf = async (w) => {
@@ -101361,6 +101393,7 @@ async function executeRenderPipeline(input) {
     }
     const framesDir = join47(workDir, "captured-frames");
     if (!existsSync33(framesDir)) mkdirSync19(framesDir, { recursive: true });
+    updateJobStatus(job, "rendering", "Checking browser GPU", 25, onProgress);
     const resolvedBrowserGpuMode = await resolveBrowserGpuMode(cfg.browserGpuMode, {
       chromePath: resolveHeadlessShellPath(cfg),
       browserTimeout: cfg.browserTimeout
@@ -101553,6 +101586,7 @@ async function executeRenderPipeline(input) {
       }
     });
     if (job.config.workers === void 0 && totalFrames >= 60 && !htmlInCanvasDetected && !cfg.lowMemoryMode && !deInversionEligible && !deParallelRouterEligible) {
+      updateJobStatus(job, "rendering", "Measuring capture speed", 25, onProgress);
       const outcome = await observeRenderStage(
         observability,
         "capture_calibration",
@@ -103950,8 +103984,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.71" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.71" : "0.0.0-dev";
+var VERSION = true ? "0.8.73" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.73" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {