@hyperframes/engine 0.8.144 → 0.8.146

package/dist/services/videoFrameExtractor.js

@@ -9,7 +9,9 @@ import { audioGroupsById, isMemberGroupHidden, isSelfOrAncestorHidden } from "./
 import { copyFileSync, existsSync, linkSync, mkdirSync, rmSync } from "fs";
 import { join } from "path";
 import { cpus } from "os";
+import { createConcurrencyLimit } from "../utils/concurrencyLimit.js";
 import { parseHTML } from "linkedom";
+import { isPathInside } from "@hyperframes/parsers/asset-paths";
 import { resolveProjectRelativeSrc } from "@hyperframes/parsers/asset-resolution";
 import { MEDIA_RENDER_ID_ATTR, isAudibleVideoElement, fpsToFfmpegArg, fpsToNumber, MEDIA_DURATION_CLAMP_EPSILON_SECONDS, normalizeRateSpec, readElementRateSpec, shiftRateLane, sourceTimeAt, timeAtSourceTime, exportClipWindow, hasClipStarted, isInClipWindow, parseStrictFiniteTimingNumber, readMediaStart, toFps, firstFrameColourArgs, hdrToSdrToneMapFilter, parseFirstFrameColour, } from "@hyperframes/core";
 import { resolveReferencedStart } from "./referenceResolver.js";
@@ -22,7 +24,7 @@ import { runFfmpeg, runFfmpegPipeline } from "../utils/runFfmpeg.js";
 import { isFfmpegFilterAvailable } from "../utils/psnrFilterAvailability.js";
 import { DEFAULT_CONFIG } from "../config.js";
 import { unwrapTemplate } from "../utils/htmlTemplate.js";
-import { FRAME_FILENAME_PREFIX, gcExtractionCache, gcSweepDue, lookupCacheEntry, partialCacheEntryDir, publishCacheEntry, readKeyStat, rehydrateCacheEntry, touchCacheEntry, } from "./extractionCache.js";
+import { FRAME_FILENAME_PREFIX, gcExtractionCache, gcSweepDue, lookupCacheEntry, partialCacheEntryDir, publishCacheEntry, readContentSha256, readKeyStat, rehydrateCacheEntry, touchCacheEntry, } from "./extractionCache.js";
 import { framePathsFromDirectory } from "./extractedFrameIndex.js";
 export { resolveProjectRelativeSrc };
 /**
@@ -105,6 +107,7 @@ export function extractionFrameCountForDuration(durationSeconds, fps, isVFR) {
     const frames = Number(frameCount);
     return Math.max(1, Number.isSafeInteger(frames) ? frames : Number.MAX_SAFE_INTEGER);
 }
+const DOWNLOAD_SUBDIR = "_downloads";
 export const EXTRACT_CACHE_MIN_AGE_MS = 60 * 60 * 1000;
 const GC_STALENESS_MS = 24 * 60 * 60 * 1000;
 const SDR_TO_HDR_COLORSPACE_FILTER = "colorspace=all=bt2020:iall=bt709:range=tv";
@@ -487,6 +490,9 @@ function restoreSourceColourFilter(metadata) {
  * same absolute times as a single pass, so their frames are byte-identical to it.
  */
 const EXTRACTION_SEGMENT_SECONDS = 120;
