hyperframes 0.8.16 → 0.8.18

package/dist/fontLocalizeCli.js

@@ -50943,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;
@@ -50965,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);
@@ -58584,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] }
     }
   ]);
 }
@@ -58672,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);
@@ -60863,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");
@@ -60889,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,
@@ -60900,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);
@@ -85230,11 +85228,23 @@ import {
   rmSync as rmSync7
 } from "fs";
 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);
@@ -85265,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 = join21(this.transactionDirectory, basename5(this.destinationPath));
     this.backupPath = join21(this.transactionDirectory, "backup");
+    this.durationProbe = durationProbe;
   }
   kind;
   fileSystem;
@@ -85281,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;
@@ -85299,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);
@@ -86510,9 +86578,6 @@ init_assetResolution();
 import { createReadStream as createReadStream4, existsSync as existsSync25, mkdirSync as mkdirSync13, readFileSync as readFileSync10 } from "fs";
 import { join as join27, dirname as dirname13, resolve as resolve12, basename as basename6 } from "path";
 
-// ../producer/src/utils/ffprobe.ts
-init_src();
-
 // ../producer/src/services/renderMediaCollector.ts
 init_esm10();
 init_dist2();
@@ -89639,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");
@@ -89686,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 [
         {
@@ -89745,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);
@@ -89821,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,
@@ -90633,7 +90698,7 @@ function shouldCopyExtractedFrames(platform3) {
 }
 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 };
 }
@@ -94305,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);
   }
 }
@@ -96097,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();
@@ -96169,7 +96243,7 @@ async function executeRenderPipeline(input) {
         copyFileSync6(stagedOutputPath, debugOutput);
       }
     }
-    artifactTransaction.commit();
+    await artifactTransaction.commit();
     job.outputPath = outputPath;
     updateJobStatus(job, "complete", "Render complete", 100, onProgress);
     await eventPublisher.flush();
@@ -97515,8 +97589,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.16" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.16" : "0.0.0-dev";
+var VERSION = true ? "0.8.18" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.18" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {