@hyperframes/producer 0.8.145 → 0.8.146

package/dist/distributed.js

@@ -288,7 +288,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;
@@ -299,7 +299,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;
@@ -541,7 +541,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;
   }
@@ -2243,7 +2243,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 };
@@ -2332,7 +2332,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.`
       );
     }
   }
@@ -2721,7 +2721,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.`
       );
     }
   }
@@ -2773,7 +2773,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 {
@@ -2798,7 +2798,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)
@@ -2891,7 +2891,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)
@@ -3535,12 +3535,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) {
@@ -3636,28 +3639,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) {
@@ -3985,7 +3988,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;
@@ -4199,7 +4202,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`
             );
           }
         }
@@ -4247,7 +4250,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(
@@ -4264,10 +4267,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);
@@ -4332,7 +4335,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") {
@@ -4379,6 +4382,7 @@ import {
   detectTransfer,
   extractAllVideoFrames,
   extractMediaMetadata as extractMediaMetadata3,
+  isVideoPastTimelineEnd,
   isHdrColorSpace as isHdrColorSpace2,
   resolveProjectRelativeSrc as resolveProjectRelativeSrc3,
   runVideoExtractionWithRetry,
@@ -4598,6 +4602,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;
@@ -4684,7 +4691,8 @@ async function runExtractVideosStage(input) {
         timelineEnd: composition.duration,
         maxTransientRetries: extractionPolicy.maxTransientRetries,
         collectProbeFailures: extractionPolicy.failureMode === "enforce",
-        deferRangeExtraction
+        deferRangeExtraction,
+        contentKeyedDirs: [join8(compiledDir, REMOTE_MEDIA_SUBDIR)]
       },
       abortSignal,
       cfg,
@@ -6143,7 +6151,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 }
         );
       }
@@ -6212,7 +6220,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 }
         );
       }
@@ -6461,7 +6469,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 };
@@ -7052,7 +7060,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;
@@ -7069,7 +7077,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;
@@ -7161,7 +7169,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;
@@ -7211,7 +7219,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");
@@ -9563,10 +9571,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;
@@ -9587,7 +9595,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);

package/dist/hyperframe.manifest.json

@@ -1,7 +1,7 @@
 {
   "version": "0.1.0",
   "buildId": "dev",
-  "sha256": "aa50e6ddf4edb969b9d47e3c977f01bd291df164527e2f1e5b5a60fd6c32bb34",
+  "sha256": "40ff09519c86046d23d0f53d7a6254fb83edc24267cbe13296b6bb185e3b1fa1",
   "artifacts": {
     "iife": "hyperframe.runtime.iife.js",
     "esm": "hyperframe.runtime.mjs"