@hyperframes/producer 0.8.149 → 0.8.151

package/dist/index.js

@@ -4304,7 +4304,8 @@ function computeSegmentPlanHash(input) {
     input.imageFormat,
     input.useGpu ? "gpu" : "cpu",
     `${input.outputWidth}x${input.outputHeight}`,
-    input.motionBlur
+    input.motionBlur,
+    input.captureQuality === void 0 ? "" : String(input.captureQuality)
   ].join(" ");
   return createHash2("sha256").update(ordered).digest("hex").slice(0, 16);
 }
@@ -5220,9 +5221,18 @@ import {
 
 // src/services/renderMediaCollector.ts
 import { parseHTML as parseHTML2 } from "linkedom";
-import { MEDIA_RENDER_ID_ATTR, resolveAuthoredTimingWindow } from "@hyperframes/core";
+import {
+  MEDIA_RENDER_ID_ATTR,
+  normalizeRateSpec as normalizeRateSpec2,
+  resolveAuthoredTimingWindow,
+  shiftRateLane,
+  sourceTimeAt as sourceTimeAt2
+} from "@hyperframes/core";
 import {
   MEDIA_START_BASIS_ATTR,
+  compositionOriginSeconds,
+  cutToHostSlots,
+  hostInPointSeconds,
   readMediaStartBasis,
   resolveAbsoluteMediaStartSeconds
 } from "@hyperframes/core/media-timing";
@@ -5232,7 +5242,6 @@ import {
   parseAudioElements,
   resolveReferencedStart
 } from "@hyperframes/engine";
-var COMPOSITION_HOST_ATTR = "data-composition-file";
 function resolveHostEnd(host, hostStart) {
   return resolveAuthoredTimingWindow({
     start: hostStart,
@@ -5240,39 +5249,52 @@ function resolveHostEnd(host, hostStart) {
     end: host.getAttribute("data-end")
   })?.end ?? null;
 }
-var ROOT_WINDOW = { offset: 0, limit: Infinity, basis: "local" };
-function resolveHostWindow(element, document2, startCache, visiting) {
+var ROOT_WINDOW = { offset: 0, limit: Infinity, basis: "local", slots: [] };
+var COMPOSITION_HOST_SELECTOR = "[data-composition-id], [data-composition-src], [data-composition-file]";
+function enclosingHosts(element) {
   const hosts = [];
   for (let ancestor = element.parentElement; ancestor; ancestor = ancestor.parentElement) {
-    if (ancestor.hasAttribute(COMPOSITION_HOST_ATTR)) hosts.push(ancestor);
+    if (ancestor.matches(COMPOSITION_HOST_SELECTOR)) {
+      hosts.unshift(ancestor);
+    }
   }
+  return hosts;
+}
+function resolveHostWindow(element, document2, startCache, visiting) {
+  const hosts = enclosingHosts(element);
   if (hosts.length === 0) return ROOT_WINDOW;
   let offset = 0;
   let limit = Infinity;
-  for (const host of hosts.reverse()) {
+  const slots = [];
+  for (const [index, host] of hosts.entries()) {
     const hostStart = resolveReferencedStart(document2, host, startCache, visiting);
     const hostEnd = resolveHostEnd(host, hostStart);
-    if (hostEnd != null) limit = Math.min(limit, offset + hostEnd);
-    offset += hostStart;
+    if (hostEnd != null && !isRootComposition(host, index)) {
+      limit = Math.min(limit, offset + hostEnd);
+    }
+    if (hostInPointSeconds(host) > 0) {
+      slots.push({ start: offset + hostStart, end: offset + (hostEnd ?? Infinity) });
+    }
+    offset += compositionOriginSeconds(hostStart, host);
   }
+  return { offset, limit, basis: mediaStartBasis(element), slots };
+}
+var isRootComposition = (host, depth) => depth === 0 && !host.matches("[data-composition-src], [data-composition-file]");
+function mediaStartBasis(element) {
   const tag = element.tagName.toLowerCase();
-  const basis = tag === "video" || tag === "audio" ? readMediaStartBasis(element.getAttribute(MEDIA_START_BASIS_ATTR)) : "local";
-  return {
-    offset,
-    limit,
-    basis
-  };
+  return tag === "video" || tag === "audio" ? readMediaStartBasis(element.getAttribute(MEDIA_START_BASIS_ATTR)) : "local";
 }
 function collectHostWindows(html) {
   const { document: document2 } = parseHTML2(html);
   const windows = /* @__PURE__ */ new Map();
   const startCache = /* @__PURE__ */ new Map();
   const visiting = /* @__PURE__ */ new Set();
-  for (const element of document2.querySelectorAll(`[${MEDIA_RENDER_ID_ATTR}]`)) {
+  for (const element of document2.querySelectorAll("video, audio, img[src]")) {
     const renderId = element.getAttribute(MEDIA_RENDER_ID_ATTR);
-    if (!renderId) continue;
+    const id = renderId || element.getAttribute("id");
+    if (!id || !renderId && windows.has(id)) continue;
     windows.set(
-      renderId,
+      id,
       resolveHostWindow(element, document2, startCache, visiting)
     );
   }
@@ -5290,34 +5312,59 @@ function toAbsoluteWindow(start, end, window2) {
     hostStart: window2.offset,
     basis: window2.basis
   });
-  return { start: absoluteStart, end: Math.min(absoluteEnd, window2.limit) };
+  const absolute = { start: absoluteStart, end: Math.min(absoluteEnd, window2.limit) };
+  const played = cutToHostSlots(absolute, window2.slots);
+  if (played.end === played.start && absolute.end > absolute.start) return null;
+  return { start: absolute.start, end: played.end, played };
+}
+function startAtPlayed(clip, played) {
+  const head = played.start - clip.start;
+  if (head <= 0) return clip;
+  if ("loop" in clip && clip.loop) return { ...clip, start: played.start };
+  const rate = normalizeRateSpec2(clip.playbackRate);
+  return {
+    ...clip,
+    start: played.start,
+    mediaStart: clip.mediaStart + sourceTimeAt2(rate, head),
+    playbackRate: shiftRateLane(rate, head)
+  };
 }
 function collectRenderMedia(html) {
   const windows = collectHostWindows(html);
   const windowFor = (id) => windows.get(id) ?? ROOT_WINDOW;
+  const droppedMediaIds = /* @__PURE__ */ new Set();
   const videos = [];
   for (const video of parseVideoElements(html)) {
     const absolute = toAbsoluteWindow(video.start, video.end, windowFor(video.id));
-    if (absolute) videos.push({ ...video, ...absolute });
+    if (!absolute) {
+      droppedMediaIds.add(video.id);
+      continue;
+    }
+    videos.push(
+      startAtPlayed({ ...video, start: absolute.start, end: absolute.end }, absolute.played)
+    );
   }
   const images = [];
   for (const image of parseImageElements(html)) {
     const absolute = toAbsoluteWindow(image.start, image.end, windowFor(image.id));
-    if (absolute) images.push({ ...image, ...absolute });
+    if (absolute) images.push({ ...image, start: absolute.start, end: absolute.end });
+    else droppedMediaIds.add(image.id);
   }
   const audios = [];
   for (const audio of parseAudioElements(html)) {
     const elementId = audio.type === "video" ? audio.id.replace(/-audio$/, "") : audio.id;
-    const authoredEnd = audio.end > 0 ? audio.end : Infinity;
-    const absolute = toAbsoluteWindow(audio.start, authoredEnd, windowFor(elementId));
-    if (!absolute) continue;
-    audios.push({
-      ...audio,
-      start: absolute.start,
-      end: Number.isFinite(absolute.end) ? absolute.end : 0
-    });
+    const placed = placeAudio(audio, windowFor(elementId));
+    if (placed) audios.push(placed);
+    else droppedMediaIds.add(elementId);
   }
-  return { videos, audios, images };
+  return { videos, audios, images, droppedMediaIds };
+}
+function placeAudio(audio, window2) {
+  const authoredEnd = audio.end > 0 ? audio.end : Infinity;
+  const absolute = toAbsoluteWindow(audio.start, authoredEnd, window2);
+  if (!absolute) return null;
+  const end = Number.isFinite(absolute.end) ? absolute.end : 0;
+  return startAtPlayed({ ...audio, start: absolute.start, end }, absolute.played);
 }
 
 // src/services/htmlCompiler.ts
@@ -5325,6 +5372,7 @@ import {
   analyzeKeyframeIntervals,
   assertMediaPayload,
   NotMediaPayloadError as NotMediaPayloadError2,
+  parseMasterFxChain,
   probeMediaProfile as probeMediaProfile2
 } from "@hyperframes/engine";
 
@@ -7024,7 +7072,8 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
   for (const [relPath, absPath] of preparedGifAssets) {
     externalAssets.set(relPath, absPath);
   }
-  const { videos, audios, images } = collectRenderMedia(html);
+  const { videos, audios, images, droppedMediaIds } = collectRenderMedia(html);
+  const masterFxChain = parseMasterFxChain(html);
   for (const video of videos) {
     if (isHttpUrl(video.src)) continue;
     const videoPath = resolve6(projectDir, video.src);
@@ -7058,6 +7107,8 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
     videos,
     audios,
     images,
+    droppedMediaIds,
+    ...masterFxChain ? { masterFxChain } : {},
     unresolvedCompositions,
     externalAssets,
     width,
@@ -7490,6 +7541,7 @@ async function runCompileStage(input) {
     videos: compiled.videos,
     audios: compiled.audios,
     images: compiled.images,
+    masterFxChain: compiled.masterFxChain,
     width: compiled.width,
     height: compiled.height
   };
@@ -7552,7 +7604,7 @@ import {
   isTransientBrowserError,
   probeBeginFrameLiveness
 } from "@hyperframes/engine";
-import { fpsToNumber as fpsToNumber7 } from "@hyperframes/core";
+import { MEDIA_RENDER_ID_ATTR as MEDIA_RENDER_ID_ATTR2, fpsToNumber as fpsToNumber7, readMediaStart as readMediaStart2 } from "@hyperframes/core";
 import { extractMediaSrcMutations } from "@hyperframes/parsers";
 
 // src/services/render/stages/probeFailures.ts
@@ -7566,6 +7618,9 @@ function isActionableProbeFailure(line) {
 function resolveCaptureImageFormat(input) {
   return input.needsAlpha || input.motionBlur ? "png" : "jpeg";
 }
+function resolveCaptureJpegQuality(quality) {
+  return quality === "draft" ? 80 : 100;
+}
 
 // src/services/render/stages/probeStage.ts
 var FRAME_BOUNDARY_EPSILON = 1e-3;
@@ -7599,6 +7654,26 @@ function hasVariableBoundMedia(html, variables) {
     return Boolean(variableId && Object.hasOwn(variables, variableId));
   });
 }
+function authoredMediaStarts(html) {
+  const { document: document2 } = parseHTML5(html);
+  const starts = /* @__PURE__ */ new Map();
+  for (const media of document2.querySelectorAll("video, audio")) {
+    const id = media.getAttribute(MEDIA_RENDER_ID_ATTR2) || media.getAttribute("id");
+    if (id && !starts.has(id)) starts.set(id, readMediaStart2(media));
+  }
+  return starts;
+}
+function adoptRuntimeMediaStart(composition, el, authored) {
+  const shift = el.mediaStart - authored;
+  if (el.mediaStart <= 0 || Math.abs(shift) <= BROWSER_MEDIA_EPSILON) return;
+  const entries = el.tagName === "video" ? [
+    ...composition.videos.filter((video) => video.id === el.id),
+    ...composition.audios.filter(
+      (audio) => audio.type === "video" && audio.id === `${el.id}-audio`
+    )
+  ] : composition.audios.filter((audio) => audio.type !== "video" && audio.id === el.id);
+  for (const entry of entries) entry.mediaStart += shift;
+}
 function reconcileBrowserMediaEnd(existingEnd, projectedEnd, sourceChanged, durationInferred) {
   if (projectedEnd <= 0) return existingEnd;
   if (sourceChanged && durationInferred) return projectedEnd;
@@ -7701,7 +7776,7 @@ async function runProbeStage(input) {
         height,
         fps: job.config.fps,
         format: captureFormat,
-        quality: captureFormat === "png" ? void 0 : 80,
+        quality: captureFormat === "png" ? void 0 : resolveCaptureJpegQuality(job.config.quality),
         variables: job.config.variables,
         deviceScaleFactor,
         motionBlur,
@@ -7852,6 +7927,7 @@ async function runProbeStage(input) {
         const existingVideoIds = new Set(composition.videos.map((v) => v.id));
         const existingAudioIds = new Set(composition.audios.map((a) => a.id));
         const existingImageIds = new Set(composition.images.map((image) => image.id));
+        const authoredStarts = authoredMediaStarts(compiled.html);
         pruneMutedBrowserMedia(composition, browserMedia, existingAudioIds);
         for (const el of browserMedia) {
           if (!el.src || el.src === "about:blank") continue;
@@ -7879,9 +7955,11 @@ async function runProbeStage(input) {
                   sourceChanged,
                   el.durationInferred
                 );
-                if (el.mediaStart > 0 && (existing.mediaStart <= 0 || Math.abs(existing.mediaStart - el.mediaStart) > BROWSER_MEDIA_EPSILON)) {
-                  existing.mediaStart = el.mediaStart;
-                }
+                adoptRuntimeMediaStart(
+                  composition,
+                  el,
+                  authoredStarts.get(el.id) ?? existing.mediaStart
+                );
                 if (el.hasAudio && !el.muted && !existing.hasAudio) {
                   existing.hasAudio = true;
                 }
@@ -7889,7 +7967,7 @@ async function runProbeStage(input) {
                   existing.loop = true;
                 }
               }
-            } else {
+            } else if (!compiled.droppedMediaIds.has(el.id)) {
               composition.videos.push({
                 id: el.id,
                 src,
@@ -7920,14 +7998,16 @@ async function runProbeStage(input) {
                   sourceChanged,
                   el.durationInferred
                 );
-                if (el.mediaStart > 0 && (existing.mediaStart <= 0 || Math.abs(existing.mediaStart - el.mediaStart) > BROWSER_MEDIA_EPSILON)) {
-                  existing.mediaStart = el.mediaStart;
-                }
+                adoptRuntimeMediaStart(
+                  composition,
+                  el,
+                  authoredStarts.get(el.id) ?? existing.mediaStart
+                );
                 if (el.volume > 0 && Math.abs((existing.volume ?? 1) - el.volume) > BROWSER_MEDIA_EPSILON) {
                   existing.volume = el.volume;
                 }
               }
-            } else {
+            } else if (!compiled.droppedMediaIds.has(el.id)) {
               composition.audios.push({
                 id: el.id,
                 src,
@@ -7955,7 +8035,7 @@ async function runProbeStage(input) {
                   existing.end = projectedEnd;
                 }
               }
-            } else {
+            } else if (!compiled.droppedMediaIds.has(el.id)) {
               composition.images.push({
                 id: el.id,
                 src,
@@ -8574,6 +8654,7 @@ async function runAudioStage(input) {
     ffmpegProcessTimeout,
     audioGain,
     audios,
+    masterFxChain,
     abortSignal,
     assertNotAborted,
     log
@@ -8593,7 +8674,7 @@ async function runAudioStage(input) {
         audioOutputPath,
         duration,
         abortSignal,
-        { ffmpegProcessTimeout, audioGain },
+        { ffmpegProcessTimeout, audioGain, masterFxChain },
         compiledDir
       );
     } catch (err) {
@@ -8679,13 +8760,16 @@ function shouldAllowAdaptiveCaptureRetry(workerCount, _explicitlyConfigured) {
   return workerCount > 1;
 }
 var JPEG_RAW_RGBA_DIVISOR = 8;
+var HIGH_QUALITY_JPEG_RAW_RGBA_DIVISOR = 4;
 var DISK_PROJECTION_SAMPLE_FRAMES = 10;
 function estimateDiskCaptureBytes(totalFrames, captureOptions) {
   const scale = captureOptions.deviceScaleFactor ?? 1;
   const outputWidth = Math.ceil(captureOptions.width * scale);
   const outputHeight = Math.ceil(captureOptions.height * scale);
   const rawBytes = Math.ceil(totalFrames) * outputWidth * outputHeight * 4;
-  return frameFileExtension(captureOptions.format) === "jpg" ? Math.ceil(rawBytes / JPEG_RAW_RGBA_DIVISOR) : rawBytes;
+  return frameFileExtension(captureOptions.format) === "jpg" ? Math.ceil(
+    rawBytes / ((captureOptions.quality ?? 80) > 80 ? HIGH_QUALITY_JPEG_RAW_RGBA_DIVISOR : JPEG_RAW_RGBA_DIVISOR)
+  ) : rawBytes;
 }
 function freeDiskBytesAt(path) {
   try {
@@ -12062,6 +12146,7 @@ async function executeRenderPipeline(input) {
         ffmpegProcessTimeout: cfg.ffmpegProcessTimeout,
         audioGain: cfg.audioGain,
         audios: composition.audios,
+        masterFxChain: composition.masterFxChain,
         abortSignal: executionSignal,
         assertNotAborted,
         log
@@ -12146,7 +12231,7 @@ async function executeRenderPipeline(input) {
       height,
       fps: job.config.fps,
       format: captureImageFormat,
-      quality: captureImageFormat === "png" ? void 0 : job.config.quality === "draft" ? 80 : 95,
+      quality: captureImageFormat === "png" ? void 0 : resolveCaptureJpegQuality(job.config.quality),
       variables: job.config.variables,
       deviceScaleFactor,
       motionBlur: job.config.motionBlur,
@@ -12774,7 +12859,8 @@ async function executeRenderPipeline(input) {
           // Device-scaled: the capture buffer, not the CSS composition size.
           outputWidth: captureCompositionWidth ?? width,
           outputHeight: captureCompositionHeight ?? height,
-          motionBlur: job.config.motionBlur ? JSON.stringify(job.config.motionBlur) : ""
+          motionBlur: job.config.motionBlur ? JSON.stringify(job.config.motionBlur) : "",
+          captureQuality: captureOptions.quality
         });
         const segmentDir = segmentDirFor(join26(projectDir, "renders"), segmentPlanHash);
         let completedSegments = /* @__PURE__ */ new Set();
@@ -16012,6 +16098,7 @@ async function buildLocalExecutionPlan(projectDir, config, executionPlanDir, opt
     ffmpegProcessTimeout: cfg.ffmpegProcessTimeout,
     audioGain: cfg.audioGain,
     audios: composition.audios,
+    masterFxChain: composition.masterFxChain,
     abortSignal,
     assertNotAborted
   });
@@ -17645,7 +17732,7 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath) {
       height: plan2.dimensions.height,
       fps: { num: plan2.dimensions.fpsNum, den: plan2.dimensions.fpsDen },
       format: plan2.dimensions.format === "mp4" ? "jpeg" : "png",
-      quality: plan2.dimensions.format === "mp4" ? 80 : void 0,
+      quality: plan2.dimensions.format === "mp4" ? resolveCaptureJpegQuality(job.config.quality) : void 0,
       deviceScaleFactor: encoder.deviceScaleFactor,
       // Re-inject the controller's snapshotted variables so the chunk's
       // first capture sees the same `window.__hfVariables` the in-process