hyperframes 0.8.190 → 0.8.192

package/dist/{chunk-OAPYPSEB.js → chunk-QX4TB4NH.js}

@@ -26,7 +26,7 @@ import {
   renderFrameIdForRenderId,
   resolveAuthoredTimingWindow,
   toFps
-} from "./chunk-56IOFIYB.js";
+} from "./chunk-MGBUWPXX.js";
 import {
   AUDIO_GROUP_RENDER_ID_ATTR,
   COLOR_GRADING_SOURCE_HIDDEN_ATTR,
@@ -63,7 +63,7 @@ import {
   sourceTimeAt,
   timeAtSourceTime,
   volumeSegmentSampleCount
-} from "./chunk-DIV37NUE.js";
+} from "./chunk-B2XLXD7V.js";
 import {
   clampAudioGain,
   clipGain,
@@ -83,7 +83,7 @@ import {
 } from "./chunk-4UMPIPCQ.js";
 import {
   resolveReferencedStart
-} from "./chunk-TSFA2Y5C.js";
+} from "./chunk-2VXY3PEF.js";
 import {
   FFMPEG_PATH_ENV,
   FFPROBE_PATH_ENV,
@@ -3735,6 +3735,7 @@ async function produceDrawElementFrameBatch(page, times, width, height, quality
         const { t, fid } = frame;
         try {
           if (aw.__hf && typeof aw.__hf.seek === "function") aw.__hf.seek(t);
+          await aw.__hfWaitForSeekCompletion?.();
           await aw.__hfDecodeDynamicCssBackgroundImages?.();
           aw.__hf3d?.update();
           const accel = (aw.__hf_accel_canvases ?? []).filter((c) => root.contains(c));
@@ -4777,8 +4778,11 @@ async function sampleProcessRss(pids, exec = defaultExec(), platform = process.p
     if (platform === "win32") {
       const results = [];
       for (const pid of unique) {
-        const { stdout: stdout2 } = await exec("tasklist", ["/FO", "CSV", "/NH", "/FI", `PID eq ${pid}`]);
-        results.push(...parseTasklistCsv(pid, stdout2));
+        try {
+          const { stdout: stdout2 } = await exec("tasklist", ["/FO", "CSV", "/NH", "/FI", `PID eq ${pid}`]);
+          results.push(...parseTasklistCsv(pid, stdout2));
+        } catch {
+        }
       }
       return results;
     }
@@ -5738,16 +5742,60 @@ async function listUnregisteredTimelineIds(page) {
   })()`);
   return Array.isArray(evaluated) ? evaluated.map((id) => String(id)) : [];
 }
-async function waitForSubCompositionTimelines(session, page, timeoutMs) {
+function isScriptFailure(session) {
+  const outcome = session.subTimelineWaitOutcome;
+  return outcome === "script_failure" || outcome === "timeout" && session.pageErrors.length > 0;
+}
+async function isolateUnregisteredCompositions(page) {
+  const isolated = await page.evaluate(`(function() {
+    var timelines = (window.__timelines = window.__timelines || {});
+    var out = [];
+    if (!window.gsap) return out;
+    var broken = [];
+    var live = 0;
+    var hosts = document.querySelectorAll("[data-composition-id]");
+    for (var i = 0; i < hosts.length; i++) {
+      var host = hosts[i];
+      var id = host.getAttribute("data-composition-id");
+      if (!id || host.hasAttribute("data-no-timeline")) continue;
+      var isRoot = !host.parentElement || !host.parentElement.closest("[data-composition-id]");
+      if (timelines[id]) {
+        if (!isRoot) live++;
+      } else if (isRoot) {
+        return out;
+      } else {
+        broken.push(host);
+      }
+    }
+    if (live === 0) return out;
+    broken.forEach(function(host) {
+      var tl = window.gsap.timeline({ paused: true });
+      var duration = parseFloat(host.getAttribute("data-duration"));
+      if (duration > 0) tl.set({}, {}, duration);
+      var id = host.getAttribute("data-composition-id");
+      timelines[id] = tl;
+      out.push({ compositionId: id, elementId: host.id || host.getAttribute("data-hf-id") || null });
+    });
+    if (out.length && typeof window.__hfForceTimelineRebind === "function") window.__hfForceTimelineRebind();
+    return out;
+  })()`);
+  return Array.isArray(isolated) ? isolated : [];
+}
+async function waitForSubCompositionTimelines(session, page, timeoutMs, options = {}) {
   const memo = session.subTimelineWaitMemo;
   session.subTimelineWaitOutcome = await pollSubCompositionTimelines(page, timeoutMs, {
     getScriptLoadFailures: () => session.scriptLoadFailures,
+    getPageErrors: () => session.pageErrors,
+    scriptErrorGraceMs: options.scriptErrorGraceMs,
     onPending: (ids) => {
       session.pendingTimelineIds = [...ids];
     },
     shouldStop: () => session.vfxFailure !== void 0,
     knownUnregisteredIds: memo.unregisteredIds
   });
+  if (isScriptFailure(session) && session.scriptLoadFailures.length === 0) {
+    session.isolatedCompositions = await isolateUnregisteredCompositions(page);
+  }
   const cleanTimeout = session.subTimelineWaitOutcome === "timeout" && session.vfxFailure === void 0 && session.pageErrors.length === 0 && session.scriptLoadFailures.length === 0;
   if (cleanTimeout) {
     memo.unregisteredIds = session.pendingTimelineIds ?? [];
@@ -5757,6 +5805,8 @@ async function pollSubCompositionTimelines(page, timeoutMs, {
   intervalMs = 150,
   getScriptLoadFailures,
   scriptFailureGraceMs = 2e3,
+  getPageErrors,
+  scriptErrorGraceMs = 5e3,
   onPending,
   shouldStop,
   knownUnregisteredIds = []
@@ -5778,16 +5828,22 @@ async function pollSubCompositionTimelines(page, timeoutMs, {
   const deadline = start + timeoutMs;
   let ready = false;
   let scriptFailureBail = false;
+  let errorSeenAt;
   for (; ; ) {
     ready = Boolean(await page.evaluate(expression));
     if (ready || shouldStop?.()) break;
     const now = Date.now();
     if (now >= deadline) break;
     const failures = getScriptLoadFailures?.() ?? [];
-    if (failures.length > 0 && now - start >= scriptFailureGraceMs) {
+    const errors = getPageErrors?.() ?? [];
+    const failed = failures.length > 0 ? failures : errors;
+    const graceMs = failures.length > 0 ? scriptFailureGraceMs : scriptErrorGraceMs;
+    if (failed.length > 0) errorSeenAt ??= now;
+    const sinceFailure = failures.length > 0 ? now - start : now - (errorSeenAt ?? now);
+    if (failed.length > 0 && sinceFailure >= graceMs) {
       scriptFailureBail = true;
       console.warn(
-        `[FrameCapture] Sub-composition timeline wait cut short after ${now - start}ms: script resource(s) failed to load (${failures.join(", ")}), so the timeline registration they carry can never arrive. Fix the script reference; the render proceeds without those animations.`
+        `[FrameCapture] Sub-composition timeline wait cut short after ${now - start}ms: script(s) failed (${failed.join(", ")}), so the timeline registration they carry can never arrive. Fix the script.`
       );
       break;
     }
@@ -5821,7 +5877,7 @@ async function pollVideosReady(page, skipIds, timeoutMs, intervalMs = 100) {
     return Boolean(
       await page.evaluate((skipIdList) => {
         const skip = new Set(skipIdList);
-        const vids = Array.from(document.querySelectorAll("video")).filter((v) => !skip.has(v.id));
+        const vids = Array.from(document.querySelectorAll("video")).filter((v) => !skip.has(v.id)).filter((v) => !v.closest("[data-hidden]"));
         return vids.length === 0 || vids.every((v) => {
           const ve = v;
           if (ve.readyState >= 2) return true;
@@ -5935,15 +5991,31 @@ function recordCaptureWarnings(session, warnings) {
 function recordSubTimelineWarning(session, timeoutMs) {
   const outcome = session.subTimelineWaitOutcome;
   if (outcome === "ready" || !outcome) return;
-  const threwThenTimedOut = outcome === "timeout" && session.pageErrors.length > 0;
-  const scriptFailure = outcome === "script_failure" || threwThenTimedOut;
+  const threwThenTimedOut = session.pageErrors.length > 0 && session.scriptLoadFailures.length === 0;
+  const scriptFailure = isScriptFailure(session);
   const sources = [...session.scriptLoadFailures, ...session.pageErrors];
   const pending = session.pendingTimelineIds ?? [];
   const pendingSuffix = pending.length > 0 ? ` (still unregistered: ${pending.join(", ")})` : "";
+  const isolated = session.isolatedCompositions ?? [];
+  if (isolated.length > 0) {
+    recordCaptureWarnings(session, [
+      {
+        code: "script_error_isolated",
+        message: `A composition script failed, so its animation was skipped and the render went on: ${isolated.map((c) => c.elementId ?? c.compositionId).join(", ")} (${sources.join(", ")}).`,
+        details: {
+          sources,
+          pendingCompositionIds: [...pending],
+          isolatedElements: isolated,
+          failureOwner: "user"
+        }
+      }
+    ]);
+    return;
+  }
   recordCaptureWarnings(session, [
     {
       code: scriptFailure ? "sub_timeline_script_failure" : "sub_timeline_readiness_timeout",
-      message: threwThenTimedOut ? `A composition script threw and a timeline did not register within ${timeoutMs}ms${pendingSuffix} (${sources.join(", ")}). Fix the error; a composition animated by CSS or rAF rather than a GSAP timeline must mark its host with data-no-timeline.` : scriptFailure ? `A sub-composition timeline script failed to load (${sources.join(", ")})` : `Sub-composition timelines did not become ready within ${timeoutMs}ms${pendingSuffix}. This can be intentional: a composition driven by CSS animations or rAF never registers window.__timelines[id], and marking its host with data-no-timeline skips the wait entirely. Otherwise, a composition that sets up asynchronously must register window.__timelines[id] once setup completes.`,
+      message: threwThenTimedOut ? `A composition script threw before its timeline registered${pendingSuffix} (${sources.join(", ")}). Fix the error; a composition animated by CSS or rAF rather than a GSAP timeline must mark its host with data-no-timeline.` : scriptFailure ? `A sub-composition timeline script failed to load (${sources.join(", ")})` : `Sub-composition timelines did not become ready within ${timeoutMs}ms${pendingSuffix}. This can be intentional: a composition driven by CSS animations or rAF never registers window.__timelines[id], and marking its host with data-no-timeline skips the wait entirely. Otherwise, a composition that sets up asynchronously must register window.__timelines[id] once setup completes.`,
       details: {
         timeoutMs,
         sources,
@@ -6219,7 +6291,7 @@ async function initializeSession(session) {
     if (!videosReady) {
       const failedVideos = await page.evaluate((skipIdList) => {
         const skip = new Set(skipIdList);
-        return Array.from(document.querySelectorAll("video")).filter((v) => !skip.has(v.id)).filter((v) => v.readyState < 2 && !v.error).map((v) => v.src || v.getAttribute("src") || "(no src)").join(", ");
+        return Array.from(document.querySelectorAll("video")).filter((v) => !skip.has(v.id)).filter((v) => !v.closest("[data-hidden]")).filter((v) => v.readyState < 2 && !v.error).map((v) => v.src || v.getAttribute("src") || "(no src)").join(", ");
       }, skipVideoIds);
       console.warn(
         `[FrameCapture] Some video elements did not decode within ${pageReadyTimeout}ms: ${failedVideos}. Continuing render. Affected videos will appear as blank/black frames.`
@@ -6315,7 +6387,7 @@ async function initializeSession(session) {
     if (!bfVideosReady) {
       const failedVideos = await page.evaluate((skipIdList) => {
         const skip = new Set(skipIdList);
-        return Array.from(document.querySelectorAll("video")).filter((v) => !skip.has(v.id)).filter((v) => v.readyState < 2 && !v.error).map((v) => v.src || v.getAttribute("src") || "(no src)").join(", ");
+        return Array.from(document.querySelectorAll("video")).filter((v) => !skip.has(v.id)).filter((v) => !v.closest("[data-hidden]")).filter((v) => v.readyState < 2 && !v.error).map((v) => v.src || v.getAttribute("src") || "(no src)").join(", ");
       }, bfSkipVideoIds);
       console.warn(
         `[FrameCapture] Some video elements did not decode within ${pageReadyTimeout}ms: ${failedVideos}. Continuing render. Affected videos will appear as blank/black frames.`
@@ -7028,6 +7100,44 @@ function resolveSessionMotionBlur(session) {
   }
   return plan;
 }
+async function judgeSmallDrawElementFrame(session, frameIndex, buffer, redraw) {
+  const sizes = session.deFrameSizes ??= [];
+  const sorted = sizes.length >= 12 ? [...sizes].sort((a, b) => a - b) : null;
+  const median = sorted ? sorted[sorted.length >> 1] ?? 0 : 0;
+  const floor = Math.max(session.deAbsFloor ?? 2e4, median * 0.12);
+  let kept = buffer;
+  if (buffer.length < floor && !session.deAcceptedSmall?.equals(buffer)) {
+    const suspect = () => new DrawElementCaptureError(
+      frameIndex,
+      `suspect small frame (${buffer.length}B < ${Math.round(floor)}B)`
+    );
+    if (session.beginFrameTimeTicks > 0) throw suspect();
+    const retry = await redraw();
+    if (retry.equals(buffer)) {
+      session.deAbsFloor = Math.min(session.deAbsFloor ?? 2e4, Math.floor(buffer.length / 2));
+      session.deAcceptedSmall = buffer;
+    } else if (retry.length < floor) {
+      throw suspect();
+    } else {
+      kept = retry;
+    }
+  }
+  if (sizes.length >= 60) sizes.shift();
+  sizes.push(kept.length);
+  return kept;
+}
+async function redrawDrawElementFrame(session, frameIndex, time, seekOptions, heldVideoTime) {
+  const { page, options } = session;
+  await prepareFrameForCapture(session, frameIndex, time, seekOptions, heldVideoTime);
+  return captureDrawElementFrame(
+    page,
+    options.width,
+    options.height,
+    options.format ?? "jpeg",
+    options.quality ?? 80,
+    true
+  );
+}
 async function captureFrameSurface(session, frameIndex, time, seekOptions, heldVideoTime) {
   const { page, options } = session;
   const { quantizedTime, seekMs, beforeCaptureMs } = await prepareFrameForCapture(
@@ -7087,19 +7197,12 @@ async function captureFrameSurface(session, frameIndex, time, seekOptions, heldV
         session.beginFrameTimeTicks === 0
       );
       if ((options.format ?? "jpeg") !== "png" && process.env.HF_FORCE_DRAWELEMENT !== "1") {
-        const sizes = session.deFrameSizes ??= [];
-        const sorted = sizes.length >= 12 ? [...sizes].sort((a, b) => a - b) : null;
-        const median = sorted ? sorted[sorted.length >> 1] ?? 0 : 0;
-        const floor = Math.max(2e4, median * 0.12);
-        if (screenshotBuffer.length < floor) {
-          throw new DrawElementCaptureError(
-            frameIndex,
-            `suspect small frame (${screenshotBuffer.length}B < ${Math.round(floor)}B)`
-          );
-        } else {
-          if (sizes.length >= 60) sizes.shift();
-          sizes.push(screenshotBuffer.length);
-        }
+        screenshotBuffer = await judgeSmallDrawElementFrame(
+          session,
+          frameIndex,
+          screenshotBuffer,
+          () => redrawDrawElementFrame(session, frameIndex, time, seekOptions, heldVideoTime)
+        );
       }
     } catch (err) {
       if (isRecoverableDrawElementError(err)) {
@@ -8444,6 +8547,7 @@ var videoMetadataCache = /* @__PURE__ */ new Map();
 var finalVideoFrameTimestampCache = /* @__PURE__ */ new Map();
 var finalVideoFrameTimestampSignalCaches = /* @__PURE__ */ new WeakMap();
 var audioMetadataCache = /* @__PURE__ */ new Map();
+var audioMetadataSignalCaches = /* @__PURE__ */ new WeakMap();
 var mediaProbeOutputCache = /* @__PURE__ */ new Map();
 var mediaProbeOutputSignalCaches = /* @__PURE__ */ new WeakMap();
 var MEDIA_PROBE_OUTPUT_CACHE_MAX_ENTRIES = 128;
@@ -8499,7 +8603,16 @@ function isPngImageProbe(output) {
     (stream) => stream.codec_type === "video" && stream.codec_name?.toLowerCase() === "png"
   );
 }
+var contentAddressedUrls = /* @__PURE__ */ new Map();
+var withoutQuery = (url) => url.split(/[?#]/, 1)[0] ?? url;
+function declareContentAddressedUrl(url, sha256) {
+  contentAddressedUrls.set(withoutQuery(url), sha256);
+}
 function mediaFileIdentity(filePath) {
+  if (/^https?:\/\//i.test(filePath)) {
+    const sha256 = contentAddressedUrls.get(withoutQuery(filePath));
+    return sha256 ? `sha256:${sha256}` : null;
+  }
   try {
     const stat = statSync2(filePath, { bigint: true });
     return [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].join(":");
@@ -8851,42 +8964,51 @@ async function extractFinalVideoFrameTimestamp(filePath, metadata, signal) {
 var extractVideoMetadata = extractMediaMetadata;
 async function extractAudioMetadata(filePath, options) {
   const identity = mediaFileIdentity(filePath);
-  const cached = options?.signal ? void 0 : readMetadataCache(audioMetadataCache, filePath, identity);
+  const signal = options?.signal;
+  if (signal && identity === null) return probeAudioMetadata(filePath, signal);
+  let cache = audioMetadataCache;
+  if (signal) {
+    cache = audioMetadataSignalCaches.get(signal) ?? /* @__PURE__ */ new Map();
+    audioMetadataSignalCaches.set(signal, cache);
+  }
+  const cached = readMetadataCache(cache, filePath, identity);
   if (cached) return cached;
-  const probePromise = (async () => {
-    const output = await probeMediaOutput(filePath, options?.signal);
-    const audioStream = output.streams.find((s) => s.codec_type === "audio");
-    if (!audioStream) throw new Error("[FFmpeg] No audio stream found");
-    let durationSeconds = output.format.duration ? parseFloat(output.format.duration) : 0;
-    const streamDuration = audioStream.duration ? parseFloat(audioStream.duration) : void 0;
-    const sampleRate = audioStream.sample_rate ? parseInt(audioStream.sample_rate) : 44100;
-    const audioCodec = audioStream.codec_name || "unknown";
-    if (sampleRate > 0) {
-      const decoded = await probeDecodedAudioDuration(
-        filePath,
-        sampleRate,
-        audioStartSeconds(audioStream, output.format),
-        durationSeconds,
-        options?.signal
-      );
-      if (decoded !== null) {
-        durationSeconds = reconcileAudioDuration(durationSeconds, decoded, output.format);
-      }
-    }
-    return {
-      durationSeconds,
-      streamDurationSeconds: streamDuration && streamDuration > 0 ? streamDuration : void 0,
-      sampleRate,
-      channels: audioStream.channels || 2,
-      audioCodec,
-      bitrate: output.format.bit_rate ? parseInt(output.format.bit_rate) : void 0,
-      latestStreamLeadSeconds: latestStreamLeadSeconds(output)
-    };
-  })();
-  if (options?.signal) return probePromise;
-  writeMetadataCache(audioMetadataCache, filePath, identity, probePromise);
+  const probePromise = probeAudioMetadata(filePath, signal);
+  writeMetadataCache(cache, filePath, identity, probePromise);
   return probePromise;
 }
+async function probeAudioMetadata(filePath, signal) {
+  const output = await probeMediaOutput(filePath, signal);
+  const audioStream = output.streams.find((s) => s.codec_type === "audio");
+  if (!audioStream) throw new Error("[FFmpeg] No audio stream found");
+  let durationSeconds = output.format.duration ? parseFloat(output.format.duration) : 0;
+  const streamDuration = audioStream.duration ? parseFloat(audioStream.duration) : void 0;
+  const sampleRate = audioStream.sample_rate ? parseInt(audioStream.sample_rate) : 44100;
+  const audioCodec = audioStream.codec_name || "unknown";
+  if (sampleRate > 0) {
+    const decoded = await probeDecodedAudioDuration(
+      filePath,
+      sampleRate,
+      audioStartSeconds(audioStream, output.format),
+      durationSeconds,
+      signal
+    );
+    if (decoded !== null) {
+      durationSeconds = reconcileAudioDuration(durationSeconds, decoded, output.format);
+    }
+  }
+  return {
+    durationSeconds,
+    streamDurationSeconds: streamDuration && streamDuration > 0 ? streamDuration : void 0,
+    sampleRate,
+    channels: audioStream.channels || 2,
+    audioCodec,
+    bitrate: output.format.bit_rate ? parseInt(output.format.bit_rate) : void 0,
+    latestStreamLeadSeconds: latestStreamLeadSeconds(output),
+    audioStreamLeadSeconds: streamLeadSeconds(output, audioStream),
+    audioStreamCount: output.streams.filter((s) => s.codec_type === "audio").length
+  };
+}
 function audioVideoStreamStarts(output) {
   return (output?.streams ?? []).filter(
     (s) => (s.codec_type === "audio" || s.codec_type === "video") && s.disposition?.attached_pic !== 1
@@ -9022,8 +9144,10 @@ async function analyzeKeyframeIntervalsUncached(filePath, videoStreamStartSecond
 
 // ../engine/src/services/softwareEncoderThreads.ts
 import { availableParallelism } from "os";
-function appendSoftwareEncoderThreadsArg(args, parallelism = availableParallelism()) {
-  args.push("-threads", String(Math.max(1, Math.floor(parallelism))));
+var X265_MAX_THREADS = 16;
+function appendSoftwareEncoderThreadsArg(args, encoder, parallelism = availableParallelism()) {
+  const cap = encoder === "libx265" ? X265_MAX_THREADS : Infinity;
+  args.push("-threads", String(Math.min(cap, Math.max(1, Math.floor(parallelism)))));
 }
 
 // ../engine/src/utils/renderProvenance.ts
@@ -9250,7 +9374,7 @@ function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = null) {
     } else {
       const encoderName = codec === "h264" ? "libx264" : "libx265";
       args.push("-c:v", encoderName, "-preset", preset);
-      appendSoftwareEncoderThreadsArg(args);
+      appendSoftwareEncoderThreadsArg(args, encoderName);
       if (bitrate) args.push("-b:v", bitrate);
       else args.push("-crf", String(quality));
       const gop = resolveLockedGopSize(options);
@@ -9955,7 +10079,7 @@ function buildStreamingArgs(options, outputPath, gpuEncoder = null) {
     } else {
       const encoderName = codec === "h264" ? "libx264" : "libx265";
       args.push("-c:v", encoderName, "-preset", preset);
-      appendSoftwareEncoderThreadsArg(args);
+      appendSoftwareEncoderThreadsArg(args, encoderName);
       if (bitrate) args.push("-b:v", bitrate);
       else args.push("-crf", String(quality));
       const lockedGop = resolveLockedGopSize(options);
@@ -11379,7 +11503,7 @@ function getSingleMeaningfulChild(container) {
 }
 function unwrapTemplate(html) {
   const lowered = html.toLowerCase();
-  if (!lowered.includes("<template") || !lowered.includes("</template>")) {
+  if (!lowered.includes("<template") || !/<\/template[ \t\n\r\f]*>/.test(lowered)) {
     return html;
   }
   const { body } = parseHTMLContent(html);
@@ -11473,7 +11597,7 @@ function isTargetExistsRenameError(err) {
   return code === "EEXIST" || code === "ENOTEMPTY" || code === "EPERM";
 }
 function adoptPublishedWinner(entry, partialDir) {
-  if (!existsSync8(join9(entry.dir, COMPLETE_SENTINEL))) return null;
+  if (!existsSync8(join9(entry.dir, COMPLETE_SENTINEL)) || !hasFrameFiles(entry.dir)) return null;
   removeDir(partialDir);
   return { dir: entry.dir, published: true };
 }
@@ -15167,6 +15291,7 @@ function legacyFilterScriptOptionIsUnsupported(stderr) {
   return /filter_complex_script/i.test(stderr) && /(?:unrecognized option|option (?:was )?not found)/i.test(stderr);
 }
 var inPrepareSlot = createConcurrencyLimit(Math.max(2, Math.floor(cpus2().length / 2)));
+var inRemotePrepareSlot = createConcurrencyLimit(16);
 var MAX_VOLUME_SEGMENTS = 32;
 var VOLUME_SIMPLIFY_EPSILON = 5e-3;
 var STEREO_CHANNEL_FILTER = "pan=stereo|FL=FL+FC|FR=FR+FC";
@@ -15383,8 +15508,11 @@ function parseAudioElements(html) {
   const startCache = /* @__PURE__ */ new Map();
   const visiting = /* @__PURE__ */ new Set();
   const resolveStart = (el) => el.getAttribute("data-start") ? resolveReferencedStart(document2, el, startCache, visiting) : 0;
-  const parseEnd = (raw) => {
-    return parseStrictFiniteTimingNumber(raw) ?? 0;
+  const resolveEnd = (el) => {
+    const end = parseStrictFiniteTimingNumber(el.getAttribute("data-end"));
+    if (end != null) return end;
+    const duration = parseStrictFiniteTimingNumber(el.getAttribute("data-duration"));
+    return duration != null && duration > 0 ? resolveStart(el) + duration : 0;
   };
   const isHidden = isSelfOrAncestorHidden;
   const groupsById = new Map(
@@ -15403,9 +15531,10 @@ function parseAudioElements(html) {
       id,
       src,
       start: resolveStart(el),
-      end: parseEnd(el.getAttribute("data-end")),
+      end: resolveEnd(el),
       mediaStart: readMediaStart(el),
       playbackRate: readElementRateSpec(el),
+      loop: el.getAttribute("loop") !== null,
       layer: layerAttr ? parseInt(layerAttr) : 0,
       volume: volumeAttr ? parseFloat(volumeAttr) : 1,
       ...fades.fadeIn > 0 ? { fadeIn: fades.fadeIn } : {},
@@ -15440,7 +15569,8 @@ function parseAudioElements(html) {
   return elements;
 }
 var FAIL_ON_READ_ERROR_INSTEAD_OF_ENDING_THERE = ["-xerror"];
-async function extractAudioSegment(srcPath, outputPath, stage, mediaStart, duration, playbackRate = 1, signal, config) {
+var SIDECAR_WARM_UP_SECONDS = 1;
+async function extractAudioSegment(srcPath, outputPath, stage, mediaStart, duration, playbackRate = 1, signal, config, audioSidecarUrl, options) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
   const outputDir = dirname7(outputPath);
   if (!existsSync11(outputDir)) mkdirSync7(outputDir, { recursive: true });
@@ -15450,25 +15580,86 @@ async function extractAudioSegment(srcPath, outputPath, stage, mediaStart, durat
   const metadata = readsUrl ? await extractAudioMetadata(srcPath, { signal }).catch((error) => {
     if (signal?.aborted) throw error;
     return extractAudioMetadata(srcPath, { signal });
-  }) : await extractAudioMetadata(srcPath).catch(() => null);
+  }) : await extractAudioMetadata(srcPath).catch((error) => {
+    if (options?.loop) throw error;
+    return null;
+  });
+  const loopDuration = (metadata?.durationSeconds ?? 0) - mediaStart;
+  if (options?.loop && loopDuration > 0 && sourceDuration > loopDuration) {
+    const cycleDir = mkdtempSync7(join14(outputDir, ".audio-loop-"));
+    const cyclePath = join14(cycleDir, "cycle.wav");
+    try {
+      const cycle = await extractAudioSegment(
+        srcPath,
+        cyclePath,
+        stage,
+        mediaStart,
+        loopDuration,
+        1,
+        signal,
+        config,
+        audioSidecarUrl,
+        { padToDuration: true }
+      );
+      if (!cycle.success) return { ...cycle, outputPath };
+      const outputArgs2 = preparedAudioOutputArgs(metadata, normalizedPlaybackRate, duration, null);
+      const result2 = await runFfmpeg(
+        [
+          "-stream_loop",
+          "-1",
+          "-t",
+          String(sourceDuration),
+          "-i",
+          cyclePath,
+          "-vn",
+          "-acodec",
+          "pcm_s16le",
+          "-ar",
+          "48000",
+          ...outputArgs2,
+          "-t",
+          String(duration),
+          "-y",
+          outputPath
+        ],
+        { signal, timeout: ffmpegProcessTimeout }
+      );
+      const failure2 = result2.success ? void 0 : ffmpegFailure(stage, result2, ffmpegProcessTimeout);
+      return {
+        success: result2.success,
+        outputPath,
+        durationMs: cycle.durationMs + result2.durationMs,
+        error: failure2?.detail,
+        failure: failure2
+      };
+    } finally {
+      rmSync8(cycleDir, { recursive: true, force: true });
+    }
+  }
   const inputSeek = mediaStart >= (metadata?.latestStreamLeadSeconds ?? 0);
   const start = formatFilterNumber(mediaStart);
   const timestampTrim = inputSeek ? null : `atrim=start=${start}:end=${formatFilterNumber(mediaStart + sourceDuration)},asetpts=PTS-${start}/TB,aresample=async=1:first_pts=0`;
+  const fromSidecar = audioSidecarUrl !== void 0 && inputSeek && normalizedPlaybackRate === 1;
+  const warmUp = fromSidecar ? Math.min(SIDECAR_WARM_UP_SECONDS, mediaStart) : 0;
   const outputArgs = preparedAudioOutputArgs(
     metadata,
     normalizedPlaybackRate,
     duration,
-    timestampTrim
+    [
+      warmUp > 0 ? `atrim=start=${warmUp},asetpts=PTS-STARTPTS` : timestampTrim,
+      ...options?.padToDuration ? ["apad"] : []
+    ].filter(Boolean).join(",") || null
   );
+  const readFrom = fromSidecar ? audioSidecarUrl : srcPath;
   const args = [
     ...readsUrl ? FAIL_ON_READ_ERROR_INSTEAD_OF_ENDING_THERE : [],
-    ...urlInputArgs(srcPath),
-    ...inputSeek ? ["-ss", String(mediaStart), "-t", String(sourceDuration)] : [],
+    ...urlInputArgs(readFrom),
+    ...inputSeek ? ["-ss", String(mediaStart - warmUp), "-t", String(sourceDuration + warmUp)] : [],
     "-i",
-    srcPath
+    readFrom
   ];
   args.push("-vn", "-acodec", "pcm_s16le", "-ar", "48000", ...outputArgs);
-  if (normalizedPlaybackRate !== 1) args.push("-t", String(duration));
+  if (normalizedPlaybackRate !== 1 || options?.padToDuration) args.push("-t", String(duration));
   args.push("-y", outputPath);
   const result = await runFfmpeg(args, { signal, timeout: ffmpegProcessTimeout });
   if (signal?.aborted) {
@@ -15500,6 +15691,17 @@ async function extractAudioSegment(srcPath, outputPath, stage, mediaStart, durat
     failure
   };
 }
+function isRemoteElement(element, baseDir, compiledDir, config) {
+  if (isHttpUrl(element.src)) return true;
+  if (!config?.urlByAbsentLocalPath?.size) return false;
+  try {
+    return config.urlByAbsentLocalPath.has(
+      resolveProjectRelativeSrc(element.src, baseDir, compiledDir)
+    );
+  } catch {
+    return false;
+  }
+}
 async function generateSilence(outputPath, duration, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
   const outputDir = dirname7(outputPath);
@@ -15894,7 +16096,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
   }
   await Promise.all(
     elements.map(
-      (element, index) => inPrepareSlot(async () => {
+      (element, index) => (isRemoteElement(element, baseDir, compiledDir, config) ? inRemotePrepareSlot : inPrepareSlot)(async () => {
         if (effectiveSignal.aborted) {
           failures.push({
             stage: "cancelled",
@@ -15909,10 +16111,12 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
         try {
           let srcPath = element.src;
           let readInPlace = false;
+          let audioSidecarUrl;
           if (!isHttpUrl(srcPath)) {
             srcPath = resolveProjectRelativeSrc(element.src, baseDir, compiledDir);
             const remoteUrl = config?.urlByAbsentLocalPath?.get(srcPath);
             if (remoteUrl) {
+              audioSidecarUrl = config?.audioSidecarUrlByLocalPath?.get(srcPath);
               srcPath = remoteUrl;
               readInPlace = true;
             }
@@ -15961,6 +16165,9 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
             return;
           }
           if (element.end - element.start <= 0) {
+            console.warn(
+              `[audioMixer] ${element.id} has no data-duration or data-end; its length is unknown, so it plays to the end of its source`
+            );
             let metadata;
             try {
               metadata = await extractAudioMetadata(
@@ -15990,7 +16197,9 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
               element.end - element.start,
               element.playbackRate,
               effectiveSignal,
-              config
+              config,
+              audioSidecarUrl,
+              { loop: element.loop }
             );
             if (!extractResult.success) {
               failures.push(
@@ -16016,7 +16225,9 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
               element.end - element.start,
               element.playbackRate,
               effectiveSignal,
-              config
+              config,
+              void 0,
+              { loop: element.loop }
             );
             if (!prepResult.success) {
               failures.push(
@@ -17535,6 +17746,7 @@ export {
   formatFfmpegError,
   describeFfmpegFailure,
   runFfmpeg,
+  declareContentAddressedUrl,
   probeMediaProfile,
   extractMediaMetadata,
   extractFinalVideoFrameTimestamp,
@@ -17589,6 +17801,7 @@ export {
   extractVideoFramesRange,
   resolvePlayableVideoDuration,
   isVideoPastTimelineEnd,
+  rebaseVideoToWindow,
   resolveTimelineExtractionWindow,
   resolveFinalFrameExtractionWindow,
   resolveVideoExtractionWindow,

package/dist/{chunk-BWPY64WA.js → chunk-R2U2G4OS.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   findCompositionDimensions
-} from "./chunk-ZFFKWHXN.js";
+} from "./chunk-WOKVXK4J.js";
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";

package/dist/{chunk-46HEFGXJ.js → chunk-REUL2KH2.js}

@@ -7,7 +7,7 @@ var __dirname = __hf_dirname(__filename);
 import {
   VALID_CANVAS_RESOLUTIONS,
   resolveResolutionFlagPair
-} from "./chunk-B2A56S5C.js";
+} from "./chunk-2MCXIY4B.js";
 
 // src/utils/parseOutputResolution.ts
 function parseOutputResolutionFlag(raw, options) {