hyperframes 0.8.192 → 0.8.194

package/dist/{chunk-DIKAPMMF.js → chunk-GQVTTWZF.js}

@@ -7,7 +7,7 @@ var __dirname = __hf_dirname(__filename);
 import {
   runCancellableProcess,
   runRenderSetupWorker
-} from "./chunk-RWGASWT7.js";
+} from "./chunk-BL4U6U52.js";
 import {
   getFreeDiskMb
 } from "./chunk-T6AGUTZJ.js";
@@ -35,9 +35,81 @@ import {
   writeFileSync
 } from "fs";
 import { homedir } from "os";
-import { debuglog } from "util";
 import { basename, dirname as dirname2, join, relative } from "path";
 
+// src/browser/installProtocol.ts
+var PROGRESS_PREFIX = "HYPERFRAMES_BROWSER_INSTALL_PROGRESS:";
+var LOG_PREFIX = "HYPERFRAMES_BROWSER_INSTALL_LOG:";
+function installProgressLine(downloaded, total) {
+  return `${PROGRESS_PREFIX}${JSON.stringify([downloaded, total])}
+`;
+}
+function installLogLine(text) {
+  return `${LOG_PREFIX}${JSON.stringify(text)}
+`;
+}
+function parseInstallLine(line) {
+  try {
+    if (line.startsWith(PROGRESS_PREFIX)) {
+      const [downloaded, total] = JSON.parse(line.slice(PROGRESS_PREFIX.length));
+      return { kind: "progress", downloaded, total };
+    }
+    if (line.startsWith(LOG_PREFIX)) {
+      return { kind: "log", text: JSON.parse(line.slice(LOG_PREFIX.length)) };
+    }
+  } catch {
+  }
+  return null;
+}
+
+// src/browser/installInChild.ts
+var CHILD_STARTUP_MS = 15e3;
+var BrowserDownloadStalledError = class extends Error {
+};
+function lineReader(onLine) {
+  let pending = "";
+  return (chunk) => {
+    const lines = (pending + chunk).split("\n");
+    pending = lines.pop() ?? "";
+    for (const line of lines) onLine(line);
+  };
+}
+async function installInChild(input, hooks) {
+  const abort = new AbortController();
+  let timer;
+  const arm = (waitMs) => {
+    clearTimeout(timer);
+    timer = setTimeout(
+      () => abort.abort(
+        new BrowserDownloadStalledError(
+          `The Chrome download from ${hooks.host} stalled: no data for ${hooks.stallMs / 1e3}s.`
+        )
+      ),
+      waitMs
+    );
+    timer.unref();
+  };
+  const onStdout = lineReader((line) => {
+    const event = parseInstallLine(line);
+    if (event?.kind === "log") hooks.onLog(event.text);
+    if (event?.kind !== "progress") return;
+    if (event.total > 0) hooks.onProgress?.(event.downloaded, event.total);
+    if (event.total > 0 && event.downloaded >= event.total) clearTimeout(timer);
+    else arm(hooks.stallMs);
+  });
+  arm(CHILD_STARTUP_MS + hooks.stallMs);
+  try {
+    return await runRenderSetupWorker("browser-install", input, {
+      signal: abort.signal,
+      detached: false,
+      maxBufferBytes: 4 * 1024 * 1024,
+      onStdout
+    });
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
 // src/browser/unzipArchive.ts
 import { mkdir } from "fs/promises";
 import { dirname } from "path";
@@ -486,10 +558,33 @@ Point hyperframes at an already-installed Chrome/Chromium instead:
 Then re-run your command. Any Chrome build works for the screenshot capture path; install a real chrome-headless-shell later if you need the perf-optimized BeginFrame path. Alternatively, run inside the hyperframes Docker image which ships a compatible headless-shell.`;
   return new Error(message, { cause: cause instanceof Error ? cause : void 0 });
 }
-async function downloadBrowser(options) {
-  if (isLinuxArm()) {
-    return ensureLinuxArmBrowser(options);
+var DOWNLOAD_STALL_MS = 6e4;
+var DOWNLOAD_ATTEMPTS = 3;
+async function retryOnStall(run, clear) {
+  for (let attempt = 1; ; attempt++) {
+    try {
+      return await run();
+    } catch (err) {
+      if (!(err instanceof BrowserDownloadStalledError) || attempt >= DOWNLOAD_ATTEMPTS) throw err;
+      console.warn(`[hyperframes] ${err.message} Retrying (${attempt}/${DOWNLOAD_ATTEMPTS - 1}).`);
+      clear();
+    }
   }
+}
+function downloadHostOf(browsers, platform, buildId, baseUrl) {
+  try {
+    const url = browsers.getDownloadUrl(
+      browsers.Browser.CHROMEHEADLESSSHELL,
+      platform,
+      buildId,
+      baseUrl
+    );
+    return new URL(url).host;
+  } catch {
+    return "the Chrome download host";
+  }
+}
+function assertRoomToDownload() {
   removeInstallLeftovers();
   const freeMb = getFreeDiskMb(CACHE_ROOT_DIR);
   if (freeMb !== null && freeMb < ARCHIVE_PLUS_UNPACKED_SHELL_MB) {
@@ -497,55 +592,63 @@ async function downloadBrowser(options) {
       `Low disk space: Chrome Headless Shell needs about ${ARCHIVE_PLUS_UNPACKED_SHELL_MB} MB to download, ${freeMb} MB free at ${CACHE_ROOT_DIR}. Free disk space, then retry.`
     );
   }
-  const { Browser, Cache, detectBrowserPlatform, install } = await loadPuppeteerBrowsers();
-  const platform = detectBrowserPlatform();
-  if (!platform) {
-    throw new Error(`Unsupported platform: ${process.platform} ${process.arch}`);
-  }
-  const stagingDir = join(CACHE_ROOT_DIR, `${STAGING_PREFIX}${randomUUID()}`);
-  const clearStaging = () => rmSync(stagingDir, { recursive: true, force: true });
-  let unzipLog = [];
+}
+function stagedInstaller(browsers, platform, stagingDir, options, unzipLog) {
   const buildId = managedChromeVersion();
-  const runInstall = async () => {
-    unzipLog = [];
-    const installOptions = {
+  const hooks = {
+    stallMs: options?.downloadStallMs ?? DOWNLOAD_STALL_MS,
+    host: downloadHostOf(browsers, platform, buildId, options?.downloadBaseUrl),
+    onProgress: options?.onProgress,
+    onLog: (line) => unzipLog.lines.push(line)
+  };
+  return async () => {
+    unzipLog.lines = [];
+    const input = {
       cacheDir: stagingDir,
-      browser: Browser.CHROMEHEADLESSSHELL,
+      browser: browsers.Browser.CHROMEHEADLESSSHELL,
       buildId,
       platform,
-      downloadProgressCallback: options?.onProgress,
-      logger: (prefix) => {
-        const debug = debuglog(prefix);
-        const isUnzip = prefix === "puppeteer:browsers:fileUtil";
-        if (!isUnzip && !debug.enabled) return void 0;
-        return (...args) => {
-          const line = args.join(" ");
-          if (isUnzip) unzipLog.push(line);
-          if (debug.enabled) debug(line);
-        };
-      }
+      baseUrl: options?.downloadBaseUrl
     };
     const unzipMayAskOnInput = process.platform !== "win32";
     if (unzipMayAskOnInput) {
-      const archive = await install({ ...installOptions, unpack: false });
-      const into = new Cache(stagingDir).installationDir(installOptions.browser, platform, buildId);
+      const archive = await installInChild({ ...input, unpack: false }, hooks);
+      const into = new browsers.Cache(stagingDir).installationDir(input.browser, platform, buildId);
       await unzipArchive(archive, into);
     }
-    return install(installOptions);
+    return installInChild(input, hooks);
   };
+}
+async function downloadBrowser(options) {
+  if (isLinuxArm()) {
+    return ensureLinuxArmBrowser(options);
+  }
+  assertRoomToDownload();
+  const browsers = await loadPuppeteerBrowsers();
+  const platform = browsers.detectBrowserPlatform();
+  if (!platform) {
+    throw new Error(`Unsupported platform: ${process.platform} ${process.arch}`);
+  }
+  const stagingDir = join(CACHE_ROOT_DIR, `${STAGING_PREFIX}${randomUUID()}`);
+  const clearStaging = () => rmSync(stagingDir, { recursive: true, force: true });
+  const unzipLog = { lines: [] };
+  const runInstall = stagedInstaller(browsers, platform, stagingDir, options, unzipLog);
   try {
-    const staged = await installWithCorruptArchiveRecovery(
-      runInstall,
-      clearStaging,
-      (err) => console.warn(
-        `[hyperframes] Downloaded browser archive was corrupt (${normalizeErrorMessage(err)}); re-downloading.`
-      )
+    const staged = await retryOnStall(
+      () => installWithCorruptArchiveRecovery(
+        runInstall,
+        clearStaging,
+        (err) => console.warn(
+          `[hyperframes] Downloaded browser archive was corrupt (${normalizeErrorMessage(err)}); re-downloading.`
+        )
+      ),
+      clearStaging
     );
     assertExecutableUnpacked(stagingDir, staged.executablePath);
-    unzipLog = [];
+    unzipLog.lines = [];
     return { executablePath: moveStagedInstallIntoCache(stagingDir, staged), source: "download" };
   } catch (err) {
-    throw wrapDownloadFailureWithBrowserPathHint(err, unzipLog);
+    throw wrapDownloadFailureWithBrowserPathHint(err, unzipLog.lines);
   } finally {
     clearStaging();
   }
@@ -622,6 +725,8 @@ function isLinuxArm() {
 }
 
 export {
+  installProgressLine,
+  installLogLine,
   CACHE_DIR,
   withInstallLock,
   releaseOwnedBrowserInstallLock,

package/dist/{chunk-7LLRMYP6.js → chunk-HCLBM2LQ.js}

@@ -6,14 +6,14 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   resolveProject
-} from "./chunk-4E75LHAL.js";
+} from "./chunk-ST4SHO3S.js";
 import {
   DEFAULT_HISTORY_ROOT,
   HistoryBusyError,
   MAX_WINDOW_IDLE_MS,
   openProjectHistory,
   readProjectHistory
-} from "./chunk-4HCJOFMB.js";
+} from "./chunk-OJNNKHAZ.js";
 import {
   findPreviewServerForProject,
   studioApiUrl

package/dist/{chunk-AMZJFCOX.js → chunk-HG5ECUOR.js}

@@ -16,7 +16,7 @@ import {
 } from "./chunk-5ETJX6WM.js";
 import {
   runEnvironmentChecks
-} from "./chunk-KZOZN4PI.js";
+} from "./chunk-HPGQPRHY.js";
 import {
   OPTIONAL_PACKAGES,
   installedOptionalPackageVersion
@@ -29,7 +29,7 @@ import {
 } from "./chunk-ZTZA4UWZ.js";
 import {
   resolveExtractCacheDir
-} from "./chunk-QX4TB4NH.js";
+} from "./chunk-52YJKWV3.js";
 import {
   getAvailableMemoryMb,
   getFreeDiskMb,
@@ -39,14 +39,14 @@ import {
 import {
   getUpdateMeta,
   withMeta
-} from "./chunk-2HP5GIQ3.js";
+} from "./chunk-SNECH6QA.js";
 import {
   CONFIG_PATH,
   withFileLock
 } from "./chunk-6NLPPKBO.js";
 import {
   VERSION
-} from "./chunk-3FV5BVWS.js";
+} from "./chunk-EY7GKVPS.js";
 import {
   normalizeErrorMessage
 } from "./chunk-T2EUWCJE.js";
@@ -232,7 +232,7 @@ function checkEnvironment() {
   return { ok: true, detail: parts.join(" \xB7 ") };
 }
 async function checkWhisper() {
-  const { findWhisper, getInstallInstructions } = await import("./manager-QROK2IH3.js");
+  const { findWhisper, getInstallInstructions } = await import("./manager-PLRSZH5G.js");
   const result = findWhisper();
   if (result) {
     return { ok: true, detail: result.executablePath };

package/dist/{chunk-KZOZN4PI.js → chunk-HPGQPRHY.js}

@@ -11,14 +11,14 @@ import {
   distroLabel,
   getFFmpegInstallHint,
   parseLddMissingLibs
-} from "./chunk-VRAXIQ6I.js";
+} from "./chunk-XYGULBFV.js";
 import {
   ensureBrowser,
   findBrowser
-} from "./chunk-DIKAPMMF.js";
+} from "./chunk-GQVTTWZF.js";
 import {
   runCancellableProcess
-} from "./chunk-RWGASWT7.js";
+} from "./chunk-BL4U6U52.js";
 import {
   getFreeDiskMb
 } from "./chunk-T6AGUTZJ.js";

package/dist/{chunk-BPKLUHFT.js → chunk-HQD7ODQB.js}

@@ -6,26 +6,26 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   parakeetRunner
-} from "./chunk-7JJMT6LN.js";
+} from "./chunk-N33FO44R.js";
 import {
   DecodeCancelled,
   prepareSherpaWav,
   sherpaUnsupportedReason,
   transcribeWithSherpa
-} from "./chunk-VOM2HLUI.js";
+} from "./chunk-BK5YCT54.js";
 import {
   initialModelForLanguage,
   transcribe
-} from "./chunk-LOKCBZYF.js";
+} from "./chunk-Q4HKC3O7.js";
 import {
   createRenderCancellationScope,
   stoppedByCancelSignal
-} from "./chunk-J2ASTCU6.js";
+} from "./chunk-4VSV56F2.js";
 import {
   DEFAULT_MODEL,
   findWhisper,
   isWhisperUnavailable
-} from "./chunk-PFRG5P32.js";
+} from "./chunk-Y3BT27Y7.js";
 import {
   formatSrt,
   formatVtt,

package/dist/{chunk-SK7TR7BL.js → chunk-JU4T4VAA.js}

@@ -11,20 +11,20 @@ import {
   isAllowedHtmlAttribute,
   isSafeAttributeValue,
   sanitizeRichTextChildren
-} from "./chunk-MGBUWPXX.js";
+} from "./chunk-JVTWX5G3.js";
 import {
   EXCLUDED_TAGS,
   ensureHfIds,
   mintHfId,
   walkCompositionDescendants
-} from "./chunk-AEXVVABM.js";
+} from "./chunk-GAFEU6AB.js";
 import {
   decodedUrlPath,
   removeElementWithGsapCascade
-} from "./chunk-2MCXIY4B.js";
+} from "./chunk-B7RJV74O.js";
 import {
   require_dist
-} from "./chunk-2VXY3PEF.js";
+} from "./chunk-K2VXPQKC.js";
 import {
   readClipTiming,
   writeClipTiming

package/dist/{chunk-MGBUWPXX.js → chunk-JVTWX5G3.js}

@@ -9,7 +9,7 @@ import {
   parseStrictFiniteTimingNumber,
   resolveNaturalMediaTimelineDuration,
   resolveTimedImageDurationSeconds
-} from "./chunk-B2XLXD7V.js";
+} from "./chunk-2D5WP2NI.js";
 import {
   CANVAS_DIMENSIONS,
   isCompositionElement,
@@ -17,7 +17,7 @@ import {
   isTextElement,
   keyframesToGsapAnimations,
   serializeGsapAnimations
-} from "./chunk-2MCXIY4B.js";
+} from "./chunk-B7RJV74O.js";
 import {
   COMPOSITION_ATTRIBUTES,
   MEDIA_START_BASIS_ATTR,
@@ -152,12 +152,27 @@ function getStageStyles(resolution = "portrait") {
 
 // ../core/dist/gsapCdn.js
 var GSAP_CDN_VERSION = "3.15.0";
-function gsapCdnDist(gsapVersion) {
+var GSAP_CDN_BASE_URL = "https://cdn.jsdelivr.net/npm";
+var GSAP_BASE_URL_META = "hyperframes-gsap-base-url";
+function normalizeGsapBaseUrl(baseUrl) {
+  const value = baseUrl?.trim();
+  if (!value)
+    return GSAP_CDN_BASE_URL;
+  if (!/^https?:\/\//i.test(value) || !URL.canParse(value) || /[?#]/.test(value)) {
+    throw new Error("GSAP base URL must be an absolute HTTP(S) URL without a query or fragment");
+  }
+  const url = new URL(value);
+  if (url.username || url.password) {
+    throw new Error("GSAP base URL must not contain credentials");
+  }
+  return url.href.replace(/\/+$/, "");
+}
+function gsapCdnDist(gsapVersion, baseUrl) {
   const version = gsapVersion && /^\d+(\.\d+)*$/.test(gsapVersion) ? gsapVersion : GSAP_CDN_VERSION;
-  return `https://cdn.jsdelivr.net/npm/gsap@${version}/dist/`;
+  return `${normalizeGsapBaseUrl(baseUrl)}/gsap@${version}/dist/`;
 }
-function motionPathPluginUrl(gsapVersion) {
-  return `${gsapCdnDist(gsapVersion)}MotionPathPlugin.min.js`;
+function motionPathPluginUrl(gsapVersion, baseUrl) {
+  return `${gsapCdnDist(gsapVersion, baseUrl)}MotionPathPlugin.min.js`;
 }
 
 // ../core/dist/templates/constants.js
@@ -4444,7 +4459,15 @@ function createRuntimeStartTimeResolver(params) {
   const startCache = /* @__PURE__ */ new WeakMap();
   const durationCache = /* @__PURE__ */ new WeakMap();
   const visiting = /* @__PURE__ */ new Set();
-  const findReferenceTarget = (refId) => {
+  const compositionScopeOf = (element) => (element.hasAttribute("data-composition-id") ? element.parentElement : element)?.closest("[data-composition-id]") ?? null;
+  const findReferenceTarget = (refId, from) => {
+    const scope = compositionScopeOf(from);
+    if (scope) {
+      for (const candidate of scope.querySelectorAll(`[id="${refId}"]`)) {
+        if (compositionScopeOf(candidate) === scope)
+          return candidate;
+      }
+    }
     const byId = doc.getElementById(refId);
     if (byId)
       return byId;
@@ -4496,7 +4519,7 @@ function createRuntimeStartTimeResolver(params) {
     if (expression.kind === "absolute") {
       return resolveHostOffsetForElement(element, fallback) + Math.max(0, expression.value);
     }
-    const target = findReferenceTarget(expression.refId);
+    const target = findReferenceTarget(expression.refId, element);
     if (!target)
       return fallback;
     const targetStart = resolveStartForElementInternal(target, 0);
@@ -5530,6 +5553,8 @@ export {
   isDistributedFps,
   generateBaseHtml,
   getStageStyles,
+  GSAP_BASE_URL_META,
+  normalizeGsapBaseUrl,
   gsapCdnDist,
   motionPathPluginUrl,
   GSAP_CDN,