hyperframes 0.8.143 → 0.8.145

package/dist/{chunk-33RZPZ4K.js → chunk-UXO2L7HJ.js}

@@ -26,7 +26,7 @@ import {
   renderFrameIdForRenderId,
   resolveAuthoredTimingWindow,
   toFps
-} from "./chunk-4M4EC7JX.js";
+} from "./chunk-VRW6EBHV.js";
 import {
   AUDIO_GROUP_RENDER_ID_ATTR,
   COLOR_GRADING_SOURCE_HIDDEN_ATTR,
@@ -55,7 +55,7 @@ import {
   shiftRateLane,
   sourceTimeAt,
   timeAtSourceTime
-} from "./chunk-6TPZSTCL.js";
+} from "./chunk-AUWHD7RA.js";
 import {
   clampAudioGain,
   isAudibleVideoElement
@@ -557,9 +557,93 @@ function applyConcreteGpuScreenshotClamp(currentForceScreenshot, resolvedGpuMode
 var SDR_RGB_TO_BT709_FILTER = "scale=out_color_matrix=bt709:out_range=tv:flags=neighbor";
 var SDR_CAPTURE_TO_BT709_FILTER = `scale=in_color_matrix=bt601:in_range=pc:flags=neighbor,format=gbrp,${SDR_RGB_TO_BT709_FILTER}`;
 
+// ../parsers/dist/htmlAttributeSpans.js
+function readAttributeValue(html, at) {
+  while (/[\t\n\f\r ]/.test(html.charAt(at))) at++;
+  const quote = ['"', "'"].includes(html.charAt(at)) ? html.charAt(at) : "";
+  if (quote) at++;
+  const valueStart = at;
+  if (quote) {
+    const closing = html.indexOf(quote, at);
+    at = closing === -1 ? html.length : closing;
+  } else {
+    while (at < html.length && !/[\t\n\f\r >]/.test(html[at])) at++;
+  }
+  const valueEnd = at;
+  const end = quote ? Math.min(valueEnd + 1, html.length) : valueEnd;
+  return { value: html.slice(valueStart, valueEnd), valueStart, valueEnd, quote, end };
+}
+function readAttribute(html, start) {
+  let at = start;
+  while (at < html.length && !/[\t\n\f\r =/>]/.test(html[at])) at++;
+  if (at === start) return null;
+  const name = html.slice(start, at).toLowerCase();
+  const nameEnd = at;
+  while (/[\t\n\f\r ]/.test(html[at] ?? "")) at++;
+  if (html[at] !== "=") return { kind: "boolean", name, start, end: nameEnd };
+  return { kind: "value", name, start, ...readAttributeValue(html, at + 1) };
+}
+function readOpeningTag(html, start, name, at) {
+  const attributes = [];
+  while (at < html.length) {
+    while (/[\t\n\f\r /]/.test(html[at] ?? "")) at++;
+    if (at >= html.length || html[at] === ">") break;
+    const attribute = readAttribute(html, at);
+    if (attribute === null) {
+      at++;
+      continue;
+    }
+    attributes.push(attribute);
+    at = attribute.end;
+  }
+  const closed = html[at] === ">";
+  return {
+    name: name.toLowerCase(),
+    start,
+    bodyEnd: at,
+    end: closed ? at + 1 : at,
+    closed,
+    rawTextEnd: null,
+    attributes
+  };
+}
+function scanHtmlOpeningTags(html) {
+  const tags = [];
+  const opening = /<!--[\s\S]*?(?:--!?>|$)|<([a-z][^\t\n\f\r />]*)/gi;
+  let match;
+  while ((match = opening.exec(html)) !== null) {
+    if (!match[1]) continue;
+    const tag = readOpeningTag(html, match.index, match[1], opening.lastIndex);
+    tags.push(tag);
+    opening.lastIndex = tag.end;
+    if ([
+      "script",
+      "style",
+      "textarea",
+      "title",
+      "xmp",
+      "iframe",
+      "noembed",
+      "noframes",
+      "plaintext"
+    ].includes(tag.name)) {
+      if (tag.name === "plaintext") {
+        tag.rawTextEnd = html.length;
+        break;
+      }
+      const closing = new RegExp(`</${tag.name}(?=[\\t\\n\\f\\r />])`, "gi");
+      closing.lastIndex = tag.end;
+      const end = closing.exec(html);
+      tag.rawTextEnd = end?.index ?? html.length;
+      opening.lastIndex = tag.rawTextEnd;
+    }
+  }
+  return tags;
+}
+
 // ../engine/src/services/browserManager.ts
 import { execSync } from "child_process";
-import { existsSync, readdirSync } from "fs";
+import { existsSync, readdirSync, statSync } from "fs";
 import { join as join2 } from "path";
 import { homedir } from "os";
 
@@ -801,6 +885,7 @@ async function getPuppeteer() {
   if (!_puppeteer) throw new Error("Neither puppeteer nor puppeteer-core found");
   return _puppeteer;
 }
+var GPU_PROBE_TIMEOUT_MS = 15e3;
 async function probeHardwareWebGlInfo(ppt, options) {
   let probeBrowser;
   try {
@@ -810,37 +895,44 @@ async function probeHardwareWebGlInfo(ppt, options) {
       args: options.args,
       defaultViewport: { width: 64, height: 64 },
       executablePath: options.executablePath,
-      timeout: options.browserTimeout
-    });
-    const page = await probeBrowser.newPage();
-    return await page.evaluate(() => {
-      const unavailable = { hasWebGL: false, vendor: "", renderer: "" };
-      const c = document.createElement("canvas");
-      let gl = c.getContext("webgl");
-      if (gl === null) {
-        gl = c.getContext("experimental-webgl");
-      }
-      if (gl === null) return unavailable;
-      const ext = gl.getExtension("WEBGL_debug_renderer_info");
-      let vendorParam = gl.VENDOR;
-      let rendererParam = gl.RENDERER;
-      if (ext !== null) {
-        vendorParam = ext.UNMASKED_VENDOR_WEBGL;
-        rendererParam = ext.UNMASKED_RENDERER_WEBGL;
-      }
-      const vendor = gl.getParameter(vendorParam);
-      const renderer = gl.getParameter(rendererParam);
-      return {
-        hasWebGL: true,
-        vendor: vendor == null ? "" : String(vendor),
-        renderer: renderer == null ? "" : String(renderer)
-      };
+      timeout: options.browserTimeout,
+      waitForInitialPage: false
     });
+    return await rejectAfter(
+      readWebGlInfo(probeBrowser),
+      GPU_PROBE_TIMEOUT_MS,
+      `GPU probe page did not answer within ${GPU_PROBE_TIMEOUT_MS}ms`
+    );
   } finally {
-    await probeBrowser?.close().catch(() => {
-    });
+    if (probeBrowser) await closeBrowserAfterFailedProbe(probeBrowser);
   }
 }
+async function readWebGlInfo(browser) {
+  const page = await browser.newPage();
+  return await page.evaluate(() => {
+    const unavailable = { hasWebGL: false, vendor: "", renderer: "" };
+    const c = document.createElement("canvas");
+    let gl = c.getContext("webgl");
+    if (gl === null) {
+      gl = c.getContext("experimental-webgl");
+    }
+    if (gl === null) return unavailable;
+    const ext = gl.getExtension("WEBGL_debug_renderer_info");
+    let vendorParam = gl.VENDOR;
+    let rendererParam = gl.RENDERER;
+    if (ext !== null) {
+      vendorParam = ext.UNMASKED_VENDOR_WEBGL;
+      rendererParam = ext.UNMASKED_RENDERER_WEBGL;
+    }
+    const vendor = gl.getParameter(vendorParam);
+    const renderer = gl.getParameter(rendererParam);
+    return {
+      hasWebGL: true,
+      vendor: vendor == null ? "" : String(vendor),
+      renderer: renderer == null ? "" : String(renderer)
+    };
+  });
+}
 function compareBrowserVersionsDescending(left, right) {
   const parse = (value) => {
     const version = value.slice(value.indexOf("-") + 1);
@@ -871,6 +963,14 @@ var CACHED_HEADLESS_SHELL_EXECUTABLES = {
 function cachedHeadlessShellExecutable(hostPlatform = process.platform, hostArch = process.arch) {
   return CACHED_HEADLESS_SHELL_EXECUTABLES[`${hostPlatform}/${hostArch}`];
 }
+function isNonEmptyFile(path) {
+  try {
+    const stat = statSync(path, { throwIfNoEntry: false });
+    return stat?.isFile() === true && stat.size > 0;
+  } catch {
+    return false;
+  }
+}
 function findCachedHeadlessShell(baseDir) {
   if (!existsSync(baseDir)) return void 0;
   const executable = cachedHeadlessShellExecutable();
@@ -881,7 +981,7 @@ function findCachedHeadlessShell(baseDir) {
     for (const version of versions) {
       if (exceedsChromeCeiling(version, ceiling)) continue;
       const binary = join2(baseDir, version, ...executable);
-      if (existsSync(binary)) return binary;
+      if (isNonEmptyFile(binary)) return binary;
     }
   } catch {
   }
@@ -937,15 +1037,15 @@ async function awaitBeforeDeadline(operation, deadline, label) {
   if (remainingMs <= 0) {
     throw new Error(`beginFrame probe timeout before ${label}`);
   }
+  return rejectAfter(operation, remainingMs, `beginFrame probe timeout during ${label}`);
+}
+async function rejectAfter(operation, timeoutMs, message) {
   let timeout;
   try {
     return await Promise.race([
       operation,
       new Promise((_, reject) => {
-        timeout = setTimeout(
-          () => reject(new Error(`beginFrame probe timeout during ${label}`)),
-          remainingMs
-        );
+        timeout = setTimeout(() => reject(new Error(message)), timeoutMs);
       })
     ]);
   } finally {
@@ -1359,8 +1459,9 @@ function buildChromeArgs(options, config) {
   return chromeArgs;
 }
 function compositionRequiresWebGpu(html) {
-  for (const [tag] of html.matchAll(/<(?:[^<>"']|"[^"]*"|'[^']*')*>/g)) {
-    if (/\bdata-composition-id\b/i.test(tag)) return /\bdata-requires-webgpu(?:\s|=|>)/i.test(tag);
+  for (const tag of scanHtmlOpeningTags(html)) {
+    const names = tag.attributes.map((attribute) => attribute.name);
+    if (names.includes("data-composition-id")) return names.includes("data-requires-webgpu");
   }
   return false;
 }
@@ -5170,6 +5271,7 @@ async function constructCaptureSession(input) {
     browserConsoleBuffer: [],
     scriptLoadFailures: [],
     pageErrors: [],
+    subTimelineWaitMemo: sessionOptions.subTimelineWaitMemo ?? {},
     warnings: [],
     capturePerf: {
       frames: 0,
@@ -5318,15 +5420,52 @@ async function pollHfReady(page, timeoutMs, intervalMs = 100) {
   State: __hf=${diag.hasHf}, seek=${diag.hasSeek}, player=${diag.hasPlayer}, renderReady=${diag.renderReady}, duration=${diag.duration}`
   );
 }
-async function pollSubCompositionTimelines(page, timeoutMs, intervalMs = 150, getScriptLoadFailures, scriptFailureGraceMs = 2e3, onPending, shouldStop) {
+async function listUnregisteredTimelineIds(page) {
+  const evaluated = await page.evaluate(`(function() {
+    var hosts = document.querySelectorAll("[data-composition-id]");
+    var timelines = window.__timelines || {};
+    var m = [];
+    for (var i = 0; i < hosts.length; i++) {
+      if (hosts[i].hasAttribute("data-no-timeline")) continue;
+      var id = hosts[i].getAttribute("data-composition-id");
+      if (id && !timelines[id]) m.push(id);
+    }
+    return m;
+  })()`);
+  return Array.isArray(evaluated) ? evaluated.map((id) => String(id)) : [];
+}
+async function waitForSubCompositionTimelines(session, page, timeoutMs) {
+  const memo = session.subTimelineWaitMemo;
+  session.subTimelineWaitOutcome = await pollSubCompositionTimelines(page, timeoutMs, {
+    getScriptLoadFailures: () => session.scriptLoadFailures,
+    onPending: (ids) => {
+      session.pendingTimelineIds = [...ids];
+    },
+    shouldStop: () => session.vfxFailure !== void 0,
+    knownUnregisteredIds: memo.unregisteredIds
+  });
+  const cleanTimeout = session.subTimelineWaitOutcome === "timeout" && session.vfxFailure === void 0 && session.pageErrors.length === 0 && session.scriptLoadFailures.length === 0;
+  if (cleanTimeout) {
+    memo.unregisteredIds = session.pendingTimelineIds ?? [];
+  }
+}
+async function pollSubCompositionTimelines(page, timeoutMs, {
+  intervalMs = 150,
+  getScriptLoadFailures,
+  scriptFailureGraceMs = 2e3,
+  onPending,
+  shouldStop,
+  knownUnregisteredIds = []
+} = {}) {
   const expression = `(function() {
     var hosts = document.querySelectorAll("[data-composition-id]");
     if (hosts.length === 0) return true;
     var timelines = window.__timelines || {};
+    var known = ${JSON.stringify(knownUnregisteredIds)};
     for (var i = 0; i < hosts.length; i++) {
       if (hosts[i].hasAttribute("data-no-timeline")) continue;
       var id = hosts[i].getAttribute("data-composition-id");
-      if (!id) continue;
+      if (!id || known.indexOf(id) !== -1) continue;
       if (!timelines[id]) return false;
     }
     return true;
@@ -5350,7 +5489,11 @@ async function pollSubCompositionTimelines(page, timeoutMs, intervalMs = 150, ge
     }
     await new Promise((resolve) => setTimeout(resolve, intervalMs));
   }
-  if (ready) {
+  const pendingIds = ready && knownUnregisteredIds.length === 0 ? [] : await listUnregisteredTimelineIds(page);
+  if (ready && pendingIds.length > 0 && (getScriptLoadFailures?.() ?? []).length > 0) {
+    scriptFailureBail = true;
+  }
+  if (ready && pendingIds.length === 0) {
     await page.evaluate(`(function() {
       if (typeof window.__hfForceTimelineRebind === "function") {
         window.__hfForceTimelineRebind();
@@ -5358,18 +5501,6 @@ async function pollSubCompositionTimelines(page, timeoutMs, intervalMs = 150, ge
     })()`);
     return "ready";
   }
-  const evaluated = await page.evaluate(`(function() {
-    var hosts = document.querySelectorAll("[data-composition-id]");
-    var timelines = window.__timelines || {};
-    var m = [];
-    for (var i = 0; i < hosts.length; i++) {
-      if (hosts[i].hasAttribute("data-no-timeline")) continue;
-      var id = hosts[i].getAttribute("data-composition-id");
-      if (id && !timelines[id]) m.push(id);
-    }
-    return m;
-  })()`);
-  const pendingIds = Array.isArray(evaluated) ? evaluated.map((id) => String(id)) : [];
   onPending?.(pendingIds);
   const missing = pendingIds.join(", ");
   if (scriptFailureBail) {
@@ -5739,17 +5870,7 @@ async function initializeSession(session) {
     const pageReadyTimeout = session.config?.playerReadyTimeout ?? DEFAULT_CONFIG.playerReadyTimeout;
     await pollHfReady(page, pageReadyTimeout);
     logInitPhase("pollHfReady complete");
-    session.subTimelineWaitOutcome = await pollSubCompositionTimelines(
-      page,
-      pageReadyTimeout,
-      void 0,
-      () => session.scriptLoadFailures,
-      void 0,
-      (ids) => {
-        session.pendingTimelineIds = [...ids];
-      },
-      () => session.vfxFailure !== void 0
-    );
+    await waitForSubCompositionTimelines(session, page, pageReadyTimeout);
     logInitPhase(`pollSubCompositionTimelines complete (${session.subTimelineWaitOutcome})`);
     assertVfxIntact(session);
     recordSubTimelineWarning(session, pageReadyTimeout);
@@ -5855,17 +5976,7 @@ async function initializeSession(session) {
     const pageReadyTimeout = session.config?.playerReadyTimeout ?? DEFAULT_CONFIG.playerReadyTimeout;
     await pollHfReady(page, pageReadyTimeout);
     logInitPhase("pollHfReady complete");
-    session.subTimelineWaitOutcome = await pollSubCompositionTimelines(
-      page,
-      pageReadyTimeout,
-      void 0,
-      () => session.scriptLoadFailures,
-      void 0,
-      (ids) => {
-        session.pendingTimelineIds = [...ids];
-      },
-      () => session.vfxFailure !== void 0
-    );
+    await waitForSubCompositionTimelines(session, page, pageReadyTimeout);
     logInitPhase(`pollSubCompositionTimelines complete (${session.subTimelineWaitOutcome})`);
     assertVfxIntact(session);
     recordSubTimelineWarning(session, pageReadyTimeout);
@@ -6302,7 +6413,10 @@ async function createStaticVerificationPage(session) {
     });
     await page.evaluate(`window.__hfFlushSync?.()`);
     await pollHfReady(page, pageReadyTimeout);
-    await pollSubCompositionTimelines(page, pageReadyTimeout);
+    await pollSubCompositionTimelines(page, pageReadyTimeout, {
+      getScriptLoadFailures: () => session.scriptLoadFailures,
+      knownUnregisteredIds: session.subTimelineWaitMemo.unregisteredIds
+    });
     await applyVideoMetadataHints(page, session.options.videoMetadataHints);
     const skipVideoIds = session.options.skipReadinessVideoIds ?? [];
     await Promise.all([
@@ -7231,7 +7345,7 @@ import {
   openSync,
   readFileSync as readFileSync3,
   readdirSync as readdirSync2,
-  statSync as statSync2,
+  statSync as statSync3,
   writeFileSync as writeFileSync2,
   writeSync
 } from "fs";
@@ -7425,7 +7539,7 @@ var H264_ENCODER_BY_GPU = {
   qsv: "h264_qsv",
   amf: "h264_amf"
 };
-var GPU_PROBE_TIMEOUT_MS = 2e3;
+var GPU_PROBE_TIMEOUT_MS2 = 2e3;
 var GPU_PROBE_KILL_GRACE_MS = 1e3;
 function getCompiledGpuEncoders(ffmpegEncodersStdout) {
   return GPU_ENCODER_CANDIDATES.filter(
@@ -7542,7 +7656,7 @@ async function canUseGpuEncoder(encoder) {
   });
   trackChildProcess(ffmpeg);
   const outcome = await new ManagedChildProcess(ffmpeg, {
-    deadlineAtMs: Date.now() + GPU_PROBE_TIMEOUT_MS,
+    deadlineAtMs: Date.now() + GPU_PROBE_TIMEOUT_MS2,
     terminationGraceMs: GPU_PROBE_KILL_GRACE_MS
   }).wait();
   const usable = outcome.reason === "exit" && outcome.exitCode === 0;
@@ -7558,7 +7672,7 @@ async function canUseGpuEncoder(encoder) {
 function logGpuProbeFailure(encoder, result) {
   if (!isGpuProbeDebugEnabled()) return;
   if (result.code === 0 && !result.error && !result.timedOut) return;
-  const reason = result.error ? result.error.message : result.timedOut ? `timed out after ${GPU_PROBE_TIMEOUT_MS}ms` : `exit=${String(result.code)} signal=${String(result.signal ?? "")}`;
+  const reason = result.error ? result.error.message : result.timedOut ? `timed out after ${GPU_PROBE_TIMEOUT_MS2}ms` : `exit=${String(result.code)} signal=${String(result.signal ?? "")}`;
   const stderr = result.stderr?.trim();
   console.warn(`[gpuEncoder] ${encoder} probe failed: ${reason}${stderr ? `
 ${stderr}` : ""}`);
@@ -7720,6 +7834,11 @@ ${tail}` : windowsMessage;
 ffmpeg stderr (tail):
 ${tail}` : `FFmpeg exited with code ${exitCode}`;
 }
+function describeFfmpegFailure(result, timeoutMs) {
+  const error = formatFfmpegError(result.exitCode, result.stderr);
+  if (result.terminationReason !== "deadline") return error;
+  return `FFmpeg timed out after ${timeoutMs} ms (ffmpegProcessTimeout; long renders can raise FFMPEG_PROCESS_TIMEOUT_MS). ${error}`;
+}
 function spawnFfmpeg(args) {
   const ffmpeg = spawn2(getFfmpegBinary(), args, { windowsHide: true });
   trackChildProcess(ffmpeg);
@@ -7743,7 +7862,16 @@ function toResult(outcome, stderr = outcome.stderr) {
   }
   return result;
 }
+var ABORTED_BEFORE_START = {
+  success: false,
+  exitCode: null,
+  signal: null,
+  stderr: "",
+  durationMs: 0,
+  terminationReason: "abort"
+};
 async function runFfmpeg(args, opts) {
+  if (opts?.signal?.aborted) return { ...ABORTED_BEFORE_START };
   const timeout = opts?.timeout ?? DEFAULT_TIMEOUT;
   const managed = new ManagedChildProcess(spawnFfmpeg(args), {
     signal: opts?.signal,
@@ -7753,6 +7881,7 @@ async function runFfmpeg(args, opts) {
   return toResult(await managed.wait());
 }
 async function runFfmpegPipeline(producerArgs, consumerArgs, opts) {
+  if (opts?.signal?.aborted) return { ...ABORTED_BEFORE_START };
   const deadlineAtMs = Date.now() + (opts?.timeout ?? DEFAULT_TIMEOUT);
   const producer = spawnFfmpeg(producerArgs);
   const consumer = spawnFfmpeg(consumerArgs);
@@ -7783,7 +7912,7 @@ async function runFfmpegPipeline(producerArgs, consumerArgs, opts) {
 
 // ../engine/src/utils/ffprobe.ts
 import { spawn as spawn3 } from "child_process";
-import { createReadStream, readFileSync, statSync } from "fs";
+import { createReadStream, readFileSync, statSync as statSync2 } from "fs";
 import { StringDecoder } from "string_decoder";
 import { basename } from "path";
 var FFPROBE_STDERR_MAX_BYTES = 8 * 1024;
@@ -7886,7 +8015,9 @@ var audioMetadataCache = /* @__PURE__ */ new Map();
 var mediaProbeOutputCache = /* @__PURE__ */ new Map();
 var mediaProbeOutputSignalCaches = /* @__PURE__ */ new WeakMap();
 var MEDIA_PROBE_OUTPUT_CACHE_MAX_ENTRIES = 128;
-var AAC_LC_SAMPLES_PER_PACKET = 1024;
+var AUDIO_DURATION_PROBE_MARGIN_SECONDS = 0.05;
+var AUDIO_DURATION_PROBE_TAIL_SECONDS = 1;
+var FFPROBE_READ_INTERVAL_EXPLICIT_FAR_END = "+2147483647";
 var STILL_IMAGE_DEMUXERS = /* @__PURE__ */ new Set([
   "apng",
   "bmp_pipe",
@@ -7938,7 +8069,7 @@ function isPngImageProbe(output) {
 }
 function mediaFileIdentity(filePath) {
   try {
-    const stat = statSync(filePath, { bigint: true });
+    const stat = statSync2(filePath, { bigint: true });
     return [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].join(":");
   } catch {
     return null;
@@ -8011,7 +8142,7 @@ async function readFileRange(filePath, start, length, signal) {
 async function hasCompletePngStructure(filePath, signal) {
   try {
     signal?.throwIfAborted();
-    const fileSize = statSync(filePath).size;
+    const fileSize = statSync2(filePath).size;
     const signature = await readFileRange(filePath, 0, 8, signal);
     signal?.throwIfAborted();
     if (signature.length !== 8 || !signature.equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]))) {
@@ -8300,29 +8431,16 @@ async function extractAudioMetadata(filePath, options) {
     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";
-    const isAacLc = /^\s*LC\s*$/i.test(audioStream.profile ?? "");
-    if (audioCodec === "aac" && isAacLc && sampleRate > 0) {
-      try {
-        const packetStdout = await runFfprobe(
-          filePath,
-          [
-            "-select_streams",
-            "a:0",
-            "-count_packets",
-            "-show_entries",
-            "stream=nb_read_packets",
-            "-print_format",
-            "json"
-          ],
-          options?.signal
-        );
-        const packetOutput = parseProbeJson(packetStdout);
-        const packetCount = Number(packetOutput.streams[0]?.nb_read_packets);
-        if (Number.isFinite(packetCount) && packetCount > 0) {
-          durationSeconds = packetCount * AAC_LC_SAMPLES_PER_PACKET / sampleRate;
-        }
-      } catch (error) {
-        if (options?.signal?.aborted) throw error;
+    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 {
@@ -8338,6 +8456,55 @@ async function extractAudioMetadata(filePath, options) {
   writeMetadataCache(audioMetadataCache, filePath, identity, probePromise);
   return probePromise;
 }
+function audioStartSeconds(stream, format) {
+  const start = parseFloat(stream.start_time ?? format.start_time ?? "");
+  return Number.isFinite(start) ? start : 0;
+}
+function reconcileAudioDuration(containerSeconds, decodedSeconds, format) {
+  const difference = decodedSeconds - containerSeconds;
+  const trustShorter = format.format_name === "aac";
+  if (difference > AUDIO_DURATION_PROBE_MARGIN_SECONDS) return decodedSeconds;
+  if (trustShorter && difference < -AUDIO_DURATION_PROBE_MARGIN_SECONDS) return decodedSeconds;
+  return containerSeconds;
+}
+async function probeDecodedAudioDuration(filePath, sampleRate, startSeconds, containerDurationSeconds, signal) {
+  const probe = async (readInterval) => {
+    const args = [
+      "-select_streams",
+      "a:0",
+      "-show_entries",
+      "frame=best_effort_timestamp_time,nb_samples",
+      "-of",
+      "csv=p=0"
+    ];
+    if (readInterval) args.unshift("-read_intervals", readInterval);
+    try {
+      const stdout = await runFfprobe(
+        filePath,
+        args,
+        signal,
+        // CSV, not JSON: a tail truncated under the size cap still parses.
+        { retainTail: true, maxChars: 64 * 1024 }
+      );
+      return stdout.split("\n").map((line) => {
+        const [timestampText, samplesText] = line.trim().split(",");
+        const timestamp = Number(timestampText);
+        const nbSamples = Number(samplesText);
+        return Number.isFinite(timestamp) && Number.isFinite(nbSamples) ? { timestamp, nbSamples } : void 0;
+      }).filter((frame) => frame !== void 0).at(-1);
+    } catch (error) {
+      if (signal?.aborted) throw signal.reason ?? error;
+      return void 0;
+    }
+  };
+  const tailStart = Math.max(
+    startSeconds,
+    startSeconds + containerDurationSeconds - AUDIO_DURATION_PROBE_TAIL_SECONDS
+  );
+  const lastFrame = await probe(`${tailStart}%${FFPROBE_READ_INTERVAL_EXPLICIT_FAR_END}`) ?? await probe();
+  if (!lastFrame) return null;
+  return lastFrame.timestamp + lastFrame.nbSamples / sampleRate - startSeconds;
+}
 var keyframeCache = /* @__PURE__ */ new Map();
 var PROBLEMATIC_KEYFRAME_INTERVAL_SECONDS = 2;
 async function analyzeKeyframeIntervals(filePath, metadata) {
@@ -8785,7 +8952,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
       failureReason: isExternalFfmpegInterruption(result) ? "external_interruption" : void 0
     };
   }
-  const fileSize = existsSync4(outputPath) ? statSync2(outputPath).size : 0;
+  const fileSize = existsSync4(outputPath) ? statSync3(outputPath).size : 0;
   return {
     success: true,
     outputPath,
@@ -8919,7 +9086,7 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
       failureReason: concatResult.externalInterruption ? "external_interruption" : void 0
     };
   }
-  const fileSize = existsSync4(outputPath) ? statSync2(outputPath).size : 0;
+  const fileSize = existsSync4(outputPath) ? statSync3(outputPath).size : 0;
   return {
     success: true,
     outputPath,
@@ -8973,7 +9140,7 @@ async function muxVideoWithAudio(videoPath, audioPath, outputPath, signal, confi
     success: result.success,
     outputPath,
     durationMs: result.durationMs,
-    error: !result.success ? formatFfmpegError(result.exitCode, result.stderr) : void 0,
+    error: !result.success ? describeFfmpegFailure(result, processTimeout) : void 0,
     failureReason: result.failureReason
   };
 }
@@ -9065,7 +9232,7 @@ async function packageHls(videoPath, audioPath, outputDir, options) {
     success: result.success,
     outputPath: outputDir,
     durationMs: result.durationMs,
-    error: !result.success ? formatFfmpegError(result.exitCode, result.stderr) : void 0,
+    error: !result.success ? describeFfmpegFailure(result, processTimeout) : void 0,
     failureReason: result.failureReason
   };
 }
@@ -9098,7 +9265,7 @@ async function applyFaststart(inputPath, outputPath, signal, config, fps, onSeco
     success: result.success,
     outputPath,
     durationMs: result.durationMs,
-    error: !result.success ? formatFfmpegError(result.exitCode, result.stderr) : void 0,
+    error: !result.success ? describeFfmpegFailure(result, processTimeout) : void 0,
     failureReason: result.failureReason
   };
 }
@@ -9151,7 +9318,7 @@ function quantizationTableError(buffer, start, end) {
 // ../engine/src/services/streamingEncoder.ts
 import { spawn as spawn4 } from "child_process";
 import { once } from "events";
-import { existsSync as existsSync5, mkdirSync as mkdirSync3, statSync as statSync3 } from "fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, statSync as statSync4 } from "fs";
 import { dirname as dirname3 } from "path";
 function createFrameReorderBuffer(startFrame, endFrame) {
   let cursor = startFrame;
@@ -9516,7 +9683,7 @@ FFmpeg stopped after ${streamingTimeout} ms without consuming a frame.` : "";
           }) ? "external_interruption" : void 0
         };
       }
-      const fileSize = existsSync5(outputPath) ? statSync3(outputPath).size : 0;
+      const fileSize = existsSync5(outputPath) ? statSync4(outputPath).size : 0;
       return { success: true, durationMs, fileSize };
     },
     getExitStatus: () => exitStatus,
@@ -9614,6 +9781,36 @@ import { copyFileSync as copyFileSync2, existsSync as existsSync8, linkSync as l
 import { join as join10 } from "path";
 import { cpus } from "os";
 
+// ../engine/src/utils/concurrencyLimit.ts
+function createConcurrencyLimit(limit) {
+  let active = 0;
+  const waiting = [];
+  const waitForSlot = (signal) => new Promise((resolve) => {
+    const granted = () => {
+      signal?.removeEventListener("abort", aborted);
+      resolve(true);
+    };
+    const aborted = () => {
+      waiting.splice(waiting.indexOf(granted), 1);
+      resolve(false);
+    };
+    waiting.push(granted);
+    signal?.addEventListener("abort", aborted, { once: true });
+  });
+  return async (task, signal) => {
+    if (signal?.aborted) return task();
+    if (active < limit) active++;
+    else if (!await waitForSlot(signal)) return task();
+    try {
+      return await task();
+    } finally {
+      const next = waiting.shift();
+      if (next) next();
+      else active--;
+    }
+  };
+}
+
 // ../engine/src/services/referenceResolver.ts
 function findReferenceTargetEl(doc, refId) {
   return doc.getElementById(refId) ?? doc.querySelector(`[data-composition-id="${refId}"]`);
@@ -9736,7 +9933,7 @@ import {
   readdirSync as readdirSync3,
   rmdirSync,
   rmSync as rmSync2,
-  statSync as statSync4,
+  statSync as statSync5,
   unlinkSync
 } from "fs";
 import { createHash, randomUUID } from "crypto";
@@ -10346,7 +10543,7 @@ async function fetchToPartial(url, partialPath, controller, options) {
   const readableStream = Readable.fromWeb(response.body);
   const fileStream = createWriteStream(partialPath, { flags: "wx" });
   await pipeline(readableStream, inspector, fileStream, { signal: controller.signal });
-  const localSize = statSync4(partialPath).size;
+  const localSize = statSync5(partialPath).size;
   const sha256Bytes = sha256.digest();
   const localSha256 = sha256Bytes.toString("hex");
   const md5Base64 = md5.digest("base64");
@@ -10760,7 +10957,7 @@ import {
   readdirSync as readdirSync5,
   renameSync,
   rmSync as rmSync3,
-  statSync as statSync5,
+  statSync as statSync6,
   utimesSync,
   writeFileSync as writeFileSync3
 } from "fs";
@@ -10821,7 +11018,7 @@ var SCHEMA_PREFIX = "hfcache-v6-";
 var KEY_HEX_CHARS = 16;
 function readKeyStat(videoPath) {
   try {
-    const stat = statSync5(videoPath);
+    const stat = statSync6(videoPath);
     return { mtimeMs: Math.floor(stat.mtimeMs), size: stat.size };
   } catch {
     return null;
@@ -10955,7 +11152,7 @@ function removeDir(path) {
 }
 function collectGcEntry(dir, name, now, minAgeMs, stats, remove) {
   try {
-    const dirStat = statSync5(dir);
+    const dirStat = statSync6(dir);
     if (isPartialChild(name) && now - dirStat.mtimeMs >= minAgeMs) {
       remove(dir);
       stats.agedPartialsRemoved += 1;
@@ -10963,7 +11160,7 @@ function collectGcEntry(dir, name, now, minAgeMs, stats, remove) {
     }
     let lastUseMs = dirStat.mtimeMs;
     try {
-      lastUseMs = statSync5(join9(dir, COMPLETE_SENTINEL)).mtimeMs;
+      lastUseMs = statSync6(join9(dir, COMPLETE_SENTINEL)).mtimeMs;
     } catch {
     }
     return { dir, size: directorySizeBytes(dir), lastUseMs, ageMs: now - lastUseMs };
@@ -10973,7 +11170,7 @@ function collectGcEntry(dir, name, now, minAgeMs, stats, remove) {
 }
 function gcSweepDue(rootDir, maxAgeMs) {
   try {
-    return Date.now() - statSync5(join9(rootDir, GC_MARKER)).mtimeMs > maxAgeMs;
+    return Date.now() - statSync6(join9(rootDir, GC_MARKER)).mtimeMs > maxAgeMs;
   } catch {
     return true;
   }
@@ -11472,6 +11669,8 @@ function restoreSourceColourFilter(metadata) {
   return tags.length > 0 ? [`setparams=${tags.map(([key, value]) => `${key}=${value}`).join(":")}`] : [];
 }
 var EXTRACTION_SEGMENT_SECONDS = 120;
+var EXTRACTION_SLOTS = Math.max(1, Math.floor(cpus().length / 2));
+var inExtractionSlot = createConcurrencyLimit(EXTRACTION_SLOTS);
 function splitFrameRanges(ranges, segmentFrames) {
   const segments = [];
   for (const range of ranges) {
@@ -11495,30 +11694,33 @@ async function runSegmentedExtraction(job) {
     while (next < segmentCount && !signal.aborted) {
       const index = next++;
       const { firstFrame, frames } = segments[index];
-      const result = await runFfmpeg(
-        [
-          ...decodeArgs,
-          "-noaccurate_seek",
-          "-ss",
-          String(startTime + firstFrame / fps),
-          "-i",
-          videoPath,
-          // Read one frame past the segment and keep exactly its own frames.
-          "-t",
-          String((frames + 1) / fps),
-          "-frames:v",
-          String(frames),
-          "-start_number",
-          String(firstFrame + 1),
-          ...filterAndEncodeArgs
-        ],
-        { ...job.runOptions, signal }
+      const result = await inExtractionSlot(
+        () => runFfmpeg(
+          [
+            ...decodeArgs,
+            "-noaccurate_seek",
+            "-ss",
+            String(startTime + firstFrame / fps),
+            "-i",
+            videoPath,
+            // Read one frame past the segment and keep exactly its own frames.
+            "-t",
+            String((frames + 1) / fps),
+            "-frames:v",
+            String(frames),
+            "-start_number",
+            String(firstFrame + 1),
+            ...filterAndEncodeArgs
+          ],
+          { ...job.runOptions, signal }
+        ),
+        signal
       );
       results[index] = result;
       if (!result.success) failed.abort();
     }
   };
-  const workers = Math.min(segmentCount, Math.max(1, Math.floor(cpus().length / 2)));
+  const workers = Math.min(segmentCount, EXTRACTION_SLOTS);
   await Promise.all(Array.from({ length: workers }, worker));
   const ran = results.filter(Boolean);
   const failure = ran.find((r) => !r.success && r.terminationReason !== "abort") ?? ran.find((r) => !r.success);
@@ -11623,20 +11825,23 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   if (resampleVfrToCfr) args.push("-fps_mode", "cfr", "-r", ffmpegFps);
   let processResult;
   if (resampleVfrToCfr && vfFilters.length > 0 && !isHdr && NUT_RAW_PIXEL_FORMATS.has(metadata.pixelFormat ?? "")) {
-    processResult = await runFfmpegPipeline(
-      [...args, "-an", "-sn", "-dn", "-c:v", "rawvideo", "-f", "nut", "pipe:1"],
-      [
-        "-f",
-        "nut",
-        "-i",
-        "pipe:0",
-        "-vf",
-        [...restoreSourceColourFilter(metadata), ...vfFilters].join(","),
-        "-fps_mode",
-        "passthrough",
-        ...encodeArgs
-      ],
-      runOptions
+    processResult = await inExtractionSlot(
+      () => runFfmpegPipeline(
+        [...args, "-an", "-sn", "-dn", "-c:v", "rawvideo", "-f", "nut", "pipe:1"],
+        [
+          "-f",
+          "nut",
+          "-i",
+          "pipe:0",
+          "-vf",
+          [...restoreSourceColourFilter(metadata), ...vfFilters].join(","),
+          "-fps_mode",
+          "passthrough",
+          ...encodeArgs
+        ],
+        runOptions
+      ),
+      signal
     );
   } else {
     const filterArgs = vfFilters.length > 0 ? ["-vf", vfFilters.join(",")] : [];
@@ -11653,7 +11858,10 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
         segmentFrames
       ),
       runOptions
-    }) : await runFfmpeg([...args, ...filterArgs, ...encodeArgs], runOptions);
+    }) : await inExtractionSlot(
+      () => runFfmpeg([...args, ...filterArgs, ...encodeArgs], runOptions),
+      signal
+    );
   }
   if (processResult.failureReason === "external_interruption") {
     throw new VideoSourceExtractionError(
@@ -15590,7 +15798,7 @@ function getSystemResources() {
 // ../engine/src/services/fileServer.ts
 import { Hono } from "hono";
 import { serve } from "@hono/node-server";
-import { readFileSync as readFileSync7, openSync as openSync4, fstatSync, closeSync as closeSync4, statSync as statSync6, constants } from "fs";
+import { readFileSync as readFileSync7, openSync as openSync4, fstatSync, closeSync as closeSync4, statSync as statSync7, constants } from "fs";
 import { join as join16, extname as extname3 } from "path";
 var MIME_TYPES = {
   ".html": "text/html; charset=utf-8",
@@ -15627,7 +15835,7 @@ function readRegularFile(filePath) {
   } catch (error) {
     if (error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR"))
       return null;
-    if (!statSync6(filePath, { throwIfNoEntry: false })?.isFile()) return null;
+    if (!statSync7(filePath, { throwIfNoEntry: false })?.isFile()) return null;
     throw error;
   }
   try {
@@ -16065,6 +16273,7 @@ export {
   releaseBrowser,
   drainBrowserPool,
   closeBrowserPool,
+  usesSoftwareWebGpu,
   buildChromeArgs,
   compositionRequiresWebGpu,
   WebGpuUnavailableError,
@@ -16144,6 +16353,7 @@ export {
   analyzeCompositionHdr,
   isExternalFfmpegInterruption,
   formatFfmpegError,
+  describeFfmpegFailure,
   runFfmpeg,
   probeMediaProfile,
   extractMediaMetadata,