@hyperframes/producer 0.8.149 → 0.8.150

package/dist/index.js

@@ -5220,9 +5220,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 +5241,6 @@ import {
   parseAudioElements,
   resolveReferencedStart
 } from "@hyperframes/engine";
-var COMPOSITION_HOST_ATTR = "data-composition-file";
 function resolveHostEnd(host, hostStart) {
   return resolveAuthoredTimingWindow({
     start: hostStart,
@@ -5240,39 +5248,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 +5311,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 +5371,7 @@ import {
   analyzeKeyframeIntervals,
   assertMediaPayload,
   NotMediaPayloadError as NotMediaPayloadError2,
+  parseMasterFxChain,
   probeMediaProfile as probeMediaProfile2
 } from "@hyperframes/engine";
 
@@ -7024,7 +7071,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 +7106,8 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
     videos,
     audios,
     images,
+    droppedMediaIds,
+    ...masterFxChain ? { masterFxChain } : {},
     unresolvedCompositions,
     externalAssets,
     width,
@@ -7490,6 +7540,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 +7603,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
@@ -7599,6 +7650,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;
@@ -7852,6 +7923,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 +7951,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 +7963,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 +7994,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 +8031,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 +8650,7 @@ async function runAudioStage(input) {
     ffmpegProcessTimeout,
     audioGain,
     audios,
+    masterFxChain,
     abortSignal,
     assertNotAborted,
     log
@@ -8593,7 +8670,7 @@ async function runAudioStage(input) {
         audioOutputPath,
         duration,
         abortSignal,
-        { ffmpegProcessTimeout, audioGain },
+        { ffmpegProcessTimeout, audioGain, masterFxChain },
         compiledDir
       );
     } catch (err) {
@@ -12062,6 +12139,7 @@ async function executeRenderPipeline(input) {
         ffmpegProcessTimeout: cfg.ffmpegProcessTimeout,
         audioGain: cfg.audioGain,
         audios: composition.audios,
+        masterFxChain: composition.masterFxChain,
         abortSignal: executionSignal,
         assertNotAborted,
         log
@@ -16012,6 +16090,7 @@ async function buildLocalExecutionPlan(projectDir, config, executionPlanDir, opt
     ffmpegProcessTimeout: cfg.ffmpegProcessTimeout,
     audioGain: cfg.audioGain,
     audios: composition.audios,
+    masterFxChain: composition.masterFxChain,
     abortSignal,
     assertNotAborted
   });

package/dist/public-server.js

@@ -5239,9 +5239,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";
@@ -5251,7 +5260,6 @@ import {
   parseAudioElements,
   resolveReferencedStart
 } from "@hyperframes/engine";
-var COMPOSITION_HOST_ATTR = "data-composition-file";
 function resolveHostEnd(host, hostStart) {
   return resolveAuthoredTimingWindow({
     start: hostStart,
@@ -5259,39 +5267,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)
     );
   }
@@ -5309,34 +5330,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
@@ -5344,6 +5390,7 @@ import {
   analyzeKeyframeIntervals,
   assertMediaPayload,
   NotMediaPayloadError as NotMediaPayloadError2,
+  parseMasterFxChain,
   probeMediaProfile as probeMediaProfile2
 } from "@hyperframes/engine";
 
@@ -7043,7 +7090,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);
@@ -7077,6 +7125,8 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
     videos,
     audios,
     images,
+    droppedMediaIds,
+    ...masterFxChain ? { masterFxChain } : {},
     unresolvedCompositions,
     externalAssets,
     width,
@@ -7509,6 +7559,7 @@ async function runCompileStage(input) {
     videos: compiled.videos,
     audios: compiled.audios,
     images: compiled.images,
+    masterFxChain: compiled.masterFxChain,
     width: compiled.width,
     height: compiled.height
   };
@@ -7571,7 +7622,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
@@ -7618,6 +7669,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;
@@ -7871,6 +7942,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;
@@ -7898,9 +7970,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;
                 }
@@ -7908,7 +7982,7 @@ async function runProbeStage(input) {
                   existing.loop = true;
                 }
               }
-            } else {
+            } else if (!compiled.droppedMediaIds.has(el.id)) {
               composition.videos.push({
                 id: el.id,
                 src,
@@ -7939,14 +8013,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,
@@ -7974,7 +8050,7 @@ async function runProbeStage(input) {
                   existing.end = projectedEnd;
                 }
               }
-            } else {
+            } else if (!compiled.droppedMediaIds.has(el.id)) {
               composition.images.push({
                 id: el.id,
                 src,
@@ -8557,6 +8633,7 @@ async function runAudioStage(input) {
     ffmpegProcessTimeout,
     audioGain,
     audios,
+    masterFxChain,
     abortSignal,
     assertNotAborted,
     log
@@ -8576,7 +8653,7 @@ async function runAudioStage(input) {
         audioOutputPath,
         duration,
         abortSignal,
-        { ffmpegProcessTimeout, audioGain },
+        { ffmpegProcessTimeout, audioGain, masterFxChain },
         compiledDir
       );
     } catch (err) {
@@ -12045,6 +12122,7 @@ async function executeRenderPipeline(input) {
         ffmpegProcessTimeout: cfg.ffmpegProcessTimeout,
         audioGain: cfg.audioGain,
         audios: composition.audios,
+        masterFxChain: composition.masterFxChain,
         abortSignal: executionSignal,
         assertNotAborted,
         log

package/dist/services/htmlCompiler.d.ts

@@ -8,6 +8,8 @@ export interface CompiledComposition {
     videos: VideoElement[];
     audios: AudioElement[];
     images: ImageElement[];
+    droppedMediaIds: Set<string>;
+    masterFxChain?: string;
     unresolvedCompositions: UnresolvedElement[];
     /** Assets that resolve outside projectDir. Keys are the path used in HTML, values are absolute filesystem paths. */
     externalAssets: Map<string, string>;

package/dist/services/render/shared.d.ts

@@ -19,6 +19,7 @@ export interface CompositionMetadata {
     videos: VideoElement[];
     audios: AudioElement[];
     images: ImageElement[];
+    masterFxChain?: string;
     width: number;
     height: number;
 }

package/dist/services/render/stages/audioStage.d.ts

@@ -32,6 +32,7 @@ export interface AudioStageInput {
     audioGain: number;
     /** Read-only view of `composition.audios`. */
     audios: CompositionMetadata["audios"];
+    masterFxChain?: string;
     abortSignal: AbortSignal | undefined;
     assertNotAborted: () => void;
     /** Where a per-track failure's detail goes. Optional so tests need not pass one. */