+// Caps extraction ffmpeg runs across all clips; uncapped, dozens of clips starved each other into timeouts.
+const EXTRACTION_SLOTS = Math.max(1, Math.floor(cpus().length / 2));
+const inExtractionSlot = createConcurrencyLimit(EXTRACTION_SLOTS);
 /** Split runs so no single ffmpeg process extracts more than `segmentFrames` frames. */
 function splitFrameRanges(ranges, segmentFrames) {
     const segments = [];
@@ -514,7 +520,7 @@ async function runSegmentedExtraction(job) {
         while (next < segmentCount && !signal.aborted) {
             const index = next++;
             const { firstFrame, frames } = segments[index];
-            const result = await runFfmpeg([
+            const result = await inExtractionSlot(() => runFfmpeg([
                 ...decodeArgs,
                 "-noaccurate_seek",
                 "-ss",
@@ -529,13 +535,13 @@ async function runSegmentedExtraction(job) {
                 "-start_number",
                 String(firstFrame + 1),
                 ...filterAndEncodeArgs,
-            ], { ...job.runOptions, signal });
+            ], { ...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);
     // Report the segment that failed, not the ones stopped because of it.
@@ -667,7 +673,7 @@ outputDirOverride) {
         NUT_RAW_PIXEL_FORMATS.has(metadata.pixelFormat ?? "")) {
         // ffmpeg <6.1 ignores frame durations in CFR resampling once any -vf is set,
         // cutting a trailing still short, so the SDR filters run in a second process.
-        processResult = await runFfmpegPipeline([...args, "-an", "-sn", "-dn", "-c:v", "rawvideo", "-f", "nut", "pipe:1"], [
+        processResult = await inExtractionSlot(() => runFfmpegPipeline([...args, "-an", "-sn", "-dn", "-c:v", "rawvideo", "-f", "nut", "pipe:1"], [
             "-f",
             "nut",
             "-i",
@@ -677,7 +683,7 @@ outputDirOverride) {
             "-fps_mode",
             "passthrough",
             ...encodeArgs,
-        ], runOptions);
+        ], runOptions), signal);
     }
     else {
         const filterArgs = vfFilters.length > 0 ? ["-vf", vfFilters.join(",")] : [];
@@ -694,7 +700,7 @@ outputDirOverride) {
                     segments: splitFrameRanges(options.frameRanges ?? [{ firstFrame: 0, frames: totalFrames }], segmentFrames),
                     runOptions,
                 })
-                : await runFfmpeg([...args, ...filterArgs, ...encodeArgs], runOptions);
+                : await inExtractionSlot(() => runFfmpeg([...args, ...filterArgs, ...encodeArgs], runOptions), signal);
     }
     if (processResult.failureReason === "external_interruption") {
         throw new VideoSourceExtractionError("external_interruption", true, "Video frame extraction interrupted by host lifecycle", `FFmpeg exited with code ${processResult.exitCode}: ${processResult.stderr.slice(-500)}`);
@@ -801,6 +807,9 @@ function canHoldFinalFramePastEof(video) {
 // deliberately below any supported output frame interval: coverage expects
 // one frame, while FFmpeg seeks to the separately probed real frame timestamp.
 const FINAL_FRAME_LOGICAL_DURATION_SECONDS = 1e-6;
+export function isVideoPastTimelineEnd(video, timelineEnd) {
+    return video.start >= timelineEnd;
+}
 /** Move a clip to its extraction window; a rate lane is shifted so it keeps integrating from the new origin. */
 export function rebaseVideoToWindow(video, window) {
     if (window.preserveTimelinePhase)
@@ -1166,15 +1175,16 @@ export async function extractAllVideoFrames(videos, baseDir, options, signal, co
     for (const video of videos) {
         if (signal?.aborted)
             break;
-        if (options.timelineEnd !== undefined && video.start >= options.timelineEnd)
+        if (options.timelineEnd !== undefined && isVideoPastTimelineEnd(video, options.timelineEnd)) {
             continue;
+        }
         try {
             let videoPath = video.src;
             if (!isHttpUrl(videoPath)) {
                 videoPath = resolveProjectRelativeSrc(video.src, baseDir, compiledDir);
             }
             if (isHttpUrl(videoPath)) {
-                const downloadDir = join(options.outputDir, "_downloads");
+                const downloadDir = join(options.outputDir, DOWNLOAD_SUBDIR);
                 mkdirSync(downloadDir, { recursive: true });
                 videoPath = await downloadToTemp(videoPath, downloadDir, undefined, signal, () => recordTransientRetries(1), { onTelemetry: writeUrlDownloadTelemetry });
             }
@@ -1218,6 +1228,11 @@ export async function extractAllVideoFrames(videos, baseDir, options, signal, co
     // HDR preflight. Without this, every render would write a new
     // normalized file with a fresh mtime → fresh cache key → perpetual misses.
     // Phase 3 updates mediaStart after trimming any invisible negative preroll.
+    // Downloads land at a new path and mtime every render, so they are keyed by content instead.
+    const contentKeyedDirs = [
+        join(options.outputDir, DOWNLOAD_SUBDIR),
+        ...(options.contentKeyedDirs ?? []),
+    ];
     const cacheKeyInputs = resolvedVideos.map(({ video, videoPath }) => {
         const stat = readKeyStat(videoPath);
         // Missing files return null — skip the cache path for that entry. The
@@ -1231,6 +1246,7 @@ export async function extractAllVideoFrames(videos, baseDir, options, signal, co
             mtimeMs: stat.mtimeMs,
             size: stat.size,
             mediaStart: video.mediaStart,
+            contentKeyed: contentKeyedDirs.some((dir) => isPathInside(videoPath, dir)),
         };
     });
     // Phase 2: Probe color spaces and normalize if mixed HDR/SDR
@@ -1410,12 +1426,30 @@ export async function extractAllVideoFrames(videos, baseDir, options, signal, co
         });
         return { ...rehydrated, ownedByLookup: true };
     }
+    // Hashed only for works that reach a lookup (deferred ranges never do), once per file.
+    const contentSha256ByPath = new Map();
+    async function hashContentKeyedSources(works) {
+        if (!cacheRootDir)
+            return;
+        const paths = new Set();
+        for (const work of works) {
+            const keyInput = cacheKeyInputs[work.index];
+            if (keyInput?.contentKeyed)
+                paths.add(keyInput.videoPath);
+        }
+        await Promise.all([...paths].map(async (path) => contentSha256ByPath.set(path, await readContentSha256(path, signal))));
+    }
     function lookupCacheFor(work) {
         if (!cacheRootDir)
             return { work };
         const keyInput = cacheKeyInputs[work.index];
         if (!keyInput)
             return { work };
+        const contentSha256 = keyInput.contentKeyed
+            ? (contentSha256ByPath.get(keyInput.videoPath) ?? null)
+            : undefined;
+        if (contentSha256 === null)
+            return { work };
         const transformParts = [
             work.sdrToHdrTransfer ? sdrToHdrTransformKey(work.sdrToHdrTransfer) : undefined,
             work.hdrToSdrTransformKey,
@@ -1427,6 +1461,7 @@ export async function extractAllVideoFrames(videos, baseDir, options, signal, co
             mtimeMs: keyInput.mtimeMs,
             size: keyInput.size,
             mediaStart: keyInput.mediaStart,
+            contentSha256,
             duration: work.videoDuration,
             fps: fpsKey,
             format: work.format,
@@ -1657,9 +1692,9 @@ export async function extractAllVideoFrames(videos, baseDir, options, signal, co
         });
     }
     const cacheMisses = [];
-    for (const work of uniqueWorks.values()) {
-        if (uniqueOutcomes.has(work.dedupeKey))
-            continue;
+    const worksToLookUp = [...uniqueWorks.values()].filter((work) => !uniqueOutcomes.has(work.dedupeKey));
+    await hashContentKeyedSources(worksToLookUp);
+    for (const work of worksToLookUp) {
         const lookup = lookupCacheFor(work);
         if ("work" in lookup) {
             cacheMisses.push(lookup);
@@ -1929,4 +1964,3 @@ export function createFrameLookupTable(videos, extracted, fps) {
     }
     return table;
 }
-//# sourceMappingURL=videoFrameExtractor.js.map

package/dist/services/videoFrameInjector.d.ts

@@ -149,4 +149,3 @@ export interface ElementStackingInfo {
  */
 export declare function queryElementStacking(page: Page, nativeHdrIds: Set<string>): Promise<ElementStackingInfo[]>;
 export {};
-//# sourceMappingURL=videoFrameInjector.d.ts.map

package/dist/services/videoFrameInjector.js

@@ -593,4 +593,3 @@ export async function queryElementStacking(page, nativeHdrIds) {
         return results;
     }, hdrIds, RENDER_FRAME_ID_PREFIX, RENDER_FRAME_ID_SUFFIX);
 }
-//# sourceMappingURL=videoFrameInjector.js.map

package/dist/services/vp9Options.d.ts

@@ -3,4 +3,3 @@ export declare const MIN_VP9_CPU_USED = -8;
 export declare const MAX_VP9_CPU_USED = 8;
 export declare function normalizeVp9CpuUsed(value: number | undefined): number;
 export declare function appendVp9CpuUsedArg(args: string[], value: number | undefined): void;
-//# sourceMappingURL=vp9Options.d.ts.map

package/dist/services/vp9Options.js

@@ -10,4 +10,3 @@ export function normalizeVp9CpuUsed(value) {
 export function appendVp9CpuUsedArg(args, value) {
     args.push("-cpu-used", String(normalizeVp9CpuUsed(value)));
 }
-//# sourceMappingURL=vp9Options.js.map

package/dist/services/wavChunks.d.ts

@@ -17,4 +17,3 @@ export interface RiffChunk {
 export declare function riffChunks(buffer: Buffer): Generator<RiffChunk>;
 /** Canonical codec tag, or null for a truncated or unsupported extensible header. */
 export declare function wavFormatTag(buffer: Buffer, body: number, size: number): number | null;
-//# sourceMappingURL=wavChunks.d.ts.map

package/dist/services/wavChunks.js

@@ -36,4 +36,3 @@ export function wavFormatTag(buffer, body, size) {
         return tag;
     return fmt.length < 40 ? null : extensibleFormatTag(fmt);
 }
-//# sourceMappingURL=wavChunks.js.map

package/dist/types.d.ts

@@ -388,4 +388,3 @@ declare global {
         __hf?: HfProtocol;
     }
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/utils/alphaBlit.d.ts

@@ -189,4 +189,3 @@ export declare function normalizeObjectFit(value: string | undefined): ObjectFit
  * flattening their scene rather than failing it.
  */
 export declare function parseTransformMatrix(css: string): number[] | null;
-//# sourceMappingURL=alphaBlit.d.ts.map

package/dist/utils/alphaBlit.js

@@ -929,4 +929,3 @@ function warnIfZSignificant(parts) {
             `This warning is emitted once per process.`);
     }
 }
-//# sourceMappingURL=alphaBlit.js.map

package/dist/utils/alphaPlaneProbe.d.ts

@@ -6,4 +6,3 @@ export declare function sampledRgbaAlphaIsFullyOpaque(buf: Buffer): boolean | un
  */
 export declare function probeInputAlphaPlane(videoPath: string, decoder: string, signal?: AbortSignal): Promise<boolean | undefined>;
 export declare function inputAlphaOpaqueWarning(src: string): string;
-//# sourceMappingURL=alphaPlaneProbe.d.ts.map

package/dist/utils/alphaPlaneProbe.js

@@ -62,4 +62,3 @@ export function inputAlphaOpaqueWarning(src) {
         "it with an alpha pixel format and avoid remuxing afterward, which can drop the " +
         "alpha while keeping the tag.\n");
 }
-//# sourceMappingURL=alphaPlaneProbe.js.map

package/dist/utils/assertSwiftShader.d.ts

@@ -56,4 +56,3 @@ export declare function readWebGlVendorInfo(page: Page): Promise<WebGlInfo>;
  */
 export declare function assertSwiftShader(page: Page, readInfo?: (page: Page) => Promise<WebGlInfo>): Promise<void>;
 export {};
-//# sourceMappingURL=assertSwiftShader.d.ts.map

package/dist/utils/assertSwiftShader.js

@@ -103,4 +103,3 @@ export async function assertSwiftShader(page, readInfo = readWebGlVendorInfo) {
         `Ensure Chrome was launched with --use-gl=swiftshader --use-angle=swiftshader and that the ` +
         `SwiftShader libraries are present in the runtime image.`, vendor, renderer);
 }
-//# sourceMappingURL=assertSwiftShader.js.map

package/dist/utils/concurrencyLimit.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Runs at most `limit` tasks at once; later tasks wait, in order, for a free slot. A waiter whose
+ * `signal` aborts stops waiting and runs at once without a slot, so a cancel never queues behind others.
+ */
+export declare function createConcurrencyLimit(limit: number): <T>(task: () => Promise<T>, signal?: AbortSignal) => Promise<T>;

package/dist/utils/concurrencyLimit.js

@@ -0,0 +1,39 @@
+/**
+ * Runs at most `limit` tasks at once; later tasks wait, in order, for a free slot. A waiter whose
+ * `signal` aborts stops waiting and runs at once without a slot, so a cancel never queues behind others.
+ */
+export 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 {
+            // Hand the slot straight to the next waiter so a newcomer cannot take it first.
+            const next = waiting.shift();
+            if (next)
+                next();
+            else
+                active--;
+        }
+    };
+}

package/dist/utils/crc32.d.ts

@@ -1,2 +1 @@
 export declare function chunkCrc32(chunkType: string, chunkData: Buffer): number;
-//# sourceMappingURL=crc32.d.ts.map

package/dist/utils/crc32.js

@@ -32,4 +32,3 @@ export function chunkCrc32(chunkType, chunkData) {
         return nativeCrc32(chunkData, nativeCrc32(typeBytes));
     return crc32Fallback(chunkData, crc32Fallback(typeBytes, 0));
 }
-//# sourceMappingURL=crc32.js.map

package/dist/utils/evenDimensions.d.ts

@@ -32,4 +32,3 @@ export declare function requiresEvenDimensions(pixelFormat: string): boolean;
  * returns just the pad when there is no existing chain.
  */
 export declare function withEvenDimensionPad(vfChain: string, pixelFormat: string, width?: number, height?: number): string;
-//# sourceMappingURL=evenDimensions.d.ts.map

package/dist/utils/evenDimensions.js

@@ -46,4 +46,3 @@ export function withEvenDimensionPad(vfChain, pixelFormat, width, height) {
     }
     return vfChain ? `${vfChain},${EVEN_DIMENSION_PAD}` : EVEN_DIMENSION_PAD;
 }
-//# sourceMappingURL=evenDimensions.js.map

package/dist/utils/ffmpegBinaries.d.ts

@@ -3,4 +3,3 @@ export { FFMPEG_PATH_ENV, FFPROBE_PATH_ENV };
 export declare function getFfmpegBinary(): string;
 export declare function getFfprobeBinary(): string;
 export declare function assertConfiguredFfmpegBinariesExist(): void;
-//# sourceMappingURL=ffmpegBinaries.d.ts.map

package/dist/utils/ffmpegBinaries.js

@@ -27,4 +27,3 @@ function pathEncodingHint(configuredPath) {
         return "";
     return " The path contains a Unicode replacement character, which usually means it was mangled while being copied or decoded.";
 }
-//# sourceMappingURL=ffmpegBinaries.js.map

package/dist/utils/ffprobe.d.ts

@@ -154,4 +154,3 @@ export interface KeyframeAnalysis {
  */
 export declare function analyzeKeyframeIntervals(filePath: string, metadata: Pick<VideoMetadata, "videoStreamDurationSeconds" | "videoStreamStartSeconds">): Promise<KeyframeAnalysis>;
 export {};
-//# sourceMappingURL=ffprobe.d.ts.map

package/dist/utils/ffprobe.js

@@ -141,6 +141,7 @@ const AUDIO_DURATION_PROBE_MARGIN_SECONDS = 0.05;
 // How far before the container's claimed end the decode probe starts reading,
 // so it decodes only the tail instead of the whole stream.
 const AUDIO_DURATION_PROBE_TAIL_SECONDS = 1;
+const FFPROBE_READ_INTERVAL_EXPLICIT_FAR_END = "+2147483647";
 const STILL_IMAGE_DEMUXERS = new Set([
     "apng",
     "bmp_pipe",
@@ -845,7 +846,7 @@ async function probeDecodedAudioDuration(filePath, sampleRate, startSeconds, con
         }
     };
     const tailStart = Math.max(startSeconds, startSeconds + containerDurationSeconds - AUDIO_DURATION_PROBE_TAIL_SECONDS);
-    const lastFrame = (await probe(`${tailStart}%`)) ?? (await probe());
+    const lastFrame = (await probe(`${tailStart}%${FFPROBE_READ_INTERVAL_EXPLICIT_FAR_END}`)) ?? (await probe());
     if (!lastFrame)
         return null;
     return lastFrame.timestamp + lastFrame.nbSamples / sampleRate - startSeconds;
@@ -928,4 +929,3 @@ async function analyzeKeyframeIntervalsUncached(filePath, videoStreamStartSecond
         isProblematic: maxInterval > PROBLEMATIC_KEYFRAME_INTERVAL_SECONDS,
     };
 }
-//# sourceMappingURL=ffprobe.js.map

package/dist/utils/gpuEncoder.d.ts

@@ -31,4 +31,3 @@ export declare function getProbeArgs(encoder: ConcreteGpuEncoder): string[];
  *   `-preset` entirely or accept the libx264 vocabulary).
  */
 export declare function mapPresetForGpuEncoder(encoder: GpuEncoder, preset: string): string;
-//# sourceMappingURL=gpuEncoder.d.ts.map

package/dist/utils/gpuEncoder.js

@@ -224,4 +224,3 @@ export function mapPresetForGpuEncoder(encoder, preset) {
             return preset;
     }
 }
-//# sourceMappingURL=gpuEncoder.js.map

package/dist/utils/gpuParityDiff.d.ts

@@ -139,4 +139,3 @@ export declare function diffGpuParityPngs(pngA: Buffer, pngB: Buffer, options?:
  * metrics without a second pass.
  */
 export declare function verifyGpuParity(a: RgbaFrame, b: RgbaFrame, options?: GpuParityDiffOptions): VerifyGpuParityResult;
-//# sourceMappingURL=gpuParityDiff.d.ts.map

package/dist/utils/gpuParityDiff.js

@@ -49,7 +49,7 @@ const DEFAULT_BLACK_ONLY_FRACTION_THRESHOLD = 0.001;
  */
 export function diffGpuParityFrames(a, b, options = {}) {
     if (a.width !== b.width || a.height !== b.height) {
-        throw new Error(`diffGpuParityFrames: frame size mismatch — A is ${a.width}x${a.height}, ` +
+        throw new Error(`diffGpuParityFrames: frame size mismatch: A is ${a.width}x${a.height}, ` +
             `B is ${b.width}x${b.height}`);
     }
     const expectedLen = a.width * a.height * 4;
@@ -66,7 +66,7 @@ export function diffGpuParityFrames(a, b, options = {}) {
     const contentSum = options.contentSumThreshold ?? DEFAULT_CONTENT_SUM_THRESHOLD;
     if (contentSum <= blackSum) {
         throw new Error(`diffGpuParityFrames: contentSumThreshold (${contentSum}) must be strictly greater ` +
-            `than blackSumThreshold (${blackSum}) — overlapping thresholds would double-classify ` +
+            `than blackSumThreshold (${blackSum}): overlapping thresholds would double-classify ` +
             `borderline pixels`);
     }
     const total = a.width * a.height;
@@ -183,7 +183,7 @@ export function verifyGpuParity(a, b, options = {}) {
             ok: false,
             reason: `hardware-GPU frame has ${diff.blackOnlyInA.pixels} pixel(s) ` +
                 `(${(diff.blackOnlyInA.fraction * 100).toFixed(3)}%) that are solid-black ` +
-                `while software-GPU frame has content there${region} — likely shape-dependent ` +
+                `while software-GPU frame has content there${region}, likely a shape-dependent ` +
                 `hardware-GPU capture bug`,
             diff,
         };
@@ -195,11 +195,10 @@ export function verifyGpuParity(a, b, options = {}) {
             ok: false,
             reason: `software-GPU frame has ${diff.blackOnlyInB.pixels} pixel(s) ` +
                 `(${(diff.blackOnlyInB.fraction * 100).toFixed(3)}%) that are solid-black ` +
-                `while hardware-GPU frame has content there${region} — unexpected inverse ` +
+                `while hardware-GPU frame has content there${region}, an unexpected inverse ` +
                 `pattern, worth investigating`,
             diff,
         };
     }
     return { ok: true, reason: "", diff };
 }
-//# sourceMappingURL=gpuParityDiff.js.map

package/dist/utils/hdr.d.ts

@@ -93,4 +93,3 @@ export declare function formatHdrAutoPromotionWarning(promotion: HdrAutoPromotio
  * contains HDR content and what the dominant transfer function is.
  */
 export declare function analyzeCompositionHdr(colorSpaces: Array<VideoColorSpace | null>): CompositionHdrInfo;
-//# sourceMappingURL=hdr.d.ts.map

package/dist/utils/hdr.js

@@ -81,7 +81,7 @@ export function findHdrAutoPromotion(sources) {
         : null;
 }
 export function formatHdrAutoPromotionWarning(promotion) {
-    return `[Render] HDR auto-promotion triggered by "${promotion.triggeringAsset}" — output: ${promotion.output.colorSpace} / ${promotion.output.codec}`;
+    return `[Render] HDR auto-promotion triggered by "${promotion.triggeringAsset}", output: ${promotion.output.colorSpace} / ${promotion.output.codec}`;
 }
 /**
  * Analyze a set of video color spaces to determine if the composition
@@ -103,4 +103,3 @@ export function analyzeCompositionHdr(colorSpaces) {
     const dominantTransfer = hasPq ? "pq" : "hlg";
     return { hasHdr: true, dominantTransfer };
 }
-//# sourceMappingURL=hdr.js.map

package/dist/utils/htmlTemplate.d.ts

@@ -5,4 +5,3 @@
  * of inputs that contain multiple sibling templates or other top-level content.
  */
 export declare function unwrapTemplate(html: string): string;
-//# sourceMappingURL=htmlTemplate.d.ts.map

package/dist/utils/htmlTemplate.js

@@ -39,4 +39,3 @@ export function unwrapTemplate(html) {
     }
     return template.innerHTML ?? html;
 }
-//# sourceMappingURL=htmlTemplate.js.map

package/dist/utils/jpegInput.d.ts

@@ -1,3 +1,2 @@
 /** Check JPEG headers before image2pipe; entropy-coded pixels still belong to FFmpeg. */
 export declare function jpegInputError(buffer: Buffer): string | undefined;
-//# sourceMappingURL=jpegInput.d.ts.map

package/dist/utils/jpegInput.js

@@ -59,4 +59,3 @@ function quantizationTableError(buffer, start, end) {
     }
     return undefined;
 }
-//# sourceMappingURL=jpegInput.js.map

package/dist/utils/layerCompositor.d.ts

@@ -33,4 +33,3 @@ export type CompositeLayer = {
  * hide them).
  */
 export declare function groupIntoLayers(elements: ElementStackingInfo[]): CompositeLayer[];
-//# sourceMappingURL=layerCompositor.d.ts.map

package/dist/utils/layerCompositor.js

@@ -46,4 +46,3 @@ export function groupIntoLayers(elements) {
     }
     return layers;
 }
-//# sourceMappingURL=layerCompositor.js.map

package/dist/utils/managedChildProcess.d.ts

@@ -47,4 +47,3 @@ export declare class ManagedChildProcess {
     private settle;
     private clearTimers;
 }
-//# sourceMappingURL=managedChildProcess.d.ts.map

package/dist/utils/managedChildProcess.js

@@ -145,4 +145,3 @@ export class ManagedChildProcess {
         this.escalationTimer = null;
     }
 }
-//# sourceMappingURL=managedChildProcess.js.map

package/dist/utils/notMediaPayload.d.ts

@@ -61,4 +61,3 @@ export declare function isNotMediaPayload(filePath: string): Promise<boolean>;
  * through its `svg_pipe` demuxer, so image sources must not be sniffed.
  */
 export declare function assertMediaPayload(filePath: string, elementId: string): Promise<void>;
-//# sourceMappingURL=notMediaPayload.d.ts.map

package/dist/utils/notMediaPayload.js

@@ -142,4 +142,3 @@ export async function assertMediaPayload(filePath, elementId) {
         throw new NotMediaPayloadError([fingerprintElementId(elementId)]);
     }
 }
-//# sourceMappingURL=notMediaPayload.js.map

package/dist/utils/parityContract.d.ts

@@ -1,2 +1 @@
 export { MEDIA_VISUAL_STYLE_PROPERTIES, quantizeTimeToFrame } from "@hyperframes/core";
-//# sourceMappingURL=parityContract.d.ts.map

package/dist/utils/parityContract.js

@@ -1,2 +1 @@
 export { MEDIA_VISUAL_STYLE_PROPERTIES, quantizeTimeToFrame } from "@hyperframes/core";
-//# sourceMappingURL=parityContract.js.map

package/dist/utils/processRss.d.ts

@@ -20,4 +20,3 @@ export declare function parseProcStatusRss(pid: number, status: string): Process
  * rejects; a pid that exited between discovery and sampling is simply absent.
  */
 export declare function sampleProcessRss(pids: readonly number[], exec?: ExecFileLike, platform?: NodeJS.Platform, readStatus?: ReadFileLike): Promise<ProcessRssSample[]>;
-//# sourceMappingURL=processRss.d.ts.map

package/dist/utils/processRss.js

@@ -90,4 +90,3 @@ export async function sampleProcessRss(pids, exec = defaultExec(), platform = pr
         return [];
     }
 }
-//# sourceMappingURL=processRss.js.map

package/dist/utils/processTracker.d.ts

@@ -5,4 +5,3 @@ export declare function trackChildProcess(proc: ChildProcess): void;
  * after a short grace period.
  */
 export declare function killTrackedProcesses(): void;
-//# sourceMappingURL=processTracker.d.ts.map

package/dist/utils/processTracker.js

@@ -36,4 +36,3 @@ export function killTrackedProcesses() {
         }
     }, 500).unref();
 }
