@hyperframes/producer 0.8.145 → 0.8.146

package/dist/index.js

@@ -272,7 +272,7 @@ function buildVirtualTimeShim(options) {
   const seedRandomFromFrame = options.seedRandomFromFrame === true;
   const seededRandomBlock = seedRandomFromFrame ? String.raw`
   // Seeded Math.random / crypto.getRandomValues, keyed by virtual time.
-  // Mulberry32 — single uint32 state, deterministic, fast.
+  // Mulberry32: single uint32 state, deterministic, fast.
   var rngState = 0;
   function mulberry32() {
     rngState |= 0; rngState = (rngState + 0x6D2B79F5) | 0;
@@ -283,7 +283,7 @@ function buildVirtualTimeShim(options) {
   }
   function reseedRngFromTime(ms) {
     var ms32 = Math.max(0, Math.floor(Number(ms) || 0)) | 0;
-    // Knuth's multiplicative hash + golden-ratio offset — gives a well-
+    // Knuth's multiplicative hash + golden-ratio offset gives a well-
     // distributed seed even for frame 0 (otherwise rngState=0 degenerates
     // the PRNG's first few outputs).
     rngState = (Math.imul(ms32, -1640531527) + 0x9E3779B9) | 0;
@@ -525,7 +525,7 @@ function buildRenderModeScript(fps) {
     };
     window.__playerReady = true;
     // Media-fallback player has no timeline to bind, so render-ready is immediate.
-    // init.ts defers __renderReady until the timeline is bound \u2014 different runtime.
+    // init.ts defers __renderReady until the timeline is bound (a different runtime).
     window.__renderReady = true;
     return true;
   }
@@ -2117,7 +2117,7 @@ function blitHdrVideoLayer(canvas, el, time, fps, hdrVideoFrameSources, hdrStart
       if (matrix && !isTranslationOnly) {
         if (clipped && log) {
           log.debug(
-            `HDR clip rect on affine-transformed element ${el.id} \u2014 clip not applied (affine scissor not yet supported)`
+            `HDR clip rect on affine-transformed element ${el.id}: clip not applied (affine scissor not yet supported)`
           );
         }
         blitRgb48leAffine(
@@ -2174,7 +2174,7 @@ function blitHdrImageLayer(canvas, el, hdrImageBuffers, hdrImageTransferCache, w
     return;
   }
   if (el.clipRect && log) {
-    log.debug(`HDR clip rect on image element ${el.id} \u2014 clip not yet supported for images`);
+    log.debug(`HDR clip rect on image element ${el.id}: clip not yet supported for images`);
   }
   try {
     if (hdrPerf) hdrPerf.hdrImageLayerBlits += 1;
@@ -4366,7 +4366,7 @@ import {
 function formatDowngradeWarning(outputFormat, forcedHdrWithoutSources) {
   const hdrSourceReason = forcedHdrWithoutSources ? "HDR was forced without detected HDR sources" : "HDR source detected";
   const formatReason = outputFormat === "hls" ? "HLS output is SDR-only (H.264 in MPEG-TS)" : "HDR + alpha is not supported";
-  return `[Render] ${hdrSourceReason}, but format is "${outputFormat}" \u2014 falling back to SDR. ${formatReason}. Use --format mp4 for HDR10 output.`;
+  return `[Render] ${hdrSourceReason}, but format is "${outputFormat}", so falling back to SDR. ${formatReason}. Use --format mp4 for HDR10 output.`;
 }
 function findRenderHdrAutoPromotionTrigger(input) {
   for (const extracted of input.extractionResult?.extracted ?? []) {
@@ -4379,12 +4379,12 @@ function findRenderHdrAutoPromotionTrigger(input) {
 function logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources) {
   if (forcedHdrWithoutSources) {
     input.log.warn(
-      "[Render] HDR forced by --hdr flag, but no HDR sources were detected \u2014 defaulting to HLG. SDR-only compositions may look perceptually wrong on HDR displays."
+      "[Render] HDR forced by --hdr flag, but no HDR sources were detected, defaulting to HLG. SDR-only compositions may look perceptually wrong on HDR displays."
     );
   }
   if (!effectiveHdr) {
     input.log.info(
-      hdrMode === "force-sdr" ? "[Render] SDR forced by --sdr flag" : "[Render] No HDR sources detected \u2014 rendering SDR"
+      hdrMode === "force-sdr" ? "[Render] SDR forced by --sdr flag" : "[Render] No HDR sources detected, rendering SDR"
     );
     return;
   }
@@ -4399,9 +4399,9 @@ function logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources)
     );
     return;
   }
-  const reason = forcedHdrWithoutSources ? "forced by --hdr flag (no HDR sources detected \u2014 defaulting to HLG)" : "forced by --hdr flag";
+  const reason = forcedHdrWithoutSources ? "forced by --hdr flag (no HDR sources detected, defaulting to HLG)" : "forced by --hdr flag";
   input.log.info(
-    `[Render] HDR ${reason} \u2014 output: ${effectiveHdr.transfer.toUpperCase()} (BT.2020, 10-bit H.265)`
+    `[Render] HDR ${reason}, output: ${effectiveHdr.transfer.toUpperCase()} (BT.2020, 10-bit H.265)`
   );
 }
 function resolveEffectiveHdrMode(input) {
@@ -4497,14 +4497,14 @@ function resolveRenderWorkerCount(totalFrames, requestedWorkers, cfg, compiled,
   const reasonCodes = new Set(compiled.renderModeHints.reasons.map((r) => r.code));
   if (reasonCodes.has("htmlInCanvas")) {
     log.warn(
-      "[Render] html-in-canvas (drawElementImage) detected \u2014 pinning to 1 worker (Chrome concurrency limitation).",
+      "[Render] html-in-canvas (drawElementImage) detected, pinning to 1 worker (Chrome concurrency limitation).",
       { requestedWorkers }
     );
     return 1;
   }
   if (cfg.lowMemoryMode && requestedWorkers === void 0) {
     log.info(
-      "[Render] Low-memory profile \u2014 pinning to 1 capture worker (auto-worker calibration skipped)."
+      "[Render] Low-memory profile, pinning to 1 capture worker (auto-worker calibration skipped)."
     );
     return 1;
   }
@@ -5139,7 +5139,7 @@ function assertVideoFrameCoverage(reports, threshold) {
   const thresholdPct = (threshold * 100).toFixed(1);
   const suffix = sorted.length > 1 ? ` (+${sorted.length - 1} more clip(s) below threshold)` : "";
   throw new VideoFrameCoverageError(
-    `Video "${worst.videoId}" captured ${worst.capturedFrames} of expected ${worst.expectedFrames} frames (coverage ${pct}%, threshold ${thresholdPct}%). check/snapshot may pass while the encoded MP4 renders this clip blank \u2014 aborting render to prevent shipping a wrong MP4.${suffix} Set HF_VIDEO_COVERAGE_THRESHOLD=0 to disable this gate.`,
+    `Video "${worst.videoId}" captured ${worst.capturedFrames} of expected ${worst.expectedFrames} frames (coverage ${pct}%, threshold ${thresholdPct}%). check/snapshot may pass while the encoded MP4 renders this clip blank, so the render is aborted to prevent shipping a wrong MP4.${suffix} Set HF_VIDEO_COVERAGE_THRESHOLD=0 to disable this gate.`,
     { threshold, worst, failedReports: sorted }
   );
 }
@@ -6035,7 +6035,7 @@ async function resolveMediaDuration(src, mediaStart, playbackRate, baseDir, down
       if (tagName !== "video") {
         if (error instanceof NotMediaPayloadError2) {
           log?.warn(
-            `[compile] Audio "${elementIdentity}" (${src}) is a text document, not a media file \u2014 the element is dropped from the render. Point it at a rendered media file.`
+            `[compile] Audio "${elementIdentity}" (${src}) is a text document, not a media file, so the element is dropped from the render. Point it at a rendered media file.`
           );
         }
         return { duration: null, resolvedPath: filePath };
@@ -6124,7 +6124,7 @@ async function compileHtmlFile(html, baseDir, downloadDir, log) {
     if (r.maxDuration != null && shouldClampResolvedMediaDuration(r.tagName, r.duration, r.maxDuration)) {
       clampList.push({ id: r.id, duration: r.maxDuration });
       log?.warn(
-        `[compile] Audio "${r.id}" (${r.src}) is ${r.maxDuration.toFixed(2)}s but its data-duration is ${r.duration.toFixed(2)}s \u2014 the slot is shortened to the media length. Set data-duration to ~${r.maxDuration.toFixed(2)}s, trim data-media-start, or use a longer/looping source if that isn't intended.`
+        `[compile] Audio "${r.id}" (${r.src}) is ${r.maxDuration.toFixed(2)}s but its data-duration is ${r.duration.toFixed(2)}s, so the slot is shortened to the media length. Set data-duration to ~${r.maxDuration.toFixed(2)}s, trim data-media-start, or use a longer/looping source if that isn't intended.`
       );
     }
   }
