@hyperframes/engine 0.9.16 → 0.9.18

package/dist/services/frameCapture.js

@@ -1761,8 +1761,8 @@ export function recordSubTimelineWarning(session, timeoutMs) {
                     `${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(", ")})` +
-                        scriptLoadCauseSuffix(loadCauses)
+                    ? `A sub-composition timeline script failed to load${scriptLoadCauseSuffix(loadCauses)} ` +
+                        `(${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. ` +

package/dist/services/videoFrameExtractor.js

@@ -15,7 +15,7 @@ import { HF_COLOR_GRADING_ATTR } from "@hyperframes/core";
 import { isPathInside } from "@hyperframes/parsers/asset-paths";
 import { resolveProjectRelativeSrc } from "@hyperframes/parsers/asset-resolution";
 import { alphaDecoderFor } from "@hyperframes/parsers/media-alpha";
-import { MEDIA_RENDER_ID_ATTR, isAudibleVideoElement, fpsToFfmpegArg, fpsToNumber, MEDIA_DURATION_CLAMP_EPSILON_SECONDS, normalizeRateSpec, readElementRateSpec, shiftRateLane, sourceTimeAt, timeAtSourceTime, exportClipWindow, hasClipStarted, isInClipWindow, mediaElementTime, parseStrictFiniteTimingNumber, readMediaStart, toFps, firstFrameColourArgs, hdrToSdrToneMapFilter, parseFirstFrameColour, } from "@hyperframes/core";
+import { MEDIA_RENDER_ID_ATTR, isAudibleVideoElement, fpsToFfmpegArg, fpsToNumber, MEDIA_DURATION_CLAMP_EPSILON_SECONDS, normalizeRateSpec, readElementRateSpec, shiftRateLane, sourceTimeAt, timeAtSourceTime, exportClipWindow, hasClipStarted, isInClipWindow, mediaElementTime, parseStrictFiniteTimingNumber, readMediaStart, toFps, firstFrameColourArgs, keyframeTransferArgs, parseKeyframeTransfers, hdrToSdrToneMapFilter, parseFirstFrameColour, readsKeyframeTransfers, } from "@hyperframes/core";
 import { resolveReferencedStart } from "./referenceResolver.js";
 import { isKnownInactiveTimelineWindow } from "./mediaTimelineWindow.js";
 import { extractFinalVideoFrameTimestamp, extractMediaMetadata, ffmpegSeekSeconds, formatFfmpegSeconds, keyframeGapSeconds, mediaFileIdentity, readMetadataCache, readStoredFinalFrame, resolvePlayableVideoDuration, videoStartOnMediaTimeline, writeMetadataCache, } from "../utils/ffprobe.js";
@@ -506,19 +506,32 @@ export function parseImageElements(html) {
     return images;
 }
 const firstFrameColourCache = new Map();
+/** A source's SPS transfers, so a PQ or SDR keyframe keeps an HLG one at 100 nits; null when the read failed. */
+function readKeyframeTransfers(videoPath, codec) {
+    return inExtractionSlot(() => runFfmpeg([...urlInputArgs(videoPath), ...keyframeTransferArgs(videoPath, codec)])).then((result) => (result.success ? parseKeyframeTransfers(result.stderr) : null));
+}
 /** The first shown frame's colour tags (see {@link firstFrameColourArgs}), probed once per source file. */
-function readFirstFrameColour(videoPath) {
+function readFirstFrameColour(videoPath, codec) {
     const identity = mediaFileIdentity(videoPath);
     const cached = readMetadataCache(firstFrameColourCache, videoPath, identity);
     if (cached)
         return cached;
     // In an extraction slot, so it never adds a decoder; unsignalled, so one cancel cannot cut it short for others.
-    const probe = inExtractionSlot(() => runFfmpeg([...urlInputArgs(videoPath), ...firstFrameColourArgs(videoPath)])).then((result) => {
+    const probe = inExtractionSlot(() => runFfmpeg([...urlInputArgs(videoPath), ...firstFrameColourArgs(videoPath)])).then(async (result) => {
+        const forget = () => {
+            if (firstFrameColourCache.get(videoPath)?.promise === probe)
+                firstFrameColourCache.delete(videoPath);
+        };
         // A failed probe answers this cut only; the next one probes again.
-        if (!result.success && firstFrameColourCache.get(videoPath)?.promise === probe) {
-            firstFrameColourCache.delete(videoPath);
-        }
-        return parseFirstFrameColour(result.stderr);
+        if (!result.success)
+            forget();
+        const first = parseFirstFrameColour(result.stderr);
+        if (!result.success || !readsKeyframeTransfers(first))
+            return first;
+        const keyframeTransfers = await readKeyframeTransfers(videoPath, codec);
+        if (!keyframeTransfers)
+            forget();
+        return { ...first, keyframeTransfers: keyframeTransfers ?? [] };
     });
     writeMetadataCache(firstFrameColourCache, videoPath, identity, probe);
     return probe;
@@ -822,7 +835,9 @@ outputDirOverride) {
             args.push("-noaccurate_seek");
         args.push("-ss", formatFfmpegSeconds(ffmpegSeek(startTime)), "-i", videoPath, "-t", formatFfmpegSeconds(duration));
     }
-    const frameColour = toneMappedToSdr ? await readFirstFrameColour(videoPath) : undefined;
+    const frameColour = toneMappedToSdr
+        ? await readFirstFrameColour(videoPath, metadata.videoCodec)
+        : undefined;
     const filtersFor = videoFilterChain({
         metadata,
         format,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.9.16",
+  "version": "0.9.18",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
@@ -61,8 +61,8 @@
     "puppeteer": "~25.11.0",
     "puppeteer-core": "^25.11.0",
     "undici": "7.25.0",
-    "@hyperframes/core": "^0.9.16",
-    "@hyperframes/parsers": "^0.9.16"
+    "@hyperframes/core": "^0.9.18",
+    "@hyperframes/parsers": "^0.9.18"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",