-//# sourceMappingURL=processTracker.js.map

package/dist/utils/psnr.d.ts

@@ -10,4 +10,3 @@ export declare function psnrDb(a: Buffer, b: Buffer): Promise<number>;
  * every prior eval used to separate real compositor damage from encoder noise.
  */
 export declare function resolveDeVerifyMinDb(): number;
-//# sourceMappingURL=psnr.d.ts.map

package/dist/utils/psnr.js

@@ -39,4 +39,3 @@ export function resolveDeVerifyMinDb() {
     const raw = Number(process.env.HF_DE_VERIFY_MIN_DB ?? "32");
     return Number.isFinite(raw) && raw >= 10 && raw <= 60 ? raw : 32;
 }
-//# sourceMappingURL=psnr.js.map

package/dist/utils/psnrFilterAvailability.d.ts

@@ -11,4 +11,3 @@ export declare function isPsnrFilterAvailable(): Promise<boolean>;
 export declare function isFfmpegFilterAvailable(name: string): Promise<boolean>;
 /** Test-only: drop the memoized probe result. */
 export declare function resetPsnrFilterAvailabilityCache(): void;
-//# sourceMappingURL=psnrFilterAvailability.d.ts.map

package/dist/utils/psnrFilterAvailability.js

@@ -56,4 +56,3 @@ async function listFilters() {
         return null;
     }
 }
-//# sourceMappingURL=psnrFilterAvailability.js.map

package/dist/utils/readWebGlVendorInfoFromCanvas.d.ts

@@ -17,4 +17,3 @@ export declare function readWebGlVendorInfoFromCanvas(page: Page): Promise<{
     vendor: string;
     renderer: string;
 }>;
-//# sourceMappingURL=readWebGlVendorInfoFromCanvas.d.ts.map

package/dist/utils/readWebGlVendorInfoFromCanvas.js

@@ -42,4 +42,3 @@ export async function readWebGlVendorInfoFromCanvas(page) {
         }
     });
 }
-//# sourceMappingURL=readWebGlVendorInfoFromCanvas.js.map

package/dist/utils/renderProvenance.d.ts

@@ -55,4 +55,3 @@ export interface RenderProvenance {
  * case-insensitive — a case-sensitive read works on mp4 and misses every webm.
  */
 export declare function readRenderProvenance(tags: Record<string, string | undefined> | undefined): RenderProvenance | null;
-//# sourceMappingURL=renderProvenance.d.ts.map

package/dist/utils/renderProvenance.js

@@ -162,4 +162,3 @@ export function readRenderProvenance(tags) {
         return null;
     return { renderer, version: readTagCI(tags, PROVENANCE_VERSION_TAG) };
 }
-//# sourceMappingURL=renderProvenance.js.map

package/dist/utils/runFfmpeg.d.ts

@@ -47,10 +47,11 @@ export declare function ffmpegStatsReader(onStats: (stats: FfmpegStats) => void)
  * exactly which option to fix.
  */
 export declare function formatFfmpegError(exitCode: number | null, stderr: string, tailLines?: number): string;
+/** formatFfmpegError, led by the timeout when this process was killed at its deadline. */
+export declare function describeFfmpegFailure(result: Pick<RunFfmpegResult, "exitCode" | "stderr" | "terminationReason">, timeoutMs: number): string;
 export declare function runFfmpeg(args: string[], opts?: RunFfmpegOptions): Promise<RunFfmpegResult>;
 /**
  * Runs `ffmpeg <producerArgs> | ffmpeg <consumerArgs>`. Fails when either side
  * fails and reports the first failure, its stderr last so error tails show it.
  */
 export declare function runFfmpegPipeline(producerArgs: string[], consumerArgs: string[], opts?: RunFfmpegOptions): Promise<RunFfmpegResult>;
-//# sourceMappingURL=runFfmpeg.d.ts.map