@hyperframes/engine 0.8.145 → 0.8.146

package/dist/services/frameCapture.js

@@ -473,7 +473,7 @@ async function initDrawElementOrTransparentBackground(session, page, logInitPhas
     if ((session.config?.useDrawElement ?? false) && !supersampling && forceScreenshot) {
         session.deGateReason = "render_mode_hint";
         session.deFallbackTrigger = "render_mode_hint";
-        console.log("[engine] fast capture: falling back to screenshot — render-mode compatibility " +
+        console.log("[engine] fast capture falls back to screenshot: render-mode compatibility " +
             "hint forced screenshot capture (e.g. raw requestAnimationFrame composition).");
     }
     if (useDrawElement) {
@@ -521,7 +521,7 @@ async function initDrawElementOrTransparentBackground(session, page, logInitPhas
         if (!supportsDrawElement) {
             session.deGateReason = "unsupported_chrome";
             session.deFallbackTrigger = "unsupported_chrome";
-            console.log(`[engine] fast capture: falling back to ${session.launchCaptureMode} capture — ` +
+            console.log(`[engine] fast capture falls back to ${session.launchCaptureMode} capture: ` +
                 "this Chrome build does not implement canvas.drawElementImage (Dev/Canary-only " +
                 "feature); run `hyperframes browser ensure --force` to fetch a supported " +
                 "build, or set HYPERFRAMES_BROWSER_PATH to one.");
@@ -540,7 +540,7 @@ async function initDrawElementOrTransparentBackground(session, page, logInitPhas
         if (!forceDE && !(await isPsnrFilterAvailable())) {
             session.deGateReason = "ffmpeg_no_psnr_filter";
             session.deFallbackTrigger = "ffmpeg_no_psnr_filter";
-            console.warn(`[engine] fast capture: falling back to ${session.launchCaptureMode} capture — ` +
+            console.warn(`[engine] fast capture falls back to ${session.launchCaptureMode} capture: ` +
                 "host ffmpeg is missing or was built without the `psnr` filter " +
                 "(libpostproc), so drawElement self-verification cannot run. Install " +
                 "an ffmpeg build that includes libpostproc (or set HYPERFRAMES_FFMPEG_PATH " +
@@ -569,8 +569,8 @@ async function initDrawElementOrTransparentBackground(session, page, logInitPhas
             // "screenshot": on a BeginFrame-launched browser (Linux fast capture)
             // Page.captureScreenshot hangs for the full protocol timeout, while
             // beginFrameCapture is the platform's normal baseline path.
-            console.log(`[engine] fast capture: falling back to ${session.launchCaptureMode} capture — ` +
-                "SwiftShader (software rasterizer — no GPU egress to skip, drawElement is " +
+            console.log(`[engine] fast capture falls back to ${session.launchCaptureMode} capture: ` +
+                "SwiftShader (software rasterizer, no GPU egress to skip, drawElement is " +
                 "parity-or-slower; see fast-capture-limitations.md)");
             await routeToFallback();
         }
@@ -584,12 +584,11 @@ async function initDrawElementOrTransparentBackground(session, page, logInitPhas
                 const cssFx = await detectCssEffectRisk(page);
                 if (cssFx) {
                     session.deGateReason = `css_effect:${(cssFx.split(":")[0] ?? "").replace(/[^a-z-]/gi, "")}`;
-                    // Full specific effect ("filter:blur" / "filter:drop-shadow" /
-                    // "backdrop-filter" / "clip-path") — `deGateReason` sanitizes
-                    // this to the low-cardinality prefix; `deFallbackTrigger` keeps
-                    // the fine-grained value for the diagnostic profile emission.
+                    // Full specific effect from `detectCssEffectRisk` (e.g. "filter:blur",
+                    // "mix-blend-mode", "webgl-context") — `deGateReason` keeps its
+                    // low-cardinality prefix, `deFallbackTrigger` the full value.
                     session.deFallbackTrigger = cssFx;
-                    console.log(`[engine] fast capture: falling back to ${session.launchCaptureMode} capture — ` +
+                    console.log(`[engine] fast capture falls back to ${session.launchCaptureMode} capture: ` +
                         `${cssFx} detected (drawElementImage cannot reproduce it; see fast-capture-limitations.md)`);
                     await routeToFallback();
                     return;
@@ -620,7 +619,7 @@ async function initDrawElementOrTransparentBackground(session, page, logInitPhas
                 if (atRisk.size > 0 && atRiskFraction > fractionFloor) {
                     session.deGateReason = "at_risk_timeline";
                     session.deFallbackTrigger = "at_risk_timeline";
-                    console.log(`[engine] fast capture: falling back to ${session.launchCaptureMode} capture — ` +
+                    console.log(`[engine] fast capture falls back to ${session.launchCaptureMode} capture: ` +
                         `${atRisk.size}/${totalFrames} frames animate a compositor-incompatible prop ` +
                         `(blend/3D/clip/mask); drawElementImage drops these mid-animation ` +
                         `(deterministic timeline gate; see fast-capture-limitations.md Lim 7)`);
@@ -636,7 +635,7 @@ async function initDrawElementOrTransparentBackground(session, page, logInitPhas
             if (!forceDE && !threeD.ok) {
                 session.deGateReason = "3d_init_failed";
                 session.deFallbackTrigger = "3d_init_failed";
-                console.log(`[engine] fast capture: falling back to ${session.launchCaptureMode} capture — ` +
+                console.log(`[engine] fast capture falls back to ${session.launchCaptureMode} capture: ` +
                     `3D projection init failed (${threeD.reason ?? "unknown"})`);
                 await routeToFallback();
                 return;
@@ -761,7 +760,7 @@ export async function createCaptureSession(serverUrl, outputDir, options, onBefo
     // passed both flags — warn once and treat page-side as disabled.
     if (useDrawElement &&
         (config?.enablePageSideCompositing ?? DEFAULT_CONFIG.enablePageSideCompositing)) {
-        console.warn("[engine] useDrawElement is incompatible with page-side shader compositing — " +
+        console.warn("[engine] useDrawElement is incompatible with page-side shader compositing, " +
             "ignoring enablePageSideCompositing for this render. Prefer resolveConfig, " +
             "which disables page-side compositing automatically for fast-capture renders.");
     }
@@ -905,7 +904,7 @@ async function constructCaptureSession(input) {
     // measured ~28 dB of damage on comps whose fades it touched. Warn instead
     // of silently ignoring the old escape hatch.
     if (process.env.HF_FAST_CAPTURE_AUTOALPHA !== undefined) {
-        console.warn("[engine] HF_FAST_CAPTURE_AUTOALPHA is retired and ignored — the requestPaint " +
+        console.warn("[engine] HF_FAST_CAPTURE_AUTOALPHA is retired and ignored: the requestPaint " +
             "paint contract captures animated opacity natively (see drawElementService.ts).");
     }
     // Re-apply the captured root's own compositor-applied props to the 2D
@@ -1061,7 +1060,7 @@ export const HF_READY_DIAGNOSTIC_EXPR = `(async function() {
     await new Promise(function(r) { setTimeout(r, 0); });
   }
   // A thenable resolving via its own setTimeout(0) can still misreport as
-  // pending here (macrotask registration order, not resolution order) — a
+  // pending here (macrotask registration order, not resolution order), a
   // narrow case that self-corrects on the next ~1s diagnostic tick.
   var pendingBuildReadyKeys = keys.filter(function(key) { return !settled[key]; });
   var rejectedBuildReadyKeys = keys.filter(function(key) { return settled[key] === "rejected"; });
@@ -1082,20 +1081,20 @@ export function buildZeroDurationDiagnostic(diag) {
     const hints = [];
     if (diag.pendingBuildReadyKeys.length > 0) {
         hints.push(`window.__hf.buildReady never resolved for: ${diag.pendingBuildReadyKeys.join(", ")}. ` +
-            "The runtime holds render-ready until every registered buildReady promise settles — " +
-            "find where the composition registers that key and confirm it actually resolves.");
+            "The runtime holds render-ready until every registered buildReady promise settles. " +
+            "Find where the composition registers that key and confirm it actually resolves.");
     }
     if (diag.rejectedBuildReadyKeys.length > 0) {
         hints.push(`window.__hf.buildReady rejected for: ${diag.rejectedBuildReadyKeys.join(", ")}. ` +
-            "That key's build promise failed rather than hanging — find why it rejects.");
+            "That key's build promise failed rather than hanging. Find why it rejects.");
     }
     if (!diag.hasPlayer) {
-        hints.push("window.__player was never set — the HyperFrames runtime did not initialize.");
+        hints.push("window.__player was never set: the HyperFrames runtime did not initialize.");
     }
     if (!diag.hasTimeline) {
         hints.push("No GSAP timeline registered (window.__timelines is empty). " +
             "CSS/WAAPI/Lottie animations are usually auto-detected (the runtime infers " +
-            "duration from the longest running animation) — this composition's duration " +
+            "duration from the longest running animation), but this composition's duration " +
             "could not be inferred, which usually means an infinite/unbounded animation " +
             "(e.g. animation-iteration-count: infinite, repeat: -1 WAAPI, or a looping Lottie " +
             "clip) or a Three.js scene with no discoverable AnimationClip.");
@@ -1104,7 +1103,7 @@ export function buildZeroDurationDiagnostic(diag) {
         hints.push('Fix: add data-duration="<seconds>" to your root <div data-composition-id="..."> element.');
     }
     if (diag.hasSeek && diag.duration === 0 && diag.renderReady) {
-        hints.push("The runtime finished initializing but reported zero duration — this is permanent.");
+        hints.push("The runtime finished initializing but reported zero duration. This is permanent.");
     }
     return (`[FrameCapture] Composition has zero duration.\n` +
         `  Runtime ready: ${diag.renderReady}, __player: ${diag.hasPlayer}, ` +
@@ -1115,7 +1114,7 @@ export function buildZeroDurationDiagnostic(diag) {
 async function evaluateHfDiagnostic(page) {
     return (await page.evaluate(HF_READY_DIAGNOSTIC_EXPR));
 }
-async function pollHfReady(page, timeoutMs, intervalMs = 100) {
+export async function pollHfReady(page, timeoutMs, intervalMs = 100) {
     const readyExpr = `!!(window.__hf && typeof window.__hf.seek === "function" && window.__hf.duration > 0)`;
     const FAST_FAIL_AFTER_MS = 10_000;
     // Throttle diagnostic CDP calls to ~1000ms — running evaluateHfDiagnostic on
@@ -1125,8 +1124,10 @@ async function pollHfReady(page, timeoutMs, intervalMs = 100) {
     const deadline = Date.now() + timeoutMs;
     let lastDiagnosticAt = 0;
     while (Date.now() < deadline) {
-        const ready = Boolean(await page.evaluate(readyExpr));
-        if (ready)
+        const state = await page.evaluate(`typeof window.__hfStartupError === "string" ? window.__hfStartupError : ${readyExpr}`);
+        if (typeof state === "string")
+            throw new Error(state);
+        if (state)
             return;
         const elapsed = timeoutMs - (deadline - Date.now());
         if (elapsed >= FAST_FAIL_AFTER_MS) {
@@ -1237,7 +1238,7 @@ export async function pollSubCompositionTimelines(page, timeoutMs, { intervalMs
         if (failures.length > 0 && now - start >= scriptFailureGraceMs) {
             scriptFailureBail = true;
             console.warn(`[FrameCapture] Sub-composition timeline wait cut short after ${now - start}ms: ` +
-                `script resource(s) failed to load (${failures.join(", ")}) — ` +
+                `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.`);
             break;
@@ -1469,7 +1470,7 @@ export function buildLiveMapWarning(libraries) {
         code: "live_map_detected",
         message: `Live map viewport(s) detected in the composition (${libraries.join(", ")}). ` +
             `Map tiles load over the network at render time, which the deterministic-render ` +
-            `contract forbids — frames captured before tiles arrive ship a blank or partial map ` +
+            `contract forbids: frames captured before tiles arrive ship a blank or partial map ` +
             `with no error. Bake the map to a video first (see the motion-graphics maps skill / ` +
             `bake-basemap.mjs) and use the baked file as the imagery layer.`,
         details: { sources: [...libraries] },
@@ -1771,7 +1772,7 @@ export async function initializeSession(session) {
                             .join(", ");
                     });
                     console.warn(`[FrameCapture] Some image elements did not load within ${pageReadyTimeout}ms: ${failedImages}. ` +
-                        `Continuing render — affected images may appear blank/missing in early frames.`);
+                        `Continuing render. Affected images may appear blank/missing in early frames.`);
                 }
                 await decodeAllImages(page);
                 return ready;
@@ -1790,7 +1791,7 @@ export async function initializeSession(session) {
                     .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.`);
+                `Continuing render. Affected videos will appear as blank/black frames.`);
         }
         recordCaptureWarnings(session, await collectMediaReadinessWarnings(page, skipVideoIds, pageReadyTimeout));
         await recordLiveMapWarning(session, page);
@@ -1901,7 +1902,7 @@ export async function initializeSession(session) {
                             .join(", ");
                     });
                     console.warn(`[FrameCapture] Some image elements did not load within ${pageReadyTimeout}ms: ${failedImages}. ` +
-                        `Continuing render — affected images may appear blank/missing in early frames.`);
+                        `Continuing render. Affected images may appear blank/missing in early frames.`);
                 }
                 await decodeAllImages(page);
                 return ready;
@@ -1920,7 +1921,7 @@ export async function initializeSession(session) {
                     .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.`);
+                `Continuing render. Affected videos will appear as blank/black frames.`);
         }
         recordCaptureWarnings(session, await collectMediaReadinessWarnings(page, bfSkipVideoIds, pageReadyTimeout));
         await recordLiveMapWarning(session, page);
@@ -2721,7 +2722,7 @@ async function armStaticDedup(session, page, logInitPhase) {
  * compositor-incompatible properties (blend-mode, 3D transforms, clip-path, mask).
  * drawElement cannot reproduce these effects mid-tween → capture those frames via
  * screenshot instead. opacity/filter fades were dropped from the set once Chrome 151
- * fixed crbug 521861819. See docs/fast-capture-limitations.md Lim 7.
+ * fixed crbug 521861819.
  *
  * Returns the union of at-risk frame indices (±1 margin around each tween interval)
  * and totalFrames (for fraction computation by the caller).
@@ -3235,7 +3236,7 @@ export async function captureFrameToBuffer(session, frameIndex, time) {
             // works. Counted here rather than in captureFrameCore's catch: the
             // deadline rejects from outside it, so that catch never runs.
             session.deFrameTimeouts = (session.deFrameTimeouts ?? 0) + 1;
-            console.log(`[engine] fast capture: frame ${frameIndex} — capture exceeded ` +
+            console.log(`[engine] fast capture frame ${frameIndex}: capture exceeded ` +
                 `${DE_FRAME_TIMEOUT_MS}ms; renderer stalled after drawElementImage ` +
                 `(PRINFRA-488). Failing the drawElement attempt so the whole render ` +
                 `retries via screenshot.`);
@@ -3809,4 +3810,3 @@ export function getCapturePerfSummary(session) {
         deFrameTimeouts: session.deFrameTimeouts ?? 0,
     };
 }
-//# sourceMappingURL=frameCapture.js.map

package/dist/services/hdrCapture.d.ts

@@ -45,4 +45,3 @@ export declare function launchHdrBrowser(width: number, height: number): Promise
     page: Page;
 }>;
 export declare function buildHdrChromeArgs(width: number, height: number): string[];
-//# sourceMappingURL=hdrCapture.d.ts.map

package/dist/services/hdrCapture.js

@@ -231,4 +231,3 @@ export function buildHdrChromeArgs(width, height) {
         "--autoplay-policy=no-user-gesture-required",
     ];
 }
-//# sourceMappingURL=hdrCapture.js.map

package/dist/services/mediaHidden.d.ts

@@ -14,4 +14,3 @@ export type AudioGroupsById = ReadonlyMap<string, {
 export declare function audioGroupsById(document: Parameters<typeof resolveAudioGroups>[0]): AudioGroupsById;
 export declare function isMemberGroupHidden(groupsById: AudioGroupsById, el: GroupKeyEl): boolean;
 export {};
-//# sourceMappingURL=mediaHidden.d.ts.map

package/dist/services/mediaHidden.js

@@ -17,4 +17,3 @@ export function isMemberGroupHidden(groupsById, el) {
     const groupId = memberGroupKey(el);
     return groupId ? (groupsById.get(groupId)?.hidden ?? false) : false;
 }
-//# sourceMappingURL=mediaHidden.js.map

package/dist/services/mediaRenderIdBridge.d.ts

@@ -32,4 +32,3 @@ declare global {
  * mid-render navigation cannot leave a capture stage without them.
  */
 export declare function installMediaRenderIdBridge(page: Page): Promise<void>;
-//# sourceMappingURL=mediaRenderIdBridge.d.ts.map

package/dist/services/mediaRenderIdBridge.js

@@ -34,4 +34,3 @@ export async function installMediaRenderIdBridge(page) {
         window.__hfMediaId = (el) => el.getAttribute(attr) || el.id;
     }, MEDIA_RENDER_ID_ATTR);
 }
-//# sourceMappingURL=mediaRenderIdBridge.js.map

package/dist/services/mediaTimelineWindow.d.ts

@@ -4,4 +4,3 @@ interface TimelineAttributeReader {
 /** True only when authored timing explicitly declares an inactive window. */
 export declare function isKnownInactiveTimelineWindow(element: TimelineAttributeReader, resolvedStart: number): boolean;
 export {};
-//# sourceMappingURL=mediaTimelineWindow.d.ts.map

package/dist/services/mediaTimelineWindow.js

@@ -7,4 +7,3 @@ export function isKnownInactiveTimelineWindow(element, resolvedStart) {
     const end = parseStrictFiniteTimingNumber(element.getAttribute("data-end"));
     return end != null && end <= resolvedStart;
 }
-//# sourceMappingURL=mediaTimelineWindow.js.map

package/dist/services/motionBlur.d.ts

@@ -130,4 +130,3 @@ export declare class MotionBlurAccumulator {
         data: Uint8Array;
     };
 }
-//# sourceMappingURL=motionBlur.d.ts.map

package/dist/services/motionBlur.js

@@ -272,4 +272,3 @@ export class MotionBlurAccumulator {
         return { width: this.width, height: this.height, data: out };
     }
 }
-//# sourceMappingURL=motionBlur.js.map

package/dist/services/pageNavigationTimeoutErrorHint.d.ts

@@ -76,4 +76,3 @@ export declare function augmentPageNavigationTimeoutError(err: unknown, effectiv
  * drift.
  */
 export declare function isPageNavigationTimeoutError(err: unknown): boolean;
-//# sourceMappingURL=pageNavigationTimeoutErrorHint.d.ts.map

package/dist/services/pageNavigationTimeoutErrorHint.js

@@ -109,4 +109,3 @@ function buildDockerHintBlock() {
         `identically under Docker. Consider:\n` +
         `  hyperframes render ... --docker\n`);
 }
-//# sourceMappingURL=pageNavigationTimeoutErrorHint.js.map

package/dist/services/parallelCoordinator.d.ts

@@ -261,4 +261,3 @@ export declare function getSystemResources(): {
     recommendedWorkers: number;
 };
 export {};
-//# sourceMappingURL=parallelCoordinator.d.ts.map

package/dist/services/parallelCoordinator.js

@@ -89,7 +89,7 @@ export function synthesizeSilentWorkerExitError(result, expectedFrames) {
     return (`worker ${result.workerId} exited without terminal error string ` +
         `(framesCaptured=${result.framesCaptured}, expected=${expectedFrames}, ` +
         `range=[${result.startFrame}, ${result.endFrame})). ` +
-        `Field signal ts=1784042064 — this class of failure has been reported; ` +
+        `Field signal ts=1784042064: this class of failure has been reported; ` +
         `consider re-run with --workers=1 to isolate.`);
 }
 /**
@@ -508,7 +508,7 @@ async function psnrForDiskSample(framePath, truth, workerId, idx) {
         if (isFfmpegInfrastructureFailure(err)) {
             const detail = err instanceof Error ? err.message : String(err);
             throw new Error(`[Parallel] drawElement disk self-verify aborted (worker ${workerId}, frame ${idx}): ` +
-                `ffmpeg or the \`psnr\` filter is unavailable — ${detail}. The preflight in ` +
+                `ffmpeg or the \`psnr\` filter is unavailable (${detail}). The preflight in ` +
                 "initDrawElementOrTransparentBackground normally catches this at bootstrap; if you " +
                 "hit this after a successful preflight, ffmpeg was replaced mid-render or " +
                 "HYPERFRAMES_FFMPEG_PATH now points at a different binary.", { cause: err });
@@ -821,4 +821,3 @@ export function getSystemResources() {
         recommendedWorkers: calculateOptimalWorkers(1000),
     };
 }
-//# sourceMappingURL=parallelCoordinator.js.map

package/dist/services/protocolTimeoutErrorHint.d.ts

@@ -25,4 +25,3 @@ export declare function augmentProtocolTimeoutError(err: unknown, effectiveTimeo
  * the same matcher as the augmentation path so the two never drift.
  */
 export declare function isProtocolTimeoutError(err: unknown): boolean;
-//# sourceMappingURL=protocolTimeoutErrorHint.d.ts.map

package/dist/services/protocolTimeoutErrorHint.js

@@ -42,4 +42,3 @@ export function isProtocolTimeoutError(err) {
     const message = err instanceof Error ? err.message : typeof err === "string" ? err : "";
     return PROTOCOL_TIMEOUT_MATCHER.test(message);
 }
-//# sourceMappingURL=protocolTimeoutErrorHint.js.map

package/dist/services/referenceResolver.d.ts

@@ -36,4 +36,3 @@ export declare function resolveReferencedStart(doc: RefResolverDoc, el: RefResol
  * at parse time) — the caller then treats the reference as duration-0.
  */
 export declare function resolveReferencedDuration(doc: RefResolverDoc, el: RefResolverEl, startCache: Map<RefResolverEl, number>, visiting: Set<RefResolverEl>): number | null;
-//# sourceMappingURL=referenceResolver.d.ts.map

package/dist/services/referenceResolver.js

@@ -85,4 +85,3 @@ export function resolveReferencedDuration(doc, el, startCache, visiting) {
     }
     return null;
 }
-//# sourceMappingURL=referenceResolver.js.map

package/dist/services/screenshotService.d.ts

@@ -193,4 +193,3 @@ export declare function injectVideoFramesBatch(page: Page, updates: Array<{
     dataUri: string;
 }>): Promise<string[]>;
 export declare function syncVideoFrameVisibility(page: Page, activeVideoIds: string[]): Promise<void>;
-//# sourceMappingURL=screenshotService.d.ts.map

package/dist/services/screenshotService.js

@@ -99,7 +99,7 @@ async function sendBeginFrame(client, params) {
                 continue;
             }
             if (isPending) {
-                throw new Error(`[BeginFrame] Frame still pending after ${PENDING_FRAME_RETRIES} retries — CPU overloaded by parallel renders. ` +
+                throw new Error(`[BeginFrame] Frame still pending after ${PENDING_FRAME_RETRIES} retries: CPU overloaded by parallel renders. ` +
                     `Reduce concurrent renders or use --docker for isolation.`);
             }
             throw err;
@@ -632,6 +632,14 @@ export async function injectVideoFramesBatch(page, updates) {
                 : Number.isNaN(opacityParsed)
                     ? 1
                     : opacityParsed;
+            // Measure first: an in-flow bordered <img> sibling would shrink the video's flex box.
+            const videoRect = video.getBoundingClientRect();
+            const videoBox = {
+                left: Number.isFinite(video.offsetLeft) ? video.offsetLeft : 0,
+                top: Number.isFinite(video.offsetTop) ? video.offsetTop : 0,
+                width: video.offsetWidth > 0 ? video.offsetWidth : videoRect.width,
+                height: video.offsetHeight > 0 ? video.offsetHeight : videoRect.height,
+            };
             if (isNewImage) {
                 img = document.createElement("img");
                 img.classList.add("__render_frame__");
@@ -667,24 +675,16 @@ export async function injectVideoFramesBatch(page, updates) {
             // instead of flowing below it. With position:relative, both elements
             // stack vertically — the <img> lands below the video and gets clipped
             // by any overflow:hidden ancestor (e.g., border-radius wrappers).
-            //
-            // Apply this after visual style copying so the measured used box is
-            // the final authority for replacement frame geometry.
-            {
-                const videoRect = video.getBoundingClientRect();
-                const offsetLeft = Number.isFinite(video.offsetLeft) ? video.offsetLeft : 0;
-                const offsetTop = Number.isFinite(video.offsetTop) ? video.offsetTop : 0;
-                const offsetWidth = video.offsetWidth > 0 ? video.offsetWidth : videoRect.width;
-                const offsetHeight = video.offsetHeight > 0 ? video.offsetHeight : videoRect.height;
-                img.style.position = "absolute";
-                img.style.inset = "auto";
-                img.style.left = `${offsetLeft}px`;
-                img.style.top = `${offsetTop}px`;
-                img.style.right = "auto";
-                img.style.bottom = "auto";
-                img.style.width = `${offsetWidth}px`;
-                img.style.height = `${offsetHeight}px`;
-            }
+            img.style.position = "absolute";
+            img.style.inset = "auto";
+            img.style.left = `${videoBox.left}px`;
+            img.style.top = `${videoBox.top}px`;
+            img.style.right = "auto";
+            img.style.bottom = "auto";
+            img.style.width = `${videoBox.width}px`;
+            img.style.height = `${videoBox.height}px`;
+            // `videoBox` is a border-box even when the video is content-box.
+            img.style.boxSizing = "border-box";
             img.style.objectFit = computedStyle.objectFit;
             img.style.objectPosition = computedStyle.objectPosition;
             img.style.zIndex = computedStyle.zIndex;
@@ -782,4 +782,3 @@ export async function syncVideoFrameVisibility(page, activeVideoIds) {
         }
     }, activeVideoIds, COLOR_GRADING_SOURCE_HIDDEN_ATTR);
 }
-//# sourceMappingURL=screenshotService.js.map

package/dist/services/streamingEncoder.d.ts

@@ -102,4 +102,3 @@ export declare function buildStreamingArgs(options: StreamingEncoderOptions, out
  * Spawn a streaming FFmpeg encoder that accepts frame buffers on stdin.
  */
 export declare function spawnStreamingEncoder(outputPath: string, options: StreamingEncoderOptions, signal?: AbortSignal, config?: Partial<Pick<EngineConfig, "ffmpegStreamingTimeout">>): Promise<StreamingEncoder>;
-//# sourceMappingURL=streamingEncoder.d.ts.map

package/dist/services/streamingEncoder.js

@@ -496,4 +496,3 @@ export async function spawnStreamingEncoder(outputPath, options, signal, config)
     };
     return encoder;
 }
-//# sourceMappingURL=streamingEncoder.js.map

package/dist/services/systemMemory.d.ts

@@ -49,4 +49,3 @@ export declare const LOW_MEMORY_TOTAL_MB_THRESHOLD = 8192;
  * small VMs, small Lambda tiers, small containers) are detected correctly.
  */
 export declare function isLowMemorySystem(totalMb?: number): boolean;
-//# sourceMappingURL=systemMemory.d.ts.map

package/dist/services/systemMemory.js

@@ -80,8 +80,8 @@ export function getCgroupMemoryLimitMb() {
         // stderr, not stdout: this is a diagnostic notice, and commands like `check --json`
         // write their machine-readable payload to stdout. A banner on stdout corrupts that
         // payload for any JSON consumer (it broke the Video Agent's hyperframes check parse).
-        console.warn(`[SystemMemory] cgroup memory limit detected: ${_cachedCgroupLimitMb} MiB — ` +
-            `it governs memory-adaptive render behaviour instead of host RAM.`);
+        console.warn(`[SystemMemory] cgroup memory limit detected: ${_cachedCgroupLimitMb} MiB. ` +
+            `It governs memory-adaptive render behaviour instead of host RAM.`);
     }
     return _cachedCgroupLimitMb;
 }
@@ -154,4 +154,3 @@ export const LOW_MEMORY_TOTAL_MB_THRESHOLD = 8192;
 export function isLowMemorySystem(totalMb = getSystemTotalMb()) {
     return totalMb <= LOW_MEMORY_TOTAL_MB_THRESHOLD;
 }
-//# sourceMappingURL=systemMemory.js.map

package/dist/services/threeDProjection.d.ts

@@ -77,4 +77,3 @@ export declare function initThreeDProjection(page: Page): Promise<ThreeDProjecti
  * Returns the first matched effect name (for logging) or null.
  */
 export declare function detectCssEffectRisk(page: Page): Promise<string | null>;
-//# sourceMappingURL=threeDProjection.d.ts.map

package/dist/services/threeDProjection.js

@@ -510,7 +510,7 @@ export async function initThreeDProjectionInPage() {
                     ok: false,
                     groups: 0,
                     quads: 0,
-                    reason: "degenerate 3D geometry (zero-size or inline-box quad) — " +
+                    reason: "degenerate 3D geometry (zero-size or inline-box quad): " +
                         "quad projection cannot reproduce Blink's lenient rendering",
                 };
             }
@@ -521,7 +521,7 @@ export async function initThreeDProjectionInPage() {
                     ok: false,
                     groups: 0,
                     quads: 0,
-                    reason: "3D quad contains GSAP-animated descendants — static texture " +
+                    reason: "3D quad contains GSAP-animated descendants, a static texture " +
                         "would freeze them at init state",
                 };
             }
@@ -977,4 +977,3 @@ export async function detectCssEffectRisk(page) {
         return null;
     }
 }
-//# sourceMappingURL=threeDProjection.js.map

package/dist/services/videoFrameExtractor.d.ts

@@ -105,6 +105,8 @@ export interface ExtractionOptions {
      * `totalFrames` so another process can extract just the frames it needs with `frameRanges`.
      */
     deferRangeExtraction?: boolean;
+    /** Directories the caller rewrites on every render (downloaded media); their sources are cached by content. */
+    contentKeyedDirs?: readonly string[];
 }
 export declare const EXTRACT_CACHE_MIN_AGE_MS: number;
 /**
@@ -280,6 +282,7 @@ export interface TimelineExtractionWindow {
     finalFrameOnly?: boolean;
 }
 type TimelineWindowVideo = Pick<VideoElement, "start" | "end" | "mediaStart"> & Partial<Pick<VideoElement, "playbackRate">> & Partial<Pick<VideoElement, "loop">>;
+export declare function isVideoPastTimelineEnd(video: Pick<VideoElement, "start">, timelineEnd: number): boolean;
 /** Move a clip to its extraction window; a rate lane is shifted so it keeps integrating from the new origin. */
 export declare function rebaseVideoToWindow(video: VideoElement, window: TimelineExtractionWindow): void;
 /**
@@ -346,4 +349,3 @@ export declare class FrameLookupTable {
     cleanup(): void;
 }
 export declare function createFrameLookupTable(videos: VideoElement[], extracted: ExtractedFrames[], fps?: number): FrameLookupTable;
-//# sourceMappingURL=videoFrameExtractor.d.ts.map