hyperframes 0.8.15 → 0.8.17

package/dist/fontLocalizeCli.js

@@ -17022,7 +17022,7 @@ var require_util = __commonJS({
       return path;
     }
     exports.normalize = normalize;
-    function join55(aRoot, aPath) {
+    function join56(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -17054,7 +17054,7 @@ var require_util = __commonJS({
       }
       return joined;
     }
-    exports.join = join55;
+    exports.join = join56;
     exports.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -17227,7 +17227,7 @@ var require_util = __commonJS({
             parsed.path = parsed.path.substring(0, index + 1);
           }
         }
-        sourceURL = join55(urlGenerate(parsed), sourceURL);
+        sourceURL = join56(urlGenerate(parsed), sourceURL);
       }
       return normalize(sourceURL);
     }
@@ -50798,7 +50798,7 @@ function compileTag(tag, isVideo, generateId) {
     result = injectAttr(result, "data-hf-auto-start", "");
     startStr = "0";
   }
-  const start = parseFloat(startStr);
+  const start = parseNumeric(startStr);
   const attrReader = { getAttribute: (name) => getAttr(result, name) };
   const mediaStart = readMediaStart(attrReader);
   const playbackRate = readElementPlaybackRate(attrReader);
@@ -50806,14 +50806,15 @@ function compileTag(tag, isVideo, generateId) {
     const durationStr = getAttr(result, "data-duration");
     const duration = parseStrictFiniteTimingNumber(durationStr);
     if (duration != null) {
-      const end = start + duration;
-      result = injectAttr(result, "data-end", String(end));
+      if (start != null) {
+        result = injectAttr(result, "data-end", String(start + duration));
+      }
     } else if (id) {
       unresolved = {
         id,
         tagName: isVideo ? "video" : "audio",
         src: getAttr(result, "src") ?? void 0,
-        start,
+        start: start ?? 0,
         mediaStart,
         playbackRate
       };
@@ -50854,7 +50855,7 @@ function compileTimingAttrs(html) {
       unresolved.push({
         id,
         tagName: "div",
-        start: startStr ? parseFloat(startStr) : 0,
+        start: parseNumeric(startStr) ?? 0,
         mediaStart: 0,
         playbackRate: 1,
         compositionSrc: compositionSrc ?? void 0
@@ -50873,9 +50874,10 @@ function injectDurations(html, resolutions) {
         result = setAttr(result, "data-duration", String(duration));
       }
       if (!hasAttr(result, "data-end")) {
-        const startStr = getAttr(result, "data-start");
-        const start = startStr ? parseFloat(startStr) : 0;
-        result = injectAttr(result, "data-end", String(start + duration));
+        const start = parseNumeric(getAttr(result, "data-start"));
+        if (start != null) {
+          result = injectAttr(result, "data-end", String(start + duration));
+        }
       }
       return result;
     });
@@ -50906,7 +50908,7 @@ function extractResolvedMedia(html) {
       id,
       tagName: isVideo ? "video" : "audio",
       src: getAttr(tag, "src") ?? void 0,
-      start: startStr !== null ? parseFloat(startStr) : 0,
+      start: parseNumeric(startStr) ?? 0,
       duration,
       mediaStart: readMediaStart(attrReader),
       playbackRate: readElementPlaybackRate(attrReader),
@@ -50920,9 +50922,10 @@ function clampDurations(html, clamps) {
     const idPattern = new RegExp(`(<[^>]*id=["']${escapeRegex2(id)}["'][^>]*>)`, "gi");
     html = html.replace(idPattern, (tag) => {
       tag = tag.replace(/data-duration=["'][^"']*["']/, `data-duration="${duration}"`);
-      const startStr = getAttr(tag, "data-start");
-      const start = startStr ? parseFloat(startStr) : 0;
-      tag = tag.replace(/data-end=["'][^"']*["']/, `data-end="${start + duration}"`);
+      const start = parseNumeric(getAttr(tag, "data-start"));
+      if (start != null) {
+        tag = tag.replace(/data-end=["'][^"']*["']/, `data-end="${start + duration}"`);
+      }
       return tag;
     });
   }
@@ -50932,6 +50935,7 @@ var MEDIA_DURATION_CLAMP_EPSILON_SECONDS, INERT_REGION_RE;
 var init_timingCompiler = __esm({
   "../core/dist/compiler/timingCompiler.js"() {
     "use strict";
+    init_compositionContract();
     init_playbackRate();
     MEDIA_DURATION_CLAMP_EPSILON_SECONDS = 0.05;
     INERT_REGION_RE = /<!--[\s\S]*?-->|<script\b[\s\S]*?<\/script\s*>|<style\b[\s\S]*?<\/style\s*>/gi;
@@ -50939,16 +50943,6 @@ var init_timingCompiler = __esm({
 });
 
 // ../core/dist/compiler/mediaRenderIds.js
-function hasPlayableSource(el) {
-  if (el.getAttribute("src"))
-    return true;
-  const sources = el.querySelectorAll?.("source[src]");
-  if (!sources)
-    return false;
-  for (const _ of sources)
-    return true;
-  return false;
-}
 function uniqueRenderId(baseId, taken) {
   if (!taken.has(baseId))
     return baseId;
@@ -50961,8 +50955,6 @@ function assignMediaRenderIds(document2) {
   const taken = /* @__PURE__ */ new Set();
   const pending = [];
   for (const el of document2.querySelectorAll(MEDIA_SELECTOR)) {
-    if (!hasPlayableSource(el))
-      continue;
     const existing = el.getAttribute(MEDIA_RENDER_ID_ATTR);
     if (existing) {
       taken.add(existing);
@@ -56094,7 +56086,12 @@ async function captureDrawElementFrame(page, width, height, format = "jpeg", qua
     }) => {
       const canvas = document.getElementById("__hf_de_canvas");
       const root = document.querySelector("[data-composition-id]");
-      if (!canvas || !root) throw new Error("drawElement canvas not initialized");
+      if (!root) {
+        throw new Error("HF_DE_COMPOSITION_ROOT_MISSING: drawElement composition root not found");
+      }
+      if (!canvas) {
+        throw new Error("HF_DE_CANVAS_NOT_INITIALIZED: drawElement canvas not initialized");
+      }
       const ctx = canvas.getContext("2d");
       if (!ctx) throw new Error("drawElement: 2d context unavailable");
       const aw = window;
@@ -56341,7 +56338,12 @@ async function produceDrawElementFrame(page, width, height, quality = 80, syncTo
     ({ w, h, q, sync, fid }) => {
       const canvas = document.getElementById("__hf_de_canvas");
       const root = document.querySelector("[data-composition-id]");
-      if (!canvas || !root) throw new Error("drawElement canvas not initialized");
+      if (!root) {
+        throw new Error("HF_DE_COMPOSITION_ROOT_MISSING: drawElement composition root not found");
+      }
+      if (!canvas) {
+        throw new Error("HF_DE_CANVAS_NOT_INITIALIZED: drawElement canvas not initialized");
+      }
       const ctx = canvas.getContext("2d");
       if (!ctx) throw new Error("drawElement: 2d context unavailable");
       const aw = window;
@@ -56508,7 +56510,18 @@ async function produceDrawElementFrameBatch(page, times, width, height, quality
     }) => {
       const canvas = document.getElementById("__hf_de_canvas");
       const root = document.querySelector("[data-composition-id]");
-      if (!canvas || !root) return { failedAt: 0, error: "drawElement canvas not initialized" };
+      if (!root) {
+        return {
+          failedAt: 0,
+          error: "HF_DE_COMPOSITION_ROOT_MISSING: drawElement composition root not found"
+        };
+      }
+      if (!canvas) {
+        return {
+          failedAt: 0,
+          error: "HF_DE_CANVAS_NOT_INITIALIZED: drawElement canvas not initialized"
+        };
+      }
       const ctx = canvas.getContext("2d");
       if (!ctx) return { failedAt: 0, error: "drawElement: 2d context unavailable" };
       const aw = window;
@@ -56647,10 +56660,11 @@ async function produceDrawElementFrameBatch(page, times, width, height, quality
   }
   return { encodeResults, failedAt: outcome.failedAt, error: outcome.error };
 }
-var workerEncodeStates, workerEncodeBoundPages;
+var DE_CANVAS_NOT_INITIALIZED_CODE, workerEncodeStates, workerEncodeBoundPages;
 var init_drawElementService = __esm({
   "../engine/src/services/drawElementService.ts"() {
     "use strict";
+    DE_CANVAS_NOT_INITIALIZED_CODE = "HF_DE_CANVAS_NOT_INITIALIZED";
     workerEncodeStates = /* @__PURE__ */ new WeakMap();
     workerEncodeBoundPages = /* @__PURE__ */ new WeakSet();
   }
@@ -58558,11 +58572,12 @@ function recordCaptureWarnings(session, warnings) {
 function recordSubTimelineWarning(session, timeoutMs) {
   if (session.subTimelineWaitOutcome === "ready" || !session.subTimelineWaitOutcome) return;
   const scriptFailure = session.subTimelineWaitOutcome === "script_failure";
+  const hasRuntimeErrors = session.scriptLoadFailures.some((f) => f.startsWith("runtime-error:"));
   recordCaptureWarnings(session, [
     {
       code: scriptFailure ? "sub_timeline_script_failure" : "sub_timeline_readiness_timeout",
-      message: scriptFailure ? "A sub-composition timeline script failed to load" : `Sub-composition timelines did not become ready within ${timeoutMs}ms`,
-      details: { timeoutMs }
+      message: scriptFailure ? hasRuntimeErrors ? `A sub-composition script threw during execution \u2014 timeline registration never arrived (${session.scriptLoadFailures.join(", ")})` : `A sub-composition timeline script failed to load (${session.scriptLoadFailures.join(", ")})` : `Sub-composition timelines did not become ready within ${timeoutMs}ms`,
+      details: { timeoutMs, sources: [...session.scriptLoadFailures] }
     }
   ]);
 }
@@ -58646,6 +58661,11 @@ async function initializeSession(session) {
     const diagnostic = formatConsoleDiagnostic(type, text, locationUrl);
     if (!diagnostic.suppressHostLog) console.log(diagnostic.text);
     appendBrowserDiagnostic(session, diagnostic.text);
+    if (type === "error" && text.startsWith("[HyperFrames] composition script error:")) {
+      const detail = text.slice("[HyperFrames] composition script error:".length).trim();
+      const compId = detail.split(" ")[0] || "unknown";
+      recordScriptLoadFailure(session, `runtime-error:${compId}`);
+    }
   });
   page.on("pageerror", (err) => {
     const message = err instanceof Error ? err.message : String(err);
@@ -59417,7 +59437,14 @@ async function computeTimelineAtRiskFrames(page, fps) {
 }
 function isNoCachedPaintRecordError(err) {
   const msg = err instanceof Error ? err.message : String(err);
-  return msg.includes("No cached paint record");
+  return msg.includes("No cached paint record for element");
+}
+function isCanvasNotInitializedError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  return msg.includes(DE_CANVAS_NOT_INITIALIZED_CODE);
+}
+function isRecoverableDrawElementError(err) {
+  return isNoCachedPaintRecordError(err) || isCanvasNotInitializedError(err);
 }
 async function captureFrameCore(session, frameIndex, time) {
   const { page, options } = session;
@@ -59491,10 +59518,11 @@ async function captureFrameCore(session, frameIndex, time) {
           }
         }
       } catch (err) {
-        if (isNoCachedPaintRecordError(err)) {
+        if (isRecoverableDrawElementError(err)) {
           session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
+          const reason = isCanvasNotInitializedError(err) ? "drawElement canvas not initialized" : "No cached paint record";
           console.log(
-            `[engine] fast capture: frame ${frameIndex} \u2014 No cached paint record; screenshot fallback for this frame (see fast-capture-limitations.md)`
+            `[engine] fast capture: frame ${frameIndex} \u2014 ${reason}; screenshot fallback for this frame (see fast-capture-limitations.md)`
           );
           screenshotBuffer = await pageScreenshotCapture(page, options);
         } else {
@@ -59611,10 +59639,11 @@ async function captureFrameToBufferPipelined(session, frameIndex, time) {
     }
     return { encodeResult, captureTimeMs };
   } catch (captureError) {
-    if (isNoCachedPaintRecordError(captureError)) {
+    if (isRecoverableDrawElementError(captureError)) {
       session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
+      const reason = isCanvasNotInitializedError(captureError) ? "drawElement canvas not initialized" : "No cached paint record";
       console.log(
-        `[engine] fast capture: frame ${frameIndex} \u2014 No cached paint record; screenshot fallback for this frame (see fast-capture-limitations.md)`
+        `[engine] fast capture: frame ${frameIndex} \u2014 ${reason}; screenshot fallback for this frame (see fast-capture-limitations.md)`
       );
       const buffer = await pageScreenshotCapture(page, options);
       return { encodeResult: Promise.resolve(buffer), captureTimeMs: Date.now() - startTime };
@@ -59677,15 +59706,36 @@ async function captureFramesBatchPipelined(session, frameIndices, times) {
     results.push({ frameIndex, encodeResult });
   }
   if (failedAt !== null) {
-    console.log(
-      `[engine] fast capture: batch produce failed at frame ${frameIndices[failedAt] ?? "?"} (${error ?? "?"}); re-capturing ${frameIndices.length - failedAt} frame(s) per-frame`
-    );
-    for (let i = failedAt; i < frameIndices.length; i++) {
-      const frameIndex = frameIndices[i];
-      const time = times[i];
-      if (frameIndex === void 0 || time === void 0) break;
-      const { encodeResult } = await captureFrameToBufferPipelined(session, frameIndex, time);
-      results.push({ frameIndex, encodeResult });
+    if (isRecoverableDrawElementError(error)) {
+      const reason = isCanvasNotInitializedError(error) ? "drawElement canvas not initialized" : "No cached paint record";
+      console.log(
+        `[engine] fast capture: batch produce failed at frame ${frameIndices[failedAt] ?? "?"} (${reason}); screenshot fallback for ${frameIndices.length - failedAt} frame(s) (see fast-capture-limitations.md)`
+      );
+      for (let i = failedAt; i < frameIndices.length; i++) {
+        const frameIndex = frameIndices[i];
+        const time = times[i];
+        if (frameIndex === void 0 || time === void 0) break;
+        session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
+        await prepareFrameForCapture(session, frameIndex, time);
+        const buffer = await pageScreenshotCapture(page, options);
+        const encodeResult = Promise.resolve(buffer);
+        if (session.staticFrames) {
+          session.lastEncodeResult = encodeResult;
+          session.lastEncodeResultFrame = frameIndex;
+        }
+        results.push({ frameIndex, encodeResult });
+      }
+    } else {
+      console.log(
+        `[engine] fast capture: batch produce failed at frame ${frameIndices[failedAt] ?? "?"} (${error ?? "?"}); re-capturing ${frameIndices.length - failedAt} frame(s) per-frame`
+      );
+      for (let i = failedAt; i < frameIndices.length; i++) {
+        const frameIndex = frameIndices[i];
+        const time = times[i];
+        if (frameIndex === void 0 || time === void 0) break;
+        const { encodeResult } = await captureFrameToBufferPipelined(session, frameIndex, time);
+        results.push({ frameIndex, encodeResult });
+      }
     }
   }
   const last = results[results.length - 1];
@@ -59843,6 +59893,13 @@ function percentileOf(samples, p) {
 }
 function getCapturePerfSummary(session) {
   const frames = Math.max(1, session.capturePerf.frames);
+  const ncprFallbacks = session.deNcprFallbacks ?? 0;
+  if (frames > 0 && ncprFallbacks / frames > DE_FALLBACK_RATIO_WARN_THRESHOLD) {
+    const pct = Math.round(ncprFallbacks / frames * 100);
+    console.warn(
+      `[engine] fast capture: ${ncprFallbacks}/${frames} frame(s) (${pct}%) fell back to screenshot capture (canvas-not-initialized / no-cached-paint-record) \u2014 drawElement likely failed to engage for this render rather than recovering a few edge-case frames; see fast-capture-limitations.md.`
+    );
+  }
   return {
     frames: session.capturePerf.frames,
     avgTotalMs: Math.round(session.capturePerf.totalMs / frames),
@@ -59881,10 +59938,10 @@ function getCapturePerfSummary(session) {
     deVerifyArmed: session.deVerifyFrames?.size ?? 0,
     deVerifyInitMs: session.deVerifyInitMs ?? 0,
     deBoundaryFrames: session.clipBoundaryFrames?.size ?? 0,
-    deNcprFallbacks: session.deNcprFallbacks ?? 0
+    deNcprFallbacks: ncprFallbacks
   };
 }
-var DrawElementVerificationError, BROWSER_CONSOLE_BUFFER_SIZE, CAPTURE_SESSION_CLOSE_TIMEOUT_MS, LOCKED_WARMUP_TICKS, realSleep, BEGIN_FRAME_CAPTURE_HEADROOM_INTERVALS, BEGIN_FRAME_COMMIT_LEAD_INTERVALS, BEGIN_FRAME_PROBE_LEAD_INTERVALS, HF_READY_DIAGNOSTIC_EXPR, LIVE_MAP_MARKERS, MAX_STATIC_DEDUP_ANALYSIS_FRAMES, STATIC_VERIFY_REFERENCE_STRIDE, STATIC_VERIFY_MAX_MS, STATIC_VERIFY_MIN_SCREENSHOT_CAP, STATIC_VERIFY_SAMPLE_CAP_MULTIPLIER, STATIC_VERIFY_MAX_GLOBAL_SAMPLE_FLOOR;
+var DrawElementVerificationError, BROWSER_CONSOLE_BUFFER_SIZE, CAPTURE_SESSION_CLOSE_TIMEOUT_MS, LOCKED_WARMUP_TICKS, realSleep, BEGIN_FRAME_CAPTURE_HEADROOM_INTERVALS, BEGIN_FRAME_COMMIT_LEAD_INTERVALS, BEGIN_FRAME_PROBE_LEAD_INTERVALS, HF_READY_DIAGNOSTIC_EXPR, LIVE_MAP_MARKERS, MAX_STATIC_DEDUP_ANALYSIS_FRAMES, STATIC_VERIFY_REFERENCE_STRIDE, STATIC_VERIFY_MAX_MS, STATIC_VERIFY_MIN_SCREENSHOT_CAP, STATIC_VERIFY_SAMPLE_CAP_MULTIPLIER, STATIC_VERIFY_MAX_GLOBAL_SAMPLE_FLOOR, DE_FALLBACK_RATIO_WARN_THRESHOLD;
 var init_frameCapture = __esm({
   "../engine/src/services/frameCapture.ts"() {
     "use strict";
@@ -59952,6 +60009,7 @@ var init_frameCapture = __esm({
     STATIC_VERIFY_MIN_SCREENSHOT_CAP = 400;
     STATIC_VERIFY_SAMPLE_CAP_MULTIPLIER = 8;
     STATIC_VERIFY_MAX_GLOBAL_SAMPLE_FLOOR = STATIC_VERIFY_MIN_SCREENSHOT_CAP / STATIC_VERIFY_SAMPLE_CAP_MULTIPLIER;
+    DE_FALLBACK_RATIO_WARN_THRESHOLD = 0.5;
   }
 });
 
@@ -60799,7 +60857,8 @@ async function extractMediaMetadata(filePath) {
           hasAudio: false,
           isVFR: false,
           hasAlpha: false,
-          colorSpace: stillImageMeta.colorSpace
+          colorSpace: stillImageMeta.colorSpace,
+          frames: 1
         };
       }
       throw new Error("[FFmpeg] No video stream found");
@@ -60825,6 +60884,8 @@ async function extractMediaMetadata(filePath) {
     const streamDuration = videoStream.duration ? parseFloat(videoStream.duration) : 0;
     const parsedStreamStart = videoStream.start_time ? parseFloat(videoStream.start_time) : 0;
     const streamStart = Number.isFinite(parsedStreamStart) ? parsedStreamStart : 0;
+    const parsedNbFrames = videoStream.nb_frames ? parseInt(videoStream.nb_frames, 10) : NaN;
+    const frames = Number.isFinite(parsedNbFrames) && parsedNbFrames > 0 ? parsedNbFrames : void 0;
     return {
       durationSeconds: containerDuration,
       videoStreamDurationSeconds: streamDuration > 0 ? streamDuration : containerDuration,
@@ -60836,7 +60897,8 @@ async function extractMediaMetadata(filePath) {
       hasAudio: output?.streams.some((s) => s.codec_type === "audio") ?? false,
       isVFR,
       hasAlpha,
-      colorSpace
+      colorSpace,
+      frames
     };
   })();
   videoMetadataCache.set(filePath, probePromise);
@@ -61517,8 +61579,6 @@ async function muxVideoWithAudio(videoPath, audioPath, outputPath, signal, confi
       args.push("-c:a", "aac", "-b:a", "192k", "-movflags", "+faststart");
     }
   }
-  const copiesContainerizedAac = !isWebm && shouldCopyAudio && config?.preserveAudioPrimingEditList === true;
-  if (!copiesContainerizedAac) args.push("-avoid_negative_ts", "make_zero");
   appendRenderProvenanceArgs(args, outputPath);
   if (fps !== void 0) {
     args.push("-r", fpsToFfmpegArg(fps));
@@ -69775,6 +69835,14 @@ function hasAttrName(tagSource, attr) {
   const attrs = tagSource.replace(/^<\s*[a-z][\w:-]*/i, "");
   return new RegExp(`(?:^|\\s)${escaped}(?:\\s*=|\\s|/?>)`, "i").test(attrs);
 }
+function mediaHasResolvableSrc(tag, tags) {
+  if (readAttr(tag.raw, "src")) return true;
+  const end = tag.closeIndex ?? tag.endIndex;
+  if (end == null) return false;
+  return tags.some(
+    (child) => child.name === "source" && child.index > tag.index && child.index < end && Boolean(readAttr(child.raw, "src"))
+  );
+}
 function classNamesFromAttr(classAttr) {
   if (!classAttr) return [];
   return classAttr.split(/\s+/).filter(Boolean);
@@ -71707,7 +71775,7 @@ var init_dist3 = __esm({
           if (tag.name !== "video" && tag.name !== "audio") continue;
           const hasDataStart = readAttr(tag.raw, "data-start");
           const hasId = readAttr(tag.raw, "id");
-          const hasSrc = readAttr(tag.raw, "src");
+          const hasSrc = mediaHasResolvableSrc(tag, tags);
           if (hasSrc && !hasDataStart) {
             findings.push({
               code: "media_missing_data_start",
@@ -71742,9 +71810,9 @@ var init_dist3 = __esm({
               findings.push({
                 code: "media_missing_src",
                 severity: "error",
-                message: `<${tag.name} id="${hasId}"> has data-start but no src attribute. The renderer cannot load this media.`,
+                message: `<${tag.name} id="${hasId}"> has data-start but no src (on the element or a <source> child). The renderer cannot load this media.`,
                 elementId: hasId,
-                fixHint: `Add a src attribute to the <${tag.name}> element directly. If using <source> children, the renderer still requires src on the parent element.`,
+                fixHint: `Add src on the <${tag.name}> element, or a <source src="..."> child.`,
                 snippet: truncateSnippet(tag.raw)
               });
             }
@@ -74507,20 +74575,73 @@ var init_htmlTemplate = __esm({
   }
 });
 
+// ../engine/src/services/extractedFrameIndex.ts
+import { readdirSync as readdirSync4 } from "fs";
+import { join as join9 } from "path";
+function extractedFrameIndex(file, format) {
+  const match = new RegExp(`^${FRAME_FILENAME_PREFIX}(\\d+)\\.${format}$`).exec(file);
+  if (!match) {
+    throw new ExtractedFrameSequenceError(`Invalid extracted frame filename: ${file}`);
+  }
+  const ordinal = Number.parseInt(match[1], 10);
+  if (!Number.isSafeInteger(ordinal) || ordinal < 1) {
+    throw new ExtractedFrameSequenceError(`Invalid extracted frame ordinal: ${file}`);
+  }
+  return ordinal - 1;
+}
+function framePathsFromDirectory(outputDir, format) {
+  const suffix = `.${format}`;
+  const indexed = /* @__PURE__ */ new Map();
+  for (const file of readdirSync4(outputDir)) {
+    if (!file.startsWith(FRAME_FILENAME_PREFIX) || !file.endsWith(suffix)) continue;
+    const index = extractedFrameIndex(file, format);
+    if (indexed.has(index)) {
+      throw new ExtractedFrameSequenceError(
+        `Duplicate extracted frame index ${index}: ${indexed.get(index)} and ${file}`
+      );
+    }
+    indexed.set(index, join9(outputDir, file));
+  }
+  const ordered = /* @__PURE__ */ new Map();
+  for (let index = 0; index < indexed.size; index += 1) {
+    const path = indexed.get(index);
+    if (!path) {
+      throw new ExtractedFrameSequenceError(
+        `Missing extracted frame index ${index} in ${outputDir}`
+      );
+    }
+    ordered.set(index, path);
+  }
+  return ordered;
+}
+var FRAME_FILENAME_PREFIX, ExtractedFrameSequenceError;
+var init_extractedFrameIndex = __esm({
+  "../engine/src/services/extractedFrameIndex.ts"() {
+    "use strict";
+    FRAME_FILENAME_PREFIX = "frame_";
+    ExtractedFrameSequenceError = class extends Error {
+      constructor(message) {
+        super(message);
+        this.name = "ExtractedFrameSequenceError";
+      }
+    };
+  }
+});
+
 // ../engine/src/services/extractionCache.ts
 import { createHash as createHash2, randomUUID as randomUUID2 } from "crypto";
 import {
   existsSync as existsSync9,
   lstatSync as lstatSync2,
   mkdirSync as mkdirSync5,
-  readdirSync as readdirSync4,
+  readdirSync as readdirSync5,
   renameSync,
   rmSync as rmSync2,
   statSync as statSync5,
   utimesSync,
   writeFileSync as writeFileSync3
 } from "fs";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 function readKeyStat(videoPath) {
   try {
     const stat = statSync5(videoPath);
@@ -74549,10 +74670,17 @@ function computeCacheKey(input) {
 function cacheEntryDirName(keyHash) {
   return SCHEMA_PREFIX + keyHash.slice(0, KEY_HEX_CHARS);
 }
+function hasFrameFiles(dir) {
+  try {
+    return readdirSync5(dir).some((file) => file.startsWith(FRAME_FILENAME_PREFIX));
+  } catch {
+    return false;
+  }
+}
 function lookupCacheEntry(rootDir, input) {
   const keyHash = computeCacheKey(input);
-  const dir = join9(rootDir, cacheEntryDirName(keyHash));
-  const complete = existsSync9(join9(dir, COMPLETE_SENTINEL));
+  const dir = join10(rootDir, cacheEntryDirName(keyHash));
+  const complete = existsSync9(join10(dir, COMPLETE_SENTINEL)) && hasFrameFiles(dir);
   return { entry: { dir, keyHash }, hit: complete };
 }
 function partialCacheEntryDir(entry) {
@@ -74563,13 +74691,13 @@ function isTargetExistsRenameError(err) {
   return code === "EEXIST" || code === "ENOTEMPTY" || code === "EPERM";
 }
 function adoptPublishedWinner(entry, partialDir) {
-  if (!existsSync9(join9(entry.dir, COMPLETE_SENTINEL))) return null;
+  if (!existsSync9(join10(entry.dir, COMPLETE_SENTINEL))) return null;
   removeDir(partialDir);
   return { dir: entry.dir, published: true };
 }
 function publishCacheEntry(entry, partialDir) {
   try {
-    writeFileSync3(join9(partialDir, COMPLETE_SENTINEL), "", "utf-8");
+    writeFileSync3(join10(partialDir, COMPLETE_SENTINEL), "", "utf-8");
   } catch {
     return { dir: partialDir, published: false };
   }
@@ -74596,7 +74724,7 @@ function publishCacheEntry(entry, partialDir) {
 function touchCacheEntry(entry) {
   try {
     const now = /* @__PURE__ */ new Date();
-    utimesSync(join9(entry.dir, COMPLETE_SENTINEL), now, now);
+    utimesSync(join10(entry.dir, COMPLETE_SENTINEL), now, now);
   } catch {
   }
 }
@@ -74616,12 +74744,12 @@ function directorySizeBytes(path) {
   let total = 0;
   let children;
   try {
-    children = readdirSync4(path);
+    children = readdirSync5(path);
   } catch {
     return 0;
   }
   for (const child of children) {
-    const childPath = join9(path, child);
+    const childPath = join10(path, child);
     try {
       const stat = lstatSync2(childPath);
       if (stat.isDirectory()) {
@@ -74650,7 +74778,7 @@ function collectGcEntry(dir, name, now, minAgeMs, stats) {
     }
     let lastUseMs = dirStat.mtimeMs;
     try {
-      lastUseMs = statSync5(join9(dir, COMPLETE_SENTINEL)).mtimeMs;
+      lastUseMs = statSync5(join10(dir, COMPLETE_SENTINEL)).mtimeMs;
     } catch {
     }
     return { dir, size: directorySizeBytes(dir), lastUseMs, ageMs: now - lastUseMs };
@@ -74660,7 +74788,7 @@ function collectGcEntry(dir, name, now, minAgeMs, stats) {
 }
 function gcSweepDue(rootDir, maxAgeMs) {
   try {
-    return Date.now() - statSync5(join9(rootDir, GC_MARKER)).mtimeMs > maxAgeMs;
+    return Date.now() - statSync5(join10(rootDir, GC_MARKER)).mtimeMs > maxAgeMs;
   } catch {
     return true;
   }
@@ -74668,16 +74796,16 @@ function gcSweepDue(rootDir, maxAgeMs) {
 function gcExtractionCache(rootDir, opts) {
   const stats = { evictedEntries: 0, evictedBytes: 0, agedPartialsRemoved: 0 };
   try {
-    writeFileSync3(join9(rootDir, GC_MARKER), "", "utf-8");
+    writeFileSync3(join10(rootDir, GC_MARKER), "", "utf-8");
   } catch {
   }
   try {
     const now = Date.now();
     const entries2 = [];
-    for (const child of readdirSync4(rootDir, { withFileTypes: true })) {
+    for (const child of readdirSync5(rootDir, { withFileTypes: true })) {
       if (!child.isDirectory() || !isCacheLikeChild(child.name)) continue;
       const entry = collectGcEntry(
-        join9(rootDir, child.name),
+        join10(rootDir, child.name),
         child.name,
         now,
         opts.minAgeMs,
@@ -74702,12 +74830,7 @@ function gcExtractionCache(rootDir, opts) {
 }
 function rehydrateCacheEntry(entry, options) {
   const framePattern = `${FRAME_FILENAME_PREFIX}%05d.${options.format}`;
-  const framePaths = /* @__PURE__ */ new Map();
-  const suffix = `.${options.format}`;
-  const files = readdirSync4(entry.dir).filter((f) => f.startsWith(FRAME_FILENAME_PREFIX) && f.endsWith(suffix)).sort();
-  files.forEach((file, idx) => {
-    framePaths.set(idx, join9(entry.dir, file));
-  });
+  const framePaths = framePathsFromDirectory(entry.dir, options.format);
   return {
     videoId: options.videoId,
     srcPath: options.srcPath,
@@ -74719,11 +74842,12 @@ function rehydrateCacheEntry(entry, options) {
     framePaths
   };
 }
-var FRAME_FILENAME_PREFIX, COMPLETE_SENTINEL, GC_MARKER, SCHEMA_PREFIX, KEY_HEX_CHARS, CACHE_GENERATION_PREFIX;
+var COMPLETE_SENTINEL, GC_MARKER, SCHEMA_PREFIX, KEY_HEX_CHARS, CACHE_GENERATION_PREFIX;
 var init_extractionCache = __esm({
   "../engine/src/services/extractionCache.ts"() {
     "use strict";
-    FRAME_FILENAME_PREFIX = "frame_";
+    init_extractedFrameIndex();
+    init_extractedFrameIndex();
     COMPLETE_SENTINEL = ".hf-complete";
     GC_MARKER = ".hf-last-gc";
     SCHEMA_PREFIX = "hfcache-v4-";
@@ -74733,8 +74857,8 @@ var init_extractionCache = __esm({
 });
 
 // ../engine/src/services/videoFrameExtractor.ts
-import { copyFileSync as copyFileSync2, existsSync as existsSync10, linkSync as linkSync2, mkdirSync as mkdirSync6, readdirSync as readdirSync5, rmSync as rmSync3 } from "fs";
-import { isAbsolute, join as join10, posix as posix2, resolve as resolve5, sep as sep2 } from "path";
+import { copyFileSync as copyFileSync2, existsSync as existsSync10, linkSync as linkSync2, mkdirSync as mkdirSync6, rmSync as rmSync3 } from "fs";
+import { isAbsolute, join as join11, posix as posix2, resolve as resolve5, sep as sep2 } from "path";
 function isVideoFrameFormat(value) {
   return typeof value === "string" && VIDEO_FRAME_FORMATS.includes(value);
 }
@@ -74956,15 +75080,27 @@ async function runVideoExtractionWithRetry(operation, options = {}) {
     }
   }
 }
+function resolveMediaElementSrc(el) {
+  const direct = el.getAttribute("src");
+  if (direct) return direct;
+  let remote = null;
+  for (const source of el.querySelectorAll("source")) {
+    const src = source.getAttribute("src");
+    if (!src) continue;
+    if (!/^https?:\/\//i.test(src)) return src;
+    remote ??= src;
+  }
+  return remote;
+}
 function parseVideoElements(html) {
   const videos = [];
   const { document: document2 } = parseHTML(unwrapTemplate(html));
   const startCache = /* @__PURE__ */ new Map();
   const visiting = /* @__PURE__ */ new Set();
-  const videoEls = document2.querySelectorAll("video[src]");
+  const videoEls = document2.querySelectorAll("video");
   let autoIdCounter = 0;
   for (const el of videoEls) {
-    const src = el.getAttribute("src");
+    const src = resolveMediaElementSrc(el);
     if (!src) continue;
     const id = el.getAttribute(MEDIA_RENDER_ID_ATTR) || el.getAttribute("id") || `hf-video-${autoIdCounter++}`;
     if (!el.getAttribute("id")) {
@@ -75040,7 +75176,7 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   const normalizedFps = toFps(options.fps);
   const fps = fpsToNumber(normalizedFps);
   const ffmpegFps = fpsToFfmpegArg(normalizedFps);
-  const videoOutputDir = outputDirOverride ?? join10(outputDir, videoId);
+  const videoOutputDir = outputDirOverride ?? join11(outputDir, videoId);
   if (!existsSync10(videoOutputDir)) mkdirSync6(videoOutputDir, { recursive: true });
   let metadata;
   try {
@@ -75067,7 +75203,7 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   }
   const format = resolveFrameFormat(metadata, options.format);
   const framePattern = `${FRAME_FILENAME_PREFIX}%05d.${format}`;
-  const outputPattern = join10(videoOutputDir, framePattern);
+  const outputPattern = join11(videoOutputDir, framePattern);
   const isHdr = isHdrColorSpace(metadata.colorSpace);
   const isMacOS = process.platform === "darwin";
   const args = [];
@@ -75129,11 +75265,7 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
       diagnostic
     );
   }
-  const framePaths = /* @__PURE__ */ new Map();
-  const files = readdirSync5(videoOutputDir).filter((f) => f.startsWith(FRAME_FILENAME_PREFIX) && f.endsWith(`.${format}`)).sort();
-  files.forEach((file, index) => {
-    framePaths.set(index, join10(videoOutputDir, file));
-  });
+  const framePaths = framePathsFromDirectory(videoOutputDir, format);
   if (framePaths.size === 0 && duration > 0) {
     throw new VideoSourceExtractionError(
       "zero_output",
@@ -75323,16 +75455,9 @@ function resolveFrameFormat(metadata, requested) {
   if (requested === "png" || requested === "jpg") return requested;
   return "jpg";
 }
-function extractedFrameFileNames(outputDir, format) {
-  const suffix = `.${format}`;
-  return readdirSync5(outputDir).filter((file) => file.startsWith(FRAME_FILENAME_PREFIX) && file.endsWith(suffix)).sort();
-}
 function extractedFramesFromDirectory(work, outputDir, srcPath, fps) {
   const framePattern = `${FRAME_FILENAME_PREFIX}%05d.${work.format}`;
-  const framePaths = /* @__PURE__ */ new Map();
-  extractedFrameFileNames(outputDir, work.format).forEach((file, index) => {
-    framePaths.set(index, join10(outputDir, file));
-  });
+  const framePaths = framePathsFromDirectory(outputDir, work.format);
   return {
     videoId: work.video.id,
     srcPath,
@@ -75452,7 +75577,7 @@ function sliceSupersetMember(member, superset, outputDir, fps, configuredFps) {
   for (let i = 0; i < frameCount; i += 1) {
     const sourceFrame = superset.framePaths.get(member.offsetFrames + i);
     if (!sourceFrame) throw new Error(`superset frame ${member.offsetFrames + i} missing`);
-    linkOrCopyFrame(sourceFrame, join10(outputDir, frameFileName(i + 1, work.format)));
+    linkOrCopyFrame(sourceFrame, join11(outputDir, frameFileName(i + 1, work.format)));
   }
   return extractedFramesFromDirectory(work, outputDir, work.videoPath, fps);
 }
@@ -75465,22 +75590,22 @@ function resolveProjectRelativeSrc(src, baseDir, compiledDir) {
     if (!candidates.includes(candidate)) candidates.push(candidate);
   };
   for (const variant of decodeUrlPathVariants(cleanSrc)) {
-    const fromCompiled = compiledDir ? join10(compiledDir, variant) : null;
-    const fromBase = join10(baseDir, variant);
+    const fromCompiled = compiledDir ? join11(compiledDir, variant) : null;
+    const fromBase = join11(baseDir, variant);
     const baseAbs = resolve5(baseDir);
     const fromBaseAbs = resolve5(fromBase);
     if (!fromBaseAbs.startsWith(baseAbs + sep2) && fromBaseAbs !== baseAbs) {
       const normalized = posix2.normalize(variant.replace(/\\/g, "/"));
       const stripped = normalized.replace(/^(\.\.\/)+/, "");
       if (stripped && stripped !== variant && !stripped.startsWith("..")) {
-        if (compiledDir) addCandidate(join10(compiledDir, stripped));
-        addCandidate(join10(baseDir, stripped));
+        if (compiledDir) addCandidate(join11(compiledDir, stripped));
+        addCandidate(join11(baseDir, stripped));
       }
     }
     if (fromCompiled) addCandidate(fromCompiled);
     addCandidate(fromBase);
   }
-  return candidates.find(existsSync10) ?? join10(baseDir, cleanSrc);
+  return candidates.find(existsSync10) ?? join11(baseDir, cleanSrc);
 }
 async function extractAllVideoFrames(videos, baseDir, options, signal, config, compiledDir) {
   if (options.timelineEnd !== void 0 && !Number.isFinite(options.timelineEnd)) {
@@ -75527,7 +75652,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
         videoPath = resolveProjectRelativeSrc(video.src, baseDir, compiledDir);
       }
       if (isHttpUrl(videoPath)) {
-        const downloadDir = join10(options.outputDir, "_downloads");
+        const downloadDir = join11(options.outputDir, "_downloads");
         mkdirSync6(downloadDir, { recursive: true });
         videoPath = await downloadToTemp(
           videoPath,
@@ -75735,7 +75860,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
   async function extractDirectMiss(miss, maxTransientRetries = options.maxTransientRetries ?? 0) {
     const { work, cacheTarget } = miss;
     if (!cacheTarget) {
-      const outputDir = join10(options.outputDir, work.video.id);
+      const outputDir = join11(options.outputDir, work.video.id);
       const attempted2 = await runVideoExtractionWithRetry(
         () => extractVideoFramesRange(
           work.videoPath,
@@ -75803,7 +75928,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
       return sliceSupersetMember(
         member,
         superset,
-        join10(options.outputDir, work.video.id),
+        join11(options.outputDir, work.video.id),
         fps,
         configuredFps
       );
@@ -75820,7 +75945,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
   async function executeSupersetGroup(group) {
     const first = group.members[0]?.miss.work;
     if (!first) return [];
-    const tempDir = cacheRootDir ? join10(cacheRootDir, `${group.groupId}.partial-${process.pid}`) : join10(options.outputDir, group.groupId);
+    const tempDir = cacheRootDir ? join11(cacheRootDir, `${group.groupId}.partial-${process.pid}`) : join11(options.outputDir, group.groupId);
     try {
       rmSync3(tempDir, { recursive: true, force: true });
       const superset = await extractVideoFramesRange(
@@ -76051,6 +76176,7 @@ var init_videoFrameExtractor = __esm({
     init_config();
     init_htmlTemplate();
     init_extractionCache();
+    init_extractedFrameIndex();
     VIDEO_FRAME_FORMATS = ["auto", "jpg", "png"];
     EXTRACT_CACHE_MIN_AGE_MS = 60 * 60 * 1e3;
     GC_STALENESS_MS = 24 * 60 * 60 * 1e3;
@@ -76884,7 +77010,7 @@ var init_audio_fx_runtime_inline = __esm({
 // ../engine/src/services/audioFxRender.ts
 import { existsSync as existsSync11, mkdtempSync as mkdtempSync2, readFileSync as readFileSync4, rmSync as rmSync4, writeFileSync as writeFileSync5 } from "fs";
 import { tmpdir as tmpdir2 } from "os";
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 import { pathToFileURL } from "url";
 function readWavChunks(buf) {
   const head = { format: 1, channels: 1, sampleRate: 48e3, bits: 16 };
@@ -76997,7 +77123,7 @@ async function applyAudioFxChain(inputWav, chain, outputWav, options) {
   const { samples, sampleRate, channels, float } = readWav(inputWav);
   const planes = deinterleave(samples, channels);
   if ((planes[0]?.length ?? 0) === 0) return { path: inputWav, envelopeBaked: false };
-  const hostDir = mkdtempSync2(join11(tmpdir2(), "hf-fx-host-"));
+  const hostDir = mkdtempSync2(join12(tmpdir2(), "hf-fx-host-"));
   let lease = null;
   try {
     if (options.signal?.aborted) {
@@ -77006,7 +77132,7 @@ async function applyAudioFxChain(inputWav, chain, outputWav, options) {
     lease = await acquireBrowser(["--no-sandbox", "--autoplay-policy=no-user-gesture-required"]);
     const page = await lease.browser.newPage();
     try {
-      const hostPage = join11(hostDir, "audio-fx.html");
+      const hostPage = join12(hostDir, "audio-fx.html");
       writeFileSync5(hostPage, "<!doctype html><meta charset=utf-8><title>audio fx</title>");
       await page.goto(pathToFileURL(hostPage).href, { waitUntil: "domcontentloaded" });
       await page.addScriptTag({ content: getAudioFxRuntimeScript() });
@@ -77143,7 +77269,7 @@ var init_audioFxRender = __esm({
 
 // ../engine/src/services/audioMixer.ts
 import { closeSync as closeSync2, existsSync as existsSync12, mkdirSync as mkdirSync7, mkdtempSync as mkdtempSync3, openSync as openSync2, rmSync as rmSync5, writeFileSync as writeFileSync6 } from "fs";
-import { join as join12, dirname as dirname7 } from "path";
+import { join as join13, dirname as dirname7 } from "path";
 function memberGroupKey(el) {
   return el.getAttribute(AUDIO_GROUP_RENDER_ID_ATTR) ?? el.getAttribute(HF_AUDIO_GROUP_ATTR);
 }
@@ -77394,7 +77520,7 @@ function parseAudioElements(html) {
     const groupId = memberGroupKey(el);
     return groupId ? groupsById.get(groupId)?.hidden ?? false : false;
   };
-  const build = (el, id, type) => {
+  const build = (el, id, src, type) => {
     const playbackRateAttr = el.getAttribute("data-playback-rate");
     const layerAttr = el.getAttribute("data-layer");
     const volumeAttr = el.getAttribute("data-volume");
@@ -77404,7 +77530,7 @@ function parseAudioElements(html) {
     const group = groupId ? groupsById.get(groupId) : void 0;
     return {
       id,
-      src: el.getAttribute("src"),
+      src,
       start: resolveStart2(el),
       end: parseEnd(el.getAttribute("data-end")),
       mediaStart: readMediaStart(el),
@@ -77425,17 +77551,19 @@ function parseAudioElements(html) {
     };
   };
   const trackId = (el) => el.getAttribute(MEDIA_RENDER_ID_ATTR) || el.getAttribute("id");
-  for (const el of document2.querySelectorAll("audio[id][src]")) {
+  for (const el of document2.querySelectorAll("audio[id]")) {
     const id = trackId(el);
-    if (!id || !el.getAttribute("src") || isHidden(el) || memberGroupHidden(el)) continue;
+    const src = resolveMediaElementSrc(el);
+    if (!id || !src || isHidden(el) || memberGroupHidden(el)) continue;
     if (isKnownInactiveTimelineWindow(el, resolveStart2(el))) continue;
-    elements.push(build(el, id, "audio"));
+    elements.push(build(el, id, src, "audio"));
   }
-  for (const el of document2.querySelectorAll('video[id][src][data-has-audio="true"]')) {
+  for (const el of document2.querySelectorAll('video[id][data-has-audio="true"]')) {
     const id = trackId(el);
-    if (!id || !el.getAttribute("src") || isHidden(el)) continue;
+    const src = resolveMediaElementSrc(el);
+    if (!id || !src || isHidden(el)) continue;
     if (isKnownInactiveTimelineWindow(el, resolveStart2(el))) continue;
-    elements.push(build(el, `${id}-audio`, "video"));
+    elements.push(build(el, `${id}-audio`, src, "video"));
   }
   return elements;
 }
@@ -77607,8 +77735,8 @@ async function mixAudioTracks(tracks, outputPath, totalDuration, signal, config)
   const runMix = async (ignoreAutomation) => {
     const inputs = [];
     tracks.forEach((track) => inputs.push("-i", track.srcPath));
-    const scriptDir = mkdtempSync3(join12(outputDir, ".filter-complex-"));
-    const scriptPath = join12(scriptDir, "graph.txt");
+    const scriptDir = mkdtempSync3(join13(outputDir, ".filter-complex-"));
+    const scriptPath = join13(scriptDir, "graph.txt");
     const fd = openSync2(scriptPath, "wx", 384);
     try {
       writeFileSync6(fd, buildFilterComplex(ignoreAutomation));
@@ -77714,8 +77842,8 @@ async function mixGroupMembers(memberTracks, outputPath, totalDuration, signal,
       `${mixInputs}amix=inputs=${memberTracks.length}:duration=longest:dropout_transition=0[mixed];[mixed]volume=${formatFilterNumber(memberTracks.length)}[out]`
     );
     const filterComplex = [...inputFilters, mixFilter].join(";");
-    const scriptDir = mkdtempSync3(join12(outputDir, ".group-filter-complex-"));
-    const scriptPath = join12(scriptDir, "graph.txt");
+    const scriptDir = mkdtempSync3(join13(outputDir, ".group-filter-complex-"));
+    const scriptPath = join13(scriptDir, "graph.txt");
     const fd = openSync2(scriptPath, "wx", 384);
     try {
       writeFileSync6(fd, filterComplex);
@@ -77865,7 +77993,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
         }
         let audioSrcPath = srcPath;
         if (element.type === "video") {
-          const extractedPath = join12(workDir, `${element.id}-extracted.wav`);
+          const extractedPath = join13(workDir, `${element.id}-extracted.wav`);
           const extractResult = await extractAudioFromVideo(
             srcPath,
             extractedPath,
@@ -77892,7 +78020,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
           }
           audioSrcPath = extractedPath;
         } else {
-          const trimmedPath = join12(workDir, `${element.id}-trimmed.wav`);
+          const trimmedPath = join13(workDir, `${element.id}-trimmed.wav`);
           const prepResult = await prepareAudioTrack(
             srcPath,
             trimmedPath,
@@ -77936,7 +78064,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
           const fxResult = await applyAudioFxChain(
             audioSrcPath,
             chain,
-            join12(workDir, `${element.id}-fx.wav`),
+            join13(workDir, `${element.id}-fx.wav`),
             {
               trackId: element.id,
               signal: effectiveSignal,
@@ -78027,7 +78155,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
     const meta = groupMeta.get(groupId);
     if (!meta) continue;
     const pathId = safePathSegment(groupId, groupIndex);
-    const groupWavPath = join12(workDir, `group-${pathId}.wav`);
+    const groupWavPath = join13(workDir, `group-${pathId}.wav`);
     try {
       const subMix = await mixGroupMembers(
         memberTracks,
@@ -78063,7 +78191,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
         const fxResult = await applyAudioFxChain(
           groupSrcPath,
           chain,
-          join12(workDir, `group-${pathId}-fx.wav`),
+          join13(workDir, `group-${pathId}-fx.wav`),
           {
             trackId: groupId,
             signal: effectiveSignal,
@@ -78161,14 +78289,14 @@ var init_audioMixer = __esm({
 import { execFile as execFile2 } from "child_process";
 import { mkdtemp, rm, writeFile } from "fs/promises";
 import { tmpdir as tmpdir3 } from "os";
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 import { promisify as promisify2 } from "util";
 async function psnrDb(a, b) {
   const execFileP = promisify2(execFile2);
-  const dir = await mkdtemp(join13(tmpdir3(), "hf-de-verify-"));
+  const dir = await mkdtemp(join14(tmpdir3(), "hf-de-verify-"));
   try {
-    const pa = join13(dir, "a.jpg");
-    const pb = join13(dir, "b.jpg");
+    const pa = join14(dir, "a.jpg");
+    const pb = join14(dir, "b.jpg");
     await Promise.all([writeFile(pa, a), writeFile(pb, b)]);
     const { stderr } = await execFileP(
       getFfmpegBinary(),
@@ -78279,7 +78407,7 @@ var init_readWebGlVendorInfoFromCanvas = __esm({
 import { cpus, freemem } from "os";
 import { existsSync as existsSync13, mkdirSync as mkdirSync8, readdirSync as readdirSync6 } from "fs";
 import { copyFile, readFile, rename } from "fs/promises";
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 import { getHeapStatistics } from "v8";
 function defaultSafeMaxWorkers() {
   return Math.max(6, Math.min(16, Math.floor(cpus().length / 8)));
@@ -78408,7 +78536,7 @@ function distributeFrames(totalFrames, workerCount, workDir, rangeStart = 0) {
       workerId: i,
       startFrame,
       endFrame,
-      outputDir: join14(workDir, `worker-${i}`),
+      outputDir: join15(workDir, `worker-${i}`),
       outputFrameOffset: rangeStart
     });
   }
@@ -78422,7 +78550,7 @@ function distributeFramesInterleaved(totalFrames, workerCount, workDir, rangeSta
       startFrame: rangeStart + i,
       endFrame: rangeStart + totalFrames,
       frameStride: workerCount,
-      outputDir: join14(workDir, `worker-${i}`),
+      outputDir: join15(workDir, `worker-${i}`),
       outputFrameOffset: rangeStart
     });
   }
@@ -78580,7 +78708,7 @@ async function verifyDiskDrawElementSamples(session, task, streaming) {
   for (const idx of selectVerifySampleIndicesForTask(truths.keys(), task)) {
     const truth = truths.get(idx);
     if (!truth) continue;
-    const framePath = join14(task.outputDir, `frame_${String(idx - offset2).padStart(6, "0")}.${ext}`);
+    const framePath = join15(task.outputDir, `frame_${String(idx - offset2).padStart(6, "0")}.${ext}`);
     const db = await psnrForDiskSample(framePath, truth, task.workerId, idx);
     if (db === null) continue;
     assertDiskSampleAboveFloor(db, verifyMinDb, idx, task.workerId);
@@ -78746,8 +78874,8 @@ async function mergeWorkerFrames(workDir, tasks, outputDir) {
     }
     const files = readdirSync6(task.outputDir).filter((f) => f.startsWith("frame_") && (f.endsWith(".jpg") || f.endsWith(".png"))).sort();
     const copyTasks = files.map(async (file) => {
-      const sourcePath = join14(task.outputDir, file);
-      const targetPath = join14(outputDir, file);
+      const sourcePath = join15(task.outputDir, file);
+      const targetPath = join15(outputDir, file);
       try {
         await rename(sourcePath, targetPath);
       } catch {
@@ -78793,7 +78921,7 @@ var init_parallelCoordinator = __esm({
 import { Hono } from "hono";
 import { serve } from "@hono/node-server";
 import { readFileSync as readFileSync5, existsSync as existsSync14, statSync as statSync6 } from "fs";
-import { join as join15, extname as extname3 } from "path";
+import { join as join16, extname as extname3 } from "path";
 function createFileServer(options) {
   const { projectDir, compiledDir, port = 0, stripEmbeddedRuntime = true } = options;
   const headScripts = options.headScripts ?? [];
@@ -78803,11 +78931,11 @@ function createFileServer(options) {
     let requestPath = c.req.path;
     if (requestPath === "/") requestPath = "/index.html";
     const relativePath = requestPath.replace(/^\//, "");
-    const compiledPath = compiledDir ? join15(compiledDir, relativePath) : null;
+    const compiledPath = compiledDir ? join16(compiledDir, relativePath) : null;
     const hasCompiledFile = Boolean(
       compiledPath && existsSync14(compiledPath) && statSync6(compiledPath).isFile()
     );
-    const filePath = hasCompiledFile ? compiledPath : join15(projectDir, relativePath);
+    const filePath = hasCompiledFile ? compiledPath : join16(projectDir, relativePath);
     if (!existsSync14(filePath) || !statSync6(filePath).isFile()) {
       return c.text("Not found", 404);
     }
@@ -80260,7 +80388,7 @@ var init_shaderTransitions = __esm({
 
 // ../engine/src/services/hdrCapture.ts
 import { existsSync as existsSync15, readdirSync as readdirSync7 } from "fs";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 import { homedir as homedir2 } from "os";
 function linearToPQ(L) {
   const Lp = Math.max(0, L * SDR_NITS / PQ_MAX_NITS);
@@ -80376,12 +80504,12 @@ function float16ToPqRgb(rawBuffer, bytesPerRow, width, height) {
   return output;
 }
 function resolveHeadedChromePath() {
-  const baseDir = join16(homedir2(), ".cache", "puppeteer", "chrome");
+  const baseDir = join17(homedir2(), ".cache", "puppeteer", "chrome");
   if (!existsSync15(baseDir)) return void 0;
   const versions = readdirSync7(baseDir).sort().reverse();
   for (const version2 of versions) {
     const candidates = [
-      join16(
+      join17(
         baseDir,
         version2,
         "chrome-mac-arm64",
@@ -80390,7 +80518,7 @@ function resolveHeadedChromePath() {
         "MacOS",
         "Google Chrome for Testing"
       ),
-      join16(
+      join17(
         baseDir,
         version2,
         "chrome-mac-x64",
@@ -80399,8 +80527,8 @@ function resolveHeadedChromePath() {
         "MacOS",
         "Google Chrome for Testing"
       ),
-      join16(baseDir, version2, "chrome-linux64", "chrome"),
-      join16(baseDir, version2, "chrome-win64", "chrome.exe")
+      join17(baseDir, version2, "chrome-linux64", "chrome"),
+      join17(baseDir, version2, "chrome-win64", "chrome.exe")
     ];
     for (const binary of candidates) {
       if (existsSync15(binary)) return binary;
@@ -80643,6 +80771,7 @@ __export(src_exports, {
   resolveHeadlessShellPath: () => resolveHeadlessShellPath,
   resolvePlayableVideoDuration: () => resolvePlayableVideoDuration,
   resolveProjectRelativeSrc: () => resolveProjectRelativeSrc,
+  resolveReferencedStart: () => resolveReferencedStart,
   resolveTimelineExtractionWindow: () => resolveTimelineExtractionWindow,
   resolveVideoExtractionDuration: () => resolveVideoExtractionDuration,
   resolveVideoExtractionWindow: () => resolveVideoExtractionWindow,
@@ -80680,6 +80809,7 @@ var init_src = __esm({
     init_chunkEncoder();
     init_streamingEncoder();
     init_videoFrameExtractor();
+    init_referenceResolver();
     init_videoFrameInjector();
     init_audioMixer();
     init_captureWarning();
@@ -83875,7 +84005,7 @@ __export(fontCompression_exports, {
 import { createHash as createHash6 } from "crypto";
 import { existsSync as existsSync21, mkdirSync as mkdirSync10, readFileSync as readFileSync7, renameSync as renameSync4, rmSync as rmSync8, writeFileSync as writeFileSync8 } from "fs";
 import { homedir as homedir4, tmpdir as tmpdir4 } from "os";
-import { dirname as dirname11, join as join23 } from "path";
+import { dirname as dirname11, join as join24 } from "path";
 async function compressToWoff2(input) {
   return Buffer.from(await compress(input));
 }
@@ -83883,12 +84013,12 @@ function rawMimeType(format) {
   return RAW_MIME_TYPES[format] ?? "font/ttf";
 }
 function defaultCacheDir() {
-  const root = process.env.HYPERFRAMES_FONT_CACHE_DIR ?? (process.env.AWS_LAMBDA_FUNCTION_NAME ? join23(tmpdir4(), "hyperframes", "fonts") : join23(homedir4(), ".cache", "hyperframes", "fonts"));
-  return join23(root, "local-compression-v1");
+  const root = process.env.HYPERFRAMES_FONT_CACHE_DIR ?? (process.env.AWS_LAMBDA_FUNCTION_NAME ? join24(tmpdir4(), "hyperframes", "fonts") : join24(homedir4(), ".cache", "hyperframes", "fonts"));
+  return join24(root, "local-compression-v1");
 }
 function cachedCompressionPath(input, originalFormat, cacheDir) {
   const digest = createHash6("sha256").update("hyperframes-local-font-compression-v1\0").update(originalFormat).update("\0").update(input).digest("hex");
-  return join23(cacheDir, `${digest}.woff2`);
+  return join24(cacheDir, `${digest}.woff2`);
 }
 function readCachedCompression(path) {
   try {
@@ -83968,7 +84098,7 @@ import {
   appendFileSync
 } from "fs";
 import { tmpdir as tmpdir7 } from "os";
-import { join as join40, dirname as dirname16, resolve as resolve13 } from "path";
+import { join as join41, dirname as dirname16, resolve as resolve13 } from "path";
 import { totalmem as totalmem3 } from "os";
 import { randomUUID as randomUUID3 } from "crypto";
 import { fileURLToPath as fileURLToPath5 } from "url";
@@ -83981,7 +84111,7 @@ import { serve as serve2 } from "@hono/node-server";
 import { existsSync as existsSync17, realpathSync as realpathSync2, statSync as statSync7, createReadStream as createReadStream3 } from "fs";
 import { readFile as readFile2 } from "fs/promises";
 import { Readable as Readable2 } from "stream";
-import { join as join17, extname as extname4, resolve as resolve7, sep as sep3 } from "path";
+import { join as join18, extname as extname4, resolve as resolve7, sep as sep3 } from "path";
 
 // ../producer/src/services/hyperframeRuntimeLoader.ts
 import { createHash as createHash4 } from "crypto";
@@ -84571,13 +84701,13 @@ function createFileServer2(options) {
     }).join("/");
     let filePath = null;
     if (compiledDir) {
-      const candidate = join17(compiledDir, relativePath);
+      const candidate = join18(compiledDir, relativePath);
       if (existsSync17(candidate) && isPathInside2(candidate, compiledDir) && statSync7(candidate).isFile()) {
         filePath = candidate;
       }
     }
     if (!filePath) {
-      const candidate = join17(projectDir, relativePath);
+      const candidate = join18(projectDir, relativePath);
       if (existsSync17(candidate) && isPathInside2(candidate, projectDir) && statSync7(candidate).isFile()) {
         filePath = candidate;
       }
@@ -84682,12 +84812,12 @@ import {
   symlinkSync,
   writeFileSync as writeFileSync7
 } from "fs";
-import { basename as basename4, dirname as dirname9, isAbsolute as isAbsolute2, join as join19, relative, resolve as resolve8 } from "path";
+import { basename as basename4, dirname as dirname9, isAbsolute as isAbsolute2, join as join20, relative, resolve as resolve8 } from "path";
 
 // ../producer/src/utils/paths.ts
 import {
   basename as basename3,
-  join as join18,
+  join as join19,
   resolve as nodeResolve,
   relative as nodeRelative,
   isAbsolute as nodeIsAbsolute
@@ -84725,7 +84855,7 @@ function formatExportFrameName(index, ext) {
 function resolveRenderPaths(projectDir, outputPath, rendersDir = DEFAULT_RENDERS_DIR) {
   const absoluteProjectDir = nodeResolve(projectDir);
   const projectName = basename3(absoluteProjectDir);
-  const resolvedOutputPath = outputPath ?? join18(rendersDir, `${projectName}.mp4`);
+  const resolvedOutputPath = outputPath ?? join19(rendersDir, `${projectName}.mp4`);
   const absoluteOutputPath = nodeResolve(resolvedOutputPath);
   return { absoluteProjectDir, absoluteOutputPath };
 }
@@ -84762,16 +84892,16 @@ function resolveDeviceScaleFactor(input) {
   return target.width / input.compositionWidth;
 }
 function writeCompiledArtifacts(compiled, workDir, includeSummary) {
-  const compileDir = join19(workDir, "compiled");
+  const compileDir = join20(workDir, "compiled");
   mkdirSync9(compileDir, { recursive: true });
-  writeFileSync7(join19(compileDir, "index.html"), compiled.html, "utf-8");
+  writeFileSync7(join20(compileDir, "index.html"), compiled.html, "utf-8");
   for (const [srcPath, html] of compiled.subCompositions) {
-    const outPath = join19(compileDir, srcPath);
+    const outPath = join20(compileDir, srcPath);
     mkdirSync9(dirname9(outPath), { recursive: true });
     writeFileSync7(outPath, html, "utf-8");
   }
   for (const [relativePath, absolutePath] of compiled.externalAssets) {
-    const outPath = resolve8(join19(compileDir, relativePath));
+    const outPath = resolve8(join20(compileDir, relativePath));
     if (!isPathInside3(outPath, compileDir)) {
       console.warn(`[Render] Skipping external asset with unsafe path: ${relativePath}`);
       continue;
@@ -84802,7 +84932,7 @@ function writeCompiledArtifacts(compiled, workDir, includeSummary) {
       renderModeHints: compiled.renderModeHints,
       hasShaderTransitions: compiled.hasShaderTransitions
     };
-    writeFileSync7(join19(compileDir, "summary.json"), JSON.stringify(summary, null, 2), "utf-8");
+    writeFileSync7(join20(compileDir, "summary.json"), JSON.stringify(summary, null, 2), "utf-8");
   }
 }
 function applyRenderModeHints(alreadyForced, compiled, log = defaultLogger) {
@@ -84829,7 +84959,7 @@ function updateJobStatus(job, status, stage, progress, onProgress) {
 }
 var materializePathModule = {
   resolve: resolve8,
-  join: join19,
+  join: join20,
   dirname: dirname9,
   basename: basename4,
   relative,
@@ -85097,17 +85227,29 @@ import {
   renameSync as renameSync3,
   rmSync as rmSync7
 } from "fs";
-import { basename as basename5, dirname as dirname10, extname as extname5, join as join20, resolve as resolve9 } from "path";
+import { basename as basename5, dirname as dirname10, extname as extname5, join as join21, resolve as resolve9 } from "path";
+
+// ../producer/src/utils/ffprobe.ts
+init_src();
+
+// ../producer/src/services/render/artifactTransaction.ts
 var defaultFileSystem = {
   existsSync: existsSync19,
   renameSync: renameSync3,
   rmSync: rmSync7
 };
+async function defaultArtifactDurationProbe(path) {
+  const meta = await extractMediaMetadata(path);
+  return {
+    durationSeconds: meta.durationSeconds,
+    frames: meta.frames
+  };
+}
 function createSiblingTransactionDirectory(destination) {
   const parent = dirname10(destination);
   const extension = extname5(destination);
   const stem = extension ? basename5(destination, extension) : basename5(destination);
-  return mkdtempSync4(join20(parent, `.${stem}.hf-transaction-`));
+  return mkdtempSync4(join21(parent, `.${stem}.hf-transaction-`));
 }
 function assertReadableNonEmptyFile(path) {
   const fd = openSync3(path, "r");
@@ -85125,7 +85267,7 @@ function collectDirectoryFiles(root) {
   const files = [];
   const visit = (directory) => {
     for (const entry of readdirSync8(directory, { withFileTypes: true })) {
-      const path = join20(directory, entry.name);
+      const path = join21(directory, entry.name);
       if (entry.isDirectory()) visit(path);
       else if (entry.isFile()) files.push(path);
     }
@@ -85133,14 +85275,44 @@ function collectDirectoryFiles(root) {
   visit(root);
   return files;
 }
+function durationToleranceSeconds(expected) {
+  if (expected.toleranceSeconds !== void 0) return expected.toleranceSeconds;
+  const fps = expected.fps;
+  return fps && fps > 0 ? 1 / fps : 0.02;
+}
+function assertUsableProbedDuration(probedSeconds, expectedSeconds, stagingPath) {
+  if (!Number.isFinite(probedSeconds) || probedSeconds <= 0) {
+    throw new Error(
+      `Render artifact duration probe returned no usable duration for ${stagingPath} (got ${String(probedSeconds)}); expected ${expectedSeconds.toFixed(3)}s. Refusing to publish an artifact whose duration cannot be verified.`
+    );
+  }
+}
+function assertDurationWithinTolerance(expectedSeconds, probedSeconds, toleranceSeconds, stagingPath) {
+  const deficit = expectedSeconds - probedSeconds;
+  if (deficit <= toleranceSeconds) return;
+  throw new Error(
+    `Render artifact is truncated: expected ${expectedSeconds.toFixed(3)}s, probed ${probedSeconds.toFixed(3)}s (deficit ${deficit.toFixed(3)}s exceeds tolerance ${toleranceSeconds.toFixed(3)}s). Artifact: ${stagingPath}`
+  );
+}
+function assertFrameCountWithinTolerance(expectedFrames, probedFrames, stagingPath) {
+  if (probedFrames === void 0 || !Number.isFinite(probedFrames) || probedFrames <= 0) {
+    return;
+  }
+  const shortfall = expectedFrames - probedFrames;
+  if (shortfall <= 1) return;
+  throw new Error(
+    `Render artifact is truncated: expected ${expectedFrames} frames, probed ${probedFrames} frames (shortfall ${shortfall} frames). Artifact: ${stagingPath}`
+  );
+}
 var ArtifactTransaction = class {
-  constructor(destinationPath, kind, fileSystem = defaultFileSystem) {
+  constructor(destinationPath, kind, fileSystem = defaultFileSystem, durationProbe = defaultArtifactDurationProbe) {
     this.kind = kind;
     this.fileSystem = fileSystem;
     this.destinationPath = resolve9(destinationPath);
     this.transactionDirectory = createSiblingTransactionDirectory(this.destinationPath);
-    this.stagingPath = join20(this.transactionDirectory, basename5(this.destinationPath));
-    this.backupPath = join20(this.transactionDirectory, "backup");
+    this.stagingPath = join21(this.transactionDirectory, basename5(this.destinationPath));
+    this.backupPath = join21(this.transactionDirectory, "backup");
+    this.durationProbe = durationProbe;
   }
   kind;
   fileSystem;
@@ -85149,9 +85321,11 @@ var ArtifactTransaction = class {
   transactionDirectory;
   backupPath;
   state = "active";
-  validate() {
+  durationProbe;
+  async validate(expected) {
     if (this.kind === "file") {
       assertReadableNonEmptyFile(this.stagingPath);
+      if (expected) await this.assertArtifactDuration(expected);
       return;
     }
     let files;
@@ -85167,11 +85341,37 @@ var ArtifactTransaction = class {
     }
     for (const file of files) assertReadableNonEmptyFile(file);
   }
-  commit() {
+  async assertArtifactDuration(expected) {
+    const expectedSeconds = expected.expectedDurationSeconds;
+    if (!Number.isFinite(expectedSeconds) || expectedSeconds <= 0) return;
+    const probed = await this.runDurationProbe();
+    assertUsableProbedDuration(probed.durationSeconds, expectedSeconds, this.stagingPath);
+    const toleranceSeconds = durationToleranceSeconds(expected);
+    assertDurationWithinTolerance(
+      expectedSeconds,
+      probed.durationSeconds,
+      toleranceSeconds,
+      this.stagingPath
+    );
+    if (expected.expectedFrames !== void 0) {
+      assertFrameCountWithinTolerance(expected.expectedFrames, probed.frames, this.stagingPath);
+    }
+  }
+  async runDurationProbe() {
+    try {
+      return await this.durationProbe(this.stagingPath);
+    } catch (error) {
+      throw new Error(
+        `Render artifact duration probe failed for ${this.stagingPath}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async commit() {
     if (this.state !== "active") {
       throw new Error(`Cannot commit an artifact transaction in state ${this.state}`);
     }
-    this.validate();
+    await this.validate();
     const hadDestination = this.fileSystem.existsSync(this.destinationPath);
     if (this.kind === "file" || !hadDestination) {
       this.fileSystem.renameSync(this.stagingPath, this.destinationPath);
@@ -85676,7 +85876,7 @@ function resolveVideoCaptureBeyondViewport(videoCount) {
 // ../producer/src/services/render/captureCost.ts
 init_dist2();
 init_src();
-import { join as join21 } from "path";
+import { join as join22 } from "path";
 var CAPTURE_CALIBRATION_TARGET_MS = 600;
 var MAX_MEASURED_CAPTURE_COST_MULTIPLIER = 8;
 var CAPTURE_CALIBRATION_PROTOCOL_TIMEOUT_MS = 3e4;
@@ -85912,7 +86112,7 @@ async function runCaptureCalibration(input) {
   });
   let calibration;
   try {
-    calibration = await runOneCalibration(join21(workDir, "capture-calibration"), calibrationCfg);
+    calibration = await runOneCalibration(join22(workDir, "capture-calibration"), calibrationCfg);
   } catch (error) {
     const shouldFallback = !forceScreenshot && shouldFallbackToScreenshotAfterCalibrationError(error);
     if (!shouldFallback) {
@@ -85945,7 +86145,7 @@ async function runCaptureCalibration(input) {
       const screenshotCfg = createCaptureCalibrationConfig({ ...cfg, forceScreenshot: true });
       try {
         calibration = await runOneCalibration(
-          join21(workDir, "capture-calibration-screenshot"),
+          join22(workDir, "capture-calibration-screenshot"),
           screenshotCfg
         );
       } catch (fallbackError) {
@@ -86366,7 +86566,7 @@ function countAuthoredTimedClips(html) {
 
 // ../producer/src/services/render/stages/compileStage.ts
 init_dist2();
-import { join as join27 } from "path";
+import { join as join28 } from "path";
 
 // ../producer/src/services/htmlCompiler.ts
 init_esm10();
@@ -86376,10 +86576,7 @@ init_compiler();
 init_subCompositionValidity();
 init_assetResolution();
 import { createReadStream as createReadStream4, existsSync as existsSync25, mkdirSync as mkdirSync13, readFileSync as readFileSync10 } from "fs";
-import { join as join26, dirname as dirname13, resolve as resolve12, basename as basename6 } from "path";
-
-// ../producer/src/utils/ffprobe.ts
-init_src();
+import { join as join27, dirname as dirname13, resolve as resolve12, basename as basename6 } from "path";
 
 // ../producer/src/services/renderMediaCollector.ts
 init_esm10();
@@ -86392,7 +86589,7 @@ function parseNumeric2(value) {
   const parsed = Number.parseFloat(value);
   return Number.isFinite(parsed) ? parsed : null;
 }
-function resolveHostWindow(element) {
+function resolveHostWindow(element, document2, startCache, visiting) {
   const hosts = [];
   for (let ancestor2 = element.parentElement; ancestor2; ancestor2 = ancestor2.parentElement) {
     if (ancestor2.hasAttribute(COMPOSITION_HOST_ATTR)) hosts.push(ancestor2);
@@ -86401,7 +86598,7 @@ function resolveHostWindow(element) {
   let offset2 = 0;
   let limit = Infinity;
   for (const host of hosts.reverse()) {
-    const hostStart = parseNumeric2(host.getAttribute("data-start")) ?? 0;
+    const hostStart = resolveReferencedStart(document2, host, startCache, visiting);
     const hostEnd = parseNumeric2(host.getAttribute("data-end"));
     if (hostEnd != null) limit = Math.min(limit, offset2 + hostEnd);
     offset2 += hostStart;
@@ -86411,10 +86608,15 @@ function resolveHostWindow(element) {
 function collectHostWindows(html) {
   const { document: document2 } = parseHTML(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}]`)) {
     const renderId = element.getAttribute(MEDIA_RENDER_ID_ATTR);
     if (!renderId) continue;
-    windows.set(renderId, resolveHostWindow(element));
+    windows.set(
+      renderId,
+      resolveHostWindow(element, document2, startCache, visiting)
+    );
   }
   return windows;
 }
@@ -86462,7 +86664,7 @@ init_src();
 import { createHash as createHash7 } from "crypto";
 import { existsSync as existsSync22, mkdirSync as mkdirSync11, mkdtempSync as mkdtempSync5, readFileSync as readFileSync8, writeFileSync as writeFileSync9 } from "fs";
 import { homedir as homedir5, tmpdir as tmpdir5 } from "os";
-import { join as join24 } from "path";
+import { join as join25 } from "path";
 
 // ../core/dist/fonts/aliases.js
 init_dist();
@@ -86471,7 +86673,7 @@ init_dist();
 import { execFileSync as execFileSync2 } from "child_process";
 import { existsSync as existsSync20, lstatSync as lstatSync3, readdirSync as readdirSync9, realpathSync as realpathSync3 } from "fs";
 import { homedir as homedir3, platform as platform2 } from "os";
-import { join as join22, resolve as resolve10 } from "path";
+import { join as join23, resolve as resolve10 } from "path";
 var SYSTEM_FONT_SIZE_LIMIT = 5 * 1024 * 1024;
 var PROFILER_TIMEOUT_MS = 5e3;
 var FONT_EXT_RE = /\.(otf|ttf|ttc|woff2?)$/i;
@@ -86568,7 +86770,7 @@ function fontDirectories() {
   const home = homedir3();
   if (platform2() === "darwin") {
     return [
-      join22(home, "Library", "Fonts"),
+      join23(home, "Library", "Fonts"),
       "/Library/Fonts",
       "/System/Library/Fonts",
       "/System/Library/Fonts/Supplemental"
@@ -86576,13 +86778,13 @@ function fontDirectories() {
   }
   if (platform2() === "win32") {
     return [
-      join22(process.env.WINDIR || "C:\\Windows", "Fonts"),
-      join22(process.env.LOCALAPPDATA || join22(homedir3(), "AppData", "Local"), "Microsoft", "Windows", "Fonts")
+      join23(process.env.WINDIR || "C:\\Windows", "Fonts"),
+      join23(process.env.LOCALAPPDATA || join23(homedir3(), "AppData", "Local"), "Microsoft", "Windows", "Fonts")
     ];
   }
   return [
-    join22(home, ".fonts"),
-    join22(home, ".local", "share", "fonts"),
+    join23(home, ".fonts"),
+    join23(home, ".local", "share", "fonts"),
     "/usr/local/share/fonts",
     "/usr/share/fonts"
   ];
@@ -86593,7 +86795,7 @@ function collectFontFileEntries(dir, depth = 0) {
   const entries2 = [];
   try {
     for (const entry of readdirSync9(dir, { withFileTypes: true })) {
-      const fullPath = join22(dir, entry.name);
+      const fullPath = join23(dir, entry.name);
       if (entry.isDirectory()) {
         entries2.push(...collectFontFileEntries(fullPath, depth + 1));
         continue;
@@ -87241,17 +87443,17 @@ function resolveFontCacheRoot() {
     return process.env.HYPERFRAMES_FONT_CACHE_DIR;
   }
   if (process.env.AWS_LAMBDA_FUNCTION_NAME) {
-    lambdaFontCacheRoot ??= mkdtempSync5(join24(tmpdir5(), "hyperframes-fonts-"));
+    lambdaFontCacheRoot ??= mkdtempSync5(join25(tmpdir5(), "hyperframes-fonts-"));
     return lambdaFontCacheRoot;
   }
-  return join24(homedir5(), ".cache", "hyperframes", "fonts");
+  return join25(homedir5(), ".cache", "hyperframes", "fonts");
 }
 var WOFF2_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";
 function fontSlug(familyName) {
   return familyName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
 }
 function fontCacheDir(slug) {
-  const dir = join24(resolveFontCacheRoot(), slug);
+  const dir = join25(resolveFontCacheRoot(), slug);
   if (!existsSync22(dir)) {
     mkdirSync11(dir, { recursive: true });
   }
@@ -87261,7 +87463,7 @@ function subsetToken(woff2Url) {
   return createHash7("sha1").update(woff2Url).digest("hex").slice(0, 12);
 }
 function cachedWoff2Path(slug, weight, style, subset) {
-  return join24(fontCacheDir(slug), `${weight}-${style}-${subset}.woff2`);
+  return join25(fontCacheDir(slug), `${weight}-${style}-${subset}.woff2`);
 }
 var FONT_FETCH_FAILED = "FONT_FETCH_FAILED";
 var FONT_FETCH_UNAVAILABLE = "FONT_FETCH_UNAVAILABLE";
@@ -87578,7 +87780,7 @@ import {
   rmSync as rmSync9,
   statSync as statSync8
 } from "fs";
-import { dirname as dirname12, isAbsolute as isAbsolute3, join as join25, resolve as resolve11 } from "path";
+import { dirname as dirname12, isAbsolute as isAbsolute3, join as join26, resolve as resolve11 } from "path";
 var PREPARED_GIF_SUBDIR = "_animated_gif";
 var CACHE_SCHEMA = "hfgif-v1";
 function splitUrlSuffix(src) {
@@ -87812,7 +88014,7 @@ function replaceImageWithVideo(input) {
   return video;
 }
 async function prepareAnimatedGifInputs(html, options) {
-  const outputDir = options.outputDir ?? join25(options.downloadDir, PREPARED_GIF_SUBDIR);
+  const outputDir = options.outputDir ?? join26(options.downloadDir, PREPARED_GIF_SUBDIR);
   const outputSrcPrefix = normalizeRelPath(options.outputSrcPrefix ?? PREPARED_GIF_SUBDIR);
   const cacheDir = options.cacheDir ?? outputDir;
   const { document: document2 } = parseHTML(html);
@@ -87834,8 +88036,8 @@ async function prepareAnimatedGifInputs(html, options) {
     const { loopIterations, padSeconds } = resolvePreparedPlayback(metadata, loop, windowSeconds);
     const hash2 = computePreparedGifHash(bytes, loopIterations, padSeconds);
     const filename = `${CACHE_SCHEMA}-${hash2.slice(0, 24)}.webm`;
-    const cachePath = join25(cacheDir, filename);
-    const outputPath = join25(outputDir, filename);
+    const cachePath = join26(cacheDir, filename);
+    const outputPath = join26(outputDir, filename);
     const outputSrc = `${outputSrcPrefix}/${filename}`;
     await ensurePreparedWebm({
       sourcePath,
@@ -88504,7 +88706,7 @@ async function resolveMediaDuration(src, mediaStart, playbackRate, baseDir, down
       return { duration: null, resolvedPath: src };
     }
   } else if (!filePath.startsWith("/")) {
-    filePath = join26(baseDir, filePath);
+    filePath = join27(baseDir, filePath);
   }
   if (!existsSync25(filePath)) {
     return { duration: null, resolvedPath: filePath };
@@ -89036,6 +89238,7 @@ function collectExternalAssets(html, projectDir) {
 }
 var REMOTE_MEDIA_SUBDIR = "_remote_media";
 var REMOTE_MEDIA_TAG_RE = /<(?:video|audio)\b[^>]*?\bsrc\s*=\s*["'](https?:\/\/[^"']+)["'][^>]*>/gi;
+var REMOTE_SOURCE_TAG_RE = /<source\b[^>]*?\bsrc\s*=\s*["'](https?:\/\/[^"']+)["'][^>]*>/gi;
 var REMOTE_IMG_TAG_RE = /<img\b[^>]*?(?<![\w-])src\s*=\s*["'](https?:\/\/[^"']+)["'][^>]*>/gi;
 async function downloadAndRewriteUrls(urlSet, html, remoteDir, warnLabel, logLabel, extraRewrite) {
   if (urlSet.size === 0) return { html, remoteMediaAssets: /* @__PURE__ */ new Map() };
@@ -89076,15 +89279,17 @@ async function downloadAndRewriteUrls(urlSet, html, remoteDir, warnLabel, logLab
 }
 async function localizeRemoteMediaSources(html, downloadDir) {
   const urlSet = /* @__PURE__ */ new Set();
-  const re = new RegExp(REMOTE_MEDIA_TAG_RE.source, REMOTE_MEDIA_TAG_RE.flags);
-  let m;
-  while ((m = re.exec(html)) !== null) {
-    if (m[1]) urlSet.add(m[1]);
+  for (const tagRe of [REMOTE_MEDIA_TAG_RE, REMOTE_SOURCE_TAG_RE]) {
+    const re = new RegExp(tagRe.source, tagRe.flags);
+    let m;
+    while ((m = re.exec(html)) !== null) {
+      if (m[1]) urlSet.add(m[1]);
+    }
   }
   return downloadAndRewriteUrls(
     urlSet,
     html,
-    join26(downloadDir, REMOTE_MEDIA_SUBDIR),
+    join27(downloadDir, REMOTE_MEDIA_SUBDIR),
     "Remote media download failed",
     "Localized remote media source(s)"
   );
@@ -89099,7 +89304,7 @@ async function localizeRemoteImageSources(html, downloadDir) {
   return downloadAndRewriteUrls(
     urlSet,
     html,
-    join26(downloadDir, REMOTE_MEDIA_SUBDIR),
+    join27(downloadDir, REMOTE_MEDIA_SUBDIR),
     "Remote image download failed",
     "Localized remote image source(s)"
   );
@@ -89115,7 +89320,7 @@ async function localizeRemoteBackgroundImages(html, downloadDir) {
   return downloadAndRewriteUrls(
     urlSet,
     html,
-    join26(downloadDir, REMOTE_MEDIA_SUBDIR),
+    join27(downloadDir, REMOTE_MEDIA_SUBDIR),
     "Remote background-image download failed",
     "Localized remote background-image(s)",
     // Quoted url('..')/url("..") are rewritten by downloadAndRewriteUrls' default
@@ -89250,7 +89455,7 @@ async function localizeRemoteFontFaces(html, downloadDir) {
   return downloadAndRewriteUrls(
     urlSet,
     processed,
-    join26(downloadDir, REMOTE_MEDIA_SUBDIR),
+    join27(downloadDir, REMOTE_MEDIA_SUBDIR),
     "Remote font download failed",
     "Localized remote font face(s)",
     (h, url, relPath) => h.replaceAll(`url(${url})`, `url("${relPath}")`)
@@ -89499,7 +89704,7 @@ async function discoverMediaFromBrowser(page) {
       const htmlEl = el;
       const isImage = htmlEl.tagName.toLowerCase() === "img";
       const tagName19 = isImage ? "image" : htmlEl.tagName.toLowerCase() === "video" ? "video" : "audio";
-      const id = htmlEl.id || (isImage ? autoImageIds.get(htmlEl) : void 0);
+      const id = htmlEl.getAttribute("data-hf-render-id") || htmlEl.id || (isImage ? autoImageIds.get(htmlEl) : void 0);
       if (!id) return;
       const src = htmlEl.currentSrc || htmlEl.src || htmlEl.getAttribute("src") || "";
       const start = parseFloat(htmlEl.getAttribute("data-start") || "0");
@@ -89546,7 +89751,7 @@ async function discoverAudioVolumeAutomationFromTimeline(page, audioIds, composi
   const sampleStep = 1 / Math.min(60, Math.max(1, sampleFps));
   const rawWindows = await page.evaluate((ids) => {
     return ids.flatMap((id) => {
-      const el = document.getElementById(id) ?? document.getElementById(id.replace(/-audio$/, ""));
+      const el = window.__hfMediaEl?.(id) ?? document.getElementById(id) ?? document.getElementById(id.replace(/-audio$/, ""));
       if (!(el instanceof HTMLAudioElement) && !(el instanceof HTMLVideoElement)) return [];
       return [
         {
@@ -89605,7 +89810,7 @@ async function discoverAudioVolumeAutomationFromTimeline(page, audioIds, composi
         }
       };
       for (const { id, start, end } of clips2) {
-        const el = document.getElementById(id) ?? document.getElementById(id.replace(/-audio$/, ""));
+        const el = window.__hfMediaEl?.(id) ?? document.getElementById(id) ?? document.getElementById(id.replace(/-audio$/, ""));
         if (!(el instanceof HTMLAudioElement) && !(el instanceof HTMLVideoElement)) continue;
         const sampleStart = Math.max(0, start);
         const sampleEnd = Math.min(duration, end);
@@ -89681,7 +89886,7 @@ async function discoverVideoVisibilityFromTimeline(page, compositionDuration) {
     const BINARY_PRECISION = 1 / 60;
     const entries2 = [];
     for (const videoEl of videos) {
-      const id = videoEl.id;
+      const id = videoEl.getAttribute?.("data-hf-render-id") || videoEl.id;
       if (!id) continue;
       entries2.push({
         id,
@@ -89828,13 +90033,13 @@ async function runCompileStage(input) {
     abortSignal
   } = input;
   const compileStart = Date.now();
-  const compiled = await compileForRender(projectDir, htmlPath, join27(workDir, "downloads"), {
+  const compiled = await compileForRender(projectDir, htmlPath, join28(workDir, "downloads"), {
     log,
     failClosedFontFetch: failClosedFontFetch === true,
     allowSystemFontCapture,
     abortSignal,
     variables: input.variables,
-    animatedGifCacheDir: cfg.extractCacheDir ? join27(cfg.extractCacheDir, "animated-gif") : void 0,
+    animatedGifCacheDir: cfg.extractCacheDir ? join28(cfg.extractCacheDir, "animated-gif") : void 0,
     ffmpegProcessTimeout: cfg.ffmpegProcessTimeout
   });
   assertNotAborted();
@@ -89896,7 +90101,7 @@ async function runCompileStage(input) {
   };
   await preflightCompositionAssetMediaTypes({
     projectDir,
-    compiledDir: join27(workDir, "compiled"),
+    compiledDir: join28(workDir, "compiled"),
     composition,
     signal: abortSignal
   });
@@ -89944,7 +90149,7 @@ async function runCompileStage(input) {
 init_esm10();
 init_src();
 init_dist2();
-import { join as join28 } from "path";
+import { join as join29 } from "path";
 
 // ../producer/src/services/render/stages/probeFailures.ts
 var NETWORK_FAILURE_PATTERN = /404|ERR_NAME_NOT_RESOLVED|ERR_CONNECTION_REFUSED|net::ERR_/i;
@@ -90045,7 +90250,7 @@ async function runProbeStage(input) {
     });
     fileServer = await createFileServer2({
       projectDir,
-      compiledDir: join28(workDir, "compiled"),
+      compiledDir: join29(workDir, "compiled"),
       port: 0,
       preHeadScripts: [VIRTUAL_TIME_SHIM],
       fps: job.config.fps
@@ -90067,7 +90272,7 @@ async function runProbeStage(input) {
         log.info("Creating capture session...", { attempt, maxAttempts: PROBE_MAX_ATTEMPTS });
         probeSession = await createCaptureSession(
           fileServer.url,
-          join28(workDir, "probe"),
+          join29(workDir, "probe"),
           captureOpts,
           null,
           probeCfg
@@ -90152,7 +90357,7 @@ async function runProbeStage(input) {
         });
         probeSession = await createCaptureSession(
           fileServer.url,
-          join28(workDir, "probe-screenshot"),
+          join29(workDir, "probe-screenshot"),
           captureOpts,
           null,
           { ...probeCfg, forceScreenshot: true }
@@ -90188,7 +90393,7 @@ async function runProbeStage(input) {
           compiled,
           resolutions,
           projectDir,
-          join28(workDir, "downloads")
+          join29(workDir, "downloads")
         );
         assertNotAborted();
         composition.videos = compiled.videos;
@@ -90359,7 +90564,7 @@ async function runProbeStage(input) {
   try {
     await preflightCompositionAssetMediaTypes({
       projectDir,
-      compiledDir: join28(workDir, "compiled"),
+      compiledDir: join29(workDir, "compiled"),
       composition,
       signal: abortSignal
     });
@@ -90487,13 +90692,13 @@ function validateRenderDuration(input) {
 // ../producer/src/services/render/stages/extractVideosStage.ts
 init_src();
 import { existsSync as existsSync26 } from "fs";
-import { join as join29 } from "path";
+import { join as join30 } from "path";
 function shouldCopyExtractedFrames(platform3) {
   return platform3 === "win32";
 }
 function resolveVideoExtractionPolicy(env = process.env) {
   const rawMode = env.HF_VIDEO_EXTRACTION_FAILURE_MODE?.trim().toLowerCase();
-  const failureMode = rawMode === "observe" || rawMode === "enforce" ? rawMode : "off";
+  const failureMode = rawMode === "observe" || rawMode === "off" ? rawMode : "enforce";
   const maxTransientRetries = failureMode !== "off" && env.HF_VIDEO_EXTRACTION_MAX_RETRIES?.trim() === "1" ? 1 : 0;
   return { failureMode, maxTransientRetries };
 }
@@ -90668,7 +90873,7 @@ async function runExtractVideosStage(input) {
       // because short boundary counts can differ by one frame.
       {
         fps: job.config.fps,
-        outputDir: join29(compiledDir, "__hyperframes_video_frames"),
+        outputDir: join30(compiledDir, "__hyperframes_video_frames"),
         format: job.config.videoFrameFormat ?? "auto",
         timelineEnd: composition.duration,
         maxTransientRetries: extractionPolicy.maxTransientRetries,
@@ -90732,7 +90937,7 @@ function appendAutoDetectedVideoAudio(composition, extracted) {
 
 // ../producer/src/services/render/stages/audioStage.ts
 init_src();
-import { join as join30 } from "path";
+import { join as join31 } from "path";
 async function runAudioStage(input) {
   const {
     projectDir,
@@ -90747,7 +90952,7 @@ async function runAudioStage(input) {
     log
   } = input;
   const stage3Start = Date.now();
-  const audioOutputPath = join30(workDir, MIXED_AUDIO_FILENAME);
+  const audioOutputPath = join31(workDir, MIXED_AUDIO_FILENAME);
   let hasAudio = false;
   let audioError;
   let audioFailures;
@@ -90757,7 +90962,7 @@ async function runAudioStage(input) {
       audioResult = await processCompositionAudio(
         audios,
         projectDir,
-        join30(workDir, "audio-work"),
+        join31(workDir, "audio-work"),
         audioOutputPath,
         duration,
         abortSignal,
@@ -90991,7 +91196,7 @@ async function runCaptureStage(input) {
 init_src();
 import { mkdtemp as mkdtemp2, writeFile as writeFile2 } from "fs/promises";
 import { tmpdir as tmpdir6 } from "os";
-import { join as join33 } from "path";
+import { join as join34 } from "path";
 
 // ../producer/src/services/render/stages/captureHdrFrameShared.ts
 init_src();
@@ -90999,7 +91204,7 @@ init_src();
 // ../producer/src/services/hdrCompositor.ts
 init_src();
 import { readSync as readSync2, closeSync as closeSync4 } from "fs";
-import { join as join31 } from "path";
+import { join as join32 } from "path";
 function countNonZeroAlpha(rgba) {
   let n = 0;
   for (let p = 3; p < rgba.length; p += 4) {
@@ -91405,7 +91610,7 @@ async function compositeHdrFrame(ctx, canvas, time, fullStacking, elementFilter,
         if (shouldLog && debugDumpDir) {
           const after2 = countNonZeroRgb48(canvas);
           const dumpName = `frame_${String(debugFrameIndex).padStart(4, "0")}_layer_${String(layerIdx).padStart(2, "0")}_dom.png`;
-          const dumpPath = join31(debugDumpDir, dumpName);
+          const dumpPath = join32(debugDumpDir, dumpName);
           writeFileExclusiveSync(dumpPath, domPng);
           log.info("[diag] dom layer blit", {
             frame: debugFrameIndex,
@@ -91453,7 +91658,7 @@ import {
   rmSync as rmSync10,
   statfsSync
 } from "fs";
-import { join as join32 } from "path";
+import { join as join33 } from "path";
 var NO_FOLLOW_FLAG = constants2.O_NOFOLLOW ?? 0;
 function tempDirSafePrefix(id) {
   const safe = id.replace(/[^A-Za-z0-9_.-]/g, "_").slice(0, 80);
@@ -91697,10 +91902,10 @@ async function extractHdrVideoFrames(args) {
       const window3 = extractionWindows.get(videoId);
       if (!video || !window3) continue;
       mkdirSync14(framesDir, { recursive: true });
-      const frameDir = mkdtempSync6(join32(framesDir, `hdr_${tempDirSafePrefix(videoId)}-`));
+      const frameDir = mkdtempSync6(join33(framesDir, `hdr_${tempDirSafePrefix(videoId)}-`));
       createdFrameDirs.add(frameDir);
       const dims = prep.hdrExtractionDims.get(videoId) ?? { width, height };
-      const rawPath = join32(frameDir, "frames.rgb48le");
+      const rawPath = join33(frameDir, "frames.rgb48le");
       const extractionStart = String(window3.extractionMediaStart ?? window3.mediaStart);
       const ffmpegArgs = [];
       if (window3.finalFrameOnly) {
@@ -92161,11 +92366,11 @@ function createDrainFrameGuard(args) {
         return buf;
       }
       if (db < verifyMinDb) {
-        const dumpDir = await mkdtemp2(join33(tmpdir6(), "hf-de-verify-fail-")).catch(() => null);
+        const dumpDir = await mkdtemp2(join34(tmpdir6(), "hf-de-verify-fail-")).catch(() => null);
         if (dumpDir) {
           await Promise.all([
-            writeFile2(join33(dumpDir, `frame-${idx}-de.jpg`), buf),
-            writeFile2(join33(dumpDir, `frame-${idx}-truth.jpg`), truth)
+            writeFile2(join34(dumpDir, `frame-${idx}-de.jpg`), buf),
+            writeFile2(join34(dumpDir, `frame-${idx}-truth.jpg`), truth)
           ]).catch(() => {
           });
         }
@@ -92560,7 +92765,7 @@ async function runCaptureStreamingStage(input) {
 init_src();
 init_dist2();
 import { existsSync as existsSync28, mkdirSync as mkdirSync15 } from "fs";
-import { join as join37 } from "path";
+import { join as join38 } from "path";
 
 // ../producer/src/services/hdrImageTransferCache.ts
 init_src();
@@ -92624,7 +92829,7 @@ function createHdrImageTransferCache(options = {}) {
 
 // ../producer/src/services/render/stages/captureHdrSequentialLoop.ts
 init_src();
-import { join as join34 } from "path";
+import { join as join35 } from "path";
 async function runSequentialLayeredFrameLoop(input) {
   const {
     job,
@@ -92745,7 +92950,7 @@ async function runSequentialLayeredFrameLoop(input) {
       );
       if (debugDumpEnabled && debugDumpDir && i % 30 === 0) {
         writeFileExclusiveSync(
-          join34(debugDumpDir, `frame_${String(i).padStart(4, "0")}_final_rgb48le.bin`),
+          join35(debugDumpDir, `frame_${String(i).padStart(4, "0")}_final_rgb48le.bin`),
           normalCanvas
         );
       }
@@ -92780,12 +92985,12 @@ async function runSequentialLayeredFrameLoop(input) {
 
 // ../producer/src/services/render/stages/captureHdrHybridLoop.ts
 init_src();
-import { join as join36 } from "path";
+import { join as join37 } from "path";
 
 // ../producer/src/services/shaderTransitionWorkerPool.ts
 import { Worker as Worker2 } from "worker_threads";
 import { fileURLToPath as fileURLToPath4, pathToFileURL as pathToFileURL2 } from "url";
-import { dirname as dirname14, join as join35 } from "path";
+import { dirname as dirname14, join as join36 } from "path";
 import { createRequire as createRequire2 } from "module";
 import { existsSync as existsSync27 } from "fs";
 import { cpus as cpus3 } from "os";
@@ -92799,9 +93004,9 @@ function resolveWorkerEntry(explicit) {
     return { path: override, isTs };
   }
   const moduleDir = dirname14(fileURLToPath4(import.meta.url));
-  const jsPath = join35(moduleDir, "shaderTransitionWorker.js");
+  const jsPath = join36(moduleDir, "shaderTransitionWorker.js");
   if (existsSync27(jsPath)) return { path: jsPath, isTs: false };
-  const tsPath = join35(moduleDir, "shaderTransitionWorker.ts");
+  const tsPath = join36(moduleDir, "shaderTransitionWorker.ts");
   return { path: tsPath, isTs: true };
 }
 function buildExecArgv(entryIsTs) {
@@ -93171,7 +93376,7 @@ async function runHybridLayeredFrameLoop(input) {
           );
           if (debugDumpEnabled && debugDumpDir && i % 30 === 0) {
             writeFileExclusiveSync(
-              join36(debugDumpDir, `frame_${String(i).padStart(4, "0")}_final_rgb48le.bin`),
+              join37(debugDumpDir, `frame_${String(i).padStart(4, "0")}_final_rgb48le.bin`),
               canvas
             );
           }
@@ -93357,7 +93562,7 @@ async function runCaptureHdrStage(input) {
         if (hdrVideoFrameSources.has(v.id)) hdrVideoEndTimes.set(v.id, v.end);
       }
       const debugDumpEnabled = process.env.KEEP_TEMP === "1";
-      const debugDumpDir = debugDumpEnabled ? join37(framesDir, "debug-composite") : null;
+      const debugDumpDir = debugDumpEnabled ? join38(framesDir, "debug-composite") : null;
       if (debugDumpDir && !existsSync28(debugDumpDir)) {
         mkdirSync15(debugDumpDir, { recursive: true });
       }
@@ -93509,10 +93714,10 @@ async function runCaptureHdrStage(input) {
 // ../producer/src/services/render/stages/encodeStage.ts
 init_src();
 import { copyFileSync as copyFileSync5, existsSync as existsSync29, mkdirSync as mkdirSync16, readdirSync as readdirSync10, rmSync as rmSync11, statSync as statSync9 } from "fs";
-import { dirname as dirname15, join as join39 } from "path";
+import { dirname as dirname15, join as join40 } from "path";
 
 // ../producer/src/services/render/stages/gifEncodeArgs.ts
-import { join as join38 } from "path";
+import { join as join39 } from "path";
 function fpsToFfmpegArg2(fps) {
   return fps.den === 1 ? String(fps.num) : `${fps.num}/${fps.den}`;
 }
@@ -93524,7 +93729,7 @@ function buildGifPalettegenArgs(input) {
     "-framerate",
     fpsArg,
     "-i",
-    join38(input.framesDir, input.framePattern),
+    join39(input.framesDir, input.framePattern),
     "-vf",
     `fps=${fpsArg},palettegen=stats_mode=diff${transparency}`,
     input.palettePath
@@ -93538,7 +93743,7 @@ function buildGifPaletteuseArgs(input) {
     "-framerate",
     fpsArg,
     "-i",
-    join38(input.framesDir, input.framePattern),
+    join39(input.framesDir, input.framePattern),
     "-i",
     input.palettePath,
     "-lavfi",
@@ -93655,11 +93860,11 @@ async function runEncodeStage(input) {
       );
     }
     captured.forEach((name, i) => {
-      const dst = join39(outputPath, formatExportFrameName(i, "png"));
-      copyFileSync5(join39(framesDir, name), dst);
+      const dst = join40(outputPath, formatExportFrameName(i, "png"));
+      copyFileSync5(join40(framesDir, name), dst);
     });
     if (hasAudio && audioOutputPath && existsSync29(audioOutputPath)) {
-      copyFileSync5(audioOutputPath, join39(outputPath, MIXED_AUDIO_FILENAME));
+      copyFileSync5(audioOutputPath, join40(outputPath, MIXED_AUDIO_FILENAME));
       log.info(
         `[Render] png-sequence: ${MIXED_AUDIO_FILENAME} sidecar written to ${outputPath}/${MIXED_AUDIO_FILENAME}`
       );
@@ -93678,7 +93883,7 @@ async function runEncodeStage(input) {
     const encodeResult2 = await encodeGifFromDir(framesDir, framePattern2, outputPath, {
       fps: job.config.fps,
       loop,
-      palettePath: join39(dirname15(videoOnlyPath), "gif-palette.png"),
+      palettePath: join40(dirname15(videoOnlyPath), "gif-palette.png"),
       preserveAlpha: needsAlpha,
       signal: abortSignal,
       timeout: engineCfg.ffmpegEncodeTimeout
@@ -94044,8 +94249,7 @@ async function runAssembleStage(input) {
       outputPath,
       abortSignal,
       {
-        audioCodec: "aac",
-        preserveAudioPrimingEditList: normalizeResult.operation !== "copy"
+        audioCodec: "aac"
       },
       job.config.fps
     );
@@ -94083,7 +94287,7 @@ function sampleDirectoryBytes(dir) {
       continue;
     }
     for (const name of entries2) {
-      const full = join40(current2, name);
+      const full = join41(current2, name);
       try {
         const st = statSync10(full);
         if (st.isDirectory()) {
@@ -94166,7 +94370,10 @@ function applyRenderWarningPolicy(job, captureWarnings, log = defaultLogger) {
   const hasAudioProcessingFailure = job.warnings.some(
     (warning) => warning.code === "audio_processing_failed"
   );
-  if (strictness === "strict" || hasAudioProcessingFailure) {
+  const hasSubTimelineScriptFailure = job.warnings.some(
+    (warning) => warning.code === "sub_timeline_script_failure"
+  );
+  if (strictness === "strict" || hasAudioProcessingFailure || hasSubTimelineScriptFailure) {
     throw new RenderQualityError(job.warnings);
   }
 }
@@ -94228,7 +94435,7 @@ function findMissingFrameRanges(totalFrames, framesDir, frameExt) {
   const ranges = [];
   let rangeStart = null;
   for (let frameIndex = 0; frameIndex < totalFrames; frameIndex++) {
-    const framePath = join40(framesDir, formatCaptureFrameName(frameIndex, frameExt));
+    const framePath = join41(framesDir, formatCaptureFrameName(frameIndex, frameExt));
     const missing = !existsSync30(framePath) || statSync10(framePath).size <= 8;
     if (missing && rangeStart === null) {
       rangeStart = frameIndex;
@@ -94251,7 +94458,7 @@ function buildMissingFrameRetryBatches(ranges, maxWorkers, workDir, attempt, ran
       workerId,
       startFrame: rangeStart + range.startFrame,
       endFrame: rangeStart + range.endFrame,
-      outputDir: join40(workDir, `retry-${attempt}-batch-${batchIndex}-worker-${workerId}`),
+      outputDir: join41(workDir, `retry-${attempt}-batch-${batchIndex}-worker-${workerId}`),
       outputFrameOffset: rangeStart
     }));
     batches.push(batch);
@@ -94274,8 +94481,8 @@ function getNextRetryWorkerCount(currentWorkers) {
   return Math.max(1, Math.floor(currentWorkers / 2));
 }
 function resolveRenderWorkDirPrefix(outputPath, jobId, platform3 = process.platform, systemTempDir = tmpdir7()) {
-  if (platform3 === "win32") return join40(systemTempDir, "hf-render-");
-  return join40(dirname16(outputPath), `work-${jobId}-`);
+  if (platform3 === "win32") return join41(systemTempDir, "hf-render-");
+  return join41(dirname16(outputPath), `work-${jobId}-`);
 }
 var MAX_TRANSIENT_CAPTURE_RETRIES = 1;
 function captureAttemptMadeProgress(attemptTargetFrameCount, remainingFrameCount) {
@@ -94304,7 +94511,7 @@ The composition is too large for the available memory. To reduce memory pressure
 function countCapturedFrames(totalFrames, framesDir, frameExt) {
   let captured = 0;
   for (let frameIndex = 0; frameIndex < totalFrames; frameIndex++) {
-    const framePath = join40(framesDir, formatCaptureFrameName(frameIndex, frameExt));
+    const framePath = join41(framesDir, formatCaptureFrameName(frameIndex, frameExt));
     if (existsSync30(framePath)) captured++;
   }
   return captured;
@@ -94329,7 +94536,7 @@ async function executeDiskCaptureWithAdaptiveRetry(options) {
       reason: attempt === 0 ? "initial" : pendingTransientRetry ? "transient-retry" : "retry"
     });
     pendingTransientRetry = false;
-    const attemptWorkDir = join40(options.workDir, `capture-attempt-${attempt}`);
+    const attemptWorkDir = join41(options.workDir, `capture-attempt-${attempt}`);
     const batches = missingRanges ? buildMissingFrameRetryBatches(
       missingRanges,
       currentWorkers,
@@ -94668,13 +94875,13 @@ function deVerifyFallbackTelemetry(err) {
 async function executeRenderJob(job, projectDir, outputPath, progressSink, abortSignal) {
   const moduleDir = dirname16(fileURLToPath5(import.meta.url));
   const producerRoot = process.env.PRODUCER_RENDERS_DIR ? resolve13(process.env.PRODUCER_RENDERS_DIR, "..") : resolve13(moduleDir, "../..");
-  const debugDir = join40(producerRoot, ".debug");
+  const debugDir = join41(producerRoot, ".debug");
   const outputDir = dirname16(outputPath);
   if (!existsSync30(outputDir)) mkdirSync17(outputDir, { recursive: true });
-  const workDir = job.config.debug ? join40(debugDir, job.id) : mkdtempSync7(resolveRenderWorkDirPrefix(outputPath, job.id));
+  const workDir = job.config.debug ? join41(debugDir, job.id) : mkdtempSync7(resolveRenderWorkDirPrefix(outputPath, job.id));
   const pipelineStart = Date.now();
   const baseLog = job.config.logger ?? defaultLogger;
-  const logPath = job.config.debug ? join40(workDir, "render.log") : null;
+  const logPath = job.config.debug ? join41(workDir, "render.log") : null;
   const execution = new RenderExecutionContext({
     request: { renderJobId: job.id, projectDir, outputPath },
     logger: logPath ? createRenderFileLogger(logPath, baseLog) : baseLog,
@@ -94722,7 +94929,7 @@ async function executeRenderPipeline(input) {
     imageDecodeFailures: 0
   };
   let hdrPerf;
-  const perfOutputPath = join40(workDir, "perf-summary.json");
+  const perfOutputPath = join41(workDir, "perf-summary.json");
   const cfg = { ...job.config.producerConfig ?? resolveConfig() };
   const observability = new RenderObservabilityRecorder({
     pipelineStartMs: pipelineStart,
@@ -94814,15 +95021,15 @@ async function executeRenderPipeline(input) {
       requestedWorkers: job.config.workers ?? "auto"
     });
     const entryFile = job.config.entryFile || "index.html";
-    let htmlPath = join40(projectDir, entryFile);
+    let htmlPath = join41(projectDir, entryFile);
     if (!existsSync30(htmlPath)) {
       throw new Error(`Entry file not found: ${htmlPath}`);
     }
     assertNotAborted();
     const rawEntry = readFileSync12(htmlPath, "utf-8");
     if (entryFile !== "index.html" && rawEntry.trimStart().startsWith("<template")) {
-      const wrapperPath = join40(workDir, "standalone-entry.html");
-      const projectIndexPath = join40(projectDir, "index.html");
+      const wrapperPath = join41(workDir, "standalone-entry.html");
+      const projectIndexPath = join41(projectDir, "index.html");
       if (!existsSync30(projectIndexPath)) {
         throw new Error(
           `Template entry file "${entryFile}" requires a project index.html to extract its render shell.`
@@ -94977,7 +95184,7 @@ async function executeRenderPipeline(input) {
       beginFrameStalled: probeResult.beginFrameStalled
     });
     updateJobStatus(job, "preprocessing", "Extracting video frames", 10, onProgress);
-    const compiledDir = join40(workDir, "compiled");
+    const compiledDir = join41(workDir, "compiled");
     const extractResult = await observeRenderStage(
       observability,
       "video_extract",
@@ -95097,7 +95304,7 @@ async function executeRenderPipeline(input) {
       try {
         fileServer = await createFileServer2({
           projectDir,
-          compiledDir: join40(workDir, "compiled"),
+          compiledDir: join41(workDir, "compiled"),
           port: 0,
           preHeadScripts: [VIRTUAL_TIME_SHIM],
           fps: job.config.fps
@@ -95115,7 +95322,7 @@ async function executeRenderPipeline(input) {
     if (!activeFileServer) {
       throw new Error("File server failed to initialize before frame capture");
     }
-    const framesDir = join40(workDir, "captured-frames");
+    const framesDir = join41(workDir, "captured-frames");
     if (!existsSync30(framesDir)) mkdirSync17(framesDir, { recursive: true });
     const resolvedBrowserGpuMode = await resolveBrowserGpuMode(cfg.browserGpuMode, {
       chromePath: resolveHeadlessShellPath(cfg),
@@ -95440,7 +95647,7 @@ async function executeRenderPipeline(input) {
       gif: ".gif"
     };
     const videoExt = FORMAT_EXT[outputFormat] ?? ".mp4";
-    const videoOnlyPath = join40(workDir, `video-only${videoExt}`);
+    const videoOnlyPath = join41(workDir, `video-only${videoExt}`);
     const usePageSideCompositingForTransitions = (cfg.enablePageSideCompositing || isGif) && compiled.hasShaderTransitions && !hasHdrContent && outputSupportsPageSideShaderCompositing(outputFormat);
     if (usePageSideCompositingForTransitions) {
       activeFileServer.addPreHeadScript(HF_PAGE_SIDE_COMPOSITING_STUB);
@@ -95958,7 +96165,13 @@ async function executeRenderPipeline(input) {
     } else {
       observability.checkpoint("assemble", `skipped for ${outputFormat}`);
     }
-    artifactTransaction.validate();
+    await artifactTransaction.validate(
+      !isPngSequence && !isGif && Number.isFinite(job.duration) && job.duration > 0 ? {
+        expectedDurationSeconds: job.duration,
+        fps: fpsToNumber(job.config.fps),
+        expectedFrames: captureTotalFrames
+      } : void 0
+    );
     const totalElapsed = Date.now() - pipelineStart;
     const tmpPeakBytes = existsSync30(workDir) ? sampleDirectoryBytes(workDir) : 0;
     recordTransientRetryObservability();
@@ -96026,11 +96239,11 @@ async function executeRenderPipeline(input) {
     }
     if (job.config.debug) {
       if (!isPngSequence && existsSync30(stagedOutputPath)) {
-        const debugOutput = join40(workDir, `output${videoExt}`);
+        const debugOutput = join41(workDir, `output${videoExt}`);
         copyFileSync6(stagedOutputPath, debugOutput);
       }
     }
-    artifactTransaction.commit();
+    await artifactTransaction.commit();
     job.outputPath = outputPath;
     updateJobStatus(job, "complete", "Render complete", 100, onProgress);
     await eventPublisher.flush();
@@ -96363,7 +96576,7 @@ import {
   rmSync as rmSync14,
   createReadStream as createReadStream5
 } from "fs";
-import { resolve as resolve15, dirname as dirname18, join as join43 } from "path";
+import { resolve as resolve15, dirname as dirname18, join as join44 } from "path";
 import { tmpdir as tmpdir8 } from "os";
 import { parseArgs } from "util";
 import crypto from "crypto";
@@ -96374,7 +96587,7 @@ import { serve as serve3 } from "@hono/node-server";
 // ../producer/src/services/hyperframeLint.ts
 init_dist3();
 import { existsSync as existsSync31, readFileSync as readFileSync13, statSync as statSync11 } from "fs";
-import { resolve as resolve14, join as join41 } from "path";
+import { resolve as resolve14, join as join42 } from "path";
 function isStringRecord(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return false;
@@ -96422,7 +96635,7 @@ function readProjectEntryFile(projectDir, preferredEntryFile) {
     }
   }
   return {
-    error: `No HTML entry file found in project directory: ${join41(absProjectDir, preferredEntryFile || "index.html")}`
+    error: `No HTML entry file found in project directory: ${join42(absProjectDir, preferredEntryFile || "index.html")}`
   };
 }
 function prepareHyperframeLintBody(body) {
@@ -96465,7 +96678,7 @@ async function runHyperframeLint(prepared) {
 // ../producer/src/services/healthWorker.ts
 import { Worker as Worker3 } from "worker_threads";
 import { fileURLToPath as fileURLToPath6 } from "url";
-import { dirname as dirname17, join as join42 } from "path";
+import { dirname as dirname17, join as join43 } from "path";
 import { existsSync as existsSync32 } from "fs";
 var DEFAULT_HEALTH_PORT = 9848;
 async function startHealthWorker(options = {}) {
@@ -96541,7 +96754,7 @@ function defaultLogger2() {
 }
 function resolveWorkerEntry2() {
   const here = dirname17(fileURLToPath6(import.meta.url));
-  const candidates = [join42(here, "healthWorkerThread.js"), join42(here, "healthWorkerThread.ts")];
+  const candidates = [join43(here, "healthWorkerThread.js"), join43(here, "healthWorkerThread.ts")];
   for (const candidate of candidates) {
     if (existsSync32(candidate)) return candidate;
   }
@@ -96743,8 +96956,8 @@ async function resolveInlineRenderHtml(body) {
 }
 function materializeInlineProject(html, options) {
   const tempRoot = process.env.PRODUCER_TMP_PROJECT_DIR || tmpdir8();
-  const tempProjectDir = mkdtempSync8(join43(tempRoot, "producer-project-"));
-  writeFileSync11(join43(tempProjectDir, "index.html"), html, "utf-8");
+  const tempProjectDir = mkdtempSync8(join44(tempRoot, "producer-project-"));
+  writeFileSync11(join44(tempProjectDir, "index.html"), html, "utf-8");
   return {
     prepared: {
       input: { projectDir: tempProjectDir, ...options },
@@ -97193,11 +97406,11 @@ init_src();
 init_dist2();
 init_src();
 import { cpSync as cpSync2, existsSync as existsSync36, mkdirSync as mkdirSync20, renameSync as renameSync6, rmSync as rmSync15, writeFileSync as writeFileSync13 } from "fs";
-import { join as join47, relative as relative4, sep as sep4 } from "path";
+import { join as join48, relative as relative4, sep as sep4 } from "path";
 
 // ../producer/src/services/render/stages/freezePlan.ts
 import { existsSync as existsSync34, mkdirSync as mkdirSync19, readFileSync as readFileSync14, readdirSync as readdirSync12, writeFileSync as writeFileSync12 } from "fs";
-import { join as join44, relative as relative2, resolve as resolve16 } from "path";
+import { join as join45, relative as relative2, resolve as resolve16 } from "path";
 
 // ../producer/src/services/distributed/planProtocol.ts
 var PLAN_SCHEMA_VERSION = 1;
@@ -97239,7 +97452,7 @@ var FIELD_DELIMITER = Buffer.from([0]);
 // ../producer/src/services/distributed/shared.ts
 init_src();
 import { execFile as execFileCallback } from "child_process";
-import { dirname as dirname19, join as join45 } from "path";
+import { dirname as dirname19, join as join46 } from "path";
 import { existsSync as existsSync35, readFileSync as readFileSync15 } from "fs";
 import { fileURLToPath as fileURLToPath7 } from "url";
 import { promisify as promisify3 } from "util";
@@ -97249,7 +97462,7 @@ var execFile3 = promisify3(execFileCallback);
 // ../producer/src/services/distributed/planSize.ts
 import { createHash as createHash10 } from "crypto";
 import { lstatSync as lstatSync4, readdirSync as readdirSync13 } from "fs";
-import { extname as extname7, join as join46, relative as relative3 } from "path";
+import { extname as extname7, join as join47, relative as relative3 } from "path";
 var PLAN_ROOT_CATEGORY = {
   compiled: "compiled",
   [PLAN_AUDIO_RELATIVE_PATH]: "audio",
@@ -97261,9 +97474,9 @@ var PLAN_ROOT_CATEGORY = {
 var PLAN_DIR_SIZE_LIMIT_BYTES = 2 * 1024 * 1024 * 1024;
 var FREEZE_OWNED_PLAN_FILES = [
   "plan.json",
-  join47("meta", "composition.json"),
-  join47("meta", "encoder.json"),
-  join47("meta", "chunks.json")
+  join48("meta", "composition.json"),
+  join48("meta", "encoder.json"),
+  join48("meta", "chunks.json")
 ];
 
 // ../producer/src/services/distributed/planV2.ts
@@ -97286,7 +97499,7 @@ import {
 } from "fs";
 import { createHash as createHash11 } from "crypto";
 import { tmpdir as tmpdir9 } from "os";
-import { dirname as dirname21, isAbsolute as isAbsolute4, join as join50, relative as relative5, resolve as resolve17, sep as sep5 } from "path";
+import { dirname as dirname21, isAbsolute as isAbsolute4, join as join51, relative as relative5, resolve as resolve17, sep as sep5 } from "path";
 
 // ../producer/src/services/distributed/planV2Publisher.ts
 import {
@@ -97300,15 +97513,15 @@ import {
   statSync as statSync13,
   writeFileSync as writeFileSync14
 } from "fs";
-import { dirname as dirname20, join as join49 } from "path";
+import { dirname as dirname20, join as join50 } from "path";
 
 // ../producer/src/services/distributed/planV2Layout.ts
-import { join as join48 } from "path";
+import { join as join49 } from "path";
 
 // ../producer/src/services/distributed/planV2Execution.ts
 import { mkdtempSync as mkdtempSync11, rmSync as rmSync20 } from "fs";
 import { tmpdir as tmpdir10 } from "os";
-import { join as join53 } from "path";
+import { join as join54 } from "path";
 
 // ../producer/src/services/distributed/assemble.ts
 init_src();
@@ -97323,19 +97536,19 @@ import {
   statSync as statSync15,
   writeFileSync as writeFileSync16
 } from "fs";
-import { dirname as dirname22, join as join51 } from "path";
+import { dirname as dirname22, join as join52 } from "path";
 
 // ../producer/src/services/distributed/renderChunk.ts
 init_src();
 import { randomBytes as randomBytes2 } from "crypto";
 import { existsSync as existsSync40, mkdirSync as mkdirSync24, readFileSync as readFileSync18, readdirSync as readdirSync16, rmSync as rmSync19, writeFileSync as writeFileSync17 } from "fs";
-import { extname as extname8, join as join52 } from "path";
+import { extname as extname8, join as join53 } from "path";
 init_src();
 
 // ../producer/src/services/distributed/projectHash.ts
 import { readdirSync as readdirSync17, readFileSync as readFileSync19 } from "fs";
 import { createHash as createHash12 } from "crypto";
-import { join as join54, relative as relative6 } from "path";
+import { join as join55, relative as relative6 } from "path";
 
 // src/fontLocalize.ts
 function safeVersion(version2) {
@@ -97376,8 +97589,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.15" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.15" : "0.0.0-dev";
+var VERSION = true ? "0.8.17" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.17" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {