hyperframes 0.8.81 → 0.8.83

package/dist/fontLocalizeCli.js

@@ -3433,10 +3433,10 @@ function compareDocumentPosition(nodeA, nodeB) {
 function uniqueSort(nodes) {
   nodes = nodes.filter((node, i, arr) => !arr.includes(node, i + 1));
   nodes.sort((a, b) => {
-    const relative11 = compareDocumentPosition(a, b);
-    if (relative11 & DocumentPosition.PRECEDING) {
+    const relative12 = compareDocumentPosition(a, b);
+    if (relative12 & DocumentPosition.PRECEDING) {
       return -1;
-    } else if (relative11 & DocumentPosition.FOLLOWING) {
+    } else if (relative12 & DocumentPosition.FOLLOWING) {
       return 1;
     }
     return 0;
@@ -16993,7 +16993,7 @@ var require_util = __commonJS({
         }
         path = url.path;
       }
-      var isAbsolute7 = exports.isAbsolute(path);
+      var isAbsolute8 = exports.isAbsolute(path);
       var parts = path.split(/\/+/);
       for (var part, up = 0, i = parts.length - 1; i >= 0; i--) {
         part = parts[i];
@@ -17013,7 +17013,7 @@ var require_util = __commonJS({
       }
       path = parts.join("/");
       if (path === "") {
-        path = isAbsolute7 ? "/" : ".";
+        path = isAbsolute8 ? "/" : ".";
       }
       if (url) {
         url.path = path;
@@ -17058,7 +17058,7 @@ var require_util = __commonJS({
     exports.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
-    function relative11(aRoot, aPath) {
+    function relative12(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -17077,7 +17077,7 @@ var require_util = __commonJS({
       }
       return Array(level + 1).join("../") + aPath.substr(aRoot.length + 1);
     }
-    exports.relative = relative11;
+    exports.relative = relative12;
     var supportsNullProto = (function() {
       var obj = /* @__PURE__ */ Object.create(null);
       return !("__proto__" in obj);
@@ -48198,10 +48198,10 @@ var init_acorn = __esm({
           state.raise("Invalid group");
         }
         var trackDisjunction = this.options.ecmaVersion >= 16;
-        var known = state.groupNames[state.lastStringValue];
-        if (known) {
+        var known2 = state.groupNames[state.lastStringValue];
+        if (known2) {
           if (trackDisjunction) {
-            for (var i = 0, list = known; i < list.length; i += 1) {
+            for (var i = 0, list = known2; i < list.length; i += 1) {
               var altID = list[i];
               if (!altID.separatedFrom(state.branchID)) {
                 state.raise("Duplicate capture group name");
@@ -48212,7 +48212,7 @@ var init_acorn = __esm({
           }
         }
         if (trackDisjunction) {
-          (known || (state.groupNames[state.lastStringValue] = [])).push(state.branchID);
+          (known2 || (state.groupNames[state.lastStringValue] = [])).push(state.branchID);
         } else {
           state.groupNames[state.lastStringValue] = true;
         }
@@ -52868,17 +52868,22 @@ function escapeCaseInsensitiveToken(source, token, replacement) {
 function inlineScriptTags(scripts) {
   return scripts.map((source) => `<script>${escapeInlineScriptSource(source)}</script>`).join("\n");
 }
-function findDocumentTag(html, tag) {
-  const lowered = lowerAscii(html);
+function* markupStarts(lowered) {
   const unclosedRawText = /* @__PURE__ */ new Set();
   let cursor = 0;
   while (cursor !== -1) {
     const open = lowered.indexOf("<", cursor);
     if (open === -1)
-      return -1;
+      return;
+    yield open;
+    cursor = skipMarkup(lowered, open, unclosedRawText);
+  }
+}
+function findDocumentTag(html, tag) {
+  const lowered = lowerAscii(html);
+  for (const open of markupStarts(lowered)) {
     if (isTagAt(lowered, open, tag))
       return open;
-    cursor = skipMarkup(lowered, open, unclosedRawText);
   }
   return -1;
 }
@@ -53069,7 +53074,7 @@ function parseApplicationExtension(bytes, offset3) {
   }
   return null;
 }
-function parseAnimatedGifMetadata(bytes) {
+function parseAnimatedGifMetadata(bytes, onFrame) {
   if (bytes.length < 13)
     return null;
   const signature = readAscii(bytes, 0, 6);
@@ -53085,6 +53090,7 @@ function parseAnimatedGifMetadata(bytes) {
     pos += colorTableByteLength(packed);
   }
   let frameCount = 0;
+  let controlPackedOffset = null;
   const delaysCentiseconds = [];
   let loopCount = null;
   while (pos < bytes.length) {
@@ -53107,6 +53113,7 @@ function parseAnimatedGifMetadata(bytes) {
         if (delay == null)
           return null;
         delaysCentiseconds.push(normalizeDelayCentiseconds(delay));
+        controlPackedOffset = pos + 1;
         pos += 1 + blockSize;
         if (bytes[pos] !== 0)
           return null;
@@ -53122,6 +53129,8 @@ function parseAnimatedGifMetadata(bytes) {
         pos = parsed.nextOffset;
         continue;
       }
+      if (label === PLAIN_TEXT_LABEL)
+        controlPackedOffset = null;
       const next = skipSubBlocks(bytes, pos);
       if (next == null)
         return null;
@@ -53132,8 +53141,11 @@ function parseAnimatedGifMetadata(bytes) {
       if (pos + 9 > bytes.length)
         return null;
       const imagePacked = bytes[pos + 8] ?? 0;
+      const localColorTable = (imagePacked & 128) !== 0;
+      onFrame?.({ controlPackedOffset, localColorTable });
+      controlPackedOffset = null;
       pos += 9;
-      if ((imagePacked & 128) !== 0) {
+      if (localColorTable) {
         pos += colorTableByteLength(imagePacked);
       }
       if (pos >= bytes.length)
@@ -53159,11 +53171,59 @@ function parseAnimatedGifMetadata(bytes) {
     animated: frameCount > 1
   };
 }
-var BROWSER_MIN_DELAY_CENTISECONDS;
+function frameLayouts(bytes) {
+  const frames = [];
+  return parseAnimatedGifMetadata(bytes, (frame) => frames.push(frame)) === null ? null : frames;
+}
+function disposalOf(bytes, frame) {
+  return frame.controlPackedOffset === null ? null : (bytes[frame.controlPackedOffset] ?? 0) & DISPOSAL_BITS;
+}
+function gifClearsAfterLeavingFrameInPlace(bytes) {
+  const frames = frameLayouts(bytes);
+  if (frames === null)
+    return null;
+  let sawOpaque = false;
+  for (const frame of frames) {
+    const disposal = disposalOf(bytes, frame);
+    if (disposal === LEAVE_IN_PLACE)
+      sawOpaque = true;
+    else if (disposal === DISPOSE_TO_BACKGROUND && sawOpaque)
+      return true;
+  }
+  return false;
+}
+function clearGifFramesBeforeNext(bytes) {
+  const frames = frameLayouts(bytes);
+  if (frames === null)
+    return false;
+  const controls = frames.flatMap((f) => f.controlPackedOffset === null ? [] : [f.controlPackedOffset]);
+  const shared = frames.flatMap((f) => f.controlPackedOffset === null || f.localColorTable ? [] : [f.controlPackedOffset]);
+  const hasIndex = (at2) => ((bytes[at2] ?? 0) & HAS_TRANSPARENT_INDEX) !== 0;
+  const source = shared.find(hasIndex);
+  for (const at2 of controls) {
+    bytes[at2] = (bytes[at2] ?? 0) & ~DISPOSAL_BITS | DISPOSE_TO_BACKGROUND;
+  }
+  if (source === void 0)
+    return true;
+  for (const at2 of shared) {
+    if (hasIndex(at2))
+      continue;
+    bytes[at2] = (bytes[at2] ?? 0) | HAS_TRANSPARENT_INDEX;
+    bytes[at2 + TRANSPARENT_INDEX_AFTER_PACKED] = bytes[source + TRANSPARENT_INDEX_AFTER_PACKED] ?? 0;
+  }
+  return true;
+}
+var BROWSER_MIN_DELAY_CENTISECONDS, PLAIN_TEXT_LABEL, DISPOSAL_BITS, LEAVE_IN_PLACE, DISPOSE_TO_BACKGROUND, HAS_TRANSPARENT_INDEX, TRANSPARENT_INDEX_AFTER_PACKED;
 var init_gif = __esm({
   "../core/dist/media/gif.js"() {
     "use strict";
     BROWSER_MIN_DELAY_CENTISECONDS = 10;
+    PLAIN_TEXT_LABEL = 1;
+    DISPOSAL_BITS = 28;
+    LEAVE_IN_PLACE = 1 << 2;
+    DISPOSE_TO_BACKGROUND = 2 << 2;
+    HAS_TRANSPARENT_INDEX = 1;
+    TRANSPARENT_INDEX_AFTER_PACKED = 3;
   }
 });
 
@@ -54046,6 +54106,36 @@ var init_colorGrading = __esm({
   }
 });
 
+// ../core/dist/hdrToneMap.js
+function known(value) {
+  return value && value !== "unknown" && value !== "reserved" ? value : void 0;
+}
+function hdrToSdrToneMapFilter(probed, firstFrame) {
+  const fill = (key2, fallback) => known(firstFrame[key2]) ? void 0 : known(probed[key2]) ?? fallback;
+  const tags = [
+    ["colorspace", fill("colorSpace", "bt2020nc")],
+    ["color_primaries", fill("colorPrimaries", "bt2020")],
+    ["color_trc", fill("colorTransfer")]
+  ].filter(([, value]) => value);
+  const setTags = tags.length ? `setparams=${tags.map((tag) => tag.join("=")).join(":")},` : "";
+  return `${setTags}zscale=t=linear:npl=100,tonemap=hable:desat=0,zscale=p=bt709:t=bt709:m=bt709:r=tv`;
+}
+function firstFrameColourArgs(videoPath) {
+  return [
+    ...["-hide_banner", "-nostats", "-i", videoPath, "-map", "0:v:0", "-frames:v", "1"],
+    ...["-vf", "showinfo", "-f", "null", "-"]
+  ];
+}
+function parseFirstFrameColour(stderr) {
+  const tags = / color_space:(\S+) color_primaries:(\S+) color_trc:(\S+)/.exec(stderr);
+  return tags ? { colorSpace: tags[1], colorPrimaries: tags[2], colorTransfer: tags[3] } : {};
+}
+var init_hdrToneMap = __esm({
+  "../core/dist/hdrToneMap.js"() {
+    "use strict";
+  }
+});
+
 // ../core/dist/inline-scripts/hyperframesRuntime.engine.js
 import { buildSync } from "esbuild";
 import { existsSync } from "fs";
@@ -54204,14 +54294,21 @@ var init_telemetryRedaction = __esm({
 });
 
 // ../core/dist/safePath.js
-import { resolve as resolve3, sep, join as join2, dirname as dirname3, basename } from "path";
-import { lstatSync, realpathSync } from "fs";
+import { resolve as resolve3, sep, join as join2, dirname as dirname3, basename, relative, isAbsolute } from "path";
+import { lstatSync, mkdirSync, realpathSync, statSync } from "fs";
 var init_safePath = __esm({
   "../core/dist/safePath.js"() {
     "use strict";
   }
 });
 
+// ../core/dist/projectRule.js
+var init_projectRule = __esm({
+  "../core/dist/projectRule.js"() {
+    "use strict";
+  }
+});
+
 // ../core/dist/adapters/gsap.js
 var init_gsap = __esm({
   "../core/dist/adapters/gsap.js"() {
@@ -55327,6 +55424,7 @@ var init_dist2 = __esm({
     init_gif();
     init_colorGrading();
     init_colorLuts();
+    init_hdrToneMap();
     init_hyperframe();
     init_runtimeContract();
     init_runtime_inline();
@@ -55334,6 +55432,7 @@ var init_dist2 = __esm({
     init_parityContract();
     init_telemetryRedaction();
     init_safePath();
+    init_projectRule();
     init_gsap();
     init_text2();
     init_renderOutputTimestamp();
@@ -56604,16 +56703,16 @@ async function launchBrowser(fingerprint) {
       `[BrowserManager] Browser launched (${browserVersion}, ${captureMode}, gl=${gpuFlags.join(" ") || "default"}, headlessShell=${!!fingerprint.executablePath}, platform=${process.platform})`
     );
     if (captureMode === "beginframe") {
-      const probe2 = await probeBeginFrameSupport(browser).catch((error) => ({
+      const probe = await probeBeginFrameSupport(browser).catch((error) => ({
         supported: true,
         detail: `probe harness error ignored: ${error instanceof Error ? error.message : String(error)}`,
         durationMs: 0
       }));
-      if (!probe2.supported) {
+      if (!probe.supported) {
         await closeBrowserAfterFailedProbe(browser);
         browser = void 0;
         console.warn(
-          `[BrowserManager] HeadlessExperimental.beginFrame probe failed after ${probe2.durationMs}ms: ${probe2.detail}; falling back to screenshot mode.`
+          `[BrowserManager] HeadlessExperimental.beginFrame probe failed after ${probe.durationMs}ms: ${probe.detail}; falling back to screenshot mode.`
         );
         captureMode = "screenshot";
         browser = await ppt.launch({
@@ -57849,9 +57948,9 @@ async function beginFrameCapture(page, options, frameTimeTicks, interval) {
     buffer = Buffer.from(result.screenshotData, "base64");
     lastFrameCache.set(page, buffer);
   } else {
-    const cached2 = lastFrameCache.get(page);
-    if (cached2) {
-      buffer = cached2;
+    const cached = lastFrameCache.get(page);
+    if (cached) {
+      buffer = cached;
     } else {
       const fallback = await sendBeginFrame(client, {
         frameTimeTicks: frameTimeTicks + 1e-3,
@@ -59800,27 +59899,31 @@ var init_ffmpegBinaries = __esm({
 import { execFile } from "child_process";
 import { promisify } from "util";
 function isPsnrFilterAvailable() {
-  if (cached === null) cached = probe();
-  return cached;
+  return isFfmpegFilterAvailable("psnr");
 }
-async function probe() {
+async function isFfmpegFilterAvailable(name) {
+  if (cachedFilterList === null) cachedFilterList = listFilters();
+  const stdout = await cachedFilterList;
+  return stdout !== null && new RegExp(`(^|\\s)${name}(\\s|$)`, "m").test(stdout);
+}
+async function listFilters() {
   const execFileP = promisify(execFile);
   try {
     const { stdout } = await execFileP(getFfmpegBinary(), ["-hide_banner", "-filters"], {
       maxBuffer: 4 * 1024 * 1024,
       timeout: 5e3
     });
-    return /(^|\s)psnr(\s|$)/m.test(stdout);
+    return stdout;
   } catch {
-    return false;
+    return null;
   }
 }
-var cached;
+var cachedFilterList;
 var init_psnrFilterAvailability = __esm({
   "../engine/src/utils/psnrFilterAvailability.ts"() {
     "use strict";
     init_ffmpegBinaries();
-    cached = null;
+    cachedFilterList = null;
   }
 });
 
@@ -60159,7 +60262,7 @@ var init_captureFailure = __esm({
 });
 
 // ../engine/src/services/frameCapture.ts
-import { existsSync as existsSync5, mkdirSync, writeFileSync } from "fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync2, writeFileSync } from "fs";
 import { join as join6 } from "path";
 function isDrawElementVerificationError(err) {
   let e = err;
@@ -60600,7 +60703,7 @@ async function completeDeferredDrawElementInit(session) {
   session.deInitDeferred = false;
 }
 async function createCaptureSession(serverUrl, outputDir, options, onBeforeCapture = null, config) {
-  if (!existsSync5(outputDir)) mkdirSync(outputDir, { recursive: true });
+  if (!existsSync5(outputDir)) mkdirSync2(outputDir, { recursive: true });
   const headlessShell = resolveHeadlessShellPath(config);
   const isLinux = process.platform === "linux";
   const forceScreenshot = config?.forceScreenshot ?? DEFAULT_CONFIG.forceScreenshot;
@@ -61411,7 +61514,7 @@ async function initializeSession(session) {
 async function captureFrameErrorDiagnostics(session, frameIndex, time, error) {
   try {
     const diagnosticsDir = join6(session.outputDir, "diagnostics");
-    if (!existsSync5(diagnosticsDir)) mkdirSync(diagnosticsDir, { recursive: true });
+    if (!existsSync5(diagnosticsDir)) mkdirSync2(diagnosticsDir, { recursive: true });
     const base2 = join6(diagnosticsDir, `frame-error-${frameIndex}`);
     await session.page.screenshot({ path: `${base2}.png`, type: "png", fullPage: true });
     const html = await session.page.content();
@@ -62518,7 +62621,7 @@ async function closeCaptureSession(session) {
 }
 function prepareCaptureSessionForReuse(session, outputDir, onBeforeCapture) {
   if (!existsSync5(outputDir)) {
-    mkdirSync(outputDir, { recursive: true });
+    mkdirSync2(outputDir, { recursive: true });
   }
   session.outputDir = outputDir;
   session.onBeforeCapture = onBeforeCapture;
@@ -63352,7 +63455,7 @@ var init_runFfmpeg = __esm({
 
 // ../engine/src/utils/ffprobe.ts
 import { spawn as spawn3 } from "child_process";
-import { createReadStream, readFileSync as readFileSync2, statSync } from "fs";
+import { createReadStream, readFileSync as readFileSync2, statSync as statSync2 } from "fs";
 import { StringDecoder } from "string_decoder";
 import { basename as basename2 } from "path";
 function redactFfprobeInput(stderr, filePath) {
@@ -63477,7 +63580,7 @@ function isPngImageProbe(output) {
 }
 function mediaFileIdentity(filePath) {
   try {
-    const stat = statSync(filePath, { bigint: true });
+    const stat = statSync2(filePath, { bigint: true });
     return [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].join(":");
   } catch {
     return null;
@@ -63490,13 +63593,13 @@ async function probeMediaOutput(filePath, signal) {
     mediaProbeOutputSignalCaches.set(signal, cache2);
   }
   const identity = mediaFileIdentity(filePath);
-  const cached2 = cache2.get(filePath);
-  if (identity !== null && cached2?.identity === identity) {
+  const cached = cache2.get(filePath);
+  if (identity !== null && cached?.identity === identity) {
     if (!signal) {
       cache2.delete(filePath);
-      cache2.set(filePath, cached2);
+      cache2.set(filePath, cached);
     }
-    return cached2.promise;
+    return cached.promise;
   }
   const promise = runFfprobe(
     filePath,
@@ -63532,7 +63635,7 @@ async function readFileRange(filePath, start, length, signal) {
 async function hasCompletePngStructure(filePath, signal) {
   try {
     signal?.throwIfAborted();
-    const fileSize = statSync(filePath).size;
+    const fileSize = statSync2(filePath).size;
     const signature = await readFileRange(filePath, 0, 8, signal);
     signal?.throwIfAborted();
     if (signature.length !== 8 || !signature.equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]))) {
@@ -63663,8 +63766,8 @@ function parseFrameRate(frameRateStr) {
   return rounded > 0 ? rounded : 0.01;
 }
 async function extractMediaMetadata(filePath) {
-  const cached2 = videoMetadataCache.get(filePath);
-  if (cached2) return cached2;
+  const cached = videoMetadataCache.get(filePath);
+  if (cached) return cached;
   const probePromise = (async () => {
     let stillImageMetaMemo;
     const stillImage = () => {
@@ -63773,8 +63876,8 @@ async function extractFinalVideoFrameTimestamp(filePath, metadata, signal) {
     probeCache = finalVideoFrameTimestampSignalCaches.get(signal) ?? /* @__PURE__ */ new Map();
     finalVideoFrameTimestampSignalCaches.set(signal, probeCache);
   }
-  const cached2 = probeCache.get(cacheKey);
-  if (cached2) return cached2;
+  const cached = probeCache.get(cacheKey);
+  if (cached) return cached;
   const probePromise = (async () => {
     if (!(videoDurationSeconds > 0) || !Number.isFinite(videoDurationSeconds)) {
       throw new Error(
@@ -63784,7 +63887,7 @@ async function extractFinalVideoFrameTimestamp(filePath, metadata, signal) {
     const streamEnd = videoStreamStartSeconds + videoDurationSeconds;
     const intervalStart = Math.max(videoStreamStartSeconds, streamEnd - 1);
     const parseFinalTimestamp = (stdout) => stdout.split("\n").map((line) => line.trim().split(",")[0]?.trim() ?? "").filter((value) => value.length > 0).map((value) => Number(value)).filter((timestamp2) => Number.isFinite(timestamp2)).at(-1);
-    const probe2 = async (readInterval) => {
+    const probe = async (readInterval) => {
       const args = [
         "-select_streams",
         "v:0",
@@ -63800,7 +63903,7 @@ async function extractFinalVideoFrameTimestamp(filePath, metadata, signal) {
       });
       return parseFinalTimestamp(stdout);
     };
-    const timestamp = await probe2(`${intervalStart}%${streamEnd}`) ?? await probe2(
+    const timestamp = await probe(`${intervalStart}%${streamEnd}`) ?? await probe(
       /* full scan */
     );
     if (timestamp === void 0) {
@@ -63817,8 +63920,8 @@ async function extractFinalVideoFrameTimestamp(filePath, metadata, signal) {
   return probePromise;
 }
 async function extractAudioMetadata(filePath, options) {
-  const cached2 = options?.signal ? void 0 : audioMetadataCache.get(filePath);
-  if (cached2) return cached2;
+  const cached = options?.signal ? void 0 : audioMetadataCache.get(filePath);
+  if (cached) return cached;
   const probePromise = (async () => {
     const output = await probeMediaOutput(filePath, options?.signal);
     const audioStream = output.streams.find((s) => s.codec_type === "audio");
@@ -63875,8 +63978,8 @@ async function analyzeKeyframeIntervals(filePath, metadata) {
     filePath,
     metadata
   );
-  const cached2 = keyframeCache.get(cacheKey);
-  if (cached2) return cached2;
+  const cached = keyframeCache.get(cacheKey);
+  if (cached) return cached;
   const promise = analyzeKeyframeIntervalsUncached(
     filePath,
     videoStreamStartSeconds,
@@ -64068,12 +64171,12 @@ import {
   copyFileSync,
   existsSync as existsSync6,
   ftruncateSync,
-  mkdirSync as mkdirSync2,
+  mkdirSync as mkdirSync3,
   mkdtempSync,
   openSync,
   readFileSync as readFileSync4,
   readdirSync as readdirSync2,
-  statSync as statSync2,
+  statSync as statSync3,
   writeFileSync as writeFileSync2,
   writeSync
 } from "fs";
@@ -64316,7 +64419,7 @@ function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = null) {
 async function encodeFramesFromDir(framesDir, framePattern, outputPath, options, signal, config) {
   const startTime = Date.now();
   const outputDir = dirname5(outputPath);
-  if (!existsSync6(outputDir)) mkdirSync2(outputDir, { recursive: true });
+  if (!existsSync6(outputDir)) mkdirSync3(outputDir, { recursive: true });
   const files = readdirSync2(framesDir).filter((f) => f.match(/\.(jpg|jpeg|png)$/i));
   const frameCount = files.length;
   if (frameCount === 0) {
@@ -64363,7 +64466,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
       failureReason: isExternalFfmpegInterruption(result) ? "external_interruption" : void 0
     };
   }
-  const fileSize = existsSync6(outputPath) ? statSync2(outputPath).size : 0;
+  const fileSize = existsSync6(outputPath) ? statSync3(outputPath).size : 0;
   return {
     success: true,
     outputPath,
@@ -64390,7 +64493,7 @@ async function concatVideoFiles(inputPaths, outputPath, signal, config) {
   if (firstInput === void 0) {
     return { success: false, error: "concatVideoFiles: no inputs", externalInterruption: false };
   }
-  mkdirSync2(dirname5(outputPath), { recursive: true });
+  mkdirSync3(dirname5(outputPath), { recursive: true });
   const listPath = writeConcatList(dirname5(firstInput), inputPaths);
   const encodeTimeout = config?.ffmpegEncodeTimeout ?? DEFAULT_CONFIG.ffmpegEncodeTimeout;
   const result = await runFfmpeg(buildConcatArgs(listPath, outputPath), {
@@ -64423,7 +64526,7 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
   }
   const chunkSize = Math.max(30, Math.floor(chunkSizeFrames));
   const chunkCount = Math.ceil(files.length / chunkSize);
-  mkdirSync2(dirname5(outputPath), { recursive: true });
+  mkdirSync3(dirname5(outputPath), { recursive: true });
   const chunkDir = mkdtempSync(join8(dirname5(outputPath), "chunk-encode-"));
   const chunkPaths = [];
   for (let i = 0; i < chunkCount; i++) {
@@ -64490,7 +64593,7 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
       failureReason: concatResult.externalInterruption ? "external_interruption" : void 0
     };
   }
-  const fileSize = existsSync6(outputPath) ? statSync2(outputPath).size : 0;
+  const fileSize = existsSync6(outputPath) ? statSync3(outputPath).size : 0;
   return {
     success: true,
     outputPath,
@@ -64501,7 +64604,7 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
 }
 async function muxVideoWithAudio(videoPath, audioPath, outputPath, signal, config, fps) {
   const outputDir = dirname5(outputPath);
-  if (!existsSync6(outputDir)) mkdirSync2(outputDir, { recursive: true });
+  if (!existsSync6(outputDir)) mkdirSync3(outputDir, { recursive: true });
   const isWebm = outputPath.endsWith(".webm");
   const isMov = outputPath.endsWith(".mov");
   const shouldCopyAudio = isWebm ? false : await shouldCopyAacSidecar(audioPath, config);
@@ -64568,7 +64671,7 @@ async function packageHls(videoPath, audioPath, outputDir, options) {
   if (outputDir.includes("%")) {
     throw new Error(`[chunkEncoder] packageHls outputDir must not contain "%": ${outputDir}`);
   }
-  if (!existsSync6(outputDir)) mkdirSync2(outputDir, { recursive: true });
+  if (!existsSync6(outputDir)) mkdirSync3(outputDir, { recursive: true });
   const hasAudio = audioPath !== null;
   const args = hasAudio ? ["-i", videoPath, "-i", audioPath, "-map", "0:v:0", "-map", "1:a:0"] : ["-i", videoPath, "-map", "0:v:0"];
   args.push(
@@ -64751,7 +64854,7 @@ var init_jpegInput = __esm({
 // ../engine/src/services/streamingEncoder.ts
 import { spawn as spawn4 } from "child_process";
 import { once } from "events";
-import { existsSync as existsSync7, mkdirSync as mkdirSync3, statSync as statSync3 } from "fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync4, statSync as statSync4 } from "fs";
 import { dirname as dirname6 } from "path";
 function createFrameReorderBuffer(startFrame, endFrame) {
   let cursor = startFrame;
@@ -64985,7 +65088,7 @@ function buildStreamingArgs(options, outputPath, gpuEncoder = null) {
 }
 async function spawnStreamingEncoder(outputPath, options, signal, config) {
   const outputDir = dirname6(outputPath);
-  if (!existsSync7(outputDir)) mkdirSync3(outputDir, { recursive: true });
+  if (!existsSync7(outputDir)) mkdirSync4(outputDir, { recursive: true });
   let gpuEncoder = null;
   if (options.useGpu) {
     gpuEncoder = await getCachedGpuEncoder();
@@ -65105,7 +65208,7 @@ FFmpeg stopped after ${streamingTimeout} ms without consuming a frame.` : "";
           }) ? "external_interruption" : void 0
         };
       }
-      const fileSize = existsSync7(outputPath) ? statSync3(outputPath).size : 0;
+      const fileSize = existsSync7(outputPath) ? statSync4(outputPath).size : 0;
       return { success: true, durationMs, fileSize };
     },
     getExitStatus: () => exitStatus,
@@ -65147,7 +65250,7 @@ var init_streamingEncoder = __esm({
 
 // ../parsers/dist/assetResolution.js
 import { existsSync as existsSync8 } from "fs";
-import { isAbsolute, join as join9, posix as posix2, relative, resolve as resolve5, sep as sep2 } from "path";
+import { isAbsolute as isAbsolute2, join as join9, posix as posix2, relative as relative2, resolve as resolve5, sep as sep2 } from "path";
 function decodeUrlPathVariants2(path) {
   const variants = [path];
   try {
@@ -65166,7 +65269,7 @@ function isUnresolvedAssetPlaceholder(rawSrc) {
 function cleanAssetUrl(url) {
   return url.trim().split(/[?#]/, 1)[0] ?? "";
 }
-function isWithinProjectRoot(projectDir, candidate, pathModule = { resolve: resolve5, relative, isAbsolute }) {
+function isWithinProjectRoot(projectDir, candidate, pathModule = { resolve: resolve5, relative: relative2, isAbsolute: isAbsolute2 }) {
   const projectRoot = pathModule.resolve(projectDir);
   const relativePath = pathModule.relative(projectRoot, candidate);
   return relativePath === "" || !relativePath.startsWith("..") && !pathModule.isAbsolute(relativePath);
@@ -65181,7 +65284,7 @@ function reanchoredCandidates(variant, baseDir, compiledDir) {
 }
 function resolveProjectRelativeSrc(src, baseDir, compiledDir) {
   const cleanSrc = cleanAssetUrl(src);
-  if (isAbsolute(cleanSrc) && existsSync8(cleanSrc)) return cleanSrc;
+  if (isAbsolute2(cleanSrc) && existsSync8(cleanSrc)) return cleanSrc;
   const candidates = /* @__PURE__ */ new Set();
   for (const variant of decodeUrlPathVariants2(cleanSrc)) {
     for (const candidate of reanchoredCandidates(variant, baseDir, compiledDir)) {
@@ -65203,8 +65306,8 @@ function findReferenceTargetEl(doc, refId) {
   return doc.getElementById(refId) ?? doc.querySelector(`[data-composition-id="${refId}"]`);
 }
 function resolveReferencedStart(doc, el, startCache, visiting) {
-  const cached2 = startCache.get(el);
-  if (cached2 !== void 0) return cached2;
+  const cached = startCache.get(el);
+  if (cached !== void 0) return cached;
   if (visiting.has(el)) return 0;
   visiting.add(el);
   try {
@@ -65273,13 +65376,13 @@ import {
   fsyncSync,
   linkSync,
   mkdtempSync as mkdtempSync2,
-  mkdirSync as mkdirSync4,
+  mkdirSync as mkdirSync5,
   lstatSync as lstatSync2,
   openSync as openSync2,
   readdirSync as readdirSync3,
   rmdirSync,
   rmSync,
-  statSync as statSync4,
+  statSync as statSync5,
   unlinkSync
 } from "fs";
 import { createHash, randomUUID } from "crypto";
@@ -65452,7 +65555,7 @@ async function acquireCachePathLock(localPath, timeoutMs, signal) {
     }
     let createdLock = false;
     try {
-      mkdirSync4(lockPath);
+      mkdirSync5(lockPath);
       createdLock = true;
     } catch (error) {
       if (error.code !== "EEXIST") throw error;
@@ -65460,7 +65563,7 @@ async function acquireCachePathLock(localPath, timeoutMs, signal) {
     if (createdLock) {
       const owner = `${CACHE_LOCK_OWNER_PREFIX}${randomUUID()}`;
       try {
-        mkdirSync4(join10(lockPath, owner));
+        mkdirSync5(join10(lockPath, owner));
         const entries2 = readdirSync3(lockPath);
         if (entries2.length === 1 && entries2[0] === owner) {
           return () => releaseOwnedCachePathLock(lockPath, owner);
@@ -65493,7 +65596,7 @@ async function acquireCachePathLock(localPath, timeoutMs, signal) {
       }
       const reclaimPath = join10(lockPath, CACHE_LOCK_RECLAIM_NAME);
       try {
-        mkdirSync4(reclaimPath);
+        mkdirSync5(reclaimPath);
       } catch (error) {
         const code = error.code;
         if (code === "EEXIST" || code === "ENOENT") continue;
@@ -65830,7 +65933,7 @@ async function fetchToPartial(url, partialPath, controller, options) {
   const readableStream = Readable.fromWeb(response.body);
   const fileStream = createWriteStream(partialPath, { flags: "wx" });
   await pipeline(readableStream, inspector, fileStream, { signal: controller.signal });
-  const localSize = statSync4(partialPath).size;
+  const localSize = statSync5(partialPath).size;
   const sha256Bytes = sha256.digest();
   const localSha256 = sha256Bytes.toString("hex");
   const md5Base64 = md5.digest("base64");
@@ -66163,7 +66266,7 @@ async function downloadToTemp(url, destDir, timeoutMs = 3e5, signal, onTransient
     return inFlight;
   }
   if (!existsSync9(destDir)) {
-    mkdirSync4(destDir, { recursive: true });
+    mkdirSync5(destDir, { recursive: true });
   }
   const filename = getFilenameFromUrl(url, validationScope);
   const localPath = join10(destDir, filename);
@@ -66309,11 +66412,12 @@ var init_scriptRuns = __esm({
 });
 
 // ../core/dist/sceneParts.js
-var SCENE_PART_ATTR, SCENE_NO_SWAP_ATTR;
+var SCENE_PART_ATTR, SCENE_PARTS_META, SCENE_NO_SWAP_ATTR;
 var init_sceneParts = __esm({
   "../core/dist/sceneParts.js"() {
     "use strict";
     SCENE_PART_ATTR = "data-hf-scene";
+    SCENE_PARTS_META = "hf-scene-parts";
     SCENE_NO_SWAP_ATTR = "data-hf-scene-no-swap";
   }
 });
@@ -67224,8 +67328,33 @@ ${source.replace(/<\/(script)/gi, "<\\/$1")}
       console.error(__hfErrorLabel, __hfCompId, _err);
     }
   };
+  // What the script started on the global gsap timeline, by any route, for a scene swap to revert.
+  // Only a page with a scene manifest can swap; elsewhere the first script stores null and none records.
+  var __hfRecordAnimations = function(run) {
+    if (window.__hfSceneAnimations === undefined) {
+      window.__hfSceneAnimations = window.document.querySelector(${jsonScriptLiteral(`meta[name="${SCENE_PARTS_META}"]`)})
+        ? {}
+        : null;
+    }
+    var byComp = window.__hfSceneAnimations;
+    var globalTimeline = __hfBaseGsap && __hfBaseGsap.globalTimeline;
+    if (!byComp || !globalTimeline || !__hfTimelineCompId) return run();
+    var before = globalTimeline.getChildren(false);
+    // A set completes as it is made and would leave the timeline before the diff below.
+    var autoRemove = globalTimeline.autoRemoveChildren;
+    globalTimeline.autoRemoveChildren = false;
+    run();
+    globalTimeline.autoRemoveChildren = autoRemove;
+    var recorded = (byComp[__hfTimelineCompId] = byComp[__hfTimelineCompId] || []);
+    globalTimeline.getChildren(false).forEach(function(animation) {
+      if (before.indexOf(animation) >= 0) return;
+      recorded.push(animation);
+      // Dropped as the timeline drops a finished tween (it keeps a paused one); moved back, a tween re-adds itself.
+      if (autoRemove && !animation.getChildren && animation.totalProgress() === 1) globalTimeline.remove(animation);
+    });
+  };
   __hfFindRoot();
-  __hfRun();
+  __hfRecordAnimations(__hfRun);
 })();`;
 }
 function wrapInlineScriptWithErrorBoundary(source, errorLabel) {
@@ -67241,6 +67370,7 @@ var AUTHORED_ROOT_ID_ATTR, INNER_ROOT_ATTR, GLOBAL_AT_RULES, SCOPED_HYPERFRAMES_
 var init_compositionScoping = __esm({
   "../core/dist/compiler/compositionScoping.js"() {
     "use strict";
+    init_sceneParts();
     AUTHORED_ROOT_ID_ATTR = "data-hf-authored-id";
     INNER_ROOT_ATTR = "data-hf-inner-root";
     GLOBAL_AT_RULES = /* @__PURE__ */ new Set(["keyframes", "-webkit-keyframes", "font-face"]);
@@ -70903,9 +71033,9 @@ function resolveCompositionDuration(input) {
   if (isPositiveFinite(input.authoredDurationSeconds)) {
     return { seconds: input.authoredDurationSeconds, source: "authored", pendingClips };
   }
-  const known = input.clipEndsSeconds.filter(isPositiveFinite);
-  if (known.length > 0) {
-    return { seconds: Math.max(...known), source: "derived", pendingClips };
+  const known2 = input.clipEndsSeconds.filter(isPositiveFinite);
+  if (known2.length > 0) {
+    return { seconds: Math.max(...known2), source: "derived", pendingClips };
   }
   return {
     seconds: null,
@@ -70914,10 +71044,11 @@ function resolveCompositionDuration(input) {
     reason: pendingClips > 0 ? "every clip's length is still pending" : "no authored duration and no clip with a length"
   };
 }
-var isPositiveFinite;
+var TIMING_TOLERANCE_SECONDS, isPositiveFinite;
 var init_compositionDuration = __esm({
   "../parsers/dist/compositionDuration.js"() {
     "use strict";
+    TIMING_TOLERANCE_SECONDS = 0.05;
     isPositiveFinite = (value) => value !== null && Number.isFinite(value) && value > 0;
   }
 });
@@ -74251,8 +74382,8 @@ function findAudioGroupCarveAttrFindings(ctx) {
   return findings;
 }
 function callsFor(script) {
-  const cached2 = callIndexes.get(script);
-  if (cached2) return cached2;
+  const cached = callIndexes.get(script);
+  if (cached) return cached;
   const calls = [];
   try {
     const ast = parse7(script.content, {
@@ -74652,8 +74783,8 @@ function synthesizeWindowRaw(timelineVar, anim) {
   return `${timelineVar}.${anim.method}("${anim.targetSelector}", { ${entries2.join(", ")} }, ${pos})`;
 }
 async function cachedExtractGsapWindows(scriptContent) {
-  const cached2 = gsapWindowsCache.get(scriptContent);
-  if (cached2) return cached2;
+  const cached = gsapWindowsCache.get(scriptContent);
+  if (cached) return cached;
   const windows = await extractGsapWindows(scriptContent);
   gsapWindowsCache.set(scriptContent, windows);
   return windows;
@@ -75597,6 +75728,26 @@ function captionFindings(rows, severity) {
   }
   return findings;
 }
+function clipsPastRootFindings(root, rows) {
+  if (root.attrs["data-composition-id"] === void 0) return [];
+  const rootDuration = readDataDurationSeconds((name) => root.attrs[name]);
+  if (rootDuration === null) return [];
+  const limit = hundredths(rootDuration);
+  return rows.flatMap((row) => {
+    const { start, end } = readClipTiming({ getAttribute: (name) => row.attrs[name] ?? null });
+    if (start === null || end === null || end <= rootDuration + TIMING_TOLERANCE_SECONDS) return [];
+    return [
+      {
+        code: "clip_ends_past_root_duration",
+        severity: "warning",
+        message: `${describe(row)} runs from ${hundredths(start)}s to ${hundredths(end)}s, past the root composition's data-duration of ${limit}s, so it is cut off in previews, posters and renders.`,
+        elementId: row.attrs.id,
+        fixHint: `Extend the root data-duration to ${hundredths(end)}, or make ${describe(row)} end at or before ${limit}s.`,
+        snippet: truncateSnippet(row.open.raw)
+      }
+    ];
+  });
+}
 function dedupeKeyFor(finding) {
   return [
     finding.code,
@@ -75665,7 +75816,7 @@ async function lintHyperframeHtml(html, options = {}) {
     timings: { totalMs: performance.now() - startedAt, ...timings }
   };
 }
-var import_postcss_selector_parser, COMPOSITION_ID_IN_CSS_PATTERN, TIMELINE_REGISTRY_INIT_PATTERN, TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN, TIMELINE_REGISTRY_ASSIGN_PATTERN, WINDOW_TIMELINE_ASSIGN_PATTERN, INVALID_SCRIPT_CLOSE_PATTERN, TIMELINE_REGISTRY_KEY_PATTERN, TIMELINE_REGISTRY_OBJECT_OPEN_PATTERN, TIMELINE_REGISTRY_OBJECT_ENTRY_PATTERN, REGEX_ALLOWED_BEFORE, REGEX_ALLOWED_KEYWORDS, WORD_CHAR, CodeContext, VISIBLE_MARKUP_COMMENT_PATTERN, VISIBLE_MARKUP_COMMENT_PROTECTED_BLOCK_PATTERN, coreRules, IMAGE_SRC_EXT, VIDEO_SRC_EXT, AUDIO_SRC_EXT, SRC_KIND_NOUN, mediaRules, AUDIO_GROUP_TIMING_ATTRS, callIndexes, INSPECTION_VIEWPORT_CAP, MAX_COMPOSITION_LINES, MAX_TIMED_ELEMENTS_PER_TRACK, TRACK_DENSITY_EXEMPT_TAGS, CAPTION_CUE_TOKEN, HEAVY_OVERLAY_ELEMENT_COUNT_WARN, HEAVY_OVERLAY_EXEMPT_TAGS, HEAVY_OVERLAY_CSS_PATTERN, INLINE_STYLE_DISPLAY_NONE_PATTERN, ZOOM_DECLARATION, NEGATIVE_Z_INDEX, compositionRules, CLIP_MEDIA_TAGS, SCENE_BOUNDARY_EPSILON_SECONDS, UNRESOLVED_TARGET, gsapWindowsCache, CONFLICTING_TRANSLATE_PROPS, CONFLICTING_SCALE_PROPS, RELATIVE_TWEEN_VALUE, TRANSFORM_SENSITIVE_READ, TRANSFORM_INVARIANT_READ, CALLBACK_MEASUREMENT_PATTERN, NUMBER_METHODS, gsapRules, captionRules, adapterRules, TEXTURE_BASE_CLASS, TEXTURE_CLASS_PREFIX, textureRules, GENERIC_FAMILIES, fontRules, slideshowRules, INLINE_TEXT_TAGS, OPAQUE_TAGS, NON_LAYOUT_TAGS, MEDIA_TAGS2, NODE_ATTRS, describe, structureRules, RULE_GROUPS, LINT_RULE_COUNT, LINT_RULE_GROUP_COUNTS;
+var import_postcss_selector_parser, COMPOSITION_ID_IN_CSS_PATTERN, TIMELINE_REGISTRY_INIT_PATTERN, TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN, TIMELINE_REGISTRY_ASSIGN_PATTERN, WINDOW_TIMELINE_ASSIGN_PATTERN, INVALID_SCRIPT_CLOSE_PATTERN, TIMELINE_REGISTRY_KEY_PATTERN, TIMELINE_REGISTRY_OBJECT_OPEN_PATTERN, TIMELINE_REGISTRY_OBJECT_ENTRY_PATTERN, REGEX_ALLOWED_BEFORE, REGEX_ALLOWED_KEYWORDS, WORD_CHAR, CodeContext, VISIBLE_MARKUP_COMMENT_PATTERN, VISIBLE_MARKUP_COMMENT_PROTECTED_BLOCK_PATTERN, coreRules, IMAGE_SRC_EXT, VIDEO_SRC_EXT, AUDIO_SRC_EXT, SRC_KIND_NOUN, mediaRules, AUDIO_GROUP_TIMING_ATTRS, callIndexes, INSPECTION_VIEWPORT_CAP, MAX_COMPOSITION_LINES, MAX_TIMED_ELEMENTS_PER_TRACK, TRACK_DENSITY_EXEMPT_TAGS, CAPTION_CUE_TOKEN, HEAVY_OVERLAY_ELEMENT_COUNT_WARN, HEAVY_OVERLAY_EXEMPT_TAGS, HEAVY_OVERLAY_CSS_PATTERN, INLINE_STYLE_DISPLAY_NONE_PATTERN, ZOOM_DECLARATION, NEGATIVE_Z_INDEX, compositionRules, CLIP_MEDIA_TAGS, SCENE_BOUNDARY_EPSILON_SECONDS, UNRESOLVED_TARGET, gsapWindowsCache, CONFLICTING_TRANSLATE_PROPS, CONFLICTING_SCALE_PROPS, RELATIVE_TWEEN_VALUE, TRANSFORM_SENSITIVE_READ, TRANSFORM_INVARIANT_READ, CALLBACK_MEASUREMENT_PATTERN, NUMBER_METHODS, gsapRules, captionRules, adapterRules, TEXTURE_BASE_CLASS, TEXTURE_CLASS_PREFIX, textureRules, GENERIC_FAMILIES, fontRules, slideshowRules, INLINE_TEXT_TAGS, OPAQUE_TAGS, NON_LAYOUT_TAGS, MEDIA_TAGS2, NODE_ATTRS, describe, hundredths, structureRules, RULE_GROUPS, LINT_RULE_COUNT, LINT_RULE_GROUP_COUNTS;
 var init_dist3 = __esm({
   "../lint/dist/index.js"() {
     "use strict";
@@ -75686,6 +75837,9 @@ var init_dist3 = __esm({
     init_composition();
     init_slideshow();
     init_topLevelElements();
+    init_compositionContract();
+    init_mediaDuration();
+    init_compositionDuration();
     init_esm10();
     init_esm10();
     COMPOSITION_ID_IN_CSS_PATTERN = /\[data-composition-id=["']([^"']+)["']\]/g;
@@ -78902,6 +79056,7 @@ ${other.raw}`)
       "data-composition-src"
     ];
     describe = (node) => `<${node.tag}${node.attrs.id ? ` id="${node.attrs.id}"` : ""}>`;
+    hundredths = (seconds) => Math.round(seconds * 100) / 100;
     structureRules = [
       (ctx) => {
         if (ctx.options.isSubComposition) return [];
@@ -78912,7 +79067,8 @@ ${other.raw}`)
         return [
           ...nestedStructureFindings(rows, severity),
           ...missingDurationFindings(rows, severity),
-          ...captionFindings(rows, severity)
+          ...captionFindings(rows, severity),
+          ...clipsPastRootFindings(root, rows)
         ];
       }
     ];
@@ -79596,18 +79752,18 @@ import { createHash as createHash3, randomUUID as randomUUID2 } from "crypto";
 import {
   existsSync as existsSync10,
   lstatSync as lstatSync3,
-  mkdirSync as mkdirSync5,
+  mkdirSync as mkdirSync6,
   readdirSync as readdirSync5,
   renameSync,
   rmSync as rmSync2,
-  statSync as statSync5,
+  statSync as statSync6,
   utimesSync,
   writeFileSync as writeFileSync3
 } from "fs";
 import { join as join12 } from "path";
 function readKeyStat(videoPath) {
   try {
-    const stat = statSync5(videoPath);
+    const stat = statSync6(videoPath);
     return { mtimeMs: Math.floor(stat.mtimeMs), size: stat.size };
   } catch {
     return null;
@@ -79740,7 +79896,7 @@ function removeDir(path) {
 }
 function collectGcEntry(dir, name, now, minAgeMs, stats) {
   try {
-    const dirStat = statSync5(dir);
+    const dirStat = statSync6(dir);
     if (isPartialChild(name) && now - dirStat.mtimeMs >= minAgeMs) {
       removeDir(dir);
       stats.agedPartialsRemoved += 1;
@@ -79748,7 +79904,7 @@ function collectGcEntry(dir, name, now, minAgeMs, stats) {
     }
     let lastUseMs = dirStat.mtimeMs;
     try {
-      lastUseMs = statSync5(join12(dir, COMPLETE_SENTINEL)).mtimeMs;
+      lastUseMs = statSync6(join12(dir, COMPLETE_SENTINEL)).mtimeMs;
     } catch {
     }
     return { dir, size: directorySizeBytes(dir), lastUseMs, ageMs: now - lastUseMs };
@@ -79758,7 +79914,7 @@ function collectGcEntry(dir, name, now, minAgeMs, stats) {
 }
 function gcSweepDue(rootDir, maxAgeMs) {
   try {
-    return Date.now() - statSync5(join12(rootDir, GC_MARKER)).mtimeMs > maxAgeMs;
+    return Date.now() - statSync6(join12(rootDir, GC_MARKER)).mtimeMs > maxAgeMs;
   } catch {
     return true;
   }
@@ -79820,14 +79976,14 @@ var init_extractionCache = __esm({
     init_extractedFrameIndex();
     COMPLETE_SENTINEL = ".hf-complete";
     GC_MARKER = ".hf-last-gc";
-    SCHEMA_PREFIX = "hfcache-v5-";
+    SCHEMA_PREFIX = "hfcache-v6-";
     KEY_HEX_CHARS = 16;
     CACHE_GENERATION_PREFIX = "hfcache-v";
   }
 });
 
 // ../engine/src/services/videoFrameExtractor.ts
-import { copyFileSync as copyFileSync2, existsSync as existsSync11, linkSync as linkSync2, mkdirSync as mkdirSync6, rmSync as rmSync3 } from "fs";
+import { copyFileSync as copyFileSync2, existsSync as existsSync11, linkSync as linkSync2, mkdirSync as mkdirSync7, rmSync as rmSync3 } from "fs";
 import { join as join13 } from "path";
 function isVideoFrameFormat(value) {
   return typeof value === "string" && VIDEO_FRAME_FORMATS.includes(value);
@@ -79870,6 +80026,19 @@ function extractionFrameCountForDuration(durationSeconds, fps, isVFR) {
   const frames = Number(frameCount);
   return Math.max(1, Number.isSafeInteger(frames) ? frames : Number.MAX_SAFE_INTEGER);
 }
+async function toneMapsWithZscale() {
+  return process.platform !== "darwin" || isFfmpegFilterAvailable("zscale");
+}
+async function hdrToSdrTransformKey() {
+  if (await toneMapsWithZscale()) return HDR_TO_SDR_ZSCALE_TRANSFORM_KEY;
+  if (!warnedMissingZscale) {
+    warnedMissingZscale = true;
+    process.stderr.write(
+      "[hyperframes:render] WARNING: this ffmpeg has no zscale filter, so forced-SDR HDR footage is tone-mapped by Chrome instead of the hable curve used on Linux and in Studio, and renders darker. Install an ffmpeg built with libzimg to match.\n"
+    );
+  }
+  return HDR_TO_SDR_VIDEOTOOLBOX_TRANSFORM_KEY;
+}
 function sdrToHdrTransformKey(transfer) {
   return `sdr2hdr-${transfer}`;
 }
@@ -80168,6 +80337,10 @@ function parseImageElements(html) {
   }
   return images;
 }
+async function readFirstFrameColour(videoPath, signal) {
+  const result = await runFfmpeg(firstFrameColourArgs(videoPath), { signal });
+  return parseFirstFrameColour(result.stderr);
+}
 function chromeGuessForUntaggedMatrix(metadata) {
   const matrix = metadata.colorSpace?.colorSpace;
   if (matrix && matrix !== "unknown") return [];
@@ -80190,7 +80363,7 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   const fps = fpsToNumber(normalizedFps);
   const ffmpegFps = fpsToFfmpegArg(normalizedFps);
   const videoOutputDir = outputDirOverride ?? join13(outputDir, videoId);
-  if (!existsSync11(videoOutputDir)) mkdirSync6(videoOutputDir, { recursive: true });
+  if (!existsSync11(videoOutputDir)) mkdirSync7(videoOutputDir, { recursive: true });
   let metadata;
   try {
     metadata = await extractMediaMetadata(videoPath);
@@ -80219,8 +80392,11 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   const outputPattern = join13(videoOutputDir, framePattern);
   const isHdr = isHdrColorSpace(metadata.colorSpace);
   const isMacOS = process.platform === "darwin";
+  const toneMappedToSdr = options.toneMapHdrToSdr === true && isHdr && await toneMapsWithZscale();
+  const decodeWithVideoToolbox = isHdr && isMacOS && !toneMappedToSdr;
+  const sampleCfrAtOutputFps = !options.finalFrameOnly && !metadata.isVFR;
   const args = [];
-  if (isHdr && isMacOS) {
+  if (decodeWithVideoToolbox) {
     args.push("-hwaccel", "videotoolbox");
   }
   if (codecMayHaveAlpha(metadata.videoCodec)) {
@@ -80229,23 +80405,32 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   if (options.finalFrameOnly) {
     args.push("-i", videoPath, "-ss", String(startTime), "-frames:v", "1");
   } else {
+    if (sampleCfrAtOutputFps) args.push("-noaccurate_seek");
     args.push("-ss", String(startTime), "-i", videoPath, "-t", String(duration));
   }
   const vfFilters = [];
-  if (isHdr && isMacOS) {
+  if (decodeWithVideoToolbox) {
     vfFilters.push("format=nv12");
   }
-  if (!options.finalFrameOnly && !metadata.isVFR) {
-    vfFilters.push(`fps=${ffmpegFps}`);
+  if (sampleCfrAtOutputFps) {
+    vfFilters.push(
+      "settb=intb/2",
+      "setpts=PTS-lte(TB\\,0.001)",
+      `fps=${ffmpegFps}:start_time=0:round=up`
+    );
   }
   if (options.sdrToHdrTransfer) {
     vfFilters.push(SDR_TO_HDR_COLORSPACE_FILTER);
   }
-  if (options.toneMapHdrToSdr && isHdr && !isMacOS) {
-    vfFilters.push(HDR_TO_SDR_TONEMAP_FILTER);
+  if (toneMappedToSdr) {
+    const frameColour = await readFirstFrameColour(videoPath, signal);
+    vfFilters.push(hdrToSdrToneMapFilter(metadata.colorSpace ?? {}, frameColour));
   }
-  if (!isHdr && !options.sdrToHdrTransfer) {
-    vfFilters.push(...chromeGuessForUntaggedMatrix(metadata), SDR_CANVAS_PASSTHROUGH_FILTER);
+  if (toneMappedToSdr || !isHdr && !options.sdrToHdrTransfer) {
+    vfFilters.push(
+      ...isHdr ? [] : chromeGuessForUntaggedMatrix(metadata),
+      SDR_CANVAS_PASSTHROUGH_FILTER
+    );
     if (format === "jpg") vfFilters.push(SDR_JPEG_AS_BT601_FULL_RANGE_FILTER);
   }
   const encodeArgs = ["-q:v", format === "jpg" ? String(Math.ceil((100 - quality) / 3)) : "0"];
@@ -80579,7 +80764,7 @@ function supersetGroupingKey(work, fps) {
     String(fps),
     work.format,
     work.sdrToHdrTransfer ?? "",
-    work.toneMapHdrToSdr ? HDR_TO_SDR_TRANSFORM_KEY : "",
+    work.hdrToSdrTransformKey ?? "",
     work.finalFrameOnly ? "final" : "range"
   ].join("\0");
 }
@@ -80661,7 +80846,7 @@ function planSupersetGroups(misses, fps) {
 function sliceSupersetMember(member, superset, outputDir, fps, configuredFps) {
   const { work } = member.miss;
   rmSync3(outputDir, { recursive: true, force: true });
-  mkdirSync6(outputDir, { recursive: true });
+  mkdirSync7(outputDir, { recursive: true });
   const requestedFrames = extractionFrameCountForDuration(
     work.videoDuration,
     configuredFps,
@@ -80722,7 +80907,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
       }
       if (isHttpUrl(videoPath)) {
         const downloadDir = join13(options.outputDir, "_downloads");
-        mkdirSync6(downloadDir, { recursive: true });
+        mkdirSync7(downloadDir, { recursive: true });
         videoPath = await downloadToTemp(
           videoPath,
           downloadDir,
@@ -80862,7 +81047,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
   let cacheRootDir;
   if (configuredCacheRootDir) {
     try {
-      mkdirSync6(configuredCacheRootDir, { recursive: true });
+      mkdirSync7(configuredCacheRootDir, { recursive: true });
       cacheRootDir = configuredCacheRootDir;
     } catch {
       process.stderr.write(
@@ -80885,7 +81070,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
       ...options,
       format: work.format,
       sdrToHdrTransfer: work.sdrToHdrTransfer,
-      toneMapHdrToSdr: work.toneMapHdrToSdr,
+      toneMapHdrToSdr: work.hdrToSdrTransformKey !== void 0,
       finalFrameOnly: work.finalFrameOnly
     };
   }
@@ -80905,7 +81090,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.hdrToSdrTransformKey,
       work.finalFrameOnly ? "final-frame" : void 0
     ].filter((part) => part !== void 0);
     const transform = transformParts.length > 0 ? transformParts.join("+") : void 0;
@@ -80956,7 +81141,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
     }
     const partialDir = partialCacheEntryDir(cacheTarget.entry);
     rmSync3(partialDir, { recursive: true, force: true });
-    mkdirSync6(partialDir, { recursive: true });
+    mkdirSync7(partialDir, { recursive: true });
     const attempted = await runVideoExtractionWithRetry(
       () => extractVideoFramesRange(
         work.videoPath,
@@ -80974,7 +81159,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
         onRetry: () => {
           recordTransientRetries(1);
           rmSync3(partialDir, { recursive: true, force: true });
-          mkdirSync6(partialDir, { recursive: true });
+          mkdirSync7(partialDir, { recursive: true });
         }
       }
     );
@@ -81080,9 +81265,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 hdrToSdrTransform = options.toneMapHdrToSdr === true && isHdrColorSpace(metadata.colorSpace) ? await hdrToSdrTransformKey() : void 0;
         const finalFrameOnly = window3.finalFrameOnly === true;
-        const dedupeKey = `${videoPath}\0${extractionMediaStart}\0${videoDuration}\0${fpsKey}\0${format}\0${sdrToHdrTransfer ?? ""}\0${toneMapHdrToSdr ? HDR_TO_SDR_TRANSFORM_KEY : ""}\0${finalFrameOnly ? "final" : "range"}`;
+        const dedupeKey = `${videoPath}\0${extractionMediaStart}\0${videoDuration}\0${fpsKey}\0${format}\0${sdrToHdrTransfer ?? ""}\0${hdrToSdrTransform ?? ""}\0${finalFrameOnly ? "final" : "range"}`;
         return {
           work: {
             video,
@@ -81094,7 +81279,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
             finalFrameOnly,
             format,
             sdrToHdrTransfer,
-            toneMapHdrToSdr,
+            hdrToSdrTransformKey: hdrToSdrTransform,
             dedupeKey
           }
         };
@@ -81237,7 +81422,7 @@ function createFrameLookupTable(videos, extracted, fps) {
   }
   return table;
 }
-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, SDR_CANVAS_PASSTHROUGH_FILTER, SDR_JPEG_AS_BT601_FULL_RANGE_FILTER, VideoSourceExtractionError, CHROME_BT601_UNTAGGED_CODECS, NUT_RAW_PIXEL_FORMATS, 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_ZSCALE_TRANSFORM_KEY, HDR_TO_SDR_VIDEOTOOLBOX_TRANSFORM_KEY, SDR_CANVAS_PASSTHROUGH_FILTER, SDR_JPEG_AS_BT601_FULL_RANGE_FILTER, warnedMissingZscale, VideoSourceExtractionError, CHROME_BT601_UNTAGGED_CODECS, NUT_RAW_PIXEL_FORMATS, TRANSIENT_FFMPEG_SPAWN_CODES, FINAL_FRAME_LOGICAL_DURATION_SECONDS, ALPHA_CAPABLE_CODECS, FrameLookupTable;
 var init_videoFrameExtractor = __esm({
   "../engine/src/services/videoFrameExtractor.ts"() {
     "use strict";
@@ -81250,6 +81435,7 @@ var init_videoFrameExtractor = __esm({
     init_hdr();
     init_urlDownloader();
     init_runFfmpeg();
+    init_psnrFilterAvailability();
     init_config();
     init_htmlTemplate();
     init_extractionCache();
@@ -81258,10 +81444,11 @@ 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";
+    HDR_TO_SDR_ZSCALE_TRANSFORM_KEY = "hdr2sdr-hable-srgb";
+    HDR_TO_SDR_VIDEOTOOLBOX_TRANSFORM_KEY = "hdr2sdr-videotoolbox-hdr";
     SDR_CANVAS_PASSTHROUGH_FILTER = "setparams=color_primaries=bt709:color_trc=iec61966-2-1";
     SDR_JPEG_AS_BT601_FULL_RANGE_FILTER = "scale=flags=neighbor,format=gbrp,scale=out_color_matrix=bt601:out_range=pc:flags=neighbor,format=yuv420p";
+    warnedMissingZscale = false;
     VideoSourceExtractionError = class extends Error {
       constructor(kind, retryable, message, diagnostic = message) {
         super(message);
@@ -81480,10 +81667,10 @@ function createFrameSourceCache(entryLimit, bytesLimit, frameSrcResolver) {
   async function get(framePath) {
     const servedSrc = frameSrcResolver?.(framePath);
     if (servedSrc) return servedSrc;
-    const cached2 = cache2.get(framePath);
-    if (cached2) {
-      remember(framePath, cached2);
-      return cached2;
+    const cached = cache2.get(framePath);
+    if (cached) {
+      remember(framePath, cached);
+      return cached;
     }
     const existing = inFlight.get(framePath);
     if (existing) {
@@ -82504,8 +82691,8 @@ var init_audioFxRender = __esm({
 });
 
 // ../engine/src/services/audioMixer.ts
-import { closeSync as closeSync3, existsSync as existsSync13, mkdirSync as mkdirSync7, mkdtempSync as mkdtempSync5, openSync as openSync3, rmSync as rmSync6, writeFileSync as writeFileSync6 } from "fs";
-import { join as join16, dirname as dirname10, isAbsolute as isAbsolute2, relative as relative2 } from "path";
+import { closeSync as closeSync3, existsSync as existsSync13, mkdirSync as mkdirSync8, mkdtempSync as mkdtempSync5, openSync as openSync3, rmSync as rmSync6, writeFileSync as writeFileSync6 } from "fs";
+import { join as join16, dirname as dirname10, isAbsolute as isAbsolute3, relative as relative3 } from "path";
 function memberGroupKey(el) {
   return el.getAttribute(AUDIO_GROUP_RENDER_ID_ATTR) ?? el.getAttribute(HF_AUDIO_GROUP_ATTR);
 }
@@ -82687,8 +82874,8 @@ function buildTrackInputFilter(track, index, volumeFilter, totalDuration) {
   return `[${index}:a]atrim=0:${formatFilterNumber(trimDuration)},${volumeFilter}${buildFadeFilters(track)},adelay=${delayMs}|${delayMs},apad,asetpts=N/SR/TB,atrim=0:${formatFilterNumber(totalDuration)}[a${index}]`;
 }
 function missingSourceMessage(elementId, src, baseDir, resolvedPath) {
-  const relativePath = relative2(baseDir, resolvedPath).replace(/\\/g, "/");
-  const insideProject = !relativePath.startsWith("..") && !isAbsolute2(relativePath);
+  const relativePath = relative3(baseDir, resolvedPath).replace(/\\/g, "/");
+  const insideProject = !relativePath.startsWith("..") && !isAbsolute3(relativePath);
   const authored = /^([\\/]|[A-Za-z]:)/.test(src) ? "" : `src="${src}" `;
   return `Source not found for audio element ${elementId}: ${authored}resolved to ${insideProject ? relativePath : "a path outside the project"}`;
 }
@@ -82863,7 +83050,7 @@ function parseAudioElements(html) {
 async function extractAudioFromVideo(videoPath, outputPath, options, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
   const outputDir = dirname10(outputPath);
-  if (!existsSync13(outputDir)) mkdirSync7(outputDir, { recursive: true });
+  if (!existsSync13(outputDir)) mkdirSync8(outputDir, { recursive: true });
   const playbackRate = normalizeRateSpec(options?.playbackRate);
   const args = [];
   if (options?.startTime !== void 0) args.push("-ss", String(options.startTime));
@@ -82909,7 +83096,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 = dirname10(outputPath);
-  if (!existsSync13(outputDir)) mkdirSync7(outputDir, { recursive: true });
+  if (!existsSync13(outputDir)) mkdirSync8(outputDir, { recursive: true });
   const normalizedPlaybackRate = normalizeRateSpec(playbackRate);
   const outputArgs = await preparedAudioOutputArgs(srcPath, normalizedPlaybackRate, duration);
   const args = [
@@ -82956,7 +83143,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 = dirname10(outputPath);
-  if (!existsSync13(outputDir)) mkdirSync7(outputDir, { recursive: true });
+  if (!existsSync13(outputDir)) mkdirSync8(outputDir, { recursive: true });
   const args = [
     "-f",
     "lavfi",
@@ -83010,7 +83197,7 @@ async function mixAudioTracks(tracks, outputPath, totalDuration, signal, config)
     };
   }
   const outputDir = dirname10(outputPath);
-  if (!existsSync13(outputDir)) mkdirSync7(outputDir, { recursive: true });
+  if (!existsSync13(outputDir)) mkdirSync8(outputDir, { recursive: true });
   const buildFilterComplex = (ignoreAutomation) => {
     const filterParts = [];
     tracks.forEach((track, i) => {
@@ -83114,7 +83301,7 @@ function groupNormalizeOptionUnsupported(stderr) {
 async function mixGroupMembers(memberTracks, outputPath, totalDuration, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
   const outputDir = dirname10(outputPath);
-  if (!existsSync13(outputDir)) mkdirSync7(outputDir, { recursive: true });
+  if (!existsSync13(outputDir)) mkdirSync8(outputDir, { recursive: true });
   const buildInputFilters = (ignoreKeyframes) => memberTracks.map((track, i) => {
     const volumeFilter = buildVolumeExpression(track, ignoreKeyframes);
     return buildTrackInputFilter(track, i, volumeFilter, totalDuration);
@@ -83201,7 +83388,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
   const failures = [];
   const groupTracks = /* @__PURE__ */ new Map();
   const groupMeta = /* @__PURE__ */ new Map();
-  if (!existsSync13(workDir)) mkdirSync7(workDir, { recursive: true });
+  if (!existsSync13(workDir)) mkdirSync8(workDir, { recursive: true });
   const internalController = new AbortController();
   const effectiveSignal = internalController.signal;
   if (signal) {
@@ -83702,7 +83889,7 @@ var init_readWebGlVendorInfoFromCanvas = __esm({
 
 // ../engine/src/services/parallelCoordinator.ts
 import { cpus, freemem } from "os";
-import { existsSync as existsSync14, mkdirSync as mkdirSync8, readdirSync as readdirSync6 } from "fs";
+import { existsSync as existsSync14, mkdirSync as mkdirSync9, readdirSync as readdirSync6 } from "fs";
 import { copyFile, readFile as readFile2, rename } from "fs/promises";
 import { join as join18 } from "path";
 import { getHeapStatistics } from "v8";
@@ -84055,7 +84242,7 @@ async function verifyDiskDrawElementSamples(session, task, streaming) {
 async function executeWorkerTask(task, serverUrl, captureOptions, createBeforeCaptureHook, signal, onFrameCaptured, onFrameBuffer, config, parallel, onFailure, onWorkerPhase) {
   const startTime = Date.now();
   let framesCaptured = 0;
-  if (!existsSync14(task.outputDir)) mkdirSync8(task.outputDir, { recursive: true });
+  if (!existsSync14(task.outputDir)) mkdirSync9(task.outputDir, { recursive: true });
   let session = null;
   let perf;
   const needsSeparateBrowsers = shouldDisableBrowserPoolForParallelWorker({
@@ -84274,7 +84461,7 @@ async function executeParallelCapture(serverUrl, workDir, tasks, captureOptions,
   return results;
 }
 async function mergeWorkerFrames(workDir, tasks, outputDir) {
-  if (!existsSync14(outputDir)) mkdirSync8(outputDir, { recursive: true });
+  if (!existsSync14(outputDir)) mkdirSync9(outputDir, { recursive: true });
   let totalFrames = 0;
   const sortedTasks = [...tasks].sort((a, b) => a.startFrame - b.startFrame);
   for (const task of sortedTasks) {
@@ -84329,7 +84516,7 @@ var init_parallelCoordinator = __esm({
 // ../engine/src/services/fileServer.ts
 import { Hono } from "hono";
 import { serve } from "@hono/node-server";
-import { readFileSync as readFileSync7, openSync as openSync4, fstatSync, closeSync as closeSync4, statSync as statSync6, constants as constants2 } from "fs";
+import { readFileSync as readFileSync7, openSync as openSync4, fstatSync, closeSync as closeSync4, statSync as statSync7, constants as constants2 } from "fs";
 import { join as join19, extname as extname3 } from "path";
 function readRegularFile(filePath) {
   let fd;
@@ -84338,7 +84525,7 @@ function readRegularFile(filePath) {
   } catch (error) {
     if (error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR"))
       return null;
-    if (!statSync6(filePath, { throwIfNoEntry: false })?.isFile()) return null;
+    if (!statSync7(filePath, { throwIfNoEntry: false })?.isFile()) return null;
     throw error;
   }
   try {
@@ -88911,7 +89098,7 @@ __export(fontCompression_exports, {
 import { createHash as createHash8 } from "crypto";
 import {
   existsSync as existsSync23,
-  mkdirSync as mkdirSync13,
+  mkdirSync as mkdirSync14,
   mkdtempSync as mkdtempSync8,
   readFileSync as readFileSync11,
   renameSync as renameSync5,
@@ -88937,8 +89124,8 @@ function cachedCompressionPath(input, originalFormat, cacheDir) {
 function readCachedCompression(path) {
   try {
     if (!existsSync23(path)) return null;
-    const cached2 = readFileSync11(path);
-    return cached2.length > 0 ? cached2 : null;
+    const cached = readFileSync11(path);
+    return cached.length > 0 ? cached : null;
   } catch {
     return null;
   }
@@ -88946,7 +89133,7 @@ function readCachedCompression(path) {
 function cacheCompression(path, compressed) {
   let tempDir;
   try {
-    mkdirSync13(dirname14(path), { recursive: true });
+    mkdirSync14(dirname14(path), { recursive: true });
     tempDir = mkdtempSync8(join32(dirname14(path), ".compression-"));
     const tmpPath = join32(tempDir, "font.woff2");
     writeFileSync9(tmpPath, compressed, { flag: "wx", mode: 420 });
@@ -88972,8 +89159,8 @@ async function fontToDataUri(input, originalFormat, options = {}) {
       originalFormat,
       options.cacheDir ?? defaultCacheDir()
     );
-    const cached2 = readCachedCompression(cachePath);
-    if (cached2) return `data:font/woff2;base64,${cached2.toString("base64")}`;
+    const cached = readCachedCompression(cachePath);
+    if (cached) return `data:font/woff2;base64,${cached.toString("base64")}`;
     const compressed = await (options.compressImpl ?? compressToWoff2)(input);
     cacheCompression(cachePath, compressed);
     return `data:font/woff2;base64,${compressed.toString("base64")}`;
@@ -89005,13 +89192,13 @@ init_dist();
 init_src();
 import {
   existsSync as existsSync33,
-  mkdirSync as mkdirSync19,
+  mkdirSync as mkdirSync20,
   mkdtempSync as mkdtempSync11,
-  readFileSync as readFileSync15,
+  readFileSync as readFileSync16,
   readdirSync as readdirSync12,
   rmSync as rmSync15,
-  statSync as statSync12,
-  writeFileSync as writeFileSync11,
+  statSync as statSync13,
+  writeFileSync as writeFileSync12,
   copyFileSync as copyFileSync6,
   appendFileSync
 } from "fs";
@@ -89029,7 +89216,7 @@ import { serve as serve2 } from "@hono/node-server";
 import {
   existsSync as existsSync17,
   realpathSync as realpathSync2,
-  statSync as statSync7,
+  statSync as statSync8,
   createReadStream as createReadStream3,
   openSync as openSync5,
   fstatSync as fstatSync2,
@@ -89620,7 +89807,7 @@ function openRegularFile(filePath) {
   } catch (error) {
     if (error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR"))
       return null;
-    if (!statSync7(filePath, { throwIfNoEntry: false })?.isFile()) return null;
+    if (!statSync8(filePath, { throwIfNoEntry: false })?.isFile()) return null;
     throw error;
   }
   let accepted = false;
@@ -89797,12 +89984,12 @@ import {
   copyFileSync as copyFileSync3,
   cpSync,
   existsSync as existsSync18,
-  mkdirSync as mkdirSync9,
+  mkdirSync as mkdirSync10,
   rmSync as rmSync7,
   symlinkSync,
   writeFileSync as writeFileSync7
 } from "fs";
-import { basename as basename4, dirname as dirname12, isAbsolute as isAbsolute3, join as join23, relative as relative3, resolve as resolve8 } from "path";
+import { basename as basename4, dirname as dirname12, isAbsolute as isAbsolute4, join as join23, relative as relative4, resolve as resolve8 } from "path";
 
 // ../producer/src/utils/paths.ts
 import {
@@ -89883,11 +90070,11 @@ function resolveDeviceScaleFactor(input) {
 }
 function writeCompiledArtifacts(compiled, workDir, includeSummary) {
   const compileDir = join23(workDir, "compiled");
-  mkdirSync9(compileDir, { recursive: true });
+  mkdirSync10(compileDir, { recursive: true });
   writeFileSync7(join23(compileDir, "index.html"), compiled.html, "utf-8");
   for (const [srcPath, html] of compiled.subCompositions) {
     const outPath = join23(compileDir, srcPath);
-    mkdirSync9(dirname12(outPath), { recursive: true });
+    mkdirSync10(dirname12(outPath), { recursive: true });
     writeFileSync7(outPath, html, "utf-8");
   }
   for (const [relativePath, absolutePath] of compiled.externalAssets) {
@@ -89896,7 +90083,7 @@ function writeCompiledArtifacts(compiled, workDir, includeSummary) {
       console.warn(`[Render] Skipping external asset with unsafe path: ${relativePath}`);
       continue;
     }
-    mkdirSync9(dirname12(outPath), { recursive: true });
+    mkdirSync10(dirname12(outPath), { recursive: true });
     copyFileSync3(absolutePath, outPath);
   }
   if (includeSummary) {
@@ -89984,12 +90171,12 @@ var materializePathModule = {
   join: join23,
   dirname: dirname12,
   basename: basename4,
-  relative: relative3,
-  isAbsolute: isAbsolute3
+  relative: relative4,
+  isAbsolute: isAbsolute4
 };
 var materializeFileSystem = {
   existsSync: existsSync18,
-  mkdirSync: mkdirSync9,
+  mkdirSync: mkdirSync10,
   symlinkSync,
   cpSync,
   rmSync: rmSync7
@@ -90645,7 +90832,7 @@ function replanAfterFailure(plan2, failure) {
 
 // ../producer/src/services/render/stages/captureSegmentedStage.ts
 init_src();
-import { existsSync as existsSync20, mkdirSync as mkdirSync11, rmSync as rmSync10, statSync as statSync8 } from "fs";
+import { existsSync as existsSync20, mkdirSync as mkdirSync12, rmSync as rmSync10, statSync as statSync9 } from "fs";
 import { join as join28 } from "path";
 
 // ../producer/src/services/render/captureStageError.ts
@@ -91235,7 +91422,7 @@ import {
   closeSync as closeSync8,
   constants as constants4,
   fstatSync as fstatSync4,
-  mkdirSync as mkdirSync10,
+  mkdirSync as mkdirSync11,
   mkdtempSync as mkdtempSync7,
   openSync as openSync7,
   readFileSync as readFileSync9,
@@ -91447,7 +91634,7 @@ async function extractHdrVideoFrames(args) {
   const extractMediaMetadataImpl = args.extractMediaMetadataImpl ?? extractMediaMetadata;
   const resolveFinalFrameExtractionWindowImpl = args.resolveFinalFrameExtractionWindowImpl ?? resolveFinalFrameExtractionWindow;
   const out = /* @__PURE__ */ new Map();
-  mkdirSync10(framesDir, { recursive: true });
+  mkdirSync11(framesDir, { recursive: true });
   const plannedVideos = [];
   const extractionWindows = /* @__PURE__ */ new Map();
   for (const [videoId, srcPath] of prep.hdrVideoSrcPaths) {
@@ -91485,7 +91672,7 @@ async function extractHdrVideoFrames(args) {
       const video = composition.videos.find((v) => v.id === videoId);
       const window3 = extractionWindows.get(videoId);
       if (!video || !window3) continue;
-      mkdirSync10(framesDir, { recursive: true });
+      mkdirSync11(framesDir, { recursive: true });
       const frameDir = mkdtempSync7(join26(framesDir, `hdr_${tempDirSafePrefix(videoId)}-`));
       createdFrameDirs.add(frameDir);
       const dims = prep.hdrExtractionDims.get(videoId) ?? { width, height };
@@ -92769,7 +92956,7 @@ async function captureSegment(ctx, segment) {
       path: segmentPath,
       // Recorded so resume can prove the file on disk is the one that
       // finished; absent only in unit tests, whose fake encoder writes none.
-      bytes: existsSync20(segmentPath) ? statSync8(segmentPath).size : 0
+      bytes: existsSync20(segmentPath) ? statSync9(segmentPath).size : 0
     });
     return encodeResult.durationMs;
   } finally {
@@ -92950,7 +93137,7 @@ async function runCaptureSegmentedStage(input) {
   const deps = { ...DEFAULT_DEPS, ...input.deps };
   const segments = planSegments(input.totalFrames, input.segmentFrames);
   const segmentDir = input.segmentDir ?? join28(input.workDir, "segments");
-  mkdirSync11(segmentDir, { recursive: true });
+  mkdirSync12(segmentDir, { recursive: true });
   const skip = input.completedSegments ?? /* @__PURE__ */ new Set();
   const pending = segments.filter((s) => !skip.has(s.index));
   for (const index of skip) log.info("[Render] segment skipped (resume)", { index });
@@ -93022,7 +93209,7 @@ async function runCaptureSegmentedStage(input) {
 
 // ../producer/src/services/render/segmentManifest.ts
 import { createHash as createHash6 } from "crypto";
-import { existsSync as existsSync21, mkdirSync as mkdirSync12, readFileSync as readFileSync10, renameSync as renameSync4, statSync as statSync9, writeFileSync as writeFileSync8 } from "fs";
+import { existsSync as existsSync21, mkdirSync as mkdirSync13, readFileSync as readFileSync10, renameSync as renameSync4, statSync as statSync10, writeFileSync as writeFileSync8 } from "fs";
 import { join as join29 } from "path";
 var MANIFEST_FILENAME = "segments.json";
 function computeSegmentPlanHash(input) {
@@ -93074,14 +93261,14 @@ function readSegmentManifest(segmentDir) {
   }
 }
 function writeSegmentManifest(segmentDir, manifest) {
-  mkdirSync12(segmentDir, { recursive: true });
+  mkdirSync13(segmentDir, { recursive: true });
   const tmp = join29(segmentDir, `${MANIFEST_FILENAME}.${process.pid}.tmp`);
   writeFileSync8(tmp, JSON.stringify(manifest, null, 2), "utf-8");
   renameSync4(tmp, join29(segmentDir, MANIFEST_FILENAME));
 }
-async function probeSegmentFrameCount(path, probe2) {
+async function probeSegmentFrameCount(path, probe) {
   try {
-    const meta = await probe2(path);
+    const meta = await probe(path);
     if (!Number.isFinite(meta.videoStreamDurationSeconds) || !Number.isFinite(meta.fps))
       return null;
     if (meta.fps <= 0) return null;
@@ -93095,7 +93282,7 @@ async function validateCompletedSegments(manifest, expectedHash, probeFrames) {
   if (manifest.planHash !== expectedHash) return ok;
   for (const entry of manifest.completed) {
     if (!existsSync21(entry.path)) continue;
-    const size = statSync9(entry.path).size;
+    const size = statSync10(entry.path).size;
     if (size <= 0 || size !== entry.bytes) continue;
     const frames = await probeFrames(entry.path);
     if (frames !== entry.endFrame - entry.startFrame) continue;
@@ -93889,8 +94076,8 @@ init_compiler();
 init_subCompositionValidity();
 init_assetResolution();
 import { createHash as createHash11 } from "crypto";
-import { createReadStream as createReadStream4, existsSync as existsSync27, mkdirSync as mkdirSync16, readFileSync as readFileSync14 } from "fs";
-import { join as join35, dirname as dirname16, resolve as resolve12, basename as basename6, relative as relative4 } from "path";
+import { createReadStream as createReadStream4, existsSync as existsSync27, mkdirSync as mkdirSync17, readFileSync as readFileSync14 } from "fs";
+import { join as join35, dirname as dirname16, resolve as resolve12, basename as basename6, relative as relative5 } from "path";
 
 // ../producer/src/services/renderMediaCollector.ts
 init_esm10();
@@ -93993,7 +94180,7 @@ init_src();
 
 // ../producer/src/services/deterministicFonts.ts
 import { createHash as createHash9 } from "crypto";
-import { existsSync as existsSync24, mkdirSync as mkdirSync14, mkdtempSync as mkdtempSync9, readFileSync as readFileSync12, writeFileSync as writeFileSync10 } from "fs";
+import { existsSync as existsSync24, mkdirSync as mkdirSync15, mkdtempSync as mkdtempSync9, readFileSync as readFileSync12, writeFileSync as writeFileSync10 } from "fs";
 import { homedir as homedir5, tmpdir as tmpdir6 } from "os";
 import { join as join33 } from "path";
 
@@ -94269,7 +94456,80 @@ function dedupeVariants(variants) {
 init_esm10();
 init_fontData_generated();
 init_fontCompression();
+import postcss5 from "postcss";
+
+// ../producer/src/services/authoredGoogleFonts.ts
+init_esm10();
 import postcss4 from "postcss";
+function screenStylesheet(media) {
+  return !media?.trim() || media.split(",").some((query2) => /^(all|screen)$/i.test(query2.trim()));
+}
+function googleStylesheetFamilies(urlText) {
+  let parsed;
+  try {
+    parsed = new URL(urlText);
+  } catch {
+    return [];
+  }
+  if (parsed.protocol !== "https:" || parsed.hostname !== "fonts.googleapis.com") return [];
+  return parsed.searchParams.getAll("family").flatMap((family) => family.split("|")).map((family) => family.split(":")[0]?.trim().toLowerCase() ?? "").filter(Boolean);
+}
+function importUrls(css) {
+  let root;
+  try {
+    root = postcss4.parse(css);
+  } catch {
+    return [];
+  }
+  const urls = [];
+  for (const node of root.nodes) {
+    if (node.type !== "atrule" || node.name.toLowerCase() !== "import") continue;
+    const url = unconditionalImportUrl(node.params);
+    if (url) urls.push(url);
+  }
+  return urls;
+}
+function unconditionalImportUrl(params) {
+  const match = /^(?:url\(\s*['"]?([^'")\s]+)['"]?\s*\)|['"]([^'"]+)['"])\s*(.*)$/i.exec(params);
+  if (!match || !screenStylesheet(match[3] ?? null)) return void 0;
+  return match[1] ?? match[2];
+}
+function activeStylesheet(element) {
+  if (element.hasAttribute("disabled") || !screenStylesheet(element.getAttribute("media")))
+    return false;
+  const type = element.getAttribute("type")?.trim().toLowerCase();
+  return !type || type === "text/css";
+}
+function stylesheetUrls(element) {
+  if (!activeStylesheet(element)) return [];
+  if (element.localName !== "link") return importUrls(element.textContent ?? "");
+  const rel = (element.getAttribute("rel") ?? "").toLowerCase().split(/\s+/);
+  if (!rel.includes("stylesheet") || rel.includes("alternate")) return [];
+  const href = element.getAttribute("href");
+  return href ? [href] : [];
+}
+function authoredGoogleFontStylesheets(html) {
+  const byFamily = /* @__PURE__ */ new Map();
+  const { document: document2 } = parseHTML(html);
+  for (const element of document2.querySelectorAll("link, style")) {
+    for (const url of stylesheetUrls(element)) {
+      for (const family of googleStylesheetFamilies(url)) {
+        const previous = byFamily.get(family) ?? [];
+        byFamily.set(family, [...previous.filter((existing) => existing !== url), url]);
+      }
+    }
+  }
+  return byFamily;
+}
+function withPageText(url, fontText) {
+  const parsed = new URL(url);
+  if (!fontText || parsed.searchParams.has("text")) return url;
+  const withoutFragment = url.split("#")[0] ?? url;
+  const joiner = parsed.search ? "&" : "?";
+  return `${withoutFragment}${joiner}text=${encodeURIComponent(fontText)}${parsed.hash}`;
+}
+
+// ../producer/src/services/deterministicFonts.ts
 var GENERIC_FAMILIES2 = /* @__PURE__ */ new Set([
   "sans-serif",
   "serif",
@@ -94286,6 +94546,13 @@ var GENERIC_FAMILIES2 = /* @__PURE__ */ new Set([
   "-apple-system",
   "blinkmacsystemfont"
 ]);
+var CSS_WIDE_KEYWORDS = /* @__PURE__ */ new Set([
+  "inherit",
+  "initial",
+  "unset",
+  "revert",
+  "revert-layer"
+]);
 function parseFontFamilyValue(value) {
   const pieces = [];
   let start = 0;
@@ -94320,7 +94587,17 @@ function parseFontFamilyValue(value) {
   pieces.push(value.slice(start));
   return pieces.map((piece) => piece.trim().replace(/^['"]/, "").replace(/['"]$/, "").trim()).filter((piece) => piece.length > 0);
 }
-function systemPrimaryReplacement(value, deterministicPrimary) {
+function systemPrimaryReplacement(value, deterministicPrimary, customProperties) {
+  const variable = primaryCssVariable(value);
+  if (variable) {
+    if (customProperties.get(variable.name) || variable.fallback === null) return null;
+    const fallback = systemPrimaryReplacement(
+      variable.fallback,
+      deterministicPrimary,
+      customProperties
+    );
+    return fallback ? `var(${variable.name}, ${fallback})${variable.rest}` : null;
+  }
   const families = parseFontFamilyValue(value);
   if (families.length === 0) return null;
   if (!GENERIC_FAMILIES2.has(normalizeFamilyName(families[0]))) return null;
@@ -94328,7 +94605,7 @@ function systemPrimaryReplacement(value, deterministicPrimary) {
 }
 function parseCssRoot(css) {
   try {
-    return postcss4.parse(css);
+    return postcss5.parse(css);
   } catch {
     return null;
   }
@@ -94337,11 +94614,11 @@ function isFontFaceDeclaration(decl) {
   const parent = decl.parent;
   return parent?.type === "atrule" && parent.name.toLowerCase() === "font-face";
 }
-function normalizeCssDeclarations(root, deterministicPrimary) {
+function normalizeCssDeclarations(root, replacePrimary) {
   let changed = false;
   root.walkDecls((decl) => {
     if (decl.prop.startsWith("--")) {
-      const replacement2 = systemPrimaryReplacement(decl.value, deterministicPrimary);
+      const replacement2 = replacePrimary(decl.value);
       if (!replacement2) return;
       decl.value = replacement2;
       changed = true;
@@ -94351,50 +94628,52 @@ function normalizeCssDeclarations(root, deterministicPrimary) {
     if (isFontFaceDeclaration(decl)) {
       return;
     }
-    const replacement = systemPrimaryReplacement(decl.value, deterministicPrimary);
+    const replacement = replacePrimary(decl.value);
     if (!replacement) return;
     decl.value = replacement;
     changed = true;
   });
   return changed;
 }
-function normalizeCssFontFamilyDeclarations(css, deterministicPrimary) {
+function normalizeCssFontFamilyDeclarations(css, replacePrimary) {
   const root = parseCssRoot(css);
   if (!root) return css;
-  const changed = normalizeCssDeclarations(root, deterministicPrimary);
+  const changed = normalizeCssDeclarations(root, replacePrimary);
   return changed ? root.toString() : css;
 }
-function normalizeInlineStyleAttribute(style, deterministicPrimary) {
+function normalizeInlineStyleAttribute(style, replacePrimary) {
   const root = parseCssRoot(`*{${style}}`);
   if (!root) return style;
   const rule = root.first;
   if (rule?.type !== "rule") return style;
   const before2 = rule.toString();
-  normalizeCssDeclarations(root, deterministicPrimary);
+  normalizeCssDeclarations(root, replacePrimary);
   if (rule.toString() === before2) return style;
   const serialized = (rule.nodes ?? []).map((node) => node.toString()).join("; ");
   return serialized.endsWith(";") ? serialized : `${serialized};`;
 }
 function normalizeSystemFontPrimaryFamilies(html, deterministicPrimary = "Inter") {
   const { document: document2 } = parseHTML(html);
+  const customProperties = collectFontFamilyCustomProperties(html);
+  const replacePrimary = (value) => systemPrimaryReplacement(value, deterministicPrimary, customProperties);
   let changed = false;
   for (const styleEl of Array.from(document2.querySelectorAll("style"))) {
     const current2 = styleEl.textContent ?? "";
-    const next = normalizeCssFontFamilyDeclarations(current2, deterministicPrimary);
+    const next = normalizeCssFontFamilyDeclarations(current2, replacePrimary);
     if (next === current2) continue;
     styleEl.textContent = next;
     changed = true;
   }
   for (const el of Array.from(document2.querySelectorAll("[style]"))) {
     const current2 = el.getAttribute("style") ?? "";
-    const next = normalizeInlineStyleAttribute(current2, deterministicPrimary);
+    const next = normalizeInlineStyleAttribute(current2, replacePrimary);
     if (next === current2) continue;
     el.setAttribute("style", next);
     changed = true;
   }
   for (const el of Array.from(document2.querySelectorAll("[data-font-family]"))) {
     const current2 = el.getAttribute("data-font-family") ?? "";
-    const next = systemPrimaryReplacement(current2, deterministicPrimary);
+    const next = replacePrimary(current2);
     if (!next) continue;
     el.setAttribute("data-font-family", next);
     changed = true;
@@ -94444,7 +94723,7 @@ function collectFontFamilyCustomProperties(html) {
   }
   return customProperties;
 }
-function primaryCssVariableName(value) {
+function primaryCssVariable(value) {
   const trimmed = value.trim();
   if (!trimmed.toLowerCase().startsWith("var(")) return null;
   let depth = 0;
@@ -94457,21 +94736,35 @@ function primaryCssVariableName(value) {
     if (char !== ")") continue;
     depth -= 1;
     if (depth !== 0) continue;
-    const varExpression = trimmed.slice(0, index + 1);
-    const inner = varExpression.slice(4, -1).trim();
+    const inner = trimmed.slice(4, index).trim();
     const commaIndex = inner.indexOf(",");
-    const variableName = (commaIndex === -1 ? inner : inner.slice(0, commaIndex)).trim();
-    return /^--[A-Za-z0-9_-]+$/.test(variableName) ? variableName : null;
+    const name = (commaIndex === -1 ? inner : inner.slice(0, commaIndex)).trim();
+    if (!/^--[A-Za-z0-9_-]+$/.test(name)) return null;
+    return {
+      name,
+      fallback: commaIndex === -1 ? null : inner.slice(commaIndex + 1),
+      rest: trimmed.slice(index + 1)
+    };
   }
   return null;
 }
-function resolveFontFamilyDeclarationFamilies(declaration, customProperties) {
+var MAX_CSS_VARIABLE_DEPTH = 8;
+function resolveDeclaredFamilies(declaration, customProperties, optional = false, depth = 0) {
+  const tag = (families2) => families2.map((family) => ({ family, optional }));
   const families = parseFontFamilyValue(declaration);
-  const variableName = primaryCssVariableName(declaration);
-  if (!variableName) return families;
-  const resolved = customProperties.get(variableName);
-  if (!resolved) return families;
-  return [...parseFontFamilyValue(resolved), ...families.slice(1)];
+  const variable = depth < MAX_CSS_VARIABLE_DEPTH ? primaryCssVariable(declaration) : null;
+  if (!variable) return tag(families);
+  const resolved = customProperties.get(variable.name);
+  const source = resolved || variable.fallback;
+  if (source === null) return tag(families);
+  const primary = resolveDeclaredFamilies(
+    source,
+    customProperties,
+    !resolved || depth > 0,
+    depth + 1
+  );
+  if (primary.length === 0) return [];
+  return [...primary, ...tag(families.slice(1))];
 }
 function* iterateFontFamilyDeclarations(html) {
   const { document: document2 } = parseHTML(html);
@@ -94596,18 +94889,22 @@ function extractExistingFontFaces(html) {
   }
   return families;
 }
+function isFetchableFamilyName(normalized2) {
+  if (!normalized2 || normalized2.startsWith("var(")) return false;
+  return !GENERIC_FAMILIES2.has(normalized2) && !CSS_WIDE_KEYWORDS.has(normalized2);
+}
 function extractRequestedFontFamilies(html) {
   const requested = /* @__PURE__ */ new Map();
   const customProperties = collectFontFamilyCustomProperties(html);
   for (const { declaration } of iterateFontFamilyDeclarations(html)) {
-    for (const originalCase of resolveFontFamilyDeclarationFamilies(
-      declaration,
-      customProperties
-    )) {
-      const normalized2 = originalCase.toLowerCase();
-      if (!normalized2 || GENERIC_FAMILIES2.has(normalized2)) continue;
-      if (normalized2.startsWith("var(")) continue;
-      if (!requested.has(normalized2)) requested.set(normalized2, originalCase);
+    for (const { family, optional } of resolveDeclaredFamilies(declaration, customProperties)) {
+      const normalized2 = family.toLowerCase();
+      if (!isFetchableFamilyName(normalized2)) continue;
+      const seen = requested.get(normalized2);
+      requested.set(normalized2, {
+        family: seen?.family ?? family,
+        optional: (seen?.optional ?? true) && optional
+      });
     }
   }
   return requested;
@@ -94685,7 +94982,10 @@ function partitionWeightRuns(faces, coveredWeights) {
 async function buildFontFaceCss(requestedFamilies, options, fontText) {
   const rules = [];
   const unresolved = [];
-  for (const [normalizedFamily, originalCaseFamily] of requestedFamilies) {
+  const requiredFirst = [...requestedFamilies].sort(
+    ([, a], [, b]) => Number(a.optional) - Number(b.optional)
+  );
+  for (const [normalizedFamily, { family: originalCaseFamily, optional }] of requiredFirst) {
     const canonicalKey = FONT_ALIASES[normalizedFamily];
     if (canonicalKey) {
       const canonical = CANONICAL_FONTS[canonicalKey];
@@ -94707,7 +95007,7 @@ async function buildFontFaceCss(requestedFamilies, options, fontText) {
         coveredWeights.add(coverageKey(face.weight, style));
       }
       const canonicalFamily = resolveAliasDisplayName(normalizedFamily);
-      const googleFaces2 = canonicalFamily ? await fetchGoogleFont(canonicalFamily, options, fontText) : [];
+      const googleFaces2 = canonicalFamily ? await fetchFamilyFaces(canonicalFamily, optional, options, fontText) : [];
       const supplementary = googleFaces2.filter(
         (face) => !coveredWeights.has(coverageKey(face.weight, face.style)) || !isBundledSubsetRange(face.unicodeRange)
       );
@@ -94733,7 +95033,7 @@ async function buildFontFaceCss(requestedFamilies, options, fontText) {
       rules.push(...bundledRules);
       continue;
     }
-    const googleFaces = await fetchGoogleFont(originalCaseFamily, options, fontText);
+    const googleFaces = await fetchFamilyFaces(originalCaseFamily, optional, options, fontText);
     if (googleFaces.length > 0) {
       for (const face of googleFaces) {
         rules.push(
@@ -94748,7 +95048,7 @@ async function buildFontFaceCss(requestedFamilies, options, fontText) {
       }
       continue;
     }
-    if (options.allowSystemFontCapture) {
+    if (options.allowSystemFontCapture && !pageNamedThisFile(originalCaseFamily, options)) {
       const variants = locateSystemFontVariants(originalCaseFamily);
       if (variants.length > 0) {
         let totalBytes = 0;
@@ -94813,12 +95113,12 @@ function fontCacheDir(slug) {
   const dir = join33(resolveFontCacheRoot(), slug);
   if (!existsSync24(dir)) {
     try {
-      mkdirSync14(dir, { recursive: true });
+      mkdirSync15(dir, { recursive: true });
     } catch {
       const firstFallback = ephemeralFontCacheRoot === void 0;
       ephemeralFontCacheRoot ??= mkdtempSync9(join33(tmpdir6(), "hyperframes-fonts-"));
       const fallback = join33(ephemeralFontCacheRoot, slug);
-      mkdirSync14(fallback, { recursive: true });
+      mkdirSync15(fallback, { recursive: true });
       if (firstFallback) {
         defaultLogger.warn(
           `Font cache directory is unwritable (${dir}). Using temporary fallback \u2014 fonts will re-download each run. Fix with: chmod 755 ${resolveFontCacheRoot()}`
@@ -94998,7 +95298,8 @@ function raceAgainstAbort(promise, signal) {
   });
 }
 function fetchGoogleFontCss(url, familyName, options) {
-  const key2 = `${options.failClosedFontFetch ? "closed" : "open"}:${url}`;
+  const mode = options.failClosedFontFetch ? `closed${options.retryPolicy.maxAttempts}` : "open";
+  const key2 = `${mode}:${url}`;
   let shared = googleFontCssCache.get(key2);
   if (!shared) {
     shared = fetchFontResource(
@@ -95018,35 +95319,66 @@ function fetchGoogleFontCss(url, familyName, options) {
   }
   return raceAgainstAbort(shared, options.abortSignal);
 }
+function pageNamedThisFile(familyName, options) {
+  return options.authoredStylesheets.has(normalizeFamilyName(familyName.replace(/\+/g, " ")));
+}
+function declaredFaceFamily(block) {
+  const found = /font-family:\s*['"]([^'"]+)['"]/i.exec(block);
+  return found?.[1];
+}
 async function fetchGoogleFont(familyName, options, fontText) {
-  const slug = fontSlug(familyName);
   const googleFamilyName = familyName.replace(/\+/g, " ");
   const encodedFamily = encodeURIComponent(googleFamilyName);
   const textParam = fontText ? `&text=${encodeURIComponent(fontText)}` : "";
-  const url = `https://fonts.googleapis.com/css2?family=${encodedFamily}:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,400;1,700${textParam}`;
-  let cssText;
+  const normalizedFamily = normalizeFamilyName(googleFamilyName);
+  const authoredStylesheet = FONT_ALIASES[normalizedFamily] ? void 0 : options.authoredStylesheets.get(normalizedFamily);
+  const urls = authoredStylesheet ? authoredStylesheet.map((url) => withPageText(url, fontText)) : [
+    `https://fonts.googleapis.com/css2?family=${encodedFamily}:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,400;1,700${textParam}`
+  ];
+  const faces = [];
+  for (const url of urls) {
+    faces.push(...await fetchGoogleFontStylesheet(googleFamilyName, url, options));
+  }
+  return faces;
+}
+async function readGoogleFontStylesheet(familyName, url, options) {
   try {
     const cssResult = await fetchGoogleFontCss(url, familyName, options);
     if (!cssResult.ok) {
-      return [];
+      return null;
     }
-    cssText = cssResult.body;
+    return cssResult.body;
   } catch (err) {
     throwIfCallerAborted(options.abortSignal);
     if (err instanceof FontFetchError) throw err;
     if (options.failClosedFontFetch) {
       throw fontFetchError(familyName, url, "Google Fonts CSS", { error: err });
     }
-    return [];
+    return null;
   }
-  const faceRegex = /@font-face\s*\{[^}]*font-style:\s*(normal|italic)[^}]*font-weight:\s*(\d+)[^}]*src:\s*url\(([^)]+)\)\s*format\(['"]woff2['"]\)(?:[^}]*?unicode-range:\s*([^;}]+))?[^}]*\}/gi;
+}
+function parseGoogleFontSource(match, familyName) {
+  const declared = declaredFaceFamily(match[0]);
+  if (declared && normalizeFamilyName(declared) !== normalizeFamilyName(familyName)) return null;
+  const url = match[3];
+  if (!url) return null;
+  return {
+    style: match[1] || "normal",
+    weight: (match[2] || "400").replace(/\s+/g, " "),
+    url,
+    unicodeRange: match[4]?.trim() || void 0
+  };
+}
+async function fetchGoogleFontStylesheet(familyName, url, options) {
+  const slug = fontSlug(familyName);
+  const cssText = await readGoogleFontStylesheet(familyName, url, options);
+  if (!cssText) return [];
+  const faceRegex = /@font-face\s*\{[^}]*font-style:\s*(normal|italic|oblique(?:\s+-?\d+(?:\.\d+)?deg){0,2})\s*;[^}]*font-weight:\s*(\d+(?:\s+\d+)?)[^}]*src:\s*url\(([^)]+)\)\s*format\(['"]woff2['"]\)(?:[^}]*?unicode-range:\s*([^;}]+))?[^}]*\}/gi;
   const faces = [];
   for (const match of cssText.matchAll(faceRegex)) {
-    const style = match[1] || "normal";
-    const weight = match[2] || "400";
-    const woff2Url = match[3] || "";
-    const unicodeRange = match[4]?.trim() || void 0;
-    if (!woff2Url) continue;
+    const source = parseGoogleFontSource(match, familyName);
+    if (!source) continue;
+    const { weight, style, unicodeRange, url: woff2Url } = source;
     const cachePath = cachedWoff2Path(slug, weight, style, subsetToken(woff2Url));
     const dataUri = await ensureWoff2DataUri(
       cachePath,
@@ -95065,6 +95397,23 @@ async function fetchGoogleFont(familyName, options, fontText) {
   }
   return faces;
 }
+async function fetchFamilyFaces(familyName, optional, options, fontText) {
+  if (!optional) return fetchGoogleFont(familyName, options, fontText);
+  const maxAttempts = Math.min(options.retryPolicy.maxAttempts, 2);
+  try {
+    return await fetchGoogleFont(
+      familyName,
+      { ...options, retryPolicy: { ...options.retryPolicy, maxAttempts } },
+      fontText
+    );
+  } catch (err) {
+    if (!(err instanceof FontFetchUnavailableError)) throw err;
+    defaultLogger.warn(
+      `[Compiler] Optional font "${familyName}" is unavailable, rendering its fallback: ${err.message}`
+    );
+    return [];
+  }
+}
 var GOOGLE_FONTS_TEXT_MAX_ENCODED_LENGTH = 1700;
 var SMALL_TO_FULL_KANA = /* @__PURE__ */ new Map([
   ["\u3041", "\u3042"],
@@ -95208,14 +95557,15 @@ async function injectDeterministicFontFaces(html, options = {}) {
     allowSystemFontCapture,
     abortSignal: options.abortSignal,
     retryPolicy,
-    retryDeadlineMs: Date.now() + retryPolicy.maxElapsedMs
+    retryDeadlineMs: Date.now() + retryPolicy.maxElapsedMs,
+    authoredStylesheets: authoredGoogleFontStylesheets(html)
   };
   const existingFaces = extractExistingFontFaces(html);
   const requestedFamilies = extractRequestedFontFamilies(html);
   const pendingFamilies = /* @__PURE__ */ new Map();
-  for (const [normalizedFamily, originalCaseFamily] of requestedFamilies) {
+  for (const [normalizedFamily, requested] of requestedFamilies) {
     if (!existingFaces.has(normalizedFamily)) {
-      pendingFamilies.set(normalizedFamily, originalCaseFamily);
+      pendingFamilies.set(normalizedFamily, requested);
     }
   }
   if (pendingFamilies.size === 0) {
@@ -95226,11 +95576,14 @@ async function injectDeterministicFontFaces(html, options = {}) {
     fetchOptions,
     extractGoogleFontsText(html)
   );
-  if (unresolved.length > 0 && options.failClosedFontFetch) {
+  const required = unresolved.filter(
+    (family) => !pendingFamilies.get(family.toLowerCase())?.optional
+  );
+  if (required.length > 0 && options.failClosedFontFetch) {
     throw new FontFetchError(
-      unresolved.join(", "),
+      required.join(", "),
       "",
-      `[Compiler] Unresolved fonts in fail-closed mode: ${unresolved.join(", ")}. Distributed renders require all fonts to be resolvable.`
+      `[Compiler] Unresolved fonts in fail-closed mode: ${required.join(", ")}. Distributed renders require all fonts to be resolvable.`
     );
   }
   if (!css) {
@@ -95265,13 +95618,13 @@ import { createHash as createHash10 } from "crypto";
 import {
   copyFileSync as copyFileSync4,
   existsSync as existsSync25,
-  mkdirSync as mkdirSync15,
+  mkdirSync as mkdirSync16,
   readFileSync as readFileSync13,
   renameSync as renameSync6,
   rmSync as rmSync12,
-  statSync as statSync10
+  statSync as statSync11
 } from "fs";
-import { dirname as dirname15, isAbsolute as isAbsolute4, join as join34, resolve as resolve11 } from "path";
+import { dirname as dirname15, isAbsolute as isAbsolute5, join as join34, resolve as resolve11 } from "path";
 var PREPARED_GIF_SUBDIR = "_animated_gif";
 var CACHE_SCHEMA = "hfgif-v1";
 function splitUrlSuffix(src) {
@@ -95310,14 +95663,14 @@ function resolveGifSourcePath(src, options) {
   if (isHttpUrl(trimmed)) return null;
   const projectRelative = basePath.startsWith("/") ? basePath.slice(1) : basePath;
   const candidates = [
-    isAbsolute4(basePath) ? basePath : resolve11(options.projectDir, projectRelative),
+    isAbsolute5(basePath) ? basePath : resolve11(options.projectDir, projectRelative),
     resolve11(options.downloadDir, normalizedBase)
   ];
   return candidates.find((candidate) => existsSync25(candidate)) ?? null;
 }
 function isUsableFile(path) {
   try {
-    const stat = statSync10(path);
+    const stat = statSync11(path);
     return stat.isFile() && stat.size > 0;
   } catch {
     return false;
@@ -95425,10 +95778,10 @@ async function runAnimatedGifTranscode(request) {
 }
 async function ensurePreparedWebm(input) {
   if (!existsSync25(dirname15(input.cachePath))) {
-    mkdirSync15(dirname15(input.cachePath), { recursive: true });
+    mkdirSync16(dirname15(input.cachePath), { recursive: true });
   }
   if (!existsSync25(dirname15(input.outputPath))) {
-    mkdirSync15(dirname15(input.outputPath), { recursive: true });
+    mkdirSync16(dirname15(input.outputPath), { recursive: true });
   }
   if (!isUsableFile(input.cachePath)) {
     const tmpPath = `${input.cachePath}.tmp-${process.pid}-${Date.now()}`;
@@ -95858,7 +96211,7 @@ function studioPositionSeekReapplyRuntime() {
 }
 
 // ../core/dist/generated/position-edits-render-inline.js
-var POSITION_EDITS_RENDER_IIFE = '"use strict";(()=>{function T(){return globalThis}function P(e,t){if(typeof window>"u")return;let o=T(),r=o.__hf?.onSwallowed;if(r)try{r({label:e,error:t})}catch(s){}(o.__hfDebug||o.__HYPERFRAMES_DEBUG)&&console.debug(`[hyperframes] ${e} swallowed:`,t)}var x=null;function R(e,t){if(x)try{x({source:"hf-preview",type:"analytics",event:e,properties:t??{}})}catch(o){P("runtime.analytics.site1",o)}}var W="http://www.w3.org/1999/xhtml";function N(e){return e!=null&&e.nodeType===1}function _(e){return N(e)&&(e.namespaceURI===W||e.namespaceURI==="http://www.w3.org/2000/svg")}var w="data-hf-edit-base-x",y="data-hf-edit-base-y",m="data-hf-edit-original-translate",k=e=>{let t=parseFloat(e??"");return Number.isFinite(t)?t:0},O=e=>{let t=[],o=0,r="";for(let s of e.trim())s==="("&&(o+=1),s===")"&&(o=Math.max(0,o-1)),/\\s/.test(s)&&o===0?(r&&t.push(r),r=""):r+=s;return r&&t.push(r),t},L=/^-?(?:\\d+(?:\\.\\d+)?|\\.\\d+)px$/,b=(e,t)=>L.test(e)&&L.test(t)?`${parseFloat(e)+parseFloat(t)}px`:`calc(${e} + ${t})`,V=(e,t,o)=>{if(!e||e==="none")return`${t} ${o}`;let[r,s,a]=O(e);if(r===void 0)return`${t} ${o}`;if(s===void 0)return`${b(r,t)} ${o}`;let i=a===void 0?"":` ${a}`;return`${b(r,t)} ${b(s,o)}${i}`},j=e=>{try{e.ownerDocument.defaultView?.gsap?.getProperty?.(e,"x")}catch{}},G=e=>{let t=e.style.getPropertyValue("translate").trim();if(t)return t==="none"?"":t;try{let o=e.ownerDocument.defaultView,r=o?o.getComputedStyle(e).getPropertyValue("translate").trim():"";return r==="none"?"":r}catch{return""}},E=new WeakMap;function B(e,t){let o=E.get(e);if(!t?.force&&o!==void 0&&e.style.getPropertyValue("translate")!==o){R("position_edit_fold_skipped",{hfId:e.getAttribute("data-hf-id")});return}let r=k(e.getAttribute("data-x"))-k(e.getAttribute(w)),s=k(e.getAttribute("data-y"))-k(e.getAttribute(y));e.hasAttribute(m)||e.setAttribute(m,G(e)),o===void 0&&j(e);let a=e.getAttribute(m)??"",i=V(a,`${r}px`,`${s}px`);e.style.setProperty("translate",i),E.set(e,e.style.getPropertyValue("translate"))}function S(e,t){let o=e.querySelectorAll(`[${m}]:not([${w}]):not([${y}])`);for(let a=0;a<o.length;a++){let i=o[a];if(i===void 0||!_(i))continue;let g=i.getAttribute(m)??"";g===""?i.style.removeProperty("translate"):i.style.setProperty("translate",g),i.removeAttribute(m),E.delete(i)}let r=e.querySelectorAll(`[${w}], [${y}]`),s=0;for(let a=0;a<r.length;a++){let i=r[a];i===void 0||!_(i)||(B(i,t),s+=1)}return s}var $="__hfPositionEditsSeekReapplyWrapped",D=new WeakSet,M=new WeakMap,H=new WeakMap;function F(e){let t=e,o=()=>{try{S(t.document)}catch{}},r=n=>typeof n=="function"&&(D.has(n)||!!n[$]),s=n=>{D.add(n);try{Object.defineProperty(n,$,{value:!0})}catch{}},a=n=>{if(typeof n!="function"||r(n))return n;let l=function(...u){let d=n.apply(this,u);return o(),d};return s(l),l},i=(n,l)=>{let u=M.get(n);if(u?.has(l))return!0;let d=Object.getOwnPropertyDescriptor(n,l);if(d?.configurable===!1){let c=n[l];return typeof c=="function"&&(n[l]=a(c),o()),!1}let p=n[l],f=d?.set;return Object.defineProperty(n,l,{configurable:!0,enumerable:d?.enumerable??!0,get:()=>p,set:c=>{p=a(c),f?.call(n,c)}}),p=a(p),u??(u=new Set),u.add(l),M.set(n,u),o(),!0},g=(n,l)=>{let u=H.get(t),d=Object.getOwnPropertyDescriptor(t,n);if(!u?.has(n)){if(d?.configurable===!1){let c=t[n];return c?i(c,l):!1}let f=t[n];Object.defineProperty(t,n,{configurable:!0,enumerable:d?.enumerable??!0,get:()=>f,set:c=>{f=c,f&&i(f,l)}}),u??(u=new Set),u.add(n),H.set(t,u)}let p=t[n];return p?i(p,l):!1},v=()=>{let n=g("__hf","seek"),l=g("__player","renderSeek");return n&&l};if(v())return;let h=120,A=t.setInterval(()=>{if(v()){t.clearInterval(A);return}h-=1,h<=0&&t.clearInterval(A)},50)}function I(){document.querySelector(`[${w}], [${y}]`)&&(S(document),F(window))}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",I,{once:!0}):I();})();\n';
+var POSITION_EDITS_RENDER_IIFE = '"use strict";(()=>{function T(){return globalThis}function P(e,t){if(typeof window>"u")return;let o=T(),r=o.__hf?.onSwallowed;if(r)try{r({label:e,error:t})}catch(s){}(o.__hfDebug||o.__HYPERFRAMES_DEBUG)&&console.debug(`[hyperframes] ${e} swallowed:`,t)}var x=null;function R(e,t){if(x)try{x({source:"hf-preview",type:"analytics",event:e,properties:t??{}})}catch(o){P("runtime.analytics.site1",o)}}var W="http://www.w3.org/1999/xhtml";function N(e){return e!=null&&e.nodeType===1}function _(e){return N(e)&&(e.namespaceURI===W||e.namespaceURI==="http://www.w3.org/2000/svg")}var w="data-hf-edit-base-x",y="data-hf-edit-base-y",m="data-hf-edit-original-translate",k=e=>{let t=parseFloat(e??"");return Number.isFinite(t)?t:0},O=e=>{let t=[],o=0,r="";for(let s of e.trim())s==="("&&(o+=1),s===")"&&(o=Math.max(0,o-1)),/\\s/.test(s)&&o===0?(r&&t.push(r),r=""):r+=s;return r&&t.push(r),t},L=/^-?(?:\\d+(?:\\.\\d+)?|\\.\\d+)px$/,E=(e,t)=>L.test(e)&&L.test(t)?`${parseFloat(e)+parseFloat(t)}px`:`calc(${e} + ${t})`,V=(e,t,o)=>{if(!e||e==="none")return`${t} ${o}`;let[r,s,a]=O(e);if(r===void 0)return`${t} ${o}`;if(s===void 0)return`${E(r,t)} ${o}`;let i=a===void 0?"":` ${a}`;return`${E(r,t)} ${E(s,o)}${i}`},j=e=>{try{e.ownerDocument.defaultView?.gsap?.getProperty?.(e,"x")}catch{}},G=e=>{let t=e.style.getPropertyValue("translate").trim();if(t)return t==="none"?"":t;try{let o=e.ownerDocument.defaultView,r=o?o.getComputedStyle(e).getPropertyValue("translate").trim():"";return r==="none"?"":r}catch{return""}},b=new WeakMap;function B(e,t){let o=b.get(e);if(!t?.force&&o!==void 0&&e.style.getPropertyValue("translate")!==o){R("position_edit_fold_skipped",{hfId:e.getAttribute("data-hf-id")});return}let r=k(e.getAttribute("data-x"))-k(e.getAttribute(w)),s=k(e.getAttribute("data-y"))-k(e.getAttribute(y));e.hasAttribute(m)||e.setAttribute(m,G(e)),o===void 0&&j(e);let a=e.getAttribute(m)??"",i=V(a,`${r}px`,`${s}px`);e.style.setProperty("translate",i),b.set(e,e.style.getPropertyValue("translate"))}function S(e,t){let o=e.querySelectorAll(`[${m}]:not([${w}]):not([${y}])`);for(let a=0;a<o.length;a++){let i=o[a];if(i===void 0||!_(i))continue;let g=i.getAttribute(m)??"";g===""?i.style.removeProperty("translate"):i.style.setProperty("translate",g),i.removeAttribute(m),b.delete(i)}let r=e.querySelectorAll(`[${w}], [${y}]`),s=0;for(let a=0;a<r.length;a++){let i=r[a];i===void 0||!_(i)||(B(i,t),s+=1)}return s}var $="__hfPositionEditsSeekReapplyWrapped",D=new WeakSet,M=new WeakMap,H=new WeakMap;function F(e){let t=e,o=()=>{try{S(t.document)}catch{}},r=n=>typeof n=="function"&&(D.has(n)||!!n[$]),s=n=>{D.add(n);try{Object.defineProperty(n,$,{value:!0})}catch{}},a=n=>{if(typeof n!="function"||r(n))return n;let l=function(...u){let d=n.apply(this,u);return o(),d};return s(l),l},i=(n,l)=>{let u=M.get(n);if(u?.has(l))return!0;let d=Object.getOwnPropertyDescriptor(n,l);if(d?.configurable===!1){let c=n[l];return typeof c=="function"&&(n[l]=a(c),o()),!1}let p=n[l],f=d?.set;return Object.defineProperty(n,l,{configurable:!0,enumerable:d?.enumerable??!0,get:()=>p,set:c=>{p=a(c),f?.call(n,c)}}),p=a(p),u??(u=new Set),u.add(l),M.set(n,u),o(),!0},g=(n,l)=>{let u=H.get(t),d=Object.getOwnPropertyDescriptor(t,n);if(!u?.has(n)){if(d?.configurable===!1){let c=t[n];return c?i(c,l):!1}let f=t[n];Object.defineProperty(t,n,{configurable:!0,enumerable:d?.enumerable??!0,get:()=>f,set:c=>{f=c,f&&i(f,l)}}),u??(u=new Set),u.add(n),H.set(t,u)}let p=t[n];return p?i(p,l):!1},v=()=>{let n=g("__hf","seek"),l=g("__player","renderSeek");return n&&l};if(v())return;let h=120,A=t.setInterval(()=>{if(v()){t.clearInterval(A);return}h-=1,h<=0&&t.clearInterval(A)},50)}function I(){document.querySelector(`[${w}], [${y}]`)&&(S(document),F(window))}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",I,{once:!0}):I();})();\n';
 function getPositionEditsRenderScript() {
   return POSITION_EDITS_RENDER_IIFE;
 }
@@ -96193,7 +96546,7 @@ function detectShaderTransitionUsage(html) {
 async function resolveMediaDuration2(src, mediaStart, playbackRate, baseDir, downloadDir, tagName19, elementIdentity, log) {
   let filePath = src;
   if (isHttpUrl(src)) {
-    if (!existsSync27(downloadDir)) mkdirSync16(downloadDir, { recursive: true });
+    if (!existsSync27(downloadDir)) mkdirSync17(downloadDir, { recursive: true });
     try {
       filePath = await downloadToTemp(src, downloadDir, void 0, void 0, void 0, {
         onTelemetry: logRemoteDownloadTelemetry
@@ -96780,7 +97133,7 @@ var REMOTE_SOURCE_TAG_RE = /<source\b[^>]*?\bsrc\s*=\s*["'](https?:\/\/[^"']+)["
 var REMOTE_IMG_TAG_RE = /<img\b[^>]*?(?<![\w-])src\s*=\s*["'](https?:\/\/[^"']+)["'][^>]*>/gi;
 async function downloadAndRewriteUrls(urlSet, html, remoteDir, warnLabel, logLabel, extraRewrite) {
   if (urlSet.size === 0) return { html, remoteMediaAssets: /* @__PURE__ */ new Map() };
-  if (!existsSync27(remoteDir)) mkdirSync16(remoteDir, { recursive: true });
+  if (!existsSync27(remoteDir)) mkdirSync17(remoteDir, { recursive: true });
   const urlToLocal = /* @__PURE__ */ new Map();
   await Promise.all(
     [...urlSet].map(async (url) => {
@@ -97092,7 +97445,7 @@ function rewriteUnresolvableGsapToCdn(html, projectDir) {
 }
 function rebaseDirectEntryAssetPaths(html, projectDir, htmlPath) {
   if (!isPathInside3(htmlPath, projectDir)) return html;
-  const entryPath = relative4(projectDir, htmlPath).replace(/\\/g, "/");
+  const entryPath = relative5(projectDir, htmlPath).replace(/\\/g, "/");
   if (!entryPath.includes("/")) return html;
   const { document: document2 } = parseHTML(html);
   const assetExists = (path) => existsSync27(resolve12(projectDir, path));
@@ -97353,8 +97706,8 @@ async function discoverAudioVolumeAutomationFromTimeline(page, audioIds, composi
       const volumeDescriptor = typeof HTMLMediaElement === "undefined" ? void 0 : Object.getOwnPropertyDescriptor(HTMLMediaElement.prototype, "volume");
       const nativeVolumeGet = volumeDescriptor?.get;
       const nativeVolumeSet = volumeDescriptor?.set;
-      const withUnclampedVolume2 = (el, probe2) => {
-        if (!nativeVolumeGet || !nativeVolumeSet) return probe2();
+      const withUnclampedVolume2 = (el, probe) => {
+        if (!nativeVolumeGet || !nativeVolumeSet) return probe();
         let authored = Number(nativeVolumeGet.call(el));
         Object.defineProperty(el, "volume", {
           configurable: true,
@@ -97365,7 +97718,7 @@ async function discoverAudioVolumeAutomationFromTimeline(page, audioIds, composi
           }
         });
         try {
-          return probe2();
+          return probe();
         } finally {
           delete el.volume;
           nativeVolumeSet.call(el, Math.max(0, Math.min(1, authored)));
@@ -99110,7 +99463,7 @@ async function captureSessionFrames(session, { input, rangeStart, rangeEnd, resu
 // ../producer/src/services/render/stages/captureHdrStage.ts
 init_src();
 init_dist2();
-import { existsSync as existsSync31, mkdirSync as mkdirSync17 } from "fs";
+import { existsSync as existsSync31, mkdirSync as mkdirSync18 } from "fs";
 import { join as join44 } from "path";
 
 // ../producer/src/services/hdrImageTransferCache.ts
@@ -99904,7 +100257,7 @@ async function runCaptureHdrStage(input) {
       const debugDumpEnabled = process.env.KEEP_TEMP === "1";
       const debugDumpDir = debugDumpEnabled ? join44(framesDir, "debug-composite") : null;
       if (debugDumpDir && !existsSync31(debugDumpDir)) {
-        mkdirSync17(debugDumpDir, { recursive: true });
+        mkdirSync18(debugDumpDir, { recursive: true });
       }
       const compositeTransfer = resolveCompositeTransfer(hasHdrContent, effectiveHdr);
       const hdrTargetTransfer = compositeTransfer === "srgb" ? void 0 : compositeTransfer;
@@ -100053,7 +100406,17 @@ async function runCaptureHdrStage(input) {
 
 // ../producer/src/services/render/stages/encodeStage.ts
 init_src();
-import { copyFileSync as copyFileSync5, existsSync as existsSync32, mkdirSync as mkdirSync18, readdirSync as readdirSync11, rmSync as rmSync13, statSync as statSync11 } from "fs";
+init_dist2();
+import {
+  copyFileSync as copyFileSync5,
+  existsSync as existsSync32,
+  mkdirSync as mkdirSync19,
+  readdirSync as readdirSync11,
+  readFileSync as readFileSync15,
+  rmSync as rmSync13,
+  statSync as statSync12,
+  writeFileSync as writeFileSync11
+} from "fs";
 import { dirname as dirname18, join as join46 } from "path";
 
 // ../producer/src/services/render/stages/gifEncodeArgs.ts
@@ -100061,15 +100424,23 @@ import { join as join45 } from "path";
 function fpsToFfmpegArg2(fps) {
   return fps.den === 1 ? String(fps.num) : `${fps.num}/${fps.den}`;
 }
+var KEEP_FILTER_GRAPH_WHEN_FRAMES_DROP_ALPHA = ["-reinit_filter", "0"];
+var WRITE_EVERY_FRAME_WHOLE = ["-gifflags", "0"];
+function framesInput(input, fpsArg) {
+  return [
+    "-framerate",
+    fpsArg,
+    ...KEEP_FILTER_GRAPH_WHEN_FRAMES_DROP_ALPHA,
+    "-i",
+    join45(input.framesDir, input.framePattern)
+  ];
+}
 function buildGifPalettegenArgs(input) {
   const fpsArg = fpsToFfmpegArg2(input.fps);
   const transparency = input.preserveAlpha ? ":reserve_transparent=1" : "";
   return [
     "-y",
-    "-framerate",
-    fpsArg,
-    "-i",
-    join45(input.framesDir, input.framePattern),
+    ...framesInput(input, fpsArg),
     "-vf",
     `fps=${fpsArg},palettegen=stats_mode=diff${transparency}`,
     input.palettePath
@@ -100080,16 +100451,14 @@ function buildGifPaletteuseArgs(input) {
   const transparency = input.preserveAlpha ? ":alpha_threshold=128" : "";
   return [
     "-y",
-    "-framerate",
-    fpsArg,
-    "-i",
-    join45(input.framesDir, input.framePattern),
+    ...framesInput(input, fpsArg),
     "-i",
     input.palettePath,
     "-lavfi",
     `fps=${fpsArg} [x]; [x][1:v] paletteuse=dither=sierra2_4a${transparency}`,
     "-loop",
     String(input.loop),
+    ...input.wholeFrames ? WRITE_EVERY_FRAME_WHOLE : [],
     input.outputPath
   ];
 }
@@ -100103,19 +100472,38 @@ function resolveGifLoop(loop) {
   }
   return resolved;
 }
+function gifEncodeFailure(startTime, outputPath, error, failureReason) {
+  return {
+    success: false,
+    outputPath,
+    durationMs: Date.now() - startTime,
+    framesEncoded: 0,
+    fileSize: 0,
+    error,
+    failureReason
+  };
+}
+async function reencodeWithClearedWholeFrames(argsInput, run, startTime) {
+  const { outputPath } = argsInput;
+  const result = await runFfmpeg(buildGifPaletteuseArgs({ ...argsInput, wholeFrames: true }), run);
+  if (!result.success) {
+    const error = formatFfmpegError(result.exitCode, result.stderr);
+    return gifEncodeFailure(startTime, outputPath, error, result.failureReason);
+  }
+  const gif = readFileSync15(outputPath);
+  if (!clearGifFramesBeforeNext(gif)) {
+    const error = "[FFmpeg] GIF output could not be parsed to clear its frames";
+    return gifEncodeFailure(startTime, outputPath, error);
+  }
+  writeFileSync11(outputPath, gif);
+  return null;
+}
 async function encodeGifFromDir(framesDir, framePattern, outputPath, input) {
   const startTime = Date.now();
   const files = readdirSync11(framesDir).filter((file) => file.match(/\.(jpg|jpeg|png)$/i));
   const frameCount = files.length;
   if (frameCount === 0) {
-    return {
-      success: false,
-      outputPath,
-      durationMs: Date.now() - startTime,
-      framesEncoded: 0,
-      fileSize: 0,
-      error: "[FFmpeg] No frame files found in directory"
-    };
+    return gifEncodeFailure(startTime, outputPath, "[FFmpeg] No frame files found in directory");
   }
   const argsInput = {
     framesDir,
@@ -100127,37 +100515,19 @@ async function encodeGifFromDir(framesDir, framePattern, outputPath, input) {
     preserveAlpha: input.preserveAlpha
   };
   try {
-    const paletteResult = await runFfmpeg(buildGifPalettegenArgs(argsInput), {
-      signal: input.signal,
-      timeout: input.timeout
-    });
-    if (!paletteResult.success) {
-      return {
-        success: false,
-        outputPath,
-        durationMs: Date.now() - startTime,
-        framesEncoded: 0,
-        fileSize: 0,
-        error: formatFfmpegError(paletteResult.exitCode, paletteResult.stderr),
-        failureReason: paletteResult.failureReason
-      };
+    const run = { signal: input.signal, timeout: input.timeout };
+    for (const args of [buildGifPalettegenArgs(argsInput), buildGifPaletteuseArgs(argsInput)]) {
+      const result = await runFfmpeg(args, run);
+      if (!result.success) {
+        const error = formatFfmpegError(result.exitCode, result.stderr);
+        return gifEncodeFailure(startTime, outputPath, error, result.failureReason);
+      }
     }
-    const gifResult = await runFfmpeg(buildGifPaletteuseArgs(argsInput), {
-      signal: input.signal,
-      timeout: input.timeout
-    });
-    if (!gifResult.success) {
-      return {
-        success: false,
-        outputPath,
-        durationMs: Date.now() - startTime,
-        framesEncoded: 0,
-        fileSize: 0,
-        error: formatFfmpegError(gifResult.exitCode, gifResult.stderr),
-        failureReason: gifResult.failureReason
-      };
+    if (input.preserveAlpha && gifClearsAfterLeavingFrameInPlace(readFileSync15(outputPath)) !== false) {
+      const failure = await reencodeWithClearedWholeFrames(argsInput, run, startTime);
+      if (failure) return failure;
     }
-    const fileSize = existsSync32(outputPath) ? statSync11(outputPath).size : 0;
+    const fileSize = existsSync32(outputPath) ? statSync12(outputPath).size : 0;
     return {
       success: true,
       outputPath,
@@ -100195,7 +100565,7 @@ async function runEncodeStage(input) {
   const stage5Start = Date.now();
   if (isPngSequence) {
     updateJobStatus(job, "encoding", "Writing PNG sequence", 75, onProgress);
-    if (!existsSync32(outputPath)) mkdirSync18(outputPath, { recursive: true });
+    if (!existsSync32(outputPath)) mkdirSync19(outputPath, { recursive: true });
     const captured = readdirSync11(framesDir).filter((name) => name.endsWith(".png")).sort();
     if (captured.length === 0) {
       throw new Error(
@@ -100800,7 +101170,7 @@ function sampleDirectoryBytes(dir) {
     for (const name of entries2) {
       const full2 = join48(current2, name);
       try {
-        const st = statSync12(full2);
+        const st = statSync13(full2);
         if (st.isDirectory()) {
           stack.push(full2);
         } else if (st.isFile()) {
@@ -100948,7 +101318,7 @@ function findMissingFrameRanges(totalFrames, framesDir, frameExt) {
   let rangeStart = null;
   for (let frameIndex = 0; frameIndex < totalFrames; frameIndex++) {
     const framePath = join48(framesDir, formatCaptureFrameName(frameIndex, frameExt));
-    const missing = !existsSync33(framePath) || statSync12(framePath).size <= 8;
+    const missing = !existsSync33(framePath) || statSync13(framePath).size <= 8;
     if (missing && rangeStart === null) {
       rangeStart = frameIndex;
     } else if (!missing && rangeStart !== null) {
@@ -101592,9 +101962,9 @@ function isRetryableEncoderDeath(err) {
   const match = ENCODER_DEATH_FRAME_RE.exec(err.message);
   return match !== null && Number(match[1]) >= 2;
 }
-async function closeOrphanedProbeForRetry(probe2, closer, log, retryContext) {
+async function closeOrphanedProbeForRetry(probe, closer, log, retryContext) {
   try {
-    await closer(probe2);
+    await closer(probe);
   } catch (closeErr) {
     log.warn(`[Render] probe close before ${retryContext} retry failed; continuing with retry`, {
       error: closeErr instanceof Error ? closeErr.message : String(closeErr)
@@ -101675,7 +102045,7 @@ async function executeRenderJob(job, projectDir, outputPath, progressSink, abort
   const producerRoot = process.env.PRODUCER_RENDERS_DIR ? resolve13(process.env.PRODUCER_RENDERS_DIR, "..") : resolve13(moduleDir, "../..");
   const debugDir = join48(producerRoot, ".debug");
   const outputDir = dirname20(outputPath);
-  if (!existsSync33(outputDir)) mkdirSync19(outputDir, { recursive: true });
+  if (!existsSync33(outputDir)) mkdirSync20(outputDir, { recursive: true });
   const workDir = job.config.debug ? join48(debugDir, job.id) : mkdtempSync11(resolveRenderWorkDirPrefix(outputPath, job.id));
   const pipelineStart = Date.now();
   const baseLog = job.config.logger ?? defaultLogger;
@@ -101807,7 +102177,7 @@ async function executeRenderPipeline(input) {
     job.startedAt = /* @__PURE__ */ new Date();
     assertNotAborted();
     assertConfiguredFfmpegBinariesExist();
-    if (!existsSync33(workDir)) mkdirSync19(workDir, { recursive: true });
+    if (!existsSync33(workDir)) mkdirSync20(workDir, { recursive: true });
     if (job.config.debug) {
       log.info("[Render] Debug artifacts enabled", { workDir, logPath });
     }
@@ -101841,7 +102211,7 @@ async function executeRenderPipeline(input) {
       throw new Error(`Entry file not found: ${htmlPath}`);
     }
     assertNotAborted();
-    const rawEntry = readFileSync15(htmlPath, "utf-8");
+    const rawEntry = readFileSync16(htmlPath, "utf-8");
     if (entryFile !== "index.html" && rawEntry.trimStart().startsWith("<template")) {
       const wrapperPath = join48(workDir, "standalone-entry.html");
       const projectIndexPath = join48(projectDir, "index.html");
@@ -101851,7 +102221,7 @@ async function executeRenderPipeline(input) {
         );
       }
       const standaloneHtml = extractStandaloneEntryFromIndex(
-        readFileSync15(projectIndexPath, "utf-8"),
+        readFileSync16(projectIndexPath, "utf-8"),
         entryFile,
         rawEntry
       );
@@ -101860,7 +102230,7 @@ async function executeRenderPipeline(input) {
           `Entry file "${entryFile}" is not mounted from index.html via data-composition-src, so it cannot be rendered independently.`
         );
       }
-      writeFileSync11(wrapperPath, standaloneHtml, "utf-8");
+      writeFileSync12(wrapperPath, standaloneHtml, "utf-8");
       htmlPath = wrapperPath;
       log.info("Extracted standalone entry from index.html host context", {
         entryFile
@@ -102145,7 +102515,7 @@ async function executeRenderPipeline(input) {
       throw new Error("File server failed to initialize before frame capture");
     }
     const framesDir = join48(workDir, "captured-frames");
-    if (!existsSync33(framesDir)) mkdirSync19(framesDir, { recursive: true });
+    if (!existsSync33(framesDir)) mkdirSync20(framesDir, { recursive: true });
     updateJobStatus(job, "rendering", "Checking browser GPU", 25, onProgress);
     const resolvedBrowserGpuMode = await resolveBrowserGpuMode(cfg.browserGpuMode, {
       chromePath: resolveHeadlessShellPath(cfg),
@@ -103136,7 +103506,7 @@ async function executeRenderPipeline(input) {
             "drawElement capture failed; retrying with a fresh screenshot session"
           );
           rmSync15(framesDir, { recursive: true, force: true });
-          mkdirSync19(framesDir, { recursive: true });
+          mkdirSync20(framesDir, { recursive: true });
           resetCaptureAttemptProgress(job);
           dedupPerfs.length = 0;
           cfg.useDrawElement = false;
@@ -103334,7 +103704,7 @@ async function executeRenderPipeline(input) {
     job.perfSummary = perfSummary;
     if (job.config.debug) {
       try {
-        writeFileSync11(perfOutputPath, JSON.stringify(perfSummary, null, 2), "utf-8");
+        writeFileSync12(perfOutputPath, JSON.stringify(perfSummary, null, 2), "utf-8");
       } catch (err) {
         log.debug("Failed to write perf summary", {
           perfOutputPath,
@@ -103684,10 +104054,10 @@ init_src();
 // ../producer/src/server.ts
 import {
   existsSync as existsSync36,
-  mkdirSync as mkdirSync20,
-  statSync as statSync14,
+  mkdirSync as mkdirSync21,
+  statSync as statSync15,
   mkdtempSync as mkdtempSync12,
-  writeFileSync as writeFileSync12,
+  writeFileSync as writeFileSync13,
   rmSync as rmSync16,
   createReadStream as createReadStream5
 } from "fs";
@@ -103703,14 +104073,14 @@ import { serve as serve3 } from "@hono/node-server";
 init_dist3();
 import {
   existsSync as existsSync34,
-  readFileSync as readFileSync16,
-  statSync as statSync13,
+  readFileSync as readFileSync17,
+  statSync as statSync14,
   openSync as openSync8,
   fstatSync as fstatSync5,
   closeSync as closeSync9,
   constants as constants5
 } from "fs";
-import { resolve as resolve14, join as join49, relative as relative5, isAbsolute as isAbsolute5, sep as sep4 } from "path";
+import { resolve as resolve14, join as join49, relative as relative6, isAbsolute as isAbsolute6, sep as sep4 } from "path";
 function isStringRecord(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return false;
@@ -103743,19 +104113,19 @@ function readEntryHtml(filePath) {
   } catch (error) {
     if (error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR"))
       return null;
-    if (!statSync13(filePath, { throwIfNoEntry: false })?.isFile()) return null;
+    if (!statSync14(filePath, { throwIfNoEntry: false })?.isFile()) return null;
     throw error;
   }
   try {
     if (!fstatSync5(fd).isFile()) return null;
-    return readFileSync16(fd, "utf-8");
+    return readFileSync17(fd, "utf-8");
   } finally {
     closeSync9(fd);
   }
 }
 function readProjectEntryFile(projectDir, preferredEntryFile) {
   const absProjectDir = resolve14(projectDir);
-  if (!existsSync34(absProjectDir) || !statSync13(absProjectDir).isDirectory()) {
+  if (!existsSync34(absProjectDir) || !statSync14(absProjectDir).isDirectory()) {
     return { error: `Project directory not found: ${absProjectDir}` };
   }
   const entryCandidates = [preferredEntryFile, "index.html", "src/index.html"].filter(
@@ -103763,8 +104133,8 @@ function readProjectEntryFile(projectDir, preferredEntryFile) {
   );
   for (const entryFile of entryCandidates) {
     const absoluteEntryPath = resolve14(absProjectDir, entryFile);
-    const entryRelativePath = relative5(absProjectDir, absoluteEntryPath);
-    if (entryRelativePath === ".." || entryRelativePath.startsWith(`..${sep4}`) || isAbsolute5(entryRelativePath)) {
+    const entryRelativePath = relative6(absProjectDir, absoluteEntryPath);
+    if (entryRelativePath === ".." || entryRelativePath.startsWith(`..${sep4}`) || isAbsolute6(entryRelativePath)) {
       return { error: `Entry file must stay inside project directory: ${entryFile}` };
     }
     const html = readEntryHtml(absoluteEntryPath);
@@ -104034,7 +104404,7 @@ function resolvePreparedRenderOutput(prepared, rendersDir, log) {
   const { input, cleanupProjectDir } = prepared;
   const absoluteOutputPath = resolveOutputPath(input.projectDir, input.outputPath, rendersDir, log);
   const outputDir = dirname22(absoluteOutputPath);
-  if (!existsSync36(outputDir)) mkdirSync20(outputDir, { recursive: true });
+  if (!existsSync36(outputDir)) mkdirSync21(outputDir, { recursive: true });
   return { input, cleanupProjectDir, absoluteOutputPath };
 }
 function validateRenderOverrides(body) {
@@ -104072,7 +104442,7 @@ function prepareProjectDirectory(projectDir, options) {
   const candidate = nonEmptyString2(projectDir);
   if (!candidate) return null;
   const absProjectDir = resolve15(candidate);
-  if (!existsSync36(absProjectDir) || !statSync14(absProjectDir).isDirectory()) {
+  if (!existsSync36(absProjectDir) || !statSync15(absProjectDir).isDirectory()) {
     return { error: `Project directory not found: ${absProjectDir}` };
   }
   const entry = options.entryFile || "index.html";
@@ -104102,7 +104472,7 @@ async function resolveInlineRenderHtml(body) {
 function materializeInlineProject(html, options) {
   const tempRoot = process.env.PRODUCER_TMP_PROJECT_DIR || tmpdir8();
   const tempProjectDir = mkdtempSync12(join51(tempRoot, "producer-project-"));
-  writeFileSync12(join51(tempProjectDir, "index.html"), html, "utf-8");
+  writeFileSync13(join51(tempProjectDir, "index.html"), html, "utf-8");
   return {
     prepared: {
       input: { projectDir: tempProjectDir, ...options },
@@ -104168,7 +104538,7 @@ function cleanupTempDir(dir, log) {
   }
 }
 function outputFileSize(path) {
-  return existsSync36(path) ? statSync14(path).size : 0;
+  return existsSync36(path) ? statSync15(path).size : 0;
 }
 function createBlockingProgressReporter(log, requestId) {
   let lastLoggedPct = -10;
@@ -104468,7 +104838,7 @@ function createRenderHandlers(options = {}) {
       store.delete(token);
       return c.json({ success: false, error: "Output artifact file missing" }, 404);
     }
-    const stats = statSync14(artifact.path);
+    const stats = statSync15(artifact.path);
     return new Response(createReadStream5(artifact.path), {
       headers: {
         "content-type": "video/mp4",
@@ -104552,12 +104922,12 @@ init_src();
 // ../producer/src/services/distributed/plan.ts
 init_dist2();
 init_src();
-import { cpSync as cpSync2, existsSync as existsSync39, mkdirSync as mkdirSync22, renameSync as renameSync8, rmSync as rmSync17, writeFileSync as writeFileSync14 } from "fs";
-import { join as join55, relative as relative8, sep as sep5 } from "path";
+import { cpSync as cpSync2, existsSync as existsSync39, mkdirSync as mkdirSync23, renameSync as renameSync8, rmSync as rmSync17, writeFileSync as writeFileSync15 } from "fs";
+import { join as join55, relative as relative9, sep as sep5 } from "path";
 
 // ../producer/src/services/render/stages/freezePlan.ts
-import { existsSync as existsSync37, mkdirSync as mkdirSync21, readFileSync as readFileSync17, readdirSync as readdirSync13, writeFileSync as writeFileSync13 } from "fs";
-import { join as join52, relative as relative6, resolve as resolve16 } from "path";
+import { existsSync as existsSync37, mkdirSync as mkdirSync22, readFileSync as readFileSync18, readdirSync as readdirSync13, writeFileSync as writeFileSync14 } from "fs";
+import { join as join52, relative as relative7, resolve as resolve16 } from "path";
 
 // ../producer/src/services/distributed/planProtocol.ts
 var PLAN_SCHEMA_VERSION = 1;
@@ -104600,7 +104970,7 @@ var FIELD_DELIMITER = Buffer.from([0]);
 init_src();
 import { execFile as execFileCallback } from "child_process";
 import { dirname as dirname23, join as join53 } from "path";
-import { existsSync as existsSync38, readFileSync as readFileSync18 } from "fs";
+import { existsSync as existsSync38, readFileSync as readFileSync19 } from "fs";
 import { fileURLToPath as fileURLToPath8 } from "url";
 import { promisify as promisify5 } from "util";
 var PLAN_AUDIO_RELATIVE_PATH = MIXED_AUDIO_FILENAME;
@@ -104609,7 +104979,7 @@ var execFile4 = promisify5(execFileCallback);
 // ../producer/src/services/distributed/planSize.ts
 import { createHash as createHash13 } from "crypto";
 import { lstatSync as lstatSync5, readdirSync as readdirSync14 } from "fs";
-import { extname as extname7, join as join54, relative as relative7 } from "path";
+import { extname as extname7, join as join54, relative as relative8 } from "path";
 var PLAN_ROOT_CATEGORY = {
   compiled: "compiled",
   [PLAN_AUDIO_RELATIVE_PATH]: "audio",
@@ -104633,32 +105003,32 @@ import {
   copyFileSync as copyFileSync8,
   existsSync as existsSync41,
   lstatSync as lstatSync6,
-  mkdirSync as mkdirSync24,
+  mkdirSync as mkdirSync25,
   mkdtempSync as mkdtempSync14,
   openSync as openSync9,
-  readFileSync as readFileSync19,
+  readFileSync as readFileSync20,
   readSync as readSync3,
   readdirSync as readdirSync15,
   renameSync as renameSync10,
   rmSync as rmSync19,
-  statSync as statSync16,
-  writeFileSync as writeFileSync16
+  statSync as statSync17,
+  writeFileSync as writeFileSync17
 } from "fs";
 import { createHash as createHash14 } from "crypto";
 import { tmpdir as tmpdir9 } from "os";
-import { dirname as dirname25, isAbsolute as isAbsolute6, join as join58, relative as relative9, resolve as resolve17, sep as sep6 } from "path";
+import { dirname as dirname25, isAbsolute as isAbsolute7, join as join58, relative as relative10, resolve as resolve17, sep as sep6 } from "path";
 
 // ../producer/src/services/distributed/planV2Publisher.ts
 import {
   copyFileSync as copyFileSync7,
   existsSync as existsSync40,
   linkSync as linkSync3,
-  mkdirSync as mkdirSync23,
+  mkdirSync as mkdirSync24,
   mkdtempSync as mkdtempSync13,
   renameSync as renameSync9,
   rmSync as rmSync18,
-  statSync as statSync15,
-  writeFileSync as writeFileSync15
+  statSync as statSync16,
+  writeFileSync as writeFileSync16
 } from "fs";
 import { dirname as dirname24, join as join57 } from "path";
 
@@ -104676,27 +105046,27 @@ init_dist2();
 import {
   cpSync as cpSync3,
   existsSync as existsSync42,
-  mkdirSync as mkdirSync25,
+  mkdirSync as mkdirSync26,
   mkdtempSync as mkdtempSync15,
-  readFileSync as readFileSync20,
+  readFileSync as readFileSync21,
   readdirSync as readdirSync16,
   rmSync as rmSync20,
-  statSync as statSync17,
-  writeFileSync as writeFileSync17
+  statSync as statSync18,
+  writeFileSync as writeFileSync18
 } from "fs";
 import { dirname as dirname26, join as join59 } from "path";
 
 // ../producer/src/services/distributed/renderChunk.ts
 init_src();
 import { randomBytes } from "crypto";
-import { existsSync as existsSync43, mkdirSync as mkdirSync26, readFileSync as readFileSync21, readdirSync as readdirSync17, rmSync as rmSync21, writeFileSync as writeFileSync18 } from "fs";
+import { existsSync as existsSync43, mkdirSync as mkdirSync27, readFileSync as readFileSync22, readdirSync as readdirSync17, rmSync as rmSync21, writeFileSync as writeFileSync19 } from "fs";
 import { extname as extname8, join as join60 } from "path";
 init_src();
 
 // ../producer/src/services/distributed/projectHash.ts
-import { readdirSync as readdirSync18, readFileSync as readFileSync22 } from "fs";
+import { readdirSync as readdirSync18, readFileSync as readFileSync23 } from "fs";
 import { createHash as createHash15 } from "crypto";
-import { join as join62, relative as relative10 } from "path";
+import { join as join62, relative as relative11 } from "path";
 
 // src/fontLocalize.ts
 function safeVersion(version2) {
@@ -104737,8 +105107,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.81" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.81" : "0.0.0-dev";
+var VERSION = true ? "0.8.83" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.83" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {