hyperframes 0.8.141 → 0.8.143

package/dist/{capture-TFZZSF6F.js → capture-26G2DPSI.js}

@@ -8,6 +8,10 @@ import {
   createCaptureWatchdog,
   runWithWatchdog
 } from "./chunk-UYEZTK4U.js";
+import {
+  CAPTURE_PHASE_SCHEMA,
+  DEFAULT_MAX_SCREENSHOTS
+} from "./chunk-P36MALQF.js";
 import {
   CAPTURE_USER_AGENT,
   downloadAndRewriteFonts,
@@ -17,7 +21,7 @@ import {
   noDrops,
   safeFetch,
   totalDrops
-} from "./chunk-3NBKW2QJ.js";
+} from "./chunk-PAGIICKN.js";
 import {
   captureProtocolTimeoutMs,
   isDegradableEvaluateTimeoutError,
@@ -35,8 +39,8 @@ import {
 } from "./chunk-3DKN5WKL.js";
 import {
   launchManagedBrowser
-} from "./chunk-O3SKIXQK.js";
-import "./chunk-J5IPIQU2.js";
+} from "./chunk-PJU63L6W.js";
+import "./chunk-QRKLPWEX.js";
 import {
   writeNewFileSync
 } from "./chunk-4YYJOFKS.js";
@@ -53,32 +57,32 @@ import {
 } from "./chunk-NGKM64BP.js";
 import "./chunk-IGLEPPTN.js";
 import "./chunk-PBN6GBJE.js";
-import "./chunk-E6SDW5FV.js";
-import "./chunk-35RSNI77.js";
-import "./chunk-A4KQZXZI.js";
+import "./chunk-33RZPZ4K.js";
+import "./chunk-F26LCYRY.js";
+import "./chunk-NE55C6S5.js";
 import "./chunk-USDEMXXL.js";
-import "./chunk-6E6CM7WS.js";
-import "./chunk-OZUQF4NB.js";
-import "./chunk-DPVXBVLL.js";
-import "./chunk-SYKKFAUW.js";
+import "./chunk-4M4EC7JX.js";
+import "./chunk-6TPZSTCL.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-YA62XGXS.js";
+import "./chunk-MQZVBHEY.js";
 import "./chunk-OFQWTKPW.js";
+import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
 import "./chunk-TWWSYAKJ.js";
-import "./chunk-WY5OODN5.js";
-import "./chunk-24OWOBQH.js";
-import "./chunk-JFKL3WAE.js";
-import "./chunk-HBBJFK6I.js";
+import "./chunk-XONFUK3M.js";
+import "./chunk-IWFLMU2N.js";
+import "./chunk-APDLWWFG.js";
 import "./chunk-PJ3HDUCY.js";
-import "./chunk-TQFG7HTI.js";
+import "./chunk-3RM2ETQT.js";
+import "./chunk-ZLW2V65P.js";
 import {
   parseHTML
-} from "./chunk-GK4AIFIH.js";
+} from "./chunk-SDYDNHEE.js";
 import "./chunk-2PSPARWP.js";
-import "./chunk-PMRBLBUP.js";
+import "./chunk-T42U2W2R.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";
@@ -688,9 +692,6 @@ async function generateProjectScaffold(outputDir, url, tokens, animationCatalog,
   }
 }
 
