hyperframes 0.8.36 → 0.8.38

package/dist/docs/examples.md

@@ -4,7 +4,7 @@ Built-in templates available via `npx hyperframes init --example <name>`.
 
 ## blank
 
-Empty 1920x1080 composition with GSAP timeline wired up. Start from scratch.
+Centered Inter stage, paused GSAP timeline. Default `hyperframes init` scaffold.
 
 ## title-card
 

package/dist/fontLocalizeCli.js

@@ -55006,7 +55006,6 @@ async function syncVideoFrameVisibility(page, activeVideoIds) {
             img.style.visibility = "visible";
           }
         } else {
-          video.style.removeProperty("display");
           video.style.setProperty("visibility", "hidden", "important");
           video.style.setProperty("pointer-events", "none", "important");
           if (hasImg) {
@@ -69964,10 +69963,6 @@ function targetHasNoStableIdentity(selector, identity) {
   if (identity) return false;
   return selector === UNRESOLVED_TARGET || selector === "dwell/hold" || selector.startsWith("proxy \u2192 ");
 }
-function readRegisteredTimelineCompositionId(script) {
-  const match = script.match(WINDOW_TIMELINE_ASSIGN_PATTERN);
-  return match?.[1] || match?.[2] || null;
-}
 function unwrapRaw(value) {
   if (typeof value === "number") return value;
   if (typeof value !== "string") return void 0;
@@ -70134,21 +70129,6 @@ function makesOverlayVisible(win) {
   if (win.method === "from" && isHiddenGsapState(win.propertyValues)) return true;
   return isVisibleGsapState(win.propertyValues);
 }
-function isSceneBoundaryExit(win) {
-  if (win.end <= win.position) return false;
-  if (win.method !== "to" && win.method !== "fromTo") return false;
-  return isHiddenGsapState(win.propertyValues);
-}
-function isHardKillSet(win, selector, boundary) {
-  return win.method === "set" && win.targetSelector === selector && Math.abs(win.position - boundary) <= SCENE_BOUNDARY_EPSILON_SECONDS && isHiddenGsapState(win.propertyValues);
-}
-function hiddenStateLiteral(values) {
-  if (zeroValue(values.autoAlpha)) return "{ autoAlpha: 0 }";
-  if (zeroValue(values.opacity)) return "{ opacity: 0 }";
-  if (stringValue(values.visibility)?.toLowerCase() === "hidden") return '{ visibility: "hidden" }';
-  if (stringValue(values.display)?.toLowerCase() === "none") return '{ display: "none" }';
-  return "{ opacity: 0 }";
-}
 function findTagEnd2(source, tag) {
   const escapedTagName = tag.name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const pattern = new RegExp(`<\\/?${escapedTagName}\\b[^>]*>`, "gi");
@@ -70165,56 +70145,11 @@ function findTagEnd2(source, tag) {
   }
   return source.length;
 }
-function collectCompositionRanges(source, tags) {
-  return tags.map((tag) => {
-    const id = readDecodedAttr(tag.raw, "data-composition-id");
-    if (!id) return null;
-    return {
-      id,
-      start: tag.index,
-      end: findTagEnd2(source, tag)
-    };
-  }).filter((range) => range !== null);
-}
-function findContainingCompositionId(tag, ranges) {
-  let match = null;
-  for (const range of ranges) {
-    if (tag.index < range.start || tag.index >= range.end) continue;
-    if (!match || range.start >= match.start) match = range;
-  }
-  return match?.id || null;
-}
 function getClipTagClasses(tag) {
   const classAttr = readAttr(tag.raw, "class") || "";
   const classes = classAttr.split(/\s+/).filter(Boolean);
   return classes.includes("clip") ? { classAttr, classes } : null;
 }
-function collectClipStartBoundariesByComposition(source, tags) {
-  const ranges = collectCompositionRanges(source, tags);
-  const boundaries = /* @__PURE__ */ new Map();
-  for (const tag of tags) {
-    if (!getClipTagClasses(tag)) continue;
-    const compositionId = findContainingCompositionId(tag, ranges);
-    if (!compositionId) continue;
-    const start = numberValue(readAttr(tag.raw, "data-start") ?? void 0);
-    if (start == null || start <= 0) continue;
-    const compositionBoundaries = boundaries.get(compositionId) ?? /* @__PURE__ */ new Set();
-    compositionBoundaries.add(start);
-    boundaries.set(compositionId, compositionBoundaries);
-  }
-  return new Map(
-    [...boundaries.entries()].map(([compositionId, values]) => [
-      compositionId,
-      [...values].sort((a, b) => a - b)
-    ])
-  );
-}
-function findMatchingSceneBoundary(time, boundaries) {
-  for (const boundary of boundaries) {
-    if (Math.abs(time - boundary) <= SCENE_BOUNDARY_EPSILON_SECONDS) return boundary;
-  }
-  return null;
-}
 function readStyleProperty(style, property) {
   const escapedProperty = property.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const match = style.match(new RegExp(`(?:^|;)\\s*${escapedProperty}\\s*:\\s*([^;]+)`, "i"));
@@ -72549,7 +72484,7 @@ ${allInlineStyles}`.replace(/\/\*[\s\S]*?\*\//g, "");
       },
       // overlapping_gsap_tweens + gsap_animates_clip_element
       // fallow-ignore-next-line complexity
-      async ({ source, tags, scripts, styles, rootCompositionId }) => {
+      async ({ tags, scripts, styles }) => {
         const findings = [];
         const authoredHiddenSelectors = new Set(
           scripts.flatMap((script) => [...extractStandaloneHiddenSelectors(script.content)])
@@ -72570,13 +72505,10 @@ ${allInlineStyles}`.replace(/\/\*[\s\S]*?\*\//g, "");
             if (cls !== "clip") clipClasses.set(`.${cls}`, info);
           }
         }
-        const clipStartBoundariesByComposition = collectClipStartBoundariesByComposition(source, tags);
         const styleRules = collectSimpleStyleRules(styles);
         const reportedVisibleOverlayKeys = /* @__PURE__ */ new Set();
         for (const script of scripts) {
-          const localTimelineCompId = readRegisteredTimelineCompositionId(script.content);
           const gsapWindows = await cachedExtractGsapWindows(script.content);
-          const clipStartBoundaries = clipStartBoundariesByComposition.get(localTimelineCompId || rootCompositionId || "") ?? [];
           for (let i = 0; i < gsapWindows.length; i++) {
             const left = gsapWindows[i];
             if (!left) continue;
@@ -72638,28 +72570,6 @@ ${right.raw}`)
               snippet: truncateSnippet(fromToWindows.map((win) => win.raw).join("\n"))
             });
           }
-          if (clipStartBoundaries.length > 0) {
-            for (const win of gsapWindows) {
-              if (win.targetSelector === UNRESOLVED_TARGET) continue;
-              if (!isSceneBoundaryExit(win)) continue;
-              const boundary = findMatchingSceneBoundary(win.end, clipStartBoundaries);
-              if (boundary == null) continue;
-              const hasHardKill = gsapWindows.some(
-                (candidate) => isHardKillSet(candidate, win.targetSelector, boundary)
-              );
-              if (hasHardKill) continue;
-              const exitClipInfo = clipIds.get(win.targetSelector) || clipClasses.get(win.targetSelector);
-              const fixHint = exitClipInfo ? `"${win.targetSelector}" is a clip element \u2014 the framework already manages its visibility. Wrap the scene's content in an inner non-clip <div>, move the exit tween and the hard kill (\`tl.set("<inner-selector>", ${hiddenStateLiteral(win.propertyValues)}, ${boundary.toFixed(2)})\`) onto that wrapper instead.` : `Add \`tl.set("${win.targetSelector}", ${hiddenStateLiteral(win.propertyValues)}, ${boundary.toFixed(2)})\` after the exit tween.`;
-              findings.push({
-                code: "gsap_exit_missing_hard_kill",
-                severity: "error",
-                message: `GSAP exit on "${win.targetSelector}" ends at the ${boundary.toFixed(2)}s clip start boundary without a matching tl.set hard kill. Non-linear seeking can land after the fade and leave stale visibility state.`,
-                selector: win.targetSelector,
-                fixHint,
-                snippet: truncateSnippet(win.raw)
-              });
-            }
-          }
           for (const tag of tags) {
             const selectors = tagSimpleSelectors(tag);
             if (selectors.length === 0) continue;
@@ -74471,6 +74381,7 @@ function declarerVariableRules(document2, layerFor) {
   }
   return rules;
 }
+var MAX_INLINE_ASSET_BYTES;
 var init_htmlBundler = __esm({
   "../core/dist/compiler/htmlBundler.js"() {
     "use strict";
@@ -74491,6 +74402,7 @@ var init_htmlBundler = __esm({
     init_cssSelector();
     init_safePath();
     init_colorGrading();
+    MAX_INLINE_ASSET_BYTES = 2 * 1024 * 1024;
   }
 });
 
@@ -86803,6 +86715,17 @@ var ArtifactTransaction = class {
 };
 
 // ../producer/src/services/render/capturePlan.ts
+function drawElementVerificationFailure(plan2, hasDiskFallbackHeadroom) {
+  const { routing } = plan2;
+  const needsHeadroom = routing.kind !== "default" && routing.fallback.kind === "sdr_disk" && routing.memoryExhaustionFallback.kind === "sdr_streaming";
+  return {
+    kind: "draw_element_verification",
+    diskFallbackAvailable: needsHeadroom ? hasDiskFallbackHeadroom() : void 0
+  };
+}
+function streamingCaptureFailure(plan2, classification, hasDiskFallbackHeadroom) {
+  return classification.isVerifyError ? drawElementVerificationFailure(plan2, hasDiskFallbackHeadroom) : { kind: "capture_failure", memoryExhaustion: classification.isMemoryExhaustion };
+}
 function assertWorkerCount(workerCount) {
   if (!Number.isInteger(workerCount) || workerCount < 1) {
     throw new Error(`CapturePlan workerCount must be a positive integer; got ${workerCount}`);
@@ -86873,11 +86796,12 @@ function replanAfterFailure(plan2, failure) {
     });
   }
   const isMemoryExhaustion = failure.kind === "capture_failure" && failure.memoryExhaustion;
+  const diskFallbackUnavailable = failure.kind === "draw_element_verification" && failure.diskFallbackAvailable === false;
   const fallback = plan2.routing.kind === "default" ? {
     kind: plan2.kind,
     workerCount: isMemoryExhaustion ? 1 : plan2.workerCount,
     forceParallelStream: false
-  } : isMemoryExhaustion ? plan2.routing.memoryExhaustionFallback : plan2.routing.fallback;
+  } : isMemoryExhaustion || diskFallbackUnavailable ? plan2.routing.memoryExhaustionFallback : plan2.routing.fallback;
   return createCapturePlan({
     ...plan2,
     workerCount: fallback.workerCount,
@@ -92793,7 +92717,7 @@ function estimateDiskCaptureBytes(totalFrames, captureOptions) {
   const outputHeight = Math.ceil(captureOptions.height * scale);
   return Math.ceil(totalFrames) * outputWidth * outputHeight * 4;
 }
-function assertDiskCaptureHeadroom(framesDir, totalFrames, captureOptions, freeDiskBytes = (path) => {
+function inspectDiskCaptureHeadroom(framesDir, totalFrames, captureOptions, freeDiskBytes = (path) => {
   try {
     const stat = statfsSync(path);
     return stat.bavail * stat.bsize;
@@ -92802,11 +92726,22 @@ function assertDiskCaptureHeadroom(framesDir, totalFrames, captureOptions, freeD
   }
 }) {
   const freeBytes = freeDiskBytes(framesDir);
-  if (freeBytes === null) return;
   const estimatedBytes = estimateDiskCaptureBytes(totalFrames, captureOptions);
-  if (estimatedBytes <= freeBytes * 0.9) return;
+  if (freeBytes === null || estimatedBytes <= freeBytes * 0.9) {
+    return { available: true, estimatedBytes, freeBytes };
+  }
+  return { available: false, estimatedBytes, freeBytes };
+}
+function assertDiskCaptureHeadroom(framesDir, totalFrames, captureOptions, freeDiskBytes) {
+  const headroom = inspectDiskCaptureHeadroom(
+    framesDir,
+    totalFrames,
+    captureOptions,
+    freeDiskBytes
+  );
+  if (headroom.available) return;
   throw new Error(
-    `Disk capture may need ~${(estimatedBytes / 1e6).toFixed(1)} MB of temporary frame storage, but only ${(freeBytes / 1e6).toFixed(1)} MB is free at ${framesDir}. Re-run with --low-memory-mode to stream frames, raise PRODUCER_STREAMING_ENCODE_MAX_DURATION_SECONDS if streaming is supported, or free up disk space.`
+    `Disk capture may need ~${(headroom.estimatedBytes / 1e6).toFixed(1)} MB of temporary frame storage, but only ${(headroom.freeBytes / 1e6).toFixed(1)} MB is free at ${framesDir}. Re-run with --low-memory-mode to stream frames, raise PRODUCER_STREAMING_ENCODE_MAX_DURATION_SECONDS if streaming is supported, or free up disk space.`
   );
 }
 async function runCaptureStage(input) {
@@ -95780,6 +95715,7 @@ import { mkdtempSync as mkdtempSync10, renameSync as renameSync6, rmSync as rmSy
 import { dirname as dirname17, join as join42 } from "path";
 var AUDIO_DURATION_TOLERANCE_SECONDS = 1e-3;
 var AAC_DELIVERY_TRUE_PEAK_DBFS = -1;
+var AAC_TRUE_PEAK_CORRECTION_HEADROOM_DB = 0.5;
 var MAX_TRUE_PEAK_CORRECTION_PASSES = 3;
 function buildAacTruePeakCorrectionArgs(inputPath, outputPath, targetDurationSeconds, attenuationDb) {
   return [
@@ -95979,10 +95915,15 @@ async function enforceAacTruePeak(input) {
   try {
     scratchDir = mkdtempSync10(join42(dirname17(input.audioPath), ".true-peak-"));
     const correctedPath = join42(scratchDir, "audio.m4a");
+    const correctionTargetDbfs = AAC_DELIVERY_TRUE_PEAK_DBFS - AAC_TRUE_PEAK_CORRECTION_HEADROOM_DB;
+    const measurements = [];
     let attenuationDb = 0;
     let measuredPath = input.audioPath;
     for (let pass = 0; pass <= MAX_TRUE_PEAK_CORRECTION_PASSES; pass += 1) {
       const truePeakDbfs = await input.probeTruePeak(measuredPath, input.signal);
+      measurements.push(
+        `pass ${pass}: ${truePeakDbfs.toFixed(3)} dBFS at ${attenuationDb.toFixed(3)} dB attenuation`
+      );
       if (Number.isNaN(truePeakDbfs) || truePeakDbfs === Number.POSITIVE_INFINITY) {
         return { success: false, error: "audioPadTrim: FFmpeg reported an invalid true peak" };
       }
@@ -95991,7 +95932,7 @@ async function enforceAacTruePeak(input) {
         return { success: true };
       }
       if (pass === MAX_TRUE_PEAK_CORRECTION_PASSES) break;
-      attenuationDb += AAC_DELIVERY_TRUE_PEAK_DBFS - truePeakDbfs;
+      attenuationDb += correctionTargetDbfs - truePeakDbfs;
       const result = await input.runner(
         buildAacTruePeakCorrectionArgs(
           input.audioPath,
@@ -96014,7 +95955,7 @@ async function enforceAacTruePeak(input) {
     }
     return {
       success: false,
-      error: `audioPadTrim: AAC true peak remained above ${AAC_DELIVERY_TRUE_PEAK_DBFS} dBFS after ${MAX_TRUE_PEAK_CORRECTION_PASSES} correction passes`
+      error: `audioPadTrim: AAC true peak remained above ${AAC_DELIVERY_TRUE_PEAK_DBFS} dBFS after ${MAX_TRUE_PEAK_CORRECTION_PASSES} correction passes; ${measurements.join("; ")}`
     };
   } catch (err) {
     return {
@@ -97923,10 +97864,12 @@ async function executeRenderPipeline(input) {
             isVerifyError ? "drawElement self-verify failed; retrying with forceScreenshot" : isDeStall ? "drawElement renderer stalled; retrying with forceScreenshot" : isSequentialStall ? "sequential capture stalled; retrying with a fresh screenshot session" : "capture failed; retrying with a fresh screenshot session"
           );
           const failedRouting = capturePlan.routing.kind;
-          capturePlan = replanAfterFailure(
+          const failure = streamingCaptureFailure(
             capturePlan,
-            isVerifyError ? { kind: "draw_element_verification" } : { kind: "capture_failure", memoryExhaustion: isMemoryExhaustion }
+            { isVerifyError, isMemoryExhaustion },
+            () => inspectDiskCaptureHeadroom(framesDir, totalFrames, buildCaptureOptions()).available
           );
+          capturePlan = replanAfterFailure(capturePlan, failure);
           syncCapturePlan();
           updateCaptureObservability({
             forceScreenshot: capturePlan.forceScreenshot,
@@ -97946,13 +97889,11 @@ async function executeRenderPipeline(input) {
             probeSession = null;
             await closeOrphanedProbeForRetry(orphaned, closeCaptureSession, log, "streaming");
           }
-          if (failedRouting === "worker_inversion") {
-            log.info(
-              `[Render] Reverting worker inversion for the retry: ${capturePlan.workerCount} workers, plan=${capturePlan.kind}.`
-            );
-          } else if (failedRouting === "parallel_router") {
+          if (failedRouting !== "default") {
+            const route = failedRouting === "worker_inversion" ? "worker inversion" : "parallel router";
+            const diskFallbackLacksHeadroom = failure.kind === "draw_element_verification" && failure.diskFallbackAvailable === false;
             log.info(
-              `[Render] Reverting parallel router for the retry: ${capturePlan.workerCount} workers, plan=${capturePlan.kind}.`
+              diskFallbackLacksHeadroom ? `[Render] ${route} disk fallback lacks headroom; retrying with ${capturePlan.workerCount}-worker screenshot streaming.` : `[Render] Reverting ${route} for the retry: ${capturePlan.workerCount} workers, plan=${capturePlan.kind}.`
             );
           }
           if (capturePlan.kind === "sdr_streaming") {
@@ -99626,8 +99567,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.36" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.36" : "0.0.0-dev";
+var VERSION = true ? "0.8.38" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.38" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {