hyperframes 0.8.166 → 0.8.168

package/dist/{chunk-AKBFKGJM.js → chunk-QKJ4KGNR.js}

@@ -8,7 +8,7 @@ import {
   DEFAULT_REGISTRY_URL,
   fetchItemManifest,
   fetchRegistryManifest
-} from "./chunk-BTTGDEGI.js";
+} from "./chunk-ID7B7NGN.js";
 
 // src/registry/resolver.ts
 function defaultWarn(message) {

package/dist/{chunk-W3SLIE72.js → chunk-RG66EU4L.js}

@@ -9,17 +9,17 @@ import {
   resolveCliChromeGpuMode,
   seekCompositionTimeline,
   waitForRuntimeReady
-} from "./chunk-L7PJO2A4.js";
+} from "./chunk-EW2QBTYO.js";
 import {
   launchManagedBrowser,
   resolveManagedGpuMode
-} from "./chunk-FLTPIUGU.js";
+} from "./chunk-UWQL2MP4.js";
 import {
   resolveCompositionViewportFromHtml
 } from "./chunk-FH7WODJH.js";
 import {
   resolveProject
-} from "./chunk-ATF6UESJ.js";
+} from "./chunk-LGCHE2F4.js";
 import {
   defineCommand
 } from "./chunk-S3S4TGEH.js";
@@ -33,7 +33,7 @@ import {
 import {
   printDeprecationNotice,
   withMeta
-} from "./chunk-ZIL7S3L6.js";
+} from "./chunk-O7BABHM4.js";
 import {
   decodeWellFormedEscapes
 } from "./chunk-BSQ7XANM.js";
