hyperframes 0.8.147 → 0.8.149

package/dist/{chunk-POKK6XXU.js → chunk-U7SASZC5.js}

@@ -6,24 +6,24 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   serveStaticProjectHtml
-} from "./chunk-EGO6Z24R.js";
-import {
-  resolveProject
-} from "./chunk-AFIATIKS.js";
+} from "./chunk-K44HCHZN.js";
 import {
   AUDIT_SEEK_OPTIONS,
   installPageFunctionGuard,
   seekCompositionTimeline,
   waitForCompositionFonts,
   waitForRuntimeReady
-} from "./chunk-SEABQTBP.js";
+} from "./chunk-TPIG7ZBX.js";
 import {
   launchManagedBrowser,
   resolveManagedGpuMode
-} from "./chunk-XOJDBRNF.js";
+} from "./chunk-4S4VUXW3.js";
 import {
   resolveDiagnosticNavigationTimeoutMs
-} from "./chunk-3HSWLZ6S.js";
+} from "./chunk-KQHJKJ3V.js";
+import {
+  resolveProject
+} from "./chunk-SFUBSJFP.js";
 import {
   defineCommand
 } from "./chunk-S3S4TGEH.js";
@@ -31,16 +31,16 @@ import {
   failCommand,
   setCommandExitCode
 } from "./chunk-PBN6GBJE.js";
+import {
+  c
+} from "./chunk-ZTZA4UWZ.js";
 import {
   printDeprecationNotice,
   withMeta
-} from "./chunk-3YUFN37G.js";
+} from "./chunk-GESJSXFH.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";
-import {
-  c
-} from "./chunk-ZTZA4UWZ.js";
 
 // src/commands/layout.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
@@ -707,7 +707,7 @@ async function collectTweenBoundaries(page) {
   });
 }
 async function bundleProjectHtml(projectDir) {
-  const { bundleToSingleHtml } = await import("./compiler-ACCPOZMQ.js");
+  const { bundleToSingleHtml } = await import("./compiler-NPD3MYMO.js");
   return bundleToSingleHtml(projectDir);
 }
 async function alignViewportToComposition(page, url) {
@@ -727,15 +727,15 @@ async function alignViewportToComposition(page, url) {
   });
 }
 async function runLayoutAudit(projectDir, opts) {
-  const { ensureBrowser } = await import("./manager-BPSR6D3V.js");
+  const { ensureBrowser } = await import("./manager-GWU5J6RJ.js");
   const puppeteer = await import("puppeteer-core");
-  const { buildChromeArgs } = await import("./src-2GMPFYHL.js");
+  const { buildChromeArgs } = await import("./src-VMTHSARJ.js");
   const {
     assertWebGpuAdapterAvailable,
     compositionRequiresWebGpu,
     resolveLocalBrowserGpuMode,
     resolveLocalWebGpu
-  } = await import("./gpuPolicy-ZOUG66M7.js");
+  } = await import("./gpuPolicy-M2JZGGVW.js");
   const html = await bundleProjectHtml(projectDir);
   const server = await serveStaticProjectHtml(
     projectDir,

package/dist/{chunk-JF5L5SQ6.js → chunk-VC7JBNPS.js}

@@ -26,7 +26,7 @@ import {
   renderFrameIdForRenderId,
   resolveAuthoredTimingWindow,
   toFps
-} from "./chunk-BAKPN2D2.js";
+} from "./chunk-AHBYQRGI.js";
 import {
   AUDIO_GROUP_RENDER_ID_ATTR,
   COLOR_GRADING_SOURCE_HIDDEN_ATTR,
@@ -55,7 +55,7 @@ import {
   shiftRateLane,
   sourceTimeAt,
   timeAtSourceTime
-} from "./chunk-Z6FLHIDV.js";
+} from "./chunk-3WD4JNMU.js";
 import {
   clampAudioGain,
   isAudibleVideoElement
@@ -8363,6 +8363,7 @@ async function extractMediaMetadata(filePath) {
       durationSeconds: containerDuration,
       videoStreamDurationSeconds: effectiveStreamDuration,
       videoStreamStartSeconds: streamStart,
+      videoStreamLeadSeconds: streamLeadSeconds(output, videoStream),
       width: videoStream.width || stillImage()?.width || 0,
       height: videoStream.height || stillImage()?.height || 0,
       fps,
@@ -8467,13 +8468,28 @@ async function extractAudioMetadata(filePath, options) {
       sampleRate,
       channels: audioStream.channels || 2,
       audioCodec,
-      bitrate: output.format.bit_rate ? parseInt(output.format.bit_rate) : void 0
+      bitrate: output.format.bit_rate ? parseInt(output.format.bit_rate) : void 0,
+      latestStreamLeadSeconds: latestStreamLeadSeconds(output)
     };
   })();
   if (options?.signal) return probePromise;
   writeMetadataCache(audioMetadataCache, filePath, identity, probePromise);
   return probePromise;
 }
+function audioVideoStreamStarts(output) {
+  return (output?.streams ?? []).filter(
+    (s) => (s.codec_type === "audio" || s.codec_type === "video") && s.disposition?.attached_pic !== 1
+  ).map((s) => parseFloat(s.start_time ?? "")).filter(Number.isFinite);
+}
+function streamLeadSeconds(output, stream) {
+  const starts = audioVideoStreamStarts(output);
+  const start = parseFloat(stream.start_time ?? "");
+  return Number.isFinite(start) && starts.length > 0 ? Math.max(0, start - Math.min(...starts)) : 0;
+}
+function latestStreamLeadSeconds(output) {
+  const starts = audioVideoStreamStarts(output);
+  return starts.length > 0 ? Math.max(...starts) - Math.min(...starts) : 0;
+}
 function audioStartSeconds(stream, format) {
   const start = parseFloat(stream.start_time ?? format.start_time ?? "");
   return Number.isFinite(start) ? start : 0;
@@ -11941,9 +11957,9 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   if (framePaths.size > 0 && duration > 0 && !options.finalFrameOnly && !options.frameRanges) {
     const expectedAtFps = extractionFrameCountForDuration(duration, normalizedFps, metadata.isVFR);
     if (expectedAtFps > 0 && framePaths.size <= expectedAtFps * 0.6) {
-      const correctedDuration = startTime + framePaths.size / fps;
-      if (correctedDuration < metadata.videoStreamDurationSeconds) {
-        metadata.videoStreamDurationSeconds = correctedDuration;
+      const correctedStreamDuration = startTime + framePaths.size / fps - (metadata.videoStreamLeadSeconds ?? 0);
+      if (correctedStreamDuration < metadata.videoStreamDurationSeconds) {
+        metadata.videoStreamDurationSeconds = correctedStreamDuration;
       }
     }
   }
@@ -11984,7 +12000,7 @@ function resolveSegmentDuration(requested, mediaStart, sourceDuration) {
   return sourceRemaining > 0 ? sourceRemaining : sourceDuration;
 }
 function resolvePlayableVideoDuration(metadata) {
-  return Number.isFinite(metadata.videoStreamDurationSeconds) && metadata.videoStreamDurationSeconds > 0 ? metadata.videoStreamDurationSeconds : metadata.durationSeconds;
+  return Number.isFinite(metadata.videoStreamDurationSeconds) && metadata.videoStreamDurationSeconds > 0 ? (metadata.videoStreamLeadSeconds ?? 0) + metadata.videoStreamDurationSeconds : metadata.durationSeconds;
 }
 function canHoldFinalFramePastEof(video) {
   const timelineDuration = video.end - video.start;
@@ -12098,10 +12114,11 @@ function resolveTimelineExtractionWindow(video, resolvedDuration, timelineEnd, s
 async function resolveFinalFrameExtractionWindow(videoPath, video, metadata, window2, signal) {
   if (!window2.ensureFinalFrame) return window2;
   const playableDuration = resolvePlayableVideoDuration(metadata);
-  const finalFrameTimestamp = await extractFinalVideoFrameTimestamp(
+  const videoStreamLead = metadata.videoStreamLeadSeconds ?? 0;
+  const finalFrameTimestamp = videoStreamLead + await extractFinalVideoFrameTimestamp(
     videoPath,
     {
-      videoStreamDurationSeconds: playableDuration,
+      videoStreamDurationSeconds: playableDuration - videoStreamLead,
       videoStreamStartSeconds: metadata.videoStreamStartSeconds
     },
     signal
@@ -12914,6 +12931,10 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
     phaseBreakdown: breakdown
   };
 }
+var BROWSER_SHOWS_UPCOMING_FIRST_FRAME_WITHIN_SECONDS = 1;
+function isVideoHiddenBeforeStreamStart(videoStreamLeadSeconds, mediaTime) {
+  return (videoStreamLeadSeconds ?? 0) - mediaTime >= BROWSER_SHOWS_UPCOMING_FIRST_FRAME_WITHIN_SECONDS - 1e-6;
+}
 function getFrameIndexAtTime(extracted, globalTime, videoStart, loop = false, mediaStart = 0, holdLastFrame = false, playbackRate = 1) {
   let localTime = Math.max(0, globalTime - videoStart);
   const normalizedPlaybackRate = normalizeRateSpec(playbackRate);
@@ -12931,6 +12952,12 @@ function getFrameIndexAtTime(extracted, globalTime, videoStart, loop = false, me
   }
   const frameIndex = Math.floor(sourceTime * extracted.fps + 1e-9);
   if (frameIndex < 0 || extracted.totalFrames <= 0) return null;
+  if (isVideoHiddenBeforeStreamStart(
+    extracted.metadata.videoStreamLeadSeconds,
+    mediaStart + sourceTime
+  )) {
+    return null;
+  }
   if (frameIndex >= extracted.totalFrames) {
     return loop || holdLastFrame ? extracted.totalFrames - 1 : null;
   }
@@ -14269,11 +14296,11 @@ function buildAtempoFilter(playbackRate) {
 }
 var RAMP_SLICE_SECONDS = 0.25;
 var MAX_RAMP_SLICES = 240;
-function buildRampFilterComplex(lane, duration, tailFilter) {
+function buildRampFilterComplex(lane, duration, headFilter, tailFilter) {
   const slices = Math.min(MAX_RAMP_SLICES, Math.max(1, Math.ceil(duration / RAMP_SLICE_SECONDS)));
   const step = duration / slices;
   const split = Array.from({ length: slices }, (_, i) => `[s${i}]`).join("");
-  const parts = [`[0:a]asplit=${slices}${split}`];
+  const parts = [`[0:a]${headFilter ? `${headFilter},` : ""}asplit=${slices}${split}`];
   for (let i = 0; i < slices; i += 1) {
     const from = sourceTimeAt(lane, i * step);
     const to = sourceTimeAt(lane, (i + 1) * step);
@@ -14293,24 +14320,16 @@ function buildRampFilterComplex(lane, duration, tailFilter) {
   if (tailFilter) parts.push(`[cat]${tailFilter}[out]`);
   return parts.join(";");
 }
-function preparedAudioOutputArgs(srcPath, playbackRate, duration = 0) {
-  return stereoOutputArgs(srcPath).then((channelArgs) => {
-    const filters = [];
-    const outputArgs = [];
-    if (channelArgs[0] === "-af" && channelArgs[1]) {
-      filters.push(channelArgs[1]);
-    } else {
-      outputArgs.push(...channelArgs);
-    }
-    if (typeof playbackRate === "object") {
-      const graph = buildRampFilterComplex(playbackRate, duration, filters.join(",") || null);
-      return ["-filter_complex", graph, "-map", "[out]", ...outputArgs];
-    }
-    const atempo = buildAtempoFilter(playbackRate);
-    if (atempo) filters.push(atempo);
-    if (filters.length > 0) outputArgs.push("-af", filters.join(","));
-    return outputArgs;
-  });
+function preparedAudioOutputArgs(metadata, playbackRate, duration, headFilter) {
+  const channelFilter = metadata?.channels === 1 ? STEREO_CHANNEL_FILTER : null;
+  const outputArgs = channelFilter ? [] : ["-ac", "2"];
+  if (typeof playbackRate === "object") {
+    const graph = buildRampFilterComplex(playbackRate, duration, headFilter, channelFilter);
+    return ["-filter_complex", graph, "-map", "[out]", ...outputArgs];
+  }
+  const filters = [headFilter, channelFilter, buildAtempoFilter(playbackRate)].filter(Boolean);
+  if (filters.length > 0) outputArgs.push("-af", filters.join(","));
+  return outputArgs;
 }
 function escapeExpressionCommas(expression) {
   return expression.replace(/\\/g, "\\\\").replace(/,/g, "\\,");
@@ -14321,14 +14340,6 @@ function legacyFilterScriptOptionIsUnsupported(stderr) {
 var MAX_VOLUME_SEGMENTS = 32;
 var VOLUME_SIMPLIFY_EPSILON = 5e-3;
 var STEREO_CHANNEL_FILTER = "pan=stereo|FL=FL+FC|FR=FR+FC";
-async function stereoOutputArgs(srcPath) {
-  try {
-    const { channels } = await extractAudioMetadata(srcPath);
-    if (channels === 1) return ["-af", STEREO_CHANNEL_FILTER];
-  } catch {
-  }
-  return ["-ac", "2"];
-}
 function simplifyVolumeKeyframes(keyframes) {
   if (keyframes.length < 3) return keyframes;
   const keep = new Array(keyframes.length).fill(false);
@@ -14592,71 +14603,24 @@ function parseAudioElements(html) {
   }
   return elements;
 }
-async function extractAudioFromVideo(videoPath, outputPath, options, signal, config) {
-  const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
-  const outputDir = dirname6(outputPath);
-  if (!existsSync10(outputDir)) mkdirSync7(outputDir, { recursive: true });
-  const playbackRate = normalizeRateSpec(options?.playbackRate);
-  const args = [];
-  if (options?.startTime !== void 0) args.push("-ss", String(options.startTime));
-  if (options?.duration !== void 0) {
-    args.push("-t", String(sourceTimeAt(playbackRate, options.duration)));
-  }
-  args.push("-i", videoPath);
-  const outputArgs = await preparedAudioOutputArgs(videoPath, playbackRate, options?.duration);
-  args.push("-vn", "-acodec", "pcm_s16le", "-ar", "48000", ...outputArgs);
-  if (playbackRate !== 1 && options?.duration !== void 0) {
-    args.push("-t", String(options.duration));
-  }
-  args.push("-y", outputPath);
-  const result = await runFfmpeg(args, { signal, timeout: ffmpegProcessTimeout });
-  if (signal?.aborted) {
-    const failure = {
-      stage: "cancelled",
-      reason: "cancelled",
-      owner: "user",
-      retryable: false,
-      detail: "Audio extract cancelled"
-    };
-    return {
-      success: false,
-      outputPath,
-      durationMs: result.durationMs,
-      error: failure.detail,
-      failure
-    };
-  }
-  if (!result.success) {
-    const failure = ffmpegFailure("extract", result);
-    return {
-      success: false,
-      outputPath,
-      durationMs: result.durationMs,
-      error: failure.detail,
-      failure
-    };
-  }
-  return { success: true, outputPath, durationMs: result.durationMs };
-}
-async function prepareAudioTrack(srcPath, outputPath, mediaStart, duration, playbackRate = 1, signal, config) {
+async function extractAudioSegment(srcPath, outputPath, stage, mediaStart, duration, playbackRate = 1, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
   const outputDir = dirname6(outputPath);
   if (!existsSync10(outputDir)) mkdirSync7(outputDir, { recursive: true });
   const normalizedPlaybackRate = normalizeRateSpec(playbackRate);
-  const outputArgs = await preparedAudioOutputArgs(srcPath, normalizedPlaybackRate, duration);
-  const args = [
-    "-ss",
-    String(mediaStart),
-    "-t",
-    String(sourceTimeAt(normalizedPlaybackRate, duration)),
-    "-i",
-    srcPath,
-    "-acodec",
-    "pcm_s16le",
-    "-ar",
-    "48000",
-    ...outputArgs
-  ];
+  const sourceDuration = sourceTimeAt(normalizedPlaybackRate, duration);
+  const metadata = await extractAudioMetadata(srcPath).catch(() => null);
+  const inputSeek = mediaStart >= (metadata?.latestStreamLeadSeconds ?? 0);
+  const start = formatFilterNumber(mediaStart);
+  const timestampTrim = inputSeek ? null : `atrim=start=${start}:end=${formatFilterNumber(mediaStart + sourceDuration)},asetpts=PTS-${start}/TB,aresample=async=1:first_pts=0`;
+  const outputArgs = preparedAudioOutputArgs(
+    metadata,
+    normalizedPlaybackRate,
+    duration,
+    timestampTrim
+  );
+  const args = inputSeek ? ["-ss", String(mediaStart), "-t", String(sourceDuration), "-i", srcPath] : ["-i", srcPath];
+  args.push("-vn", "-acodec", "pcm_s16le", "-ar", "48000", ...outputArgs);
   if (normalizedPlaybackRate !== 1) args.push("-t", String(duration));
   args.push("-y", outputPath);
   const result = await runFfmpeg(args, { signal, timeout: ffmpegProcessTimeout });
@@ -14666,7 +14630,7 @@ async function prepareAudioTrack(srcPath, outputPath, mediaStart, duration, play
       reason: "cancelled",
       owner: "user",
       retryable: false,
-      detail: "Audio prepare cancelled"
+      detail: `Audio ${stage} cancelled`
     };
     return {
       success: false,
@@ -14676,7 +14640,7 @@ async function prepareAudioTrack(srcPath, outputPath, mediaStart, duration, play
       failure: failure2
     };
   }
-  const failure = !result.success ? ffmpegFailure("prepare", result) : void 0;
+  const failure = !result.success ? ffmpegFailure(stage, result) : void 0;
   return {
     success: result.success,
     outputPath,
@@ -15018,14 +14982,13 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
         let audioSrcPath = srcPath;
         if (element.type === "video") {
           const extractedPath = join13(workDir, `${element.id}-extracted.wav`);
-          const extractResult = await extractAudioFromVideo(
+          const extractResult = await extractAudioSegment(
             srcPath,
             extractedPath,
-            {
-              startTime: element.mediaStart,
-              duration: element.end - element.start,
-              playbackRate: element.playbackRate
-            },
+            "extract",
+            element.mediaStart,
+            element.end - element.start,
+            element.playbackRate,
             effectiveSignal,
             config
           );
@@ -15045,9 +15008,10 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
           audioSrcPath = extractedPath;
         } else {
           const trimmedPath = join13(workDir, `${element.id}-trimmed.wav`);
-          const prepResult = await prepareAudioTrack(
+          const prepResult = await extractAudioSegment(
             srcPath,
             trimmedPath,
+            "prepare",
             element.mediaStart,
             element.end - element.start,
             element.playbackRate,
@@ -16627,6 +16591,7 @@ export {
   resolveVideoExtractionWindow,
   resolveVideoExtractionDuration,
   extractAllVideoFrames,
+  isVideoHiddenBeforeStreamStart,
   getFrameAtTime,
   analyzeClipMediaFit,
   FrameLookupTable,

package/dist/{chunk-N53FLAMZ.js → chunk-VGCEMOQA.js}

@@ -7,38 +7,41 @@ var __dirname = __hf_dirname(__filename);
 import {
   RegistryCompatibilityError,
   gateRegistryItemsCompatibility
-} from "./chunk-6BSIQJPW.js";
+} from "./chunk-LTJDUBSQ.js";
 import {
   DEFAULT_PROJECT_CONFIG,
   createProjectConfig,
   loadProjectConfig,
   projectConfigPath,
   recordProjectRegistryItems
-} from "./chunk-LE7T4ML7.js";
+} from "./chunk-SP6XL3NP.js";
 import {
   resolveItemWithDependencies,
   resolveItemsByTag
-} from "./chunk-DDNS2674.js";
+} from "./chunk-PR7QQBSC.js";
 import {
   InvalidVariableValuesError,
   prepareItem,
   publishItem
-} from "./chunk-FDL4HV44.js";
+} from "./chunk-Q2Y5OZCY.js";
 import {
   DEFAULT_REGISTRY_URL
-} from "./chunk-XVIYZU3D.js";
+} from "./chunk-K35E45SI.js";
 import {
   trackRegistryItemAdded
-} from "./chunk-55RZG5SQ.js";
+} from "./chunk-Y475GD4L.js";
 import {
   defineCommand
 } from "./chunk-S3S4TGEH.js";
 import {
   failCommand
 } from "./chunk-PBN6GBJE.js";
+import {
+  c
+} from "./chunk-ZTZA4UWZ.js";
 import {
   ITEM_TYPE_DIRS
-} from "./chunk-BAKPN2D2.js";
+} from "./chunk-AHBYQRGI.js";
 import {
   isProjectRootMissing,
   realpath
@@ -46,9 +49,6 @@ import {
 import {
   parseHTML
 } from "./chunk-SDYDNHEE.js";
-import {
-  c
-} from "./chunk-ZTZA4UWZ.js";
 
 // src/commands/add.ts
 import { existsSync, readFileSync } from "fs";

package/dist/{normalize-U3SL5VG3.js → chunk-VHZ6DL3M.js}

@@ -7,7 +7,6 @@ var __dirname = __hf_dirname(__filename);
 import {
   parseHTML
 } from "./chunk-SDYDNHEE.js";
-import "./chunk-M2WBOQ2Q.js";
 
 // src/whisper/normalize.ts
 import { readFileSync, readdirSync, writeFileSync } from "fs";
@@ -330,11 +329,12 @@ function patchCaptionHtml(dir, words) {
     }
   }
 }
+
 export {
   detectFormat,
+  wordsToCues,
   formatSrt,
   formatVtt,
   loadTranscript,
-  patchCaptionHtml,
-  wordsToCues
+  patchCaptionHtml
 };

package/dist/chunk-VX4AL2FQ.js

@@ -0,0 +1,26 @@
+import { createRequire as __hf_createRequire } from "node:module";
+import { fileURLToPath as __hf_fileURLToPath } from "node:url";
+import { dirname as __hf_dirname } from "node:path";
+var require = __hf_createRequire(import.meta.url);
+var __filename = __hf_fileURLToPath(import.meta.url);
+var __dirname = __hf_dirname(__filename);
+import {
+  sherpaParakeetInstalled,
+  sherpaUnsupportedReason
+} from "./chunk-CT6ZQRLD.js";
+import {
+  findParakeet
+} from "./chunk-JZIEZCQM.js";
+
+// src/whisper/parakeetRunner.ts
+function parakeetRunner({
+  unsupported = sherpaUnsupportedReason(),
+  skipSherpa = false
+} = {}) {
+  if (!skipSherpa && !unsupported && sherpaParakeetInstalled()) return "sherpa";
+  return findParakeet() ? "parakeet-mlx" : null;
+}
+
+export {
+  parakeetRunner
+};

package/dist/{chunk-3BYMCR4O.js → chunk-VXM4BH23.js}

@@ -16,7 +16,7 @@ import {
   EncoderInterruptedError,
   encoderFailureError,
   prepareAnimatedGifInputs
-} from "./chunk-4YVMMRHR.js";
+} from "./chunk-K4RIT6PX.js";
 import {
   createStudioPositionSeekReapplyScript
 } from "./chunk-EOOEC32M.js";
@@ -105,6 +105,7 @@ import {
   isNotMediaPayload,
   isTransientBrowserError,
   isVideoFrameFormat,
+  isVideoHiddenBeforeStreamStart,
   isVideoPastTimelineEnd,
   mergeWorkerFrames,
   muxVideoWithAudio,
@@ -145,7 +146,7 @@ import {
   validateEngineConfigSnapshot,
   verifyDiskDrawElementSamples,
   writeCapturedFrame
-} from "./chunk-JF5L5SQ6.js";
+} from "./chunk-VC7JBNPS.js";
 import {
   assignBundledRuntimeCompositionIds,
   buildVariablesByCompScript,
@@ -158,7 +159,7 @@ import {
   isTemplateEntry,
   parsesAsScript,
   prepareFlattenedInnerRoot
-} from "./chunk-JBQJKC23.js";
+} from "./chunk-62RUQJ5J.js";
 import {
   LOW_MEMORY_TOTAL_MB_THRESHOLD,
   getCgroupMemoryLimitMb,
@@ -179,7 +180,7 @@ import {
   resolveAbsoluteMediaStartSeconds,
   resolveAuthoredTimingWindow,
   toFps
-} from "./chunk-BAKPN2D2.js";
+} from "./chunk-AHBYQRGI.js";
 import {
   COMPOSITION_SOURCE_URL,
   HF_COLOR_GRADING_ATTR,
@@ -206,7 +207,7 @@ import {
   shouldClampResolvedMediaDuration,
   sourceTimeAt,
   styleElementsFor
-} from "./chunk-Z6FLHIDV.js";
+} from "./chunk-3WD4JNMU.js";
 import {
   MAX_AUDIO_GAIN
 } from "./chunk-YA62XGXS.js";
@@ -2216,6 +2217,8 @@ function blitHdrVideoLayer(canvas, el, time, fps, hdrVideoFrameSources, hdrStart
     frameSource.loop
   );
   if (effectiveIndex === null) return;
+  const mediaTime = (frameSource.mediaStart ?? 0) + effectiveIndex / fps;
+  if (isVideoHiddenBeforeStreamStart(frameSource.videoStreamLeadSeconds, mediaTime)) return;
   const frameOffset = effectiveIndex * frameSource.frameSize;
   try {
     if (hdrPerf) hdrPerf.hdrVideoLayerBlits += 1;
@@ -2824,7 +2827,10 @@ async function extractHdrVideoFrames(args) {
       initialWindow,
       abortSignal
     );
-    extractionWindows.set(videoId, window2);
+    extractionWindows.set(videoId, {
+      window: window2,
+      videoStreamLeadSeconds: metadata.videoStreamLeadSeconds
+    });
     prep.hdrVideoStartTimes.set(videoId, window2.compositionStart);
     plannedVideos.push({
       durationSeconds: window2.durationSeconds,
@@ -2843,14 +2849,16 @@ async function extractHdrVideoFrames(args) {
   try {
     for (const [videoId, srcPath] of prep.hdrVideoSrcPaths) {
       const video = composition.videos.find((v) => v.id === videoId);
-      const window2 = extractionWindows.get(videoId);
-      if (!video || !window2) continue;
+      const planned = extractionWindows.get(videoId);
+      if (!video || !planned) continue;
+      const { window: window2 } = planned;
       mkdirSync2(framesDir, { recursive: true });
       const frameDir = mkdtempSync2(join7(framesDir, `hdr_${tempDirSafePrefix(videoId)}-`));
       createdFrameDirs.add(frameDir);
       const dims = prep.hdrExtractionDims.get(videoId) ?? { width, height };
       const rawPath = join7(frameDir, "frames.rgb48le");
-      const extractionStart = String(window2.extractionMediaStart ?? window2.mediaStart);
+      const extractionMediaStart = window2.extractionMediaStart ?? window2.mediaStart;
+      const extractionStart = String(extractionMediaStart);
       const ffmpegArgs = [];
       if (window2.finalFrameOnly) {
         ffmpegArgs.push("-i", srcPath, "-ss", extractionStart, "-frames:v", "1");
@@ -2910,7 +2918,9 @@ async function extractHdrVideoFrames(args) {
           frameSize,
           frameCount,
           scratch: Buffer.allocUnsafe(frameSize),
-          loop: video.loop
+          loop: video.loop,
+          mediaStart: extractionMediaStart,
+          videoStreamLeadSeconds: planned.videoStreamLeadSeconds
         });
         handedOff = true;
       } finally {
@@ -14310,7 +14320,7 @@ function startServer(options = {}) {
   });
   async function shutdown(signal) {
     log.info(`Received ${signal}, shutting down`);
-    const { drainBrowserPool } = await import("./src-2GMPFYHL.js");
+    const { drainBrowserPool } = await import("./src-VMTHSARJ.js");
     await drainBrowserPool().catch(() => {
     });
     const handle = await Promise.race([
@@ -14804,6 +14814,7 @@ function readVideoMetadata(value, field) {
     // overwhelmingly common start-at-zero domain. Preserve that compatibility
     // while carrying non-zero edit-list/transport timestamps in new plans.
     videoStreamStartSeconds: record.videoStreamStartSeconds === void 0 ? 0 : readFiniteNumber(record.videoStreamStartSeconds, `${field}.videoStreamStartSeconds`),
+    videoStreamLeadSeconds: record.videoStreamLeadSeconds === void 0 ? 0 : readFiniteNumber(record.videoStreamLeadSeconds, `${field}.videoStreamLeadSeconds`),
     width: readPositiveInteger(record.width, `${field}.width`),
     height: readPositiveInteger(record.height, `${field}.height`),
     fps: readFiniteNumber(record.fps, `${field}.fps`),
@@ -15495,7 +15506,7 @@ async function buildLocalExecutionPlan(projectDir, config, executionPlanDir, opt
   if (probeResult.fileServer) closeFileServerSafely(probeResult.fileServer, "plan", log);
   if (probeResult.probeSession) {
     try {
-      const { closeCaptureSession: closeCaptureSession2 } = await import("./src-2GMPFYHL.js");
+      const { closeCaptureSession: closeCaptureSession2 } = await import("./src-VMTHSARJ.js");
       await closeCaptureSession2(probeResult.probeSession);
     } catch (err) {
       log.warn("[plan] probe session close failed", {

package/dist/{chunk-ZLL72U3I.js → chunk-WX7VCRM7.js}

@@ -20,7 +20,7 @@ import {
   typeDirPath,
   updateRecord,
   withFigmaErrors
-} from "./chunk-5OKZLMQK.js";
+} from "./chunk-RMIFSBRV.js";
 import {
   defineCommand
 } from "./chunk-S3S4TGEH.js";
@@ -229,7 +229,7 @@ var asset_default = defineCommand({
           rendered > 0 ? `(${results.length} nodes, ${rendered} rendered in 1 figma request)` : `(${results.length} nodes, all reused from cache \u2014 no figma request)`
         );
       }
-      const { trackFigmaImport } = await import("./telemetry-V5JYZDS4.js");
+      const { trackFigmaImport } = await import("./telemetry-565KDZUW.js");
       trackFigmaImport({
         phase: "asset",
         reused: results.every((r) => r.reused),

package/dist/{chunk-KPJMBC4K.js → chunk-XHBX7QN6.js}

@@ -13,16 +13,16 @@ import {
 import {
   failCommand
 } from "./chunk-PBN6GBJE.js";
+import {
+  c
+} from "./chunk-ZTZA4UWZ.js";
 import {
   formatVariableValidationIssue,
   validateVariables
-} from "./chunk-BAKPN2D2.js";
+} from "./chunk-AHBYQRGI.js";
 import {
   extractCompositionMetadata
 } from "./chunk-LFNQDTSH.js";
-import {
-  c
-} from "./chunk-ZTZA4UWZ.js";
 
 // src/utils/variables.ts
 import { readFileSync } from "fs";