@@ -6513,7 +6513,7 @@ ${safeText}
     } else {
       if (download.reason instanceof ScriptIntegrityError) throw download.reason;
       defaultLogger.warn(
-        `[Compiler] WARNING: Failed to download CDN script: ${src} \u2014 ${download.reason}. The render may fail if this script is required (e.g. GSAP). Consider bundling it locally in your project.`
+        `[Compiler] WARNING: Failed to download CDN script: ${src} (${download.reason}). The render may fail if this script is required (e.g. GSAP). Consider bundling it locally in your project.`
       );
     }
   }
@@ -6565,7 +6565,7 @@ function collectExternalAssets(html, projectDir) {
   }
   if (externalAssets.size > 0) {
     defaultLogger.info(
-      `[Compiler] Found ${externalAssets.size} asset(s) outside project directory \u2014 will copy to render output`
+      `[Compiler] Found ${externalAssets.size} asset(s) outside project directory, will copy to render output`
     );
   }
   return {
@@ -6590,7 +6590,7 @@ async function downloadAndRewriteUrls(urlSet, html, remoteDir, warnLabel, logLab
         urlToLocal.set(url, localPath);
       } catch (err) {
         const identity = safeDownloadUrlIdentity(url);
-        defaultLogger.warn(`[Compiler] ${warnLabel} \u2014 using original URL as fallback.`, {
+        defaultLogger.warn(`[Compiler] ${warnLabel}, using original URL as fallback.`, {
           urlFingerprint: identity.urlFingerprint,
           host: identity.host,
           error: err instanceof Error ? err.message : String(err)
@@ -6683,7 +6683,7 @@ async function fetchExternalStylesheetCss(href) {
       timeoutMs: 15e3
     });
   } catch (err) {
-    defaultLogger.warn("[Compiler] External stylesheet fetch failed \u2014 preserving link tag.", {
+    defaultLogger.warn("[Compiler] External stylesheet fetch failed, preserving link tag.", {
       urlFingerprint: identity.urlFingerprint,
       host: identity.host,
       error: err instanceof Error ? err.message : String(err)
@@ -7327,12 +7327,15 @@ async function resolveCompositionDurations(page, unresolved) {
     const resolved = [];
     for (const id of compIds) {
       const tl = timelines[id];
-      if (tl && typeof tl.duration === "function") {
-        const dur = tl.duration();
-        if (dur > 0) {
-          resolved.push({ id, duration: dur, source: "__timelines" });
-          continue;
-        }
+      let dur = 0;
+      try {
+        dur = typeof tl?.duration === "function" ? Number(tl.duration()) : 0;
+      } catch {
+        dur = 0;
+      }
+      if (dur > 0) {
+        resolved.push({ id, duration: dur, source: "__timelines" });
+        continue;
       }
       const el = document.getElementById(id);
       if (el) {
@@ -7428,28 +7431,28 @@ async function runCompileStage(input) {
     cfg.useDrawElement = false;
     deCompileGate = "3d";
     log.info(
-      "[Render] Fast capture: composition uses a CSS 3D rendering context (perspective / preserve-3d / backface-visibility) \u2014 disabling drawElementImage for this render. Capture uses the platform's baseline route."
+      "[Render] Fast capture: composition uses a CSS 3D rendering context (perspective / preserve-3d / backface-visibility), so disabling drawElementImage for this render. Capture uses the platform's baseline route."
     );
   }
   if (cfg.useDrawElement && process.env.HF_FAST_CAPTURE_BLEND !== "true" && compiled.usesMixBlendMode) {
     cfg.useDrawElement = false;
     deCompileGate = "mix_blend_mode";
     log.info(
-      "[Render] Fast capture: composition uses mix-blend-mode \u2014 disabling drawElementImage for this render. Capture uses the platform's baseline route."
+      "[Render] Fast capture: composition uses mix-blend-mode, so disabling drawElementImage for this render. Capture uses the platform's baseline route."
     );
   }
   if (cfg.useDrawElement && process.env.HF_FAST_CAPTURE_ANCESTOR_BG !== "true" && compiled.hasAncestorBackgroundImage) {
     cfg.useDrawElement = false;
     deCompileGate = "ancestor_background_image";
     log.info(
-      "[Render] Fast capture: composition root's ancestors (body/html/wrapper) carry a background-image \u2014 disabling drawElementImage for this render. Capture uses the platform's baseline route."
+      "[Render] Fast capture: composition root's ancestors (body/html/wrapper) carry a background-image, so disabling drawElementImage for this render. Capture uses the platform's baseline route."
     );
   }
   if (cfg.useDrawElement && process.env.PRODUCER_EXPERIMENTAL_FAST_CAPTURE !== "true" && compiled.hasShaderTransitions) {
     cfg.useDrawElement = false;
     deCompileGate = "shader_transitions";
     log.info(
-      "[Render] Fast capture: composition uses shader transitions \u2014 disabling drawElementImage so page-side compositing stays available."
+      "[Render] Fast capture: composition uses shader transitions, so disabling drawElementImage so page-side compositing stays available."
     );
   }
   if (!cfg.useDrawElement && cfg.pageSideCompositingAutoDisabled) {
@@ -7777,7 +7780,7 @@ async function runProbeStage(input) {
         } else {
           beginFrameStalled = true;
           log.warn(
-            "[Render] BeginFrame liveness probe timed out \u2014 this composition stalls BeginFrame on this host (SwiftShader heavy-layer pattern). Relaunching the probe browser in screenshot capture mode; the render will use screenshot capture throughout.",
+            "[Render] BeginFrame liveness probe timed out: this composition stalls BeginFrame on this host (SwiftShader heavy-layer pattern). Relaunching the probe browser in screenshot capture mode; the render will use screenshot capture throughout.",
             { probeTimeoutMs }
           );
           lastBrowserConsole = probeSession.browserConsoleBuffer;
@@ -7991,7 +7994,7 @@ async function runProbeStage(input) {
             video.start = win.visibleStart;
             video.end = win.visibleEnd;
             log.info(
-              `[Probe] Runtime video discovery: ${video.id} visible ${win.visibleStart.toFixed(2)}s\u2013${win.visibleEnd.toFixed(2)}s`
+              `[Probe] Runtime video discovery: ${video.id} visible ${win.visibleStart.toFixed(2)}s to ${win.visibleEnd.toFixed(2)}s`
             );
           }
         }
@@ -8039,7 +8042,7 @@ async function runProbeStage(input) {
         });
         if (!timelinesInfo.gsapLoaded) {
           diagnostics.push(
-            "GSAP is not loaded \u2014 CDN script may have failed to download. Bundle GSAP locally in your project instead of using a CDN <script src>."
+            "GSAP is not loaded. The CDN script may have failed to download. Bundle GSAP locally in your project instead of using a CDN <script src>."
           );
         } else if (timelinesInfo.timelineKeys.length === 0) {
           diagnostics.push(
@@ -8056,10 +8059,10 @@ async function runProbeStage(input) {
       log.warn("Failed to gather browser diagnostics for zero-duration composition", {
         error: err instanceof Error ? err.message : String(err)
       });
-      diagnostics.push("(Could not gather browser diagnostics \u2014 page may have crashed)");
+      diagnostics.push("(Could not gather browser diagnostics. The page may have crashed.)");
     }
     const hint = diagnostics.length > 0 ? "\n\nDiagnostics:\n  - " + diagnostics.join("\n  - ") : "\n\nCheck that GSAP timelines are registered on window.__timelines.";
-    throw new Error("Composition duration is 0 \u2014 this would produce a black video." + hint);
+    throw new Error("Composition duration is 0, so this would produce a black video." + hint);
   }
   if (probeSession) {
     const failedRequests = probeSession.browserConsoleBuffer.filter(isActionableProbeFailure);
@@ -8124,7 +8127,7 @@ function validateNoGpuEncode(config) {
   if (config.useGpu === true) {
     throw new PlanValidationError(
       BROWSER_GPU_NOT_SOFTWARE,
-      "[planValidation] GPU encode is banned in distributed mode: config.useGpu === true. Distributed retries must be byte-identical, but NVENC/QSV/VAAPI produce different output across machines. Set useGpu=false (the default) \u2014 software libx264/libx265 is the only supported encoder in distributed mode."
+      "[planValidation] GPU encode is banned in distributed mode: config.useGpu === true. Distributed retries must be byte-identical, but NVENC/QSV/VAAPI produce different output across machines. Set useGpu=false (the default): software libx264/libx265 is the only supported encoder in distributed mode."
     );
   }
   if (config.browserGpuMode !== void 0 && config.browserGpuMode !== "software") {
@@ -8171,6 +8174,7 @@ import {
   detectTransfer,
   extractAllVideoFrames,
   extractMediaMetadata as extractMediaMetadata3,
+  isVideoPastTimelineEnd,
   isHdrColorSpace as isHdrColorSpace2,
   resolveProjectRelativeSrc as resolveProjectRelativeSrc3,
   runVideoExtractionWithRetry,
@@ -8390,6 +8394,9 @@ async function runExtractVideosStage(input) {
   } = input;
   const stage2Start = Date.now();
   const extractionPolicy = resolveVideoExtractionPolicy();
+  composition.videos = composition.videos.filter(
+    (video) => !isVideoPastTimelineEnd(video, composition.duration)
+  );
   let frameLookup = null;
   let extractionResult = null;
   let failureToEnforce = null;
@@ -8476,7 +8483,8 @@ async function runExtractVideosStage(input) {
         timelineEnd: composition.duration,
         maxTransientRetries: extractionPolicy.maxTransientRetries,
         collectProbeFailures: extractionPolicy.failureMode === "enforce",
-        deferRangeExtraction
+        deferRangeExtraction,
+        contentKeyedDirs: [join16(compiledDir, REMOTE_MEDIA_SUBDIR)]
       },
       abortSignal,
       cfg,
@@ -11102,7 +11110,7 @@ async function executeDiskCaptureWithAdaptiveRetry(options) {
       const madeProgress = captureAttemptMadeProgress(frameCount, remainingCount);
       if (!madeProgress) {
         options.log.warn(
-          "[Render] Capture attempt made no forward progress; composition is likely structurally broken \u2014 not retrying.",
+          "[Render] Capture attempt made no forward progress; composition is likely structurally broken, not retrying.",
           { attempt, frameCount, remainingCount, workers: currentWorkers }
         );
       }
@@ -11171,7 +11179,7 @@ async function executeDiskCaptureWithAdaptiveRetry(options) {
       }
       if (!madeProgress) {
         options.log.warn(
-          "[Render] Capture attempt made no forward progress; composition is likely structurally broken \u2014 not retrying.",
+          "[Render] Capture attempt made no forward progress; composition is likely structurally broken, not retrying.",
           { attempt, frameCount, remainingCount, workers: currentWorkers }
         );
       }
@@ -11634,7 +11642,7 @@ async function executeRenderJob(job, projectDir, outputPath, progressSink, abort
   execution.defer("remove workDir", () => {
     if (job.config.debug) return;
     if (job.status === "complete" && process.env.KEEP_TEMP === "1") {
-      log.info("KEEP_TEMP=1 \u2014 leaving workDir on disk for inspection", { workDir });
+      log.info("KEEP_TEMP=1, leaving workDir on disk for inspection", { workDir });
       return;
     }
     rmSync9(workDir, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
@@ -11871,7 +11879,7 @@ async function executeRenderPipeline(input) {
       captureForceScreenshot = true;
       updateCaptureObservability({ forceScreenshot: captureForceScreenshot });
       log.info(
-        "[Render] Low-memory render profile active \u2014 screenshot capture, auto-worker calibration skipped" + (job.config.workers === void 0 ? ", pinned to 1 worker" : "") + ". Override with --no-low-memory-mode or PRODUCER_LOW_MEMORY_MODE=false.",
+        "[Render] Low-memory render profile active: screenshot capture, auto-worker calibration skipped" + (job.config.workers === void 0 ? ", pinned to 1 worker" : "") + ". Override with --no-low-memory-mode or PRODUCER_LOW_MEMORY_MODE=false.",
         { totalMemMb: getSystemTotalMb(), thresholdMb: LOW_MEMORY_TOTAL_MB_THRESHOLD }
       );
     }
@@ -12439,7 +12447,7 @@ async function executeRenderPipeline(input) {
       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."
+        "[Render] Fast capture: default-on drawElement disabled for this render: " + (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;
@@ -12535,7 +12543,7 @@ async function executeRenderPipeline(input) {
       });
       updateCaptureObservability({ forceScreenshot: captureForceScreenshot });
       log.info(
-        `[Render] Page-side compositing enabled \u2014 bypassing Node-side layered shader-blend path. Engine will capture one ${needsAlpha ? "RGBA PNG" : "opaque RGB"} screenshot per output frame.`
+        `[Render] Page-side compositing enabled, bypassing Node-side layered shader-blend path. Engine will capture one ${needsAlpha ? "RGBA PNG" : "opaque RGB"} screenshot per output frame.`
       );
     }
     const useLayeredComposite = !usePageSideCompositingForTransitions && shouldUseLayeredComposite({
@@ -13032,7 +13040,7 @@ async function executeRenderPipeline(input) {
             cfg.useDrawElement = false;
             deClampReason = deClampReason ?? "disk_path";
             log.info(
-              "[Render] Fast capture: drawElement disabled for the disk fallback \u2014 streaming encoder spawn failed and the disk path has no runtime self-verification."
+              "[Render] Fast capture: drawElement disabled for the disk fallback: streaming encoder spawn failed and the disk path has no runtime self-verification."
             );
             if (probeSession && probeSession.captureMode === "drawelement") {
               lastBrowserConsole = probeSession.browserConsoleBuffer;
@@ -13584,10 +13592,10 @@ function validateJsonSafeValue(value, field) {
   walkVariables(value, field, /* @__PURE__ */ new WeakSet());
 }
 var LEAF_REJECTIONS = {
-  undefined: "undefined leaves are silently dropped by JSON.stringify \u2014 use null if you mean an absent value",
+  undefined: "undefined leaves are silently dropped by JSON.stringify. Use null if you mean an absent value",
   function: "functions are not JSON-serializable",
   symbol: "Symbols are not JSON-serializable",
-  bigint: "BigInt values throw at JSON.stringify \u2014 encode as a string if you need 64-bit integers"
+  bigint: "BigInt values throw at JSON.stringify. Encode as a string if you need 64-bit integers"
 };
 function walkVariables(value, path, seen) {
   const t = typeof value;
@@ -13608,7 +13616,7 @@ function walkVariables(value, path, seen) {
   if (seen.has(value)) {
     throw new InvalidConfigError(
       path,
-      "circular reference detected \u2014 JSON.stringify cannot serialize cycles"
+      "circular reference detected: JSON.stringify cannot serialize cycles"
     );
   }
   seen.add(value);
@@ -14299,7 +14307,7 @@ function validateOutputResolutionOverride(body) {
     return `Invalid outputResolution "${body.outputResolution}". Must be one of: landscape, portrait, landscape-4k, portrait-4k, square, square-4k (aliases: 1080p, 4k, \u2026).`;
   }
   if (normalized !== void 0 && (body.format === "webm" || body.format === "mov")) {
-    return `outputResolution is not supported with format "${body.format}" \u2014 the alpha (webm/mov) capture path can't supersample. Use format "mp4", or omit outputResolution to render at the composition's native dimensions.`;
+    return `outputResolution is not supported with format "${body.format}": the alpha (webm/mov) capture path can't supersample. Use format "mp4", or omit outputResolution to render at the composition's native dimensions.`;
   }
   return void 0;
 }
@@ -15024,7 +15032,7 @@ function collectPlanAssetShas(planDir) {
   }
   if (compositionHtml === null) {
     throw new Error(
-      `[freezePlan] compiled HTML missing at ${COMPILED_INDEX_RELATIVE_PATH} \u2014 upstream compile stage did not materialize the expected file.`
+      `[freezePlan] compiled HTML missing at ${COMPILED_INDEX_RELATIVE_PATH} (upstream compile stage did not materialize the expected file).`
     );
   }
   return { compositionHtml, assets };
@@ -15607,7 +15615,7 @@ var PlanTooLargeError = class extends Error {
     const breakdownSuffix = breakdown ? ` Breakdown: video-frames=${formatBytes(breakdown.videoFramesBytes)}, compiled=${formatBytes(breakdown.compiledBytes)} (source-media=${formatBytes(breakdown.sourceMediaBytes)}), audio=${formatBytes(breakdown.audioBytes)}, metadata=${formatBytes(breakdown.metadataBytes)}, other=${formatBytes(breakdown.otherBytes)}, files=${breakdown.fileCount}.` : "";
     const observationSuffix = observedAt ? ` Observed at ${observedAt}.` : "";
     super(
-      `[plan] planDir size ${formatBytes(sizeBytes)} exceeds the configured ceiling ${formatBytes(limitBytes)} (PLAN_TOO_LARGE). The default 2 GB cap fits inside AWS Lambda's 10 GB /tmp budget alongside the chunk worker's frame buffer and ffmpeg's working set. To unblock: use the content-addressed \`planV2()\` transport, shorten the composition, lower the framerate, or use the in-process renderer (\`executeRenderJob\`) \u2014 it has no planDir size cap.` + observationSuffix + breakdownSuffix
+      `[plan] planDir size ${formatBytes(sizeBytes)} exceeds the configured ceiling ${formatBytes(limitBytes)} (PLAN_TOO_LARGE). The default 2 GB cap fits inside AWS Lambda's 10 GB /tmp budget alongside the chunk worker's frame buffer and ffmpeg's working set. To unblock: use the content-addressed \`planV2()\` transport, shorten the composition, lower the framerate, or use the in-process renderer (\`executeRenderJob\`), which has no planDir size cap.` + observationSuffix + breakdownSuffix
     );
     this.name = "PlanTooLargeError";
     this.sizeBytes = sizeBytes;
@@ -15624,7 +15632,7 @@ var FormatNotSupportedInDistributedError = class extends Error {
   reason;
   constructor(format, reason) {
     super(
-      `[plan] format ${JSON.stringify(format)} is not supported in distributed mode: ${reason}. Render with the in-process renderer (\`executeRenderJob\`) \u2014 it has full format support \u2014 or pick a distributed-supported format: mp4 SDR, mov ProRes 4444, png-sequence, or webm VP9.`
+      `[plan] format ${JSON.stringify(format)} is not supported in distributed mode: ${reason}. Render with the in-process renderer (\`executeRenderJob\`), which has full format support, or pick a distributed-supported format: mp4 SDR, mov ProRes 4444, png-sequence, or webm VP9.`
     );
     this.name = "FormatNotSupportedInDistributedError";
     this.format = format;
@@ -15713,7 +15721,7 @@ async function readFontSnapshotSha() {
   const data = module.EMBEDDED_FONT_DATA;
   if (!data || typeof data !== "object") {
     throw new Error(
-      "[plan] EMBEDDED_FONT_DATA missing from @hyperframes/core/fonts/embedded-data \u2014 was `bun run build:fonts` run?"
+      "[plan] EMBEDDED_FONT_DATA missing from @hyperframes/core/fonts/embedded-data. Was `bun run build:fonts` run?"
     );
   }
   const dataObj = data;
@@ -15763,7 +15771,7 @@ function resolveEncoderTriple(config) {
   }
   if (config.codec !== void 0) {
     throw new Error(
-      `[plan] DistributedRenderConfig.codec is only valid for format="mp4"; received codec=${JSON.stringify(config.codec)} with format=${JSON.stringify(config.format)}. Omit codec for non-mp4 formats \u2014 mov is always ProRes 4444, webm is always libvpx-vp9, and png-sequence has no encoder.`
+      `[plan] DistributedRenderConfig.codec is only valid for format="mp4"; received codec=${JSON.stringify(config.codec)} with format=${JSON.stringify(config.format)}. Omit codec for non-mp4 formats: mov is always ProRes 4444, webm is always libvpx-vp9, and png-sequence has no encoder.`
     );
   }
   return resolveNonMp4EncoderTriple(config.format, config.quality ?? "standard");