@@ -228,7 +228,7 @@ function extractCompositionErrorsFromLint(lintResult) {
 async function localizeRemoteAssets(html) {
   let dir;
   try {
-    const { loadProducer } = await import("./producer-STNCPEUU.js");
+    const { loadProducer } = await import("./producer-FKOEAHJW.js");
     const { localizeRemoteMediaSources, localizeRemoteImageSources, localizeRemoteFontFaces } = await loadProducer();
     dir = mkdtempSync(join(tmpdir(), "hf-validate-assets-"));
     const assetDir = dir;
@@ -249,10 +249,10 @@ async function localizeRemoteAssets(html) {
 }
 async function validateInBrowser(project, opts) {
   const projectDir = project.dir;
-  const { bundleToSingleHtml } = await import("./compiler-VQ7QYOSB.js");
+  const { bundleToSingleHtml } = await import("./compiler-OSQ4L7FP.js");
   const { ensureBrowser } = await import("./manager-HEUPD2YB.js");
-  const { serveStaticProjectHtml } = await import("./staticProjectServer-H6GKJPVR.js");
-  const { lintProject } = await import("./lintProject-BGDYHF3F.js");
+  const { serveStaticProjectHtml } = await import("./staticProjectServer-RLERPIY6.js");
+  const { lintProject } = await import("./lintProject-PXB5Y6TX.js");
   const lintResult = await lintProject(projectDir);
   const compositionErrors = extractCompositionErrorsFromLint(lintResult);
   const html = await bundleToSingleHtml(projectDir);
@@ -273,9 +273,9 @@ async function validateInBrowser(project, opts) {
   try {
     const browser = await ensureBrowser();
     const puppeteer = await import("puppeteer-core");
-    const { buildChromeArgs, analyzeClipMediaFit } = await import("./src-DG7XW5WW.js");
+    const { buildChromeArgs, analyzeClipMediaFit } = await import("./src-5XO7KBBL.js");
     const requestedGpuMode = resolveCliChromeGpuMode();
-    const { assertWebGpuAdapterAvailable, compositionRequiresWebGpu, resolveLocalWebGpu } = await import("./gpuPolicy-4YD2BS3P.js");
+    const { assertWebGpuAdapterAvailable, compositionRequiresWebGpu, resolveLocalWebGpu } = await import("./gpuPolicy-CHXUX2ZT.js");
     const resolvedGpuMode = await resolveManagedGpuMode(requestedGpuMode, browser.executablePath);
     const requiresWebGpu = compositionRequiresWebGpu(html);
     const { gpuConfig, softwareWebGpu } = resolveLocalWebGpu(resolvedGpuMode, requiresWebGpu);

package/dist/{chunk-AWNBM3MZ.js → chunk-RGHQID2E.js}

@@ -49,9 +49,9 @@ function isProtocolEvaluateTimeoutError(err) {
 function isDegradableEvaluateTimeoutError(err) {
   return isStageBudgetTimeoutError(err) || isProtocolEvaluateTimeoutError(err);
 }
-async function withRemainingBudget(work, remainingMs, label) {
+async function withRemainingBudget(work, remainingMs, label, timeoutError = () => new StageBudgetTimeoutError(label, Math.max(0, remainingMs))) {
   if (!(remainingMs > 0)) {
-    throw new StageBudgetTimeoutError(label, Math.max(0, remainingMs));
+    throw timeoutError();
   }
   let timer;
   try {
@@ -59,7 +59,7 @@ async function withRemainingBudget(work, remainingMs, label) {
       work,
       new Promise((_resolve, reject) => {
         timer = setTimeout(() => {
-          reject(new StageBudgetTimeoutError(label, remainingMs));
+          reject(timeoutError());
         }, remainingMs);
       })
     ]);

package/dist/{chunk-MMSCLNCJ.js → chunk-SYKPCN32.js}

@@ -9,7 +9,7 @@ import {
   parseStrictFiniteTimingNumber,
   resolveNaturalMediaTimelineDuration,
   resolveTimedImageDurationSeconds
-} from "./chunk-LGAKMIEX.js";
+} from "./chunk-QE7XLLGT.js";
 import {
   CANVAS_DIMENSIONS,
   isCompositionElement,
@@ -17,7 +17,7 @@ import {
   isTextElement,
   keyframesToGsapAnimations,
   serializeGsapAnimations
-} from "./chunk-ALLKNYC3.js";
+} from "./chunk-YMS5FOMC.js";
 import {
   COMPOSITION_ATTRIBUTES,
   parseStartExpression
@@ -120,6 +120,10 @@ function parseFpsWithDefault(input) {
     return { ok: true, value: { num: 30, den: 1 } };
   return parseFps(input);
 }
+var DISTRIBUTED_FPS = [24, 25, 30, 60];
+function isDistributedFps(value) {
+  return DISTRIBUTED_FPS.includes(value);
+}
 
 // ../core/dist/templates/base.js
 function generateBaseHtml(resolution = "portrait") {
@@ -5551,6 +5555,8 @@ export {
   fpsToFfmpegArg,
   parseFps,
   parseFpsWithDefault,
+  DISTRIBUTED_FPS,
+  isDistributedFps,
   generateBaseHtml,
   getStageStyles,
   gsapCdnDist,

package/dist/{chunk-TIZRYBKL.js → chunk-TW7H5CJO.js}

@@ -8,10 +8,10 @@ import {
   DEFAULT_VP9_CPU_USED,
   isHttpUrl,
   runFfmpeg
-} from "./chunk-BSXI5VWK.js";
+} from "./chunk-CAHSX6IW.js";
 import {
   parseAnimatedGifMetadata
-} from "./chunk-MMSCLNCJ.js";
+} from "./chunk-SYKPCN32.js";
 import {
   parseHTML
 } from "./chunk-SDYDNHEE.js";

package/dist/{chunk-FLTPIUGU.js → chunk-UWQL2MP4.js}

@@ -4,9 +4,16 @@ 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 {
+  sandboxDeniedRemediation
+} from "./chunk-2F7S7OK2.js";
 import {
   resolveCaptureBrowserGpuMode
-} from "./chunk-AL7XYJTK.js";
+} from "./chunk-DO3UPPO4.js";
+import {
+  isNavigationTimeoutError,
+  withRemainingBudget
+} from "./chunk-RGHQID2E.js";
 import {
   requestCliExit
 } from "./chunk-PBN6GBJE.js";
@@ -84,6 +91,9 @@ async function launchManagedBrowser(puppeteer, options) {
     browsers.add(browser);
     child.once("exit", () => browsers.delete(browser));
     return browser;
+  } catch (error) {
+    const remediation = sandboxDeniedRemediation(normalizeErrorMessage(error));
+    throw remediation ? new Error(remediation, { cause: error }) : error;
   } finally {
     pending.delete(launch);
   }
@@ -157,11 +167,99 @@ async function closeBrowser(browser) {
   }
 }
 
+// src/capture/navigateForCapture.ts
+import { TimeoutError } from "puppeteer-core";
+var NETWORK_IDLE_ATTEMPT_MS = 3e4;
+function networkIdleAttemptTimeoutMs(totalTimeoutMs) {
+  return Math.min(NETWORK_IDLE_ATTEMPT_MS, Math.max(0, totalTimeoutMs));
+}
+async function navigateForCapture(page, url, totalTimeoutMs) {
+  const networkIdleTimeoutMs = networkIdleAttemptTimeoutMs(totalTimeoutMs);
+  try {
+    const response2 = await page.goto(url, {
+      waitUntil: "networkidle2",
+      timeout: networkIdleTimeoutMs
+    });
+    return {
+      response: response2,
+      waitUntil: "networkidle2",
+      networkIdleTimeoutMs,
+      fellBackFromNetworkIdle: false
+    };
+  } catch (err) {
+    if (!isNavigationTimeoutError(err) || networkIdleTimeoutMs >= totalTimeoutMs) {
+      throw err;
+    }
+  }
+  const fallbackTimeoutMs = totalTimeoutMs - networkIdleTimeoutMs;
+  const response = await page.goto(url, {
+    waitUntil: "domcontentloaded",
+    timeout: fallbackTimeoutMs
+  });
+  return {
+    response,
+    waitUntil: "domcontentloaded",
+    networkIdleTimeoutMs,
+    fellBackFromNetworkIdle: true
+  };
+}
+var PUPPETEER_LAUNCH_DEFAULT_TIMEOUT_MS = 3e4;
+var SENT_OR_ANSWERED_WITHOUT_NETWORK = [
+  "Network.requestWillBeSentExtraInfo",
+  "Network.responseReceived"
+];
+async function gotoWhenSent(page, url, timeoutMs, coldChromeFirstRequestTimeoutMs = PUPPETEER_LAUNCH_DEFAULT_TIMEOUT_MS) {
+  const cdp = await page.createCDPSession();
+  try {
+    await cdp.send("Network.enable");
+    const sent = documentRequestSent(cdp);
+    const navigation = page.goto(url, { waitUntil: "domcontentloaded", timeout: 0 });
+    const navigationAwaitedBelow = navigation.catch(() => void 0);
+    await withRemainingBudget(
+      Promise.race([sent, navigationAwaitedBelow]),
+      coldChromeFirstRequestTimeoutMs,
+      "sending the page request",
+      () => new TimeoutError(
+        `Navigation timeout: Chrome did not send the page request within ${coldChromeFirstRequestTimeoutMs} ms`
+      )
+    );
+    return await withRemainingBudget(
+      navigation,
+      timeoutMs,
+      "loading the page",
+      () => new TimeoutError(`Navigation timeout of ${timeoutMs} ms exceeded`)
+    );
+  } finally {
+    await cdp.detach().catch(() => void 0);
+  }
+}
+function documentRequestSent(cdp) {
+  const documents = /* @__PURE__ */ new Set();
+  const sent = /* @__PURE__ */ new Set();
+  return new Promise((resolve) => {
+    const settle = (requestId) => {
+      if (documents.has(requestId) && sent.has(requestId)) resolve();
+    };
+    cdp.on("Network.requestWillBeSent", ({ requestId, type }) => {
+      if (type === "Document") documents.add(requestId);
+      settle(requestId);
+    });
+    for (const event of SENT_OR_ANSWERED_WITHOUT_NETWORK) {
+      cdp.on(event, ({ requestId }) => {
+        sent.add(requestId);
+        settle(requestId);
+      });
+    }
+  });
+}
+
 export {
   BrowserCleanupError,
   resolveManagedGpuMode,
   launchManagedBrowser,
   registerBrowserSessionCleanup,
   closeManagedBrowser,
-  rethrowAfterBrowserCleanup
+  rethrowAfterBrowserCleanup,
+  navigateForCapture,
+  gotoWhenSent
 };

package/dist/{chunk-TAANFVLO.js → chunk-VTBME36F.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   shouldTrack
-} from "./chunk-B4VG7PGX.js";
+} from "./chunk-YULVV525.js";
 
 // src/telemetry/renderObservability.ts
 function renderObservabilityTelemetryPayload(observability) {

package/dist/{chunk-25CSBTM2.js → chunk-XOODFU75.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   VERSION
-} from "./chunk-HTDDV7CM.js";
+} from "./chunk-BC2XZL6O.js";
 
 // src/registry/compatibility.ts
 import { compareVersions } from "compare-versions";

package/dist/{chunk-WPNE5NEP.js → chunk-XR3XDG7V.js}

@@ -4,6 +4,13 @@ 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 {
+  c
+} from "./chunk-ZTZA4UWZ.js";
+import {
+  DISTRIBUTED_FPS,
+  isDistributedFps
+} from "./chunk-SYKPCN32.js";
 import {
   parseHTML
 } from "./chunk-SDYDNHEE.js";
@@ -25,20 +32,27 @@ function readCompositionFps(html) {
   const raw = root?.getAttribute("data-fps")?.trim();
   return raw ? raw : null;
 }
-function readAllowedCompositionFpsFromDir(projectDir, allowed) {
+var DEFAULT_CLOUD_FPS = 30;
+function defaultCloudFps(projectDir) {
   let html;
   try {
     html = readFileSync(join(projectDir, "index.html"), "utf8");
   } catch {
-    return null;
+    return DEFAULT_CLOUD_FPS;
   }
   const raw = readCompositionFps(html);
-  if (raw == null) return null;
+  if (raw == null) return DEFAULT_CLOUD_FPS;
   const n = Number(raw);
-  return Number.isInteger(n) && allowed.includes(n) ? n : null;
+  if (isDistributedFps(n)) return n;
+  console.warn(
+    c.warn(
+      `The composition declares data-fps="${raw}", which cloud renders do not support (${DISTRIBUTED_FPS.join(", ")}). Rendering at ${DEFAULT_CLOUD_FPS} fps; pass --fps to choose.`
+    )
+  );
+  return DEFAULT_CLOUD_FPS;
 }
 
 export {
   readCompositionFps,
-  readAllowedCompositionFpsFromDir
+  defaultCloudFps
 };

package/dist/{chunk-ALLKNYC3.js → chunk-YMS5FOMC.js}

@@ -1106,7 +1106,14 @@ var CANVAS_DIMENSIONS = {
   "landscape-4k": { width: 3840, height: 2160 },
   "portrait-4k": { width: 2160, height: 3840 },
   square: { width: 1080, height: 1080 },
-  "square-4k": { width: 2160, height: 2160 }
+  "square-4k": { width: 2160, height: 2160 },
+  "landscape-720p": { width: 1280, height: 720 },
+  "portrait-720p": { width: 720, height: 1280 },
+  "square-720p": { width: 720, height: 720 },
+  // 480 tall at 16:9 is 853.33 wide: 854 keeps both sides even for 4:2:0 encoders.
+  "landscape-480p": { width: 854, height: 480 },
+  "portrait-480p": { width: 480, height: 854 },
+  "square-480p": { width: 480, height: 480 }
 };
 var VALID_CANVAS_RESOLUTIONS = Object.keys(
   CANVAS_DIMENSIONS
@@ -1121,13 +1128,21 @@ var RESOLUTION_ALIASES = {
   "4k-portrait": "portrait-4k",
   "1080p-square": "square",
   "square-1080p": "square",
-  "4k-square": "square-4k"
+  "4k-square": "square-4k",
+  "720p": "landscape-720p",
+  "720p-portrait": "portrait-720p",
+  "720p-square": "square-720p",
+  "480p": "landscape-480p",
+  "480p-portrait": "portrait-480p",
+  "480p-square": "square-480p"
 };
 var ASPECT_AGNOSTIC_RESOLUTION_ALIASES = /* @__PURE__ */ new Set([
   "1080p",
   "hd",
   "4k",
-  "uhd"
+  "uhd",
+  "720p",
+  "480p"
 ]);
 function normalizeResolutionFlag(input) {
   if (!input) return void 0;
@@ -4388,14 +4403,17 @@ function extractGsapScripts(doc) {
 }
 var OK = { ok: true };
 function suggestMatchingPreset(compositionWidth, compositionHeight, chosen) {
-  const aspectMatches = VALID_CANVAS_RESOLUTIONS.filter((preset) => {
-    const { width, height } = CANVAS_DIMENSIONS[preset];
-    return width * compositionHeight === height * compositionWidth;
-  });
+  const aspectMatches = VALID_CANVAS_RESOLUTIONS.filter(
+    (preset) => fitsAspect(CANVAS_DIMENSIONS[preset], compositionWidth, compositionHeight)
+  );
   if (aspectMatches.length === 0) return void 0;
-  const chosenIs4k = chosen.endsWith("-4k");
-  const sameTier = aspectMatches.find((preset) => preset.endsWith("-4k") === chosenIs4k);
-  return sameTier ?? aspectMatches[0];
+  return aspectMatches.find((preset) => tierOf(preset) === tierOf(chosen));
+}
+var tierOf = (preset) => preset.includes("-") ? preset.slice(preset.indexOf("-")) : "";
+function fitsAspect(target, compositionWidth, compositionHeight) {
+  const drift = Math.abs(target.width * compositionHeight - target.height * compositionWidth);
+  if (drift === 0) return true;
+  return target.width < compositionWidth && drift < Math.min(compositionWidth, compositionHeight);
 }
 function describeOrientation(width, height) {
   if (width > height) return "landscape";
@@ -4427,17 +4445,11 @@ function checkOutputResolutionCompatibility(input) {
     };
   }
   const target = CANVAS_DIMENSIONS[outputResolution];
-  if (target.width * compositionHeight !== target.height * compositionWidth) {
+  if (!fitsAspect(target, compositionWidth, compositionHeight)) {
     return buildAspectMismatch(compositionWidth, compositionHeight, outputResolution, target);
   }
   const widthRatio = target.width / compositionWidth;
-  if (widthRatio < 1) {
-    return {
-      ok: false,
-      kind: "downsampling",
-      message: `outputResolution ${outputResolution} (${target.width}\xD7${target.height}) is smaller than the composition (${compositionWidth}\xD7${compositionHeight}). Downsampling via --resolution is not supported.`
-    };
-  }
+  if (widthRatio < 1) return OK;
   if (!Number.isInteger(widthRatio)) {
     return {
       ok: false,
@@ -5000,6 +5012,7 @@ export {
   HTML_BODY_CSS_WIDTH_FIRST_RE,
   HTML_BODY_CSS_HEIGHT_FIRST_RE,
   VIEWPORT_META_SIZE_RE,
+  isSubCompositionHost,
   topLevelElements,
   trackKindOf,
   decodeUrlPathVariants,

package/dist/{chunk-V652CBKA.js → chunk-YTZA25TZ.js}

@@ -8,7 +8,7 @@ import {
   flush,
   shouldTrack,
   trackEvent
-} from "./chunk-B4VG7PGX.js";
+} from "./chunk-YULVV525.js";
 import {
   getPowerState
 } from "./chunk-QWQ6GQTI.js";

package/dist/{chunk-B4VG7PGX.js → chunk-YULVV525.js}

@@ -29,7 +29,7 @@ import {
 } from "./chunk-XUXGIA7H.js";
 import {
   VERSION
-} from "./chunk-HTDDV7CM.js";
+} from "./chunk-BC2XZL6O.js";
 import {
   CANARIES,
   canaryEnvVar,

package/dist/{clean-QWXJ5QJQ.js → clean-UPXYD6VX.js}

@@ -6,30 +6,30 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   redactHome
-} from "./chunk-BIOWX4AM.js";
+} from "./chunk-NT3WPYAU.js";
 import "./chunk-Z27A7NUB.js";
 import "./chunk-5ETJX6WM.js";
 import {
   loadProducer
-} from "./chunk-F67VJSSH.js";
+} from "./chunk-4WPRJ7ID.js";
 import {
   formatBytes
 } from "./chunk-K2FLNJVB.js";
-import "./chunk-A2DMF2Q6.js";
-import "./chunk-UKTXHF3Q.js";
-import "./chunk-OBZWOV4Q.js";
+import "./chunk-CDDIEZ4D.js";
+import "./chunk-4CIMRQQY.js";
 import "./chunk-6JR2XUEE.js";
 import "./chunk-C6TPGUWD.js";
 import {
   CACHE_DIR_NAME,
   cleanupProxyCache
-} from "./chunk-SZDHUSQ5.js";
+} from "./chunk-AQZZZTFL.js";
 import {
   DEFAULT_HISTORY_ROOT,
   listProjectHistories,
   pruneGoneProjectHistories
 } from "./chunk-JGYHWVXQ.js";
 import "./chunk-FFDC5OWV.js";
+import "./chunk-A2DMF2Q6.js";
 import "./chunk-5CS4T6C6.js";
 import "./chunk-QWQ6GQTI.js";
 import {
@@ -47,12 +47,12 @@ import "./chunk-TJSTGSAW.js";
 import "./chunk-XRKMITSS.js";
 import {
   withMeta
-} from "./chunk-ZIL7S3L6.js";
+} from "./chunk-O7BABHM4.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-HTDDV7CM.js";
+import "./chunk-BC2XZL6O.js";
 import "./chunk-3DKN5WKL.js";
 import "./chunk-EOVYQ3IG.js";
 import "./chunk-6BEFEWFB.js";
@@ -63,16 +63,16 @@ import {
   directorySizeBytes,
   gcExtractionCache,
   resolveExtractCacheDir
-} from "./chunk-BSXI5VWK.js";
-import "./chunk-KPPC3C4I.js";
+} from "./chunk-CAHSX6IW.js";
+import "./chunk-KDC5D5VM.js";
 import "./chunk-KCF6GHJP.js";
 import "./chunk-JYVGYKXG.js";
 import "./chunk-7KDQAD2W.js";
-import "./chunk-MMSCLNCJ.js";
-import "./chunk-LGAKMIEX.js";
+import "./chunk-SYKPCN32.js";
+import "./chunk-QE7XLLGT.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
-import "./chunk-ALLKNYC3.js";
+import "./chunk-YMS5FOMC.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
@@ -80,9 +80,9 @@ import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
 import "./chunk-D3ZWBHZP.js";
 import "./chunk-TWWSYAKJ.js";
-import "./chunk-2742O5DO.js";
+import "./chunk-PLWORQFC.js";
 import "./chunk-IWFLMU2N.js";
-import "./chunk-3VGU2SH7.js";
+import "./chunk-OYLO6TYK.js";
 import "./chunk-VAS6HQX3.js";
 import "./chunk-3RM2ETQT.js";
 import "./chunk-BSQ7XANM.js";