-// src/capture/types.ts
-var CAPTURE_PHASE_SCHEMA = "hyperframes.capture.phase.v1";
-
 // src/capture/browserLaunchArgs.ts
 function captureBrowserArgs(disableWebgl, viewportWidth, viewportHeight) {
   return [
@@ -3045,6 +3046,13 @@ async function runCoreExtraction(input) {
     downloadByteBudget,
     canWrite
   } = input;
+  const { maxScreenshots } = input;
+  let exhaustedPhase = remainingMs() <= 0 ? "navigation checks" : void 0;
+  const recordBudget = (phase) => {
+    if (exhaustedPhase === void 0 && remainingMs() <= 0) exhaustedPhase = phase;
+  };
+  const animationWarning = () => remainingMs() > 0 ? "animation catalog evaluate timed out; continuing without animation catalog" : "--capture-budget spent before the animation catalog finished; continuing without animation catalog";
+  let screenshotOutcome = { kind: "complete" };
   const runLazyAndLottie = async () => {
     if (!contentCheckTimedOut && pageContentCheck.textLength < 100) {
       const reason = "Page has very little text content (" + pageContentCheck.textLength + " chars) \u2014 may be blocked or a client-rendered SPA that needs more time";
@@ -3066,6 +3074,7 @@ async function runCoreExtraction(input) {
     await new Promise((r) => setTimeout(r, 300));
   };
   await runLazyAndLottie();
+  recordBudget("lazy scrolling");
   const runAnimationDiscovery = async () => {
     const scanDomLotties = async () => {
       try {
@@ -3124,6 +3133,7 @@ async function runCoreExtraction(input) {
     await saveDiscoveredLotties();
   };
   await runAnimationDiscovery();
+  recordBudget("animation discovery");
   const runShaderCapture = async () => {
     try {
       const shaders = await page1.evaluate(`window.__capturedShaders || []`);
@@ -3148,6 +3158,7 @@ async function runCoreExtraction(input) {
     }
   };
   await runShaderCapture();
+  recordBudget("shader capture");
   const runTokenExtraction = async () => {
     progress("tokens", "Extracting design tokens...");
     tokens = await extractTokens(page1);
@@ -3182,6 +3193,7 @@ ${err.stack}` : normalizeErrorMessage(err);
     }
   };
   await runTokenExtraction();
+  recordBudget("design token extraction");
   const runAnimationCapture = async () => {
     progress("animations", "Cataloging animations...");
     try {
@@ -3191,7 +3203,7 @@ ${err.stack}` : normalizeErrorMessage(err);
       });
       animationCatalog = animationOutcome.catalog;
       if (animationOutcome.timedOut) {
-        const message = "animation catalog evaluate timed out; continuing without animation catalog";
+        const message = animationWarning();
         warnings.push(message);
         progress("warn", message);
       }
@@ -3199,7 +3211,7 @@ ${err.stack}` : normalizeErrorMessage(err);
       if (!isDegradableEvaluateTimeoutError(err)) {
         throw err;
       }
-      const message = "animation catalog evaluate timed out; continuing without animation catalog";
+      const message = animationWarning();
       warnings.push(message);
       progress("warn", message);
       try {
@@ -3207,27 +3219,48 @@ ${err.stack}` : normalizeErrorMessage(err);
       } catch {
       }
     }
+    recordBudget("animation catalog");
+  };
+  await runAnimationCapture();
+  const runScreenshotCapture = async () => {
     progress("screenshots", "Capturing scroll screenshots...");
-    const { captureScrollScreenshots } = await import("./screenshotCapture-ECBTLCU6.js");
-    try {
-      if (!canWrite()) return;
-      screenshots = await captureScrollScreenshots(page1, outputDir, { remainingMs });
-      state.screenshots = screenshots;
-      progress("screenshots", `${screenshots.length} scroll screenshots captured`);
-    } catch (err) {
-      if (!isDegradableEvaluateTimeoutError(err)) {
-        throw err;
-      }
-      const message = "scroll screenshots timed out; continuing without screenshots";
+    const { captureScrollScreenshots } = await import("./screenshotCapture-TEUIWXWN.js");
+    if (!canWrite()) {
+      screenshotOutcome = {
+        kind: "failed",
+        reason: "deadline"
+      };
+      return;
+    }
+    screenshots = [];
+    state.screenshots = screenshots;
+    const capture = await captureScrollScreenshots(page1, outputDir, {
+      remainingMs,
+      maxScreenshots,
+      files: screenshots
+    });
+    if (capture.interruption || screenshots.length === 0) {
+      recordBudget("screenshots");
+      const { reason, message: detail } = capture.interruption ?? {
+        reason: "internal-error",
+        message: "screenshot capture produced no files"
+      };
+      const cause = reason === "budget-exhausted" ? `--capture-budget exhausted during ${exhaustedPhase}` : detail;
+      const message = `${screenshots.length}/${maxScreenshots} requested screenshot files captured: ${cause}`;
+      screenshotOutcome = {
+        kind: screenshots.length === 0 ? "failed" : "partial",
+        reason
+      };
       warnings.push(message);
       progress("warn", message);
     }
+    progress("screenshots", `${screenshots.length} scroll screenshots captured`);
   };
-  await runAnimationCapture();
+  await runScreenshotCapture();
   const runHtmlExtraction = async () => {
     progress("design", "Cataloging assets...");
     try {
-      const { catalogAssets } = await import("./assetCataloger-WGR4LYYN.js");
+      const { catalogAssets } = await import("./assetCataloger-FRO4G6OU.js");
       catalogedAssets = await catalogAssets(page1);
       progress("design", `${catalogedAssets.length} assets cataloged`);
       if (catalogedAssets.length === 0) {
@@ -3278,6 +3311,7 @@ ${err.stack}` : normalizeErrorMessage(err);
   };
   await runHtmlExtraction();
   return {
+    screenshotOutcome,
     animationCatalog,
     capturedShaders,
     catalogedAssets,
@@ -3799,7 +3833,7 @@ async function captureWebsiteAttempt(opts, onProgress, disableWebgl, watchdog, s
     viewportHeight = 1080,
     timeout = 12e4,
     settleTime = 3e3,
-    maxScreenshots: _maxScreenshots = 24,
+    maxScreenshots = DEFAULT_MAX_SCREENSHOTS,
     skipAssets = false,
     skipVision = false,
     postNavigationBudgetMs = DEFAULT_POST_NAVIGATION_BUDGET_MS,
@@ -3959,7 +3993,8 @@ async function captureWebsiteAttempt(opts, onProgress, disableWebgl, watchdog, s
       extracted,
       screenshots,
       downloadByteBudget,
-      canWrite
+      canWrite,
+      maxScreenshots
     });
     ({
       animationCatalog,
@@ -3972,7 +4007,9 @@ async function captureWebsiteAttempt(opts, onProgress, disableWebgl, watchdog, s
       extracted,
       screenshots
     } = coreResult);
-    phase("core-extraction", "completed");
+    const screenshotOutcome = coreResult.screenshotOutcome;
+    if (screenshotOutcome.kind === "complete") phase("core-extraction", "completed");
+    else phase("core-extraction", "degraded", screenshotOutcome.reason);
     const postResult = await runPostExtraction({
       state,
       outputDir,
@@ -4012,10 +4049,15 @@ async function captureWebsiteAttempt(opts, onProgress, disableWebgl, watchdog, s
       );
     }
     phase("scaffold", "completed");
-    progress("done", "Capture complete");
-    phase("complete", "completed");
+    progress(
+      "done",
+      screenshotOutcome.kind === "failed" ? "Capture failed: no screenshots captured" : "Capture complete"
+    );
+    if (screenshotOutcome.kind === "failed")
+      phase("complete", "degraded", screenshotOutcome.reason);
+    else phase("complete", "completed");
     return {
-      ok: true,
+      ok: screenshotOutcome.kind !== "failed",
       projectDir: outputDir,
       url,
       httpStatus,

package/dist/{capture-XD3P3YQR.js → capture-OGQAEYKO.js}

@@ -7,6 +7,9 @@ var __dirname = __hf_dirname(__filename);
 import {
   parseCaptureDeadline
 } from "./chunk-UYEZTK4U.js";
+import {
+  DEFAULT_MAX_SCREENSHOTS
+} from "./chunk-P36MALQF.js";
 import {
   diag
 } from "./chunk-VWG7OQKU.js";
@@ -27,11 +30,11 @@ var CAPTURE_PHASE_PREFIX = "HYPERFRAMES_CAPTURE_PHASE ";
 function emitCapturePhase(event) {
   diag.notice(`${CAPTURE_PHASE_PREFIX}${JSON.stringify(event)}`);
 }
-function parseCaptureBudget(raw) {
+function parsePositiveInteger(raw, flag, unit = "") {
   if (raw === void 0) return void 0;
   const parsed = Number(raw);
   if (!Number.isInteger(parsed) || parsed <= 0) {
-    console.error("--capture-budget must be a positive integer in milliseconds.");
+    console.error(`${flag} must be a positive integer${unit}.`);
     failCommand();
   }
   return parsed;
@@ -77,7 +80,7 @@ var capture_default = defineCommand({
     },
     "max-screenshots": {
       type: "string",
-      description: "Maximum screenshots to capture (default: 24)"
+      description: `Maximum page-capture files including the full-page plate, excluding derived contact sheets (default: ${DEFAULT_MAX_SCREENSHOTS})`
     },
     timeout: {
       type: "string",
@@ -113,7 +116,7 @@ var capture_default = defineCommand({
   // fallow-ignore-next-line complexity
   async run({ args }) {
     if (args.video) {
-      const { runVideoMode } = await import("./video-RVGYEFQU.js");
+      const { runVideoMode } = await import("./video-SJDMTSTL.js");
       await runVideoMode({
         project: args.video,
         index: args.index ?? null,
@@ -135,7 +138,15 @@ var capture_default = defineCommand({
       console.error(`Invalid URL: ${url}`);
       failCommand();
     }
-    const captureBudgetMs = parseCaptureBudget(args["capture-budget"]);
+    const captureBudgetMs = parsePositiveInteger(
+      args["capture-budget"],
+      "--capture-budget",
+      " in milliseconds"
+    );
+    const maxScreenshots = parsePositiveInteger(
+      args["max-screenshots"],
+      "--max-screenshots"
+    );
     const isDefaultOutput = !args.output;
     let outputName = args.output ?? "capture";
     let outputDir = resolve(outputName);
@@ -162,7 +173,8 @@ var capture_default = defineCommand({
       }
       console.log();
     }
-    const { captureWebsite } = await import("./capture-TFZZSF6F.js");
+    const { captureWebsite } = await import("./capture-26G2DPSI.js");
+    let captureFailed = false;
     try {
       const result = await captureWebsite(
         {
@@ -170,7 +182,7 @@ var capture_default = defineCommand({
           outputDir,
           skipAssets: args["skip-assets"],
           skipVision: args["skip-vision"],
-          maxScreenshots: args["max-screenshots"] ? parseInt(args["max-screenshots"]) : void 0,
+          maxScreenshots,
           timeout: args.timeout ? parseInt(args.timeout) : void 0,
           postNavigationBudgetMs: captureBudgetMs,
           captureDeadlineMs: parseCaptureDeadline(process.env.HYPERFRAMES_CAPTURE_DEADLINE_MS),
@@ -192,6 +204,7 @@ var capture_default = defineCommand({
           console.log(detail ? `${label} ${detail}` : label);
         }
       );
+      captureFailed = !result.ok;
       if (isJson) {
         console.log(
           JSON.stringify(
@@ -220,7 +233,9 @@ var capture_default = defineCommand({
       } else {
         const { c } = await import("./colors-HKWSZCGK.js");
         console.log();
-        console.log(c.success("\u25C7") + `  Captured ${c.bold(result.title)} \u2192 ${c.dim(outputDir)}`);
+        const icon = result.ok ? c.success("\u25C7") : c.error("\u2717");
+        const status = result.ok ? "Captured" : "Capture failed";
+        console.log(icon + `  ${status} ${c.bold(result.title)} \u2192 ${c.dim(outputDir)}`);
         console.log();
         console.log(`  ${c.dim("Screenshots:")} ${result.screenshots.length}`);
         console.log(`  ${c.dim("Assets:")} ${result.assets.length}`);
@@ -282,6 +297,7 @@ URL: ${url}
       }
       failCommand();
     }
+    if (captureFailed) failCommand();
   }
 });
 export {

package/dist/{catalog-4S33QWJJ.js → catalog-RKORTIUE.js}

@@ -11,30 +11,30 @@ import {
 } from "./chunk-3DKN5WKL.js";
 import {
   runAdd
-} from "./chunk-OLDDJS3S.js";
-import "./chunk-XWVGSEUT.js";
+} from "./chunk-I7QGQAZM.js";
+import "./chunk-KO5QBV73.js";
 import {
   DEFAULT_PROJECT_CONFIG,
   loadProjectConfig
-} from "./chunk-AVWEIOEN.js";
+} from "./chunk-2LBBHMKT.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
 import "./chunk-6BEFEWFB.js";
 import {
   loadAllItems
-} from "./chunk-IKVBTDLO.js";
-import "./chunk-L3JSAB4L.js";
+} from "./chunk-HW4AKJ5F.js";
+import "./chunk-CLOH4LIB.js";
 import {
   fetchRegistryManifest
-} from "./chunk-Q65ZQFF2.js";
+} from "./chunk-TAMQYQGJ.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import {
   downloadFile
-} from "./chunk-WCJGTLPF.js";
-import "./chunk-7XTZVLE6.js";
-import "./chunk-RCFCZT5O.js";
+} from "./chunk-BHVFTYSI.js";
+import "./chunk-QFN7NVWM.js";
+import "./chunk-OSSHSIMD.js";
 import "./chunk-VWG7OQKU.js";
 import "./chunk-GQJZORQP.js";
 import "./chunk-AMKC3AXA.js";
@@ -53,23 +53,24 @@ import {
   finishCommand
 } from "./chunk-PBN6GBJE.js";
 import "./chunk-USDEMXXL.js";
-import "./chunk-6E6CM7WS.js";
-import "./chunk-OZUQF4NB.js";
-import "./chunk-DPVXBVLL.js";
-import "./chunk-SYKKFAUW.js";
+import "./chunk-4M4EC7JX.js";
+import "./chunk-6TPZSTCL.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-YA62XGXS.js";
+import "./chunk-MQZVBHEY.js";
 import {
   realpath
 } from "./chunk-OFQWTKPW.js";
+import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-HBBJFK6I.js";
-import "./chunk-TQFG7HTI.js";
-import "./chunk-GK4AIFIH.js";
+import "./chunk-APDLWWFG.js";
+import "./chunk-3RM2ETQT.js";
+import "./chunk-ZLW2V65P.js";
+import "./chunk-SDYDNHEE.js";
 import "./chunk-2PSPARWP.js";
-import "./chunk-PMRBLBUP.js";
+import "./chunk-T42U2W2R.js";
 import "./chunk-K4WIOZFP.js";
 import {
   readConfig,
@@ -79,7 +80,7 @@ import {
   isAttendedTerminal
 } from "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-W6HTOVHU.js";
+import "./chunk-W35EKBS6.js";
 import "./chunk-KNU5COPB.js";
 import {
   c

package/dist/{catch-up-RW7YXXNT.js → catch-up-4OBERRQO.js}

@@ -6,8 +6,8 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   resolveProject
-} from "./chunk-TC2FBZJZ.js";
-import "./chunk-IHFUKJOR.js";
+} from "./chunk-VIVBA6E6.js";
+import "./chunk-K2FLNJVB.js";
 import {
   filesChangedSince,
   markSeen,
@@ -15,8 +15,8 @@ import {
   unseenTurns
 } from "./chunk-DCAI5DBR.js";
 import "./chunk-EOVYQ3IG.js";
-import "./chunk-7XTZVLE6.js";
-import "./chunk-RCFCZT5O.js";
+import "./chunk-QFN7NVWM.js";
+import "./chunk-OSSHSIMD.js";
 import "./chunk-VWG7OQKU.js";
 import "./chunk-GQJZORQP.js";
 import "./chunk-AMKC3AXA.js";
@@ -33,7 +33,7 @@ import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-W6HTOVHU.js";
+import "./chunk-W35EKBS6.js";
 import "./chunk-KNU5COPB.js";
 import {
   c