hyperframes 0.8.40 → 0.8.42

package/dist/fontLocalizeCli.js

@@ -56728,7 +56728,12 @@ var init_captureFailure = __esm({
       /Navigation timeout of \d+ ms exceeded/i,
       /ECONNREFUSED/i,
       /net::ERR_NETWORK_CHANGED/i,
-      /Composition has zero duration[\s\S]*Runtime ready: false/
+      /Composition has zero duration[\s\S]*Runtime ready: false/,
+      // CDP can refuse a capture call outright with this exact wording; timed-out
+      // variants of the same call hit PROTOCOL_TIMEOUT_PATTERNS, checked first.
+      // Anchored to this literal reason (not just the CDP method) so an unrelated,
+      // genuinely deterministic Page.captureScreenshot error isn't swept in too.
+      /Protocol error \(Page\.captureScreenshot\): Unable to capture screenshot/i
     ];
     PROTOCOL_TIMEOUT_PATTERNS = [
       /Network\.enable timed out/i,
@@ -59548,6 +59553,19 @@ function getHdrEncoderColorParams(transfer, mastering = DEFAULT_HDR10_MASTERING)
     mastering
   };
 }
+function sanitizeHdrAutoPromotionAsset(asset) {
+  return asset.split(/[\r\n?#]/, 1)[0] ?? "";
+}
+function findHdrAutoPromotion(sources) {
+  const source = sources.find(({ colorSpace }) => isHdrColorSpace(colorSpace));
+  return source ? {
+    triggeringAsset: sanitizeHdrAutoPromotionAsset(source.asset),
+    output: HDR_AUTO_PROMOTION_PIPELINE
+  } : null;
+}
+function formatHdrAutoPromotionWarning(promotion) {
+  return `[Render] HDR auto-promotion triggered by "${promotion.triggeringAsset}" \u2014 output: ${promotion.output.colorSpace} / ${promotion.output.codec}`;
+}
 function analyzeCompositionHdr(colorSpaces) {
   let hasPq = false;
   let hasHdr = false;
@@ -59560,7 +59578,7 @@ function analyzeCompositionHdr(colorSpaces) {
   const dominantTransfer = hasPq ? "pq" : "hlg";
   return { hasHdr: true, dominantTransfer };
 }
-var DEFAULT_HDR10_MASTERING;
+var DEFAULT_HDR10_MASTERING, HDR_AUTO_PROMOTION_PIPELINE;
 var init_hdr = __esm({
   "../engine/src/utils/hdr.ts"() {
     "use strict";
@@ -59568,6 +59586,10 @@ var init_hdr = __esm({
       masterDisplay: "G(13250,34500)B(7500,3000)R(34000,16000)WP(15635,16450)L(10000000,1)",
       maxCll: "1000,400"
     };
+    HDR_AUTO_PROMOTION_PIPELINE = {
+      colorSpace: "BT.2020",
+      codec: "HEVC Main10"
+    };
   }
 });
 
@@ -70906,6 +70928,7 @@ var init_dist3 = __esm({
     init_composition();
     init_slideshow();
     init_esm10();
+    init_esm10();
     COMPOSITION_ID_IN_CSS_PATTERN = /\[data-composition-id=["']([^"']+)["']\]/g;
     TIMELINE_REGISTRY_INIT_PATTERN = /window\.__timelines\s*=\s*window\.__timelines\s*\|\|\s*\{\}|window\.__timelines\s*=\s*\{\}|window\.__timelines\s*\?\?=\s*\{\}/i;
     TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN = /window\.__timelines\s*=\s*\{\s*(?:["'][^"']+["']|[A-Za-z_$][\w$]*)\s*:/i;
@@ -74630,13 +74653,20 @@ function publishCacheEntry(entry, partialDir) {
     return adoptPublishedWinner(entry, partialDir) ?? { dir: partialDir, published: false };
   }
 }
-function touchCacheEntry(entry) {
+function touchCacheDir(dir) {
+  const now = /* @__PURE__ */ new Date();
+  try {
+    utimesSync(dir, now, now);
+  } catch {
+  }
   try {
-    const now = /* @__PURE__ */ new Date();
-    utimesSync(join10(entry.dir, COMPLETE_SENTINEL), now, now);
+    utimesSync(join10(dir, COMPLETE_SENTINEL), now, now);
   } catch {
   }
 }
+function touchCacheEntry(entry) {
+  touchCacheDir(entry.dir);
+}
 function isCacheLikeChild(name) {
   return name.startsWith(CACHE_GENERATION_PREFIX) || name.includes(".partial-");
 }
@@ -75168,6 +75198,9 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   if (options.sdrToHdrTransfer) {
     vfFilters.push(SDR_TO_HDR_COLORSPACE_FILTER);
   }
+  if (options.toneMapHdrToSdr && isHdr && !isMacOS) {
+    vfFilters.push(HDR_TO_SDR_TONEMAP_FILTER);
+  }
   if (vfFilters.length > 0) args.push("-vf", vfFilters.join(","));
   if (!options.finalFrameOnly && metadata.isVFR) {
     args.push("-fps_mode", "cfr", "-r", ffmpegFps);
@@ -75260,6 +75293,10 @@ function resolveSegmentDuration(requested, mediaStart, sourceDuration) {
 function resolvePlayableVideoDuration(metadata) {
   return Number.isFinite(metadata.videoStreamDurationSeconds) && metadata.videoStreamDurationSeconds > 0 ? metadata.videoStreamDurationSeconds : metadata.durationSeconds;
 }
+function canHoldFinalFramePastEof(video) {
+  const timelineDuration = video.end - video.start;
+  return !video.loop && Number.isFinite(timelineDuration) && timelineDuration > 0;
+}
 function resolveTimelineExtractionWindow(video, resolvedDuration, timelineEnd, sourceDuration) {
   const playbackRate = normalizePlaybackRate(video.playbackRate ?? 1);
   const withTimelineDuration = (window3, timelineDurationSeconds) => playbackRate === 1 ? window3 : { ...window3, timelineDurationSeconds };
@@ -75328,6 +75365,18 @@ function resolveTimelineExtractionWindow(video, resolvedDuration, timelineEnd, s
         },
         visibleDuration
       );
+    } else if (canHoldFinalFramePastEof(video)) {
+      const logicalDuration = Math.min(sourceDuration, FINAL_FRAME_LOGICAL_DURATION_SECONDS);
+      return withTimelineDuration(
+        {
+          compositionStart: video.start,
+          mediaStart: sourceDuration - logicalDuration,
+          durationSeconds: logicalDuration,
+          preserveTimelineEnd: true,
+          ensureFinalFrame: true
+        },
+        visibleDuration
+      );
     }
   }
   return withTimelineDuration(
@@ -75352,7 +75401,10 @@ async function resolveFinalFrameExtractionWindow(videoPath, video, metadata, win
   );
   if (window3.mediaStart < finalFrameTimestamp - 1e-9) return window3;
   const sourceRemaining = playableDuration - video.mediaStart;
-  const logicalDuration = Math.min(sourceRemaining, FINAL_FRAME_LOGICAL_DURATION_SECONDS);
+  const logicalDuration = Math.min(
+    Math.max(sourceRemaining, window3.durationSeconds),
+    FINAL_FRAME_LOGICAL_DURATION_SECONDS
+  );
   return {
     compositionStart: Math.max(0, video.start),
     mediaStart: playableDuration - logicalDuration,
@@ -75373,7 +75425,9 @@ function resolveVideoExtractionWindow(video, metadata, timelineEnd) {
       `Playable video stream duration is ${playableDuration}s`
     );
   }
-  if (video.mediaStart >= playableDuration) {
+  const requestedTimelineDuration = video.end - video.start;
+  const heldPastEof = video.mediaStart >= playableDuration && canHoldFinalFramePastEof(video);
+  if (video.mediaStart >= playableDuration && !heldPastEof) {
     throw new VideoSourceExtractionError(
       "media_start_out_of_range",
       false,
@@ -75382,9 +75436,13 @@ function resolveVideoExtractionWindow(video, metadata, timelineEnd) {
     );
   }
   const playbackRate = normalizePlaybackRate(video.playbackRate ?? 1);
-  const requestedTimelineDuration = video.end - video.start;
   const resolvedDuration = Number.isFinite(requestedTimelineDuration) && requestedTimelineDuration > 0 ? requestedTimelineDuration : resolveSegmentDuration(requestedTimelineDuration, video.mediaStart, playableDuration) / playbackRate;
-  return resolveTimelineExtractionWindow(video, resolvedDuration, timelineEnd, playableDuration);
+  return resolveTimelineExtractionWindow(
+    video,
+    resolvedDuration,
+    timelineEnd ?? (heldPastEof ? video.end : void 0),
+    playableDuration
+  );
 }
 function resolveVideoExtractionDuration(video, metadata, timelineEnd) {
   return resolveVideoExtractionWindow(video, metadata, timelineEnd).durationSeconds;
@@ -75433,6 +75491,7 @@ function supersetGroupingKey(work, fps) {
     String(fps),
     work.format,
     work.sdrToHdrTransfer ?? "",
+    work.toneMapHdrToSdr ? HDR_TO_SDR_TRANSFORM_KEY : "",
     work.finalFrameOnly ? "final" : "range"
   ].join("\0");
 }
@@ -75700,7 +75759,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
         const metadata = videoMetadata[i];
         if (!entry || !metadata) continue;
         const playableDuration = resolvePlayableVideoDuration(metadata);
-        if (entry.video.mediaStart >= playableDuration) {
+        if (entry.video.mediaStart >= playableDuration && !canHoldFinalFramePastEof(entry.video)) {
           errors.push({
             videoId: entry.video.id,
             kind: "media_start_out_of_range",
@@ -75764,6 +75823,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
       ...options,
       format: work.format,
       sdrToHdrTransfer: work.sdrToHdrTransfer,
+      toneMapHdrToSdr: work.toneMapHdrToSdr,
       finalFrameOnly: work.finalFrameOnly
     };
   }
@@ -75783,6 +75843,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
     if (!keyInput) return { work };
     const transformParts = [
       work.sdrToHdrTransfer ? sdrToHdrTransformKey(work.sdrToHdrTransfer) : void 0,
+      work.toneMapHdrToSdr ? HDR_TO_SDR_TRANSFORM_KEY : void 0,
       work.finalFrameOnly ? "final-frame" : void 0
     ].filter((part) => part !== void 0);
     const transform = transformParts.length > 0 ? transformParts.join("+") : void 0;
@@ -75963,8 +76024,9 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
         if (keyInput) keyInput.mediaStart = extractionMediaStart;
         const format = resolveFrameFormat(metadata, options.format);
         const sdrToHdrTransfer = sdrToHdrTransfers[index];
+        const toneMapHdrToSdr = options.toneMapHdrToSdr === true && isHdrColorSpace(metadata.colorSpace);
         const finalFrameOnly = window3.finalFrameOnly === true;
-        const dedupeKey = `${videoPath}\0${extractionMediaStart}\0${videoDuration}\0${fpsKey}\0${format}\0${sdrToHdrTransfer ?? ""}\0${finalFrameOnly ? "final" : "range"}`;
+        const dedupeKey = `${videoPath}\0${extractionMediaStart}\0${videoDuration}\0${fpsKey}\0${format}\0${sdrToHdrTransfer ?? ""}\0${toneMapHdrToSdr ? HDR_TO_SDR_TRANSFORM_KEY : ""}\0${finalFrameOnly ? "final" : "range"}`;
         return {
           work: {
             video,
@@ -75976,6 +76038,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
             finalFrameOnly,
             format,
             sdrToHdrTransfer,
+            toneMapHdrToSdr,
             dedupeKey
           }
         };
@@ -76110,7 +76173,7 @@ function createFrameLookupTable(videos, extracted) {
   }
   return table;
 }
-var VIDEO_FRAME_FORMATS, EXTRACT_CACHE_MIN_AGE_MS, GC_STALENESS_MS, SDR_TO_HDR_COLORSPACE_FILTER, VideoSourceExtractionError, TRANSIENT_FFMPEG_SPAWN_CODES, FINAL_FRAME_LOGICAL_DURATION_SECONDS, ALPHA_CAPABLE_CODECS, FrameLookupTable;
+var VIDEO_FRAME_FORMATS, EXTRACT_CACHE_MIN_AGE_MS, GC_STALENESS_MS, SDR_TO_HDR_COLORSPACE_FILTER, HDR_TO_SDR_TONEMAP_FILTER, HDR_TO_SDR_TRANSFORM_KEY, VideoSourceExtractionError, TRANSIENT_FFMPEG_SPAWN_CODES, FINAL_FRAME_LOGICAL_DURATION_SECONDS, ALPHA_CAPABLE_CODECS, FrameLookupTable;
 var init_videoFrameExtractor = __esm({
   "../engine/src/services/videoFrameExtractor.ts"() {
     "use strict";
@@ -76130,6 +76193,8 @@ var init_videoFrameExtractor = __esm({
     EXTRACT_CACHE_MIN_AGE_MS = 60 * 60 * 1e3;
     GC_STALENESS_MS = 24 * 60 * 60 * 1e3;
     SDR_TO_HDR_COLORSPACE_FILTER = "colorspace=all=bt2020:iall=bt709:range=tv";
+    HDR_TO_SDR_TONEMAP_FILTER = "zscale=t=linear:npl=100,tonemap=hable:desat=0,zscale=p=bt709:t=bt709:m=bt709:r=tv";
+    HDR_TO_SDR_TRANSFORM_KEY = "hdr2sdr-hable-bt709";
     VideoSourceExtractionError = class extends Error {
       constructor(kind, retryable, message, diagnostic = message) {
         super(message);
@@ -76267,6 +76332,7 @@ var init_videoFrameExtractor = __esm({
 
 // ../engine/src/services/videoFrameInjector.ts
 import { promises as fs } from "fs";
+import { dirname as dirname7 } from "path";
 function createFrameSourceCache(entryLimit, bytesLimit, frameSrcResolver) {
   const cache = /* @__PURE__ */ new Map();
   const inFlight = /* @__PURE__ */ new Map();
@@ -76346,6 +76412,15 @@ function createVideoFrameInjector(frameLookup, config) {
   const bytesLimit = bytesLimitMb * 1024 * 1024;
   const frameCache = createFrameSourceCache(entryLimit, bytesLimit, config?.frameSrcResolver);
   const lastInjectedFrameByVideo = /* @__PURE__ */ new Map();
+  const lastCacheTouchByDir = /* @__PURE__ */ new Map();
+  function renewCacheLease(framePath) {
+    const cacheDir = dirname7(framePath);
+    const now = Date.now();
+    const lastTouch = lastCacheTouchByDir.get(cacheDir);
+    if (lastTouch !== void 0 && now - lastTouch < CACHE_TOUCH_THROTTLE_MS) return;
+    touchCacheDir(cacheDir);
+    lastCacheTouchByDir.set(cacheDir, now);
+  }
   return async (page, time) => {
     const activePayloads = frameLookup.getActiveFramePayloads(time);
     const updates = [];
@@ -76354,6 +76429,7 @@ function createVideoFrameInjector(frameLookup, config) {
       const pendingReads = [];
       for (const [videoId, payload] of activePayloads) {
         activeIds.add(videoId);
+        renewCacheLease(payload.framePath);
         const lastFrameIndex = lastInjectedFrameByVideo.get(videoId);
         if (lastFrameIndex === payload.frameIndex) continue;
         pendingReads.push(
@@ -76679,12 +76755,15 @@ async function queryElementStacking(page, nativeHdrIds) {
     RENDER_FRAME_ID_SUFFIX
   );
 }
+var CACHE_TOUCH_THROTTLE_MS;
 var init_videoFrameInjector = __esm({
   "../engine/src/services/videoFrameInjector.ts"() {
     "use strict";
+    init_extractionCache();
     init_screenshotService();
     init_config();
     init_dist2();
+    CACHE_TOUCH_THROTTLE_MS = 5 * 60 * 1e3;
   }
 });
 
@@ -76839,7 +76918,7 @@ var init_wavChunks = __esm({
 
 // ../engine/src/services/audioVolumeEnvelope.ts
 import { mkdtempSync as mkdtempSync3, readFileSync as readFileSync3, renameSync as renameSync2, rmSync as rmSync4, writeFileSync as writeFileSync4 } from "fs";
-import { dirname as dirname7, join as join12 } from "path";
+import { dirname as dirname8, join as join12 } from "path";
 function readFmtChunk(buffer, body) {
   const format = buffer.readUInt16LE(body);
   const bits = buffer.readUInt16LE(body + 14);
@@ -76911,7 +76990,7 @@ function applyVolumeEnvelopeToWav(wavPath, keyframes, trackStart, baseVolume) {
     const layout2 = parseWavLayout(buffer);
     if (!layout2) return false;
     scaleSamples(buffer, layout2, gainAt);
-    stagingDir = mkdtempSync3(join12(dirname7(wavPath), ".hf-volume-"));
+    stagingDir = mkdtempSync3(join12(dirname8(wavPath), ".hf-volume-"));
     const tempPath = join12(stagingDir, "audio.wav");
     writeFileSync4(tempPath, buffer, { flag: "wx" });
     renameSync2(tempPath, wavPath);
@@ -78384,7 +78463,7 @@ var init_audioFxRender = __esm({
 
 // ../engine/src/services/audioMixer.ts
 import { closeSync as closeSync2, existsSync as existsSync12, mkdirSync as mkdirSync7, mkdtempSync as mkdtempSync5, openSync as openSync2, rmSync as rmSync6, writeFileSync as writeFileSync6 } from "fs";
-import { join as join14, dirname as dirname8 } from "path";
+import { join as join14, dirname as dirname9 } from "path";
 function memberGroupKey(el) {
   return el.getAttribute(AUDIO_GROUP_RENDER_ID_ATTR) ?? el.getAttribute(HF_AUDIO_GROUP_ATTR);
 }
@@ -78687,7 +78766,7 @@ function parseAudioElements(html) {
 }
 async function extractAudioFromVideo(videoPath, outputPath, options, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
-  const outputDir = dirname8(outputPath);
+  const outputDir = dirname9(outputPath);
   if (!existsSync12(outputDir)) mkdirSync7(outputDir, { recursive: true });
   const playbackRate = normalizePlaybackRate(options?.playbackRate ?? 1);
   const args = [];
@@ -78731,7 +78810,7 @@ async function extractAudioFromVideo(videoPath, outputPath, options, signal, con
 }
 async function prepareAudioTrack(srcPath, outputPath, mediaStart, duration, playbackRate = 1, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
-  const outputDir = dirname8(outputPath);
+  const outputDir = dirname9(outputPath);
   if (!existsSync12(outputDir)) mkdirSync7(outputDir, { recursive: true });
   const normalizedPlaybackRate = normalizePlaybackRate(playbackRate);
   const outputArgs = await preparedAudioOutputArgs(srcPath, normalizedPlaybackRate);
@@ -78778,7 +78857,7 @@ async function prepareAudioTrack(srcPath, outputPath, mediaStart, duration, play
 }
 async function generateSilence(outputPath, duration, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
-  const outputDir = dirname8(outputPath);
+  const outputDir = dirname9(outputPath);
   if (!existsSync12(outputDir)) mkdirSync7(outputDir, { recursive: true });
   const args = [
     "-f",
@@ -78832,7 +78911,7 @@ async function mixAudioTracks(tracks, outputPath, totalDuration, signal, config)
       failures: result2.failure ? [result2.failure] : void 0
     };
   }
-  const outputDir = dirname8(outputPath);
+  const outputDir = dirname9(outputPath);
   if (!existsSync12(outputDir)) mkdirSync7(outputDir, { recursive: true });
   const buildFilterComplex = (ignoreAutomation) => {
     const filterParts = [];
@@ -78940,7 +79019,7 @@ function groupNormalizeOptionUnsupported(stderr) {
 }
 async function mixGroupMembers(memberTracks, outputPath, totalDuration, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
-  const outputDir = dirname8(outputPath);
+  const outputDir = dirname9(outputPath);
   if (!existsSync12(outputDir)) mkdirSync7(outputDir, { recursive: true });
   const buildInputFilters = (ignoreKeyframes) => memberTracks.map((track, i) => {
     const delayMs = Math.round(track.start * 1e3);
@@ -81841,6 +81920,7 @@ __export(src_exports, {
   FFMPEG_PATH_ENV: () => FFMPEG_PATH_ENV,
   FFPROBE_PATH_ENV: () => FFPROBE_PATH_ENV,
   FrameLookupTable: () => FrameLookupTable,
+  HDR_AUTO_PROMOTION_PIPELINE: () => HDR_AUTO_PROMOTION_PIPELINE,
   LOW_MEMORY_TOTAL_MB_THRESHOLD: () => LOW_MEMORY_TOTAL_MB_THRESHOLD,
   MAX_VP9_CPU_USED: () => MAX_VP9_CPU_USED,
   MEDIA_VISUAL_STYLE_PROPERTIES: () => MEDIA_VISUAL_STYLE_PROPERTIES,
@@ -81925,9 +82005,11 @@ __export(src_exports, {
   extractVideoMetadata: () => extractVideoMetadata,
   extractionFrameCountForDuration: () => extractionFrameCountForDuration,
   fetchPublicHttpsText: () => fetchPublicHttpsText,
+  findHdrAutoPromotion: () => findHdrAutoPromotion,
   fingerprintElementId: () => fingerprintElementId,
   float16ToPqRgb: () => float16ToPqRgb,
   formatFfmpegError: () => formatFfmpegError,
+  formatHdrAutoPromotionWarning: () => formatHdrAutoPromotionWarning,
   getCapturePerfSummary: () => getCapturePerfSummary,
   getCdpSession: () => getCdpSession,
   getCgroupMemoryLimitMb: () => getCgroupMemoryLimitMb,
@@ -82009,6 +82091,7 @@ __export(src_exports, {
   safeDownloadUrlIdentity: () => safeDownloadUrlIdentity,
   safeVideoExtractionSourceIdentity: () => safeVideoExtractionSourceIdentity,
   sampleRgb48le: () => sampleRgb48le,
+  sanitizeHdrAutoPromotionAsset: () => sanitizeHdrAutoPromotionAsset,
   scaleProtocolTimeoutForComposition: () => scaleProtocolTimeoutForComposition,
   selectVerifySampleIndicesForTask: () => selectVerifySampleIndicesForTask,
   shouldClampToScreenshotForConcreteGpu: () => shouldClampToScreenshotForConcreteGpu,
@@ -85243,7 +85326,7 @@ import {
   writeFileSync as writeFileSync8
 } from "fs";
 import { homedir as homedir4, tmpdir as tmpdir4 } from "os";
-import { dirname as dirname12, join as join25 } from "path";
+import { dirname as dirname13, join as join25 } from "path";
 async function compressToWoff2(input) {
   return Buffer.from(await compress(input));
 }
@@ -85270,8 +85353,8 @@ function readCachedCompression(path) {
 function cacheCompression(path, compressed) {
   let tempDir;
   try {
-    mkdirSync10(dirname12(path), { recursive: true });
-    tempDir = mkdtempSync7(join25(dirname12(path), ".compression-"));
+    mkdirSync10(dirname13(path), { recursive: true });
+    tempDir = mkdtempSync7(join25(dirname13(path), ".compression-"));
     const tmpPath = join25(tempDir, "font.woff2");
     writeFileSync8(tmpPath, compressed, { flag: "wx", mode: 420 });
     renameSync4(tmpPath, path);
@@ -85338,7 +85421,7 @@ import {
   appendFileSync
 } from "fs";
 import { tmpdir as tmpdir7 } from "os";
-import { join as join43, dirname as dirname18, resolve as resolve13 } from "path";
+import { join as join43, dirname as dirname19, resolve as resolve13 } from "path";
 import { totalmem as totalmem3 } from "os";
 import { randomUUID as randomUUID3 } from "crypto";
 import { fileURLToPath as fileURLToPath5 } from "url";
@@ -85366,9 +85449,9 @@ import { join as join19, extname as extname4, resolve as resolve7, sep as sep3 }
 // ../producer/src/services/hyperframeRuntimeLoader.ts
 import { createHash as createHash4 } from "crypto";
 import { existsSync as existsSync15, readFileSync as readFileSync6 } from "fs";
-import { dirname as dirname9, resolve as resolve6 } from "path";
+import { dirname as dirname10, resolve as resolve6 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
-var PRODUCER_DIR = dirname9(fileURLToPath2(import.meta.url));
+var PRODUCER_DIR = dirname10(fileURLToPath2(import.meta.url));
 var SIBLING_MANIFEST_PATH = resolve6(PRODUCER_DIR, "hyperframe.manifest.json");
 var MODULE_RELATIVE_MANIFEST_PATH = resolve6(
   PRODUCER_DIR,
@@ -85411,7 +85494,7 @@ function resolveVerifiedHyperframeRuntime() {
       `[HyperframeRuntimeLoader] Invalid manifest at ${manifestPath}; missing iife artifact or sha256.`
     );
   }
-  const runtimePath = resolve6(dirname9(manifestPath), runtimeFileName);
+  const runtimePath = resolve6(dirname10(manifestPath), runtimeFileName);
   if (!existsSync15(runtimePath)) {
     throw new Error(`[HyperframeRuntimeLoader] Missing runtime artifact at ${runtimePath}.`);
   }
@@ -86085,7 +86168,7 @@ import {
   symlinkSync,
   writeFileSync as writeFileSync7
 } from "fs";
-import { basename as basename4, dirname as dirname10, isAbsolute as isAbsolute2, join as join21, relative, resolve as resolve8 } from "path";
+import { basename as basename4, dirname as dirname11, isAbsolute as isAbsolute2, join as join21, relative, resolve as resolve8 } from "path";
 
 // ../producer/src/utils/paths.ts
 import {
@@ -86170,7 +86253,7 @@ function writeCompiledArtifacts(compiled, workDir, includeSummary) {
   writeFileSync7(join21(compileDir, "index.html"), compiled.html, "utf-8");
   for (const [srcPath, html] of compiled.subCompositions) {
     const outPath = join21(compileDir, srcPath);
-    mkdirSync9(dirname10(outPath), { recursive: true });
+    mkdirSync9(dirname11(outPath), { recursive: true });
     writeFileSync7(outPath, html, "utf-8");
   }
   for (const [relativePath, absolutePath] of compiled.externalAssets) {
@@ -86179,7 +86262,7 @@ function writeCompiledArtifacts(compiled, workDir, includeSummary) {
       console.warn(`[Render] Skipping external asset with unsafe path: ${relativePath}`);
       continue;
     }
-    mkdirSync9(dirname10(outPath), { recursive: true });
+    mkdirSync9(dirname11(outPath), { recursive: true });
     copyFileSync3(absolutePath, outPath);
   }
   if (includeSummary) {
@@ -86233,7 +86316,7 @@ function updateJobStatus(job, status, stage, progress, onProgress) {
 var materializePathModule = {
   resolve: resolve8,
   join: join21,
-  dirname: dirname10,
+  dirname: dirname11,
   basename: basename4,
   relative,
   isAbsolute: isAbsolute2
@@ -86535,7 +86618,7 @@ import {
   renameSync as renameSync3,
   rmSync as rmSync8
 } from "fs";
-import { basename as basename5, dirname as dirname11, extname as extname5, join as join22, resolve as resolve9 } from "path";
+import { basename as basename5, dirname as dirname12, extname as extname5, join as join22, resolve as resolve9 } from "path";
 
 // ../producer/src/utils/ffprobe.ts
 init_src();
@@ -86554,7 +86637,7 @@ async function defaultArtifactDurationProbe(path) {
   };
 }
 function createSiblingTransactionDirectory(destination) {
-  const parent = dirname11(destination);
+  const parent = dirname12(destination);
   const extension = extname5(destination);
   const stem = extension ? basename5(destination, extension) : basename5(destination);
   return mkdtempSync6(join22(parent, `.${stem}.hf-transaction-`));
@@ -86725,6 +86808,10 @@ var ArtifactTransaction = class {
     }
   }
 };
+async function commitArtifactTransaction(transaction, assertNotAborted) {
+  assertNotAborted();
+  await transaction.commit();
+}
 
 // ../producer/src/services/render/capturePlan.ts
 function drawElementVerificationFailure(plan2, hasDiskFallbackHeadroom) {
@@ -86827,6 +86914,42 @@ function replanAfterFailure(plan2, failure) {
 
 // ../producer/src/services/render/hdrMode.ts
 init_src();
+function findRenderHdrAutoPromotionTrigger(input) {
+  for (const extracted of input.extractionResult?.extracted ?? []) {
+    if (!isHdrColorSpace(extracted.metadata.colorSpace)) continue;
+    const source = input.videos.find(({ id }) => id === extracted.videoId)?.src;
+    if (source) return source;
+  }
+  return input.images.find(({ id }) => input.nativeHdrImageIds.has(id))?.src;
+}
+function logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources) {
+  if (forcedHdrWithoutSources) {
+    input.log.warn(
+      "[Render] HDR forced by --hdr flag, but no HDR sources were detected \u2014 defaulting to HLG. SDR-only compositions may look perceptually wrong on HDR displays."
+    );
+  }
+  if (!effectiveHdr) {
+    input.log.info(
+      hdrMode === "force-sdr" ? "[Render] SDR forced by --sdr flag" : "[Render] No HDR sources detected \u2014 rendering SDR"
+    );
+    return;
+  }
+  if (hdrMode === "auto") {
+    input.log.warn(
+      formatHdrAutoPromotionWarning({
+        triggeringAsset: sanitizeHdrAutoPromotionAsset(
+          input.autoPromotionTrigger ?? "an HDR-tagged asset"
+        ),
+        output: HDR_AUTO_PROMOTION_PIPELINE
+      })
+    );
+    return;
+  }
+  const reason = forcedHdrWithoutSources ? "forced by --hdr flag (no HDR sources detected \u2014 defaulting to HLG)" : "forced by --hdr flag";
+  input.log.info(
+    `[Render] HDR ${reason} \u2014 output: ${effectiveHdr.transfer.toUpperCase()} (BT.2020, 10-bit H.265)`
+  );
+}
 function resolveEffectiveHdrMode(input) {
   const hdrMode = input.hdrMode ?? "auto";
   const videoColorSpaces = (input.extractionResult?.extracted ?? []).map(
@@ -86855,26 +86978,7 @@ function resolveEffectiveHdrMode(input) {
     );
     effectiveHdr = void 0;
   }
-  if (forcedHdrWithoutSources) {
-    input.log.warn(
-      "[Render] HDR forced by --hdr flag, but no HDR sources were detected \u2014 defaulting to HLG. SDR-only compositions may look perceptually wrong on HDR displays."
-    );
-  }
-  if (effectiveHdr) {
-    let reason;
-    if (hdrMode === "force-hdr") {
-      reason = forcedHdrWithoutSources ? "forced by --hdr flag (no HDR sources detected \u2014 defaulting to HLG)" : "forced by --hdr flag";
-    } else {
-      reason = "auto-detected from source(s)";
-    }
-    input.log.info(
-      `[Render] HDR ${reason} \u2014 output: ${effectiveHdr.transfer.toUpperCase()} (BT.2020, 10-bit H.265)`
-    );
-  } else if (hdrMode === "force-sdr") {
-    input.log.info("[Render] SDR forced by --sdr flag");
-  } else {
-    input.log.info("[Render] No HDR sources detected \u2014 rendering SDR");
-  }
+  logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources);
   return effectiveHdr;
 }
 
@@ -87900,7 +88004,7 @@ init_subCompositionValidity();
 init_assetResolution();
 import { createHash as createHash9 } from "crypto";
 import { createReadStream as createReadStream4, existsSync as existsSync24, mkdirSync as mkdirSync13, readFileSync as readFileSync10 } from "fs";
-import { join as join28, dirname as dirname14, resolve as resolve12, basename as basename6, relative as relative2 } from "path";
+import { join as join28, dirname as dirname15, resolve as resolve12, basename as basename6, relative as relative2 } from "path";
 
 // ../producer/src/services/renderMediaCollector.ts
 init_esm10();
@@ -89249,7 +89353,7 @@ import {
   rmSync as rmSync10,
   statSync as statSync8
 } from "fs";
-import { dirname as dirname13, isAbsolute as isAbsolute3, join as join27, resolve as resolve11 } from "path";
+import { dirname as dirname14, isAbsolute as isAbsolute3, join as join27, resolve as resolve11 } from "path";
 var PREPARED_GIF_SUBDIR = "_animated_gif";
 var CACHE_SCHEMA = "hfgif-v1";
 function splitUrlSuffix(src) {
@@ -89402,11 +89506,11 @@ async function runAnimatedGifTranscode(request) {
   throw result.error ?? new Error(`Animated GIF transcode failed (${result.exitCode}): ${result.stderr.slice(-500)}`);
 }
 async function ensurePreparedWebm(input) {
-  if (!existsSync22(dirname13(input.cachePath))) {
-    mkdirSync12(dirname13(input.cachePath), { recursive: true });
+  if (!existsSync22(dirname14(input.cachePath))) {
+    mkdirSync12(dirname14(input.cachePath), { recursive: true });
   }
-  if (!existsSync22(dirname13(input.outputPath))) {
-    mkdirSync12(dirname13(input.outputPath), { recursive: true });
+  if (!existsSync22(dirname14(input.outputPath))) {
+    mkdirSync12(dirname14(input.outputPath), { recursive: true });
   }
   if (!isUsableFile(input.cachePath)) {
     const tmpPath = `${input.cachePath}.tmp-${process.pid}-${Date.now()}`;
@@ -90329,7 +90433,7 @@ async function parseSubCompositions(html, projectDir, downloadDir, visited = /*
     workItems.map(async (item) => {
       const { html: compiledSub } = await compileHtmlFile(
         item.rawSubHtml,
-        dirname14(item.filePath),
+        dirname15(item.filePath),
         downloadDir
       );
       const nested = await parseSubCompositions(
@@ -92560,6 +92664,7 @@ async function runExtractVideosStage(input) {
         fps: job.config.fps,
         outputDir: join31(compiledDir, "__hyperframes_video_frames"),
         format: job.config.videoFrameFormat ?? "auto",
+        toneMapHdrToSdr: job.config.hdrMode === "force-sdr",
         timelineEnd: composition.duration,
         maxTransientRetries: extractionPolicy.maxTransientRetries,
         collectProbeFailures: extractionPolicy.failureMode === "enforce"
@@ -94762,7 +94867,7 @@ import { join as join38 } from "path";
 // ../producer/src/services/shaderTransitionWorkerPool.ts
 import { Worker as Worker2 } from "worker_threads";
 import { fileURLToPath as fileURLToPath4, pathToFileURL as pathToFileURL2 } from "url";
-import { dirname as dirname15, join as join37 } from "path";
+import { dirname as dirname16, join as join37 } from "path";
 import { createRequire as createRequire2 } from "module";
 import { existsSync as existsSync26 } from "fs";
 import { cpus as cpus3 } from "os";
@@ -94775,7 +94880,7 @@ function resolveWorkerEntry(explicit) {
     const isTs = override.endsWith(".ts");
     return { path: override, isTs };
   }
-  const moduleDir = dirname15(fileURLToPath4(import.meta.url));
+  const moduleDir = dirname16(fileURLToPath4(import.meta.url));
   const jsPath = join37(moduleDir, "shaderTransitionWorker.js");
   if (existsSync26(jsPath)) return { path: jsPath, isTs: false };
   const tsPath = join37(moduleDir, "shaderTransitionWorker.ts");
@@ -95486,7 +95591,7 @@ async function runCaptureHdrStage(input) {
 // ../producer/src/services/render/stages/encodeStage.ts
 init_src();
 import { copyFileSync as copyFileSync5, existsSync as existsSync28, mkdirSync as mkdirSync16, readdirSync as readdirSync10, rmSync as rmSync12, statSync as statSync9 } from "fs";
-import { dirname as dirname16, join as join41 } from "path";
+import { dirname as dirname17, join as join41 } from "path";
 
 // ../producer/src/services/render/stages/gifEncodeArgs.ts
 import { join as join40 } from "path";
@@ -95657,7 +95762,7 @@ async function runEncodeStage(input) {
     const encodeResult2 = await encodeGifFromDir(framesDir, framePattern2, outputPath, {
       fps: job.config.fps,
       loop,
-      palettePath: join41(dirname16(videoOnlyPath), "gif-palette.png"),
+      palettePath: join41(dirname17(videoOnlyPath), "gif-palette.png"),
       preserveAlpha: needsAlpha,
       signal: abortSignal,
       timeout: engineCfg.ffmpegEncodeTimeout
@@ -95724,7 +95829,7 @@ init_src();
 init_dist2();
 import { spawn as spawn5 } from "child_process";
 import { mkdtempSync as mkdtempSync10, renameSync as renameSync6, rmSync as rmSync13 } from "fs";
-import { dirname as dirname17, join as join42 } from "path";
+import { dirname as dirname18, join as join42 } from "path";
 var AUDIO_DURATION_TOLERANCE_SECONDS = 1e-3;
 var AAC_DELIVERY_TRUE_PEAK_DBFS = -1;
 var AAC_TRUE_PEAK_CORRECTION_HEADROOM_DB = 0.5;
@@ -95925,7 +96030,7 @@ async function padOrTrimAudioToVideoFrameCount(input) {
 async function enforceAacTruePeak(input) {
   let scratchDir;
   try {
-    scratchDir = mkdtempSync10(join42(dirname17(input.audioPath), ".true-peak-"));
+    scratchDir = mkdtempSync10(join42(dirname18(input.audioPath), ".true-peak-"));
     const correctedPath = join42(scratchDir, "audio.m4a");
     const correctionTargetDbfs = AAC_DELIVERY_TRUE_PEAK_DBFS - AAC_TRUE_PEAK_CORRECTION_HEADROOM_DB;
     const measurements = [];
@@ -96380,7 +96485,7 @@ function getNextRetryWorkerCount(currentWorkers) {
 }
 function resolveRenderWorkDirPrefix(outputPath, jobId, platform3 = process.platform, systemTempDir = tmpdir7()) {
   if (platform3 === "win32") return join43(systemTempDir, "hf-render-");
-  return join43(dirname18(outputPath), `work-${jobId}-`);
+  return join43(dirname19(outputPath), `work-${jobId}-`);
 }
 var MAX_TRANSIENT_CAPTURE_RETRIES = 1;
 function captureAttemptMadeProgress(attemptTargetFrameCount, remainingFrameCount) {
@@ -96740,6 +96845,7 @@ function shouldRetryViaPinnedFallback(args) {
   if (args.isCancellation || args.isEncoderInterrupted) return false;
   if (args.isVerifyError || args.isDeCaptureError) return true;
   if (args.isDeRendererStall === true || args.isSequentialCaptureStall === true) return true;
+  if (args.isTransientCaptureError === true) return true;
   return args.deWorkerInversion === "inverted" || args.deParallelRouter === "routed";
 }
 function isDeRendererStallError(err) {
@@ -96801,11 +96907,11 @@ function deVerifyFallbackTelemetry(err) {
     thresholdDb: roundDb(details?.verifyThresholdDb)
   };
 }
-async function executeRenderJob(job, projectDir, outputPath, progressSink, abortSignal) {
-  const moduleDir = dirname18(fileURLToPath5(import.meta.url));
+async function executeRenderJob(job, projectDir, outputPath, progressSink, abortSignal, assertRenderActive) {
+  const moduleDir = dirname19(fileURLToPath5(import.meta.url));
   const producerRoot = process.env.PRODUCER_RENDERS_DIR ? resolve13(process.env.PRODUCER_RENDERS_DIR, "..") : resolve13(moduleDir, "../..");
   const debugDir = join43(producerRoot, ".debug");
-  const outputDir = dirname18(outputPath);
+  const outputDir = dirname19(outputPath);
   if (!existsSync29(outputDir)) mkdirSync17(outputDir, { recursive: true });
   const workDir = job.config.debug ? join43(debugDir, job.id) : mkdtempSync11(resolveRenderWorkDirPrefix(outputPath, job.id));
   const pipelineStart = Date.now();
@@ -96834,14 +96940,24 @@ async function executeRenderJob(job, projectDir, outputPath, progressSink, abort
       workDir,
       logPath,
       pipelineStart,
-      execution
+      execution,
+      assertRenderActive
     });
   } finally {
     await execution.dispose();
   }
 }
 async function executeRenderPipeline(input) {
-  const { job, projectDir, outputPath, workDir, logPath, pipelineStart, execution } = input;
+  const {
+    job,
+    projectDir,
+    outputPath,
+    workDir,
+    logPath,
+    pipelineStart,
+    execution,
+    assertRenderActive
+  } = input;
   const log = execution.logger;
   const eventPublisher = execution.events;
   const onProgress = execution.onProgress;
@@ -97170,11 +97286,18 @@ async function executeRenderPipeline(input) {
     });
     if (failureToEnforce) throw failureToEnforce;
     assertVideoFrameCoverage(coverageReports, coverageThreshold);
+    const autoPromotionTrigger = findRenderHdrAutoPromotionTrigger({
+      extractionResult,
+      videos: composition.videos,
+      images: composition.images,
+      nativeHdrImageIds
+    });
     const effectiveHdr = resolveEffectiveHdrMode({
       hdrMode: job.config.hdrMode,
       outputFormat,
       extractionResult,
       imageColorSpaces,
+      autoPromotionTrigger,
       log
     });
     observability.checkpoint("hdr_detection", "resolved", {
@@ -97853,7 +97976,8 @@ async function executeRenderPipeline(input) {
             deWorkerInversion,
             deParallelRouter,
             isDeRendererStall: isDeStall,
-            isSequentialCaptureStall: isSequentialStall
+            isSequentialCaptureStall: isSequentialStall,
+            isTransientCaptureError: isTransientBrowserError(err)
           }))
             throw err;
           const isMemoryExhaustion = !isVerifyError && isMemoryExhaustionError(err);
@@ -98194,7 +98318,10 @@ async function executeRenderPipeline(input) {
         copyFileSync6(stagedOutputPath, debugOutput);
       }
     }
-    await artifactTransaction.commit();
+    await commitArtifactTransaction(artifactTransaction, () => {
+      assertRenderActive?.();
+      assertNotAborted();
+    });
     job.outputPath = outputPath;
     updateJobStatus(job, "complete", "Render complete", 100, onProgress);
     await eventPublisher.flush();
@@ -98533,7 +98660,7 @@ import {
   rmSync as rmSync15,
   createReadStream as createReadStream5
 } from "fs";
-import { resolve as resolve15, dirname as dirname20, join as join46 } from "path";
+import { resolve as resolve15, dirname as dirname21, join as join46 } from "path";
 import { tmpdir as tmpdir8 } from "os";
 import { parseArgs } from "util";
 import crypto from "crypto";
@@ -98662,7 +98789,7 @@ async function runHyperframeLint(prepared) {
 // ../producer/src/services/healthWorker.ts
 import { Worker as Worker3 } from "worker_threads";
 import { fileURLToPath as fileURLToPath6 } from "url";
-import { dirname as dirname19, join as join45 } from "path";
+import { dirname as dirname20, join as join45 } from "path";
 import { existsSync as existsSync31 } from "fs";
 var DEFAULT_HEALTH_PORT = 9848;
 async function startHealthWorker(options = {}) {
@@ -98737,7 +98864,7 @@ function defaultLogger2() {
   };
 }
 function resolveWorkerEntry2() {
-  const here = dirname19(fileURLToPath6(import.meta.url));
+  const here = dirname20(fileURLToPath6(import.meta.url));
   const candidates = [join45(here, "healthWorkerThread.js"), join45(here, "healthWorkerThread.ts")];
   for (const candidate of candidates) {
     if (existsSync31(candidate)) return candidate;
@@ -98875,7 +99002,7 @@ function buildRenderJobConfig(input, outputPath, log) {
 function resolvePreparedRenderOutput(prepared, rendersDir, log) {
   const { input, cleanupProjectDir } = prepared;
   const absoluteOutputPath = resolveOutputPath(input.projectDir, input.outputPath, rendersDir, log);
-  const outputDir = dirname20(absoluteOutputPath);
+  const outputDir = dirname21(absoluteOutputPath);
   if (!existsSync32(outputDir)) mkdirSync18(outputDir, { recursive: true });
   return { input, cleanupProjectDir, absoluteOutputPath };
 }
@@ -99441,7 +99568,7 @@ var FIELD_DELIMITER = Buffer.from([0]);
 // ../producer/src/services/distributed/shared.ts
 init_src();
 import { execFile as execFileCallback } from "child_process";
-import { dirname as dirname21, join as join48 } from "path";
+import { dirname as dirname22, join as join48 } from "path";
 import { existsSync as existsSync34, readFileSync as readFileSync15 } from "fs";
 import { fileURLToPath as fileURLToPath7 } from "url";
 import { promisify as promisify4 } from "util";
@@ -99488,7 +99615,7 @@ import {
 } from "fs";
 import { createHash as createHash12 } from "crypto";
 import { tmpdir as tmpdir9 } from "os";
-import { dirname as dirname23, isAbsolute as isAbsolute5, join as join53, relative as relative7, resolve as resolve17, sep as sep6 } from "path";
+import { dirname as dirname24, isAbsolute as isAbsolute5, join as join53, relative as relative7, resolve as resolve17, sep as sep6 } from "path";
 
 // ../producer/src/services/distributed/planV2Publisher.ts
 import {
@@ -99502,7 +99629,7 @@ import {
   statSync as statSync13,
   writeFileSync as writeFileSync14
 } from "fs";
-import { dirname as dirname22, join as join52 } from "path";
+import { dirname as dirname23, join as join52 } from "path";
 
 // ../producer/src/services/distributed/planV2Layout.ts
 import { join as join51 } from "path";
@@ -99526,7 +99653,7 @@ import {
   statSync as statSync15,
   writeFileSync as writeFileSync16
 } from "fs";
-import { dirname as dirname24, join as join54 } from "path";
+import { dirname as dirname25, join as join54 } from "path";
 
 // ../producer/src/services/distributed/renderChunk.ts
 init_src();
@@ -99579,8 +99706,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.40" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.40" : "0.0.0-dev";
+var VERSION = true ? "0.8.42" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.42" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {