hyperframes 0.8.141 → 0.8.143

package/dist/{render-75E342ZU.js → render-3CVZ2SZG.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   warnOnDimensionMismatch
-} from "./chunk-THXFSPLV.js";
+} from "./chunk-ZIRIDSDB.js";
 import {
   requireStack,
   stateFilePath
@@ -15,27 +15,28 @@ import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-BM5PX3DJ.js";
-import "./chunk-5Z63TBTX.js";
-import "./chunk-IHFUKJOR.js";
-import "./chunk-PFCFR3KZ.js";
+} from "./chunk-LW6HO6U3.js";
+import "./chunk-FH7WODJH.js";
+import "./chunk-K2FLNJVB.js";
+import "./chunk-442JNXRM.js";
 import {
   setCommandExitCode
 } from "./chunk-PBN6GBJE.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-TQFG7HTI.js";
-import "./chunk-GK4AIFIH.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 {
   c
 } from "./chunk-ZTZA4UWZ.js";

package/dist/{render-S73DW4KK.js → render-K25YOG3M.js}

@@ -8,7 +8,7 @@ import {
   parseEnumFlag,
   parseIntFlag,
   parseNumericFlag
-} from "./chunk-RVCWIIZ7.js";
+} from "./chunk-GV5R5B7Q.js";
 import {
   colorStatus
 } from "./chunk-U7CZBDMV.js";
@@ -20,34 +20,34 @@ import {
   createCloudClient,
   pollUntilTerminal,
   reportApiError
-} from "./chunk-HKCNZITN.js";
+} from "./chunk-4OA4LDTU.js";
 import {
   downloadToFile
 } from "./chunk-BXCMXMJQ.js";
 import {
   buildPublishFileMap,
   zipPublishFileMap
-} from "./chunk-EDYBFSPE.js";
-import "./chunk-XTFJOR3K.js";
-import "./chunk-BRITLL56.js";
-import "./chunk-246MOR5U.js";
+} from "./chunk-OBXQRJWQ.js";
+import "./chunk-4SFGME7K.js";
+import "./chunk-B4P5VDFQ.js";
+import "./chunk-DKSDVDXG.js";
 import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-BM5PX3DJ.js";
+} from "./chunk-LW6HO6U3.js";
 import {
   resolveProject
-} from "./chunk-TC2FBZJZ.js";
+} from "./chunk-VIVBA6E6.js";
 import {
   errorBox,
   formatBytes,
   formatDuration
-} from "./chunk-IHFUKJOR.js";
+} from "./chunk-K2FLNJVB.js";
 import "./chunk-EOVYQ3IG.js";
-import "./chunk-PFCFR3KZ.js";
-import "./chunk-7XTZVLE6.js";
-import "./chunk-RCFCZT5O.js";
+import "./chunk-442JNXRM.js";
+import "./chunk-QFN7NVWM.js";
+import "./chunk-OSSHSIMD.js";
 import "./chunk-VWG7OQKU.js";
 import "./chunk-GQJZORQP.js";
 import "./chunk-AMKC3AXA.js";
@@ -59,28 +59,29 @@ import {
   failCommand
 } 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 "./chunk-OFQWTKPW.js";
+import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-TQFG7HTI.js";
-import "./chunk-GK4AIFIH.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 {
   withMeta
-} from "./chunk-IYFKBFTW.js";
+} from "./chunk-Y6QL2LGO.js";
 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 {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";

package/dist/{render-2DVYTVLQ.js → render-TSE75QUL.js}

@@ -6,21 +6,21 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   maybePromptRenderFeedback
-} from "./chunk-6IFXWJDX.js";
+} from "./chunk-3NE7ZYU2.js";
 import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-BM5PX3DJ.js";
+} from "./chunk-LW6HO6U3.js";
 import {
   loadProducer
-} from "./chunk-N77KD7ZZ.js";
+} from "./chunk-QVYVUCWD.js";
 import {
   formatLintStartupMessage
 } from "./chunk-6CSYCFQV.js";
 import {
   resolveProject
-} from "./chunk-TC2FBZJZ.js";
+} from "./chunk-VIVBA6E6.js";
 import {
   renderJobObservabilityTelemetryPayload
 } from "./chunk-VXVRPIJA.js";
@@ -32,8 +32,8 @@ import {
   resolveCompositionEntryArg,
   resolveDefaultFpsArg,
   windowsChromeCrashRemediation
-} from "./chunk-EKA4ZZBI.js";
-import "./chunk-YEIFI443.js";
+} from "./chunk-P7THMINS.js";
+import "./chunk-WPNE5NEP.js";
 import {
   desktopHint
 } from "./chunk-EDUBJPGL.js";
@@ -44,29 +44,29 @@ import {
   formatRenderSummaryDetail,
   formatScreenshotFallbackHint,
   resolvePrintedCaptureMode
-} from "./chunk-IHFUKJOR.js";
+} from "./chunk-K2FLNJVB.js";
 import "./chunk-DCAI5DBR.js";
 import "./chunk-EOVYQ3IG.js";
 import {
   runEnvironmentChecks
 } from "./chunk-KOEWEFHK.js";
-import "./chunk-PFCFR3KZ.js";
+import "./chunk-442JNXRM.js";
 import {
   createRenderCancellationScope
-} from "./chunk-3A5AAPMP.js";
+} from "./chunk-UICWP23D.js";
 import {
   loadProjectConfig,
   readProjectConfigWithStatus,
   seedProjectAuthoringSkill
-} from "./chunk-AVWEIOEN.js";
+} from "./chunk-2LBBHMKT.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import {
   normalizeSkillSlug
 } from "./chunk-HVW7ABXD.js";
-import "./chunk-IKVBTDLO.js";
-import "./chunk-L3JSAB4L.js";
-import "./chunk-Q65ZQFF2.js";
+import "./chunk-HW4AKJ5F.js";
+import "./chunk-CLOH4LIB.js";
+import "./chunk-TAMQYQGJ.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import {
@@ -82,8 +82,8 @@ import {
   trackRenderError,
   trackRenderObservation,
   trackRenderPreflightRejected
-} from "./chunk-7XTZVLE6.js";
-import "./chunk-RCFCZT5O.js";
+} from "./chunk-QFN7NVWM.js";
+import "./chunk-OSSHSIMD.js";
 import "./chunk-VWG7OQKU.js";
 import {
   bytesToMb
@@ -110,27 +110,27 @@ import {
   MAX_VP9_CPU_USED,
   MIN_VP9_CPU_USED,
   isVideoFrameFormat
-} from "./chunk-E6SDW5FV.js";
-import "./chunk-35RSNI77.js";
-import "./chunk-A4KQZXZI.js";
+} from "./chunk-33RZPZ4K.js";
+import "./chunk-F26LCYRY.js";
+import "./chunk-NE55C6S5.js";
 import "./chunk-USDEMXXL.js";
 import {
   formatRenderOutputTimestamp,
   fpsToFfmpegArg,
   fpsToNumber,
   parseFps
-} from "./chunk-6E6CM7WS.js";
+} from "./chunk-4M4EC7JX.js";
+import "./chunk-6TPZSTCL.js";
+import "./chunk-VC76R6W2.js";
+import "./chunk-YA62XGXS.js";
 import {
   checkOutputResolutionCompatibility,
   isAspectAgnosticResolutionAlias,
   normalizeResolutionFlag,
   suggestMatchingPreset
-} from "./chunk-OZUQF4NB.js";
-import "./chunk-DPVXBVLL.js";
-import "./chunk-SYKKFAUW.js";
-import "./chunk-VC76R6W2.js";
-import "./chunk-YA62XGXS.js";
+} from "./chunk-MQZVBHEY.js";
 import "./chunk-OFQWTKPW.js";
+import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
@@ -148,17 +148,17 @@ import "./chunk-TWWSYAKJ.js";
 import {
   lintProject,
   shouldBlockRender
-} from "./chunk-WY5OODN5.js";
-import "./chunk-24OWOBQH.js";
+} from "./chunk-XONFUK3M.js";
 import {
   collectSubCompositionSrcs
-} from "./chunk-JFKL3WAE.js";
-import "./chunk-HBBJFK6I.js";
+} from "./chunk-IWFLMU2N.js";
+import "./chunk-APDLWWFG.js";
 import "./chunk-PJ3HDUCY.js";
-import "./chunk-TQFG7HTI.js";
-import "./chunk-GK4AIFIH.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 {
   readConfigFresh,
@@ -172,7 +172,7 @@ import {
 } from "./chunk-ISN5GRYI.js";
 import {
   VERSION
-} from "./chunk-W6HTOVHU.js";
+} from "./chunk-W35EKBS6.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";
@@ -646,7 +646,7 @@ function formatGpuModes(plan) {
 }
 async function warnForSlideshow(plan) {
   try {
-    const { slideshowIslandRegex } = await import("./slideshow-EJ4IMY6P.js");
+    const { slideshowIslandRegex } = await import("./slideshow-4OJEPWNZ.js");
     if (!slideshowIslandRegex("i").test(readFileSync2(plan.renderTarget, "utf8"))) return;
     console.log(
       c.warn("\u26A0") + "  This composition carries a slideshow island \u2014 `render` captures only the first scene, so the MP4 will be truncated to slide 1. Use " + c.accent("hyperframes present") + " for the deck; a linear main-line MP4 export is not yet available."
@@ -671,7 +671,7 @@ async function executeRenderPlan(plan, dependencies, cancellation) {
   let batchModule;
   let preparedBatch;
   if (plan.batchPath) {
-    batchModule = await import("./batchRender-GOLLOE4V.js");
+    batchModule = await import("./batchRender-4U73BYTU.js");
     try {
       preparedBatch = batchModule.prepareBatchRender({
         batchPath: plan.batchPath,
@@ -1461,7 +1461,7 @@ var render_default = defineCommand({
 });
 async function readCompositionDimensions(compositionHtml) {
   try {
-    const { ensureDOMParser } = await import("./dom-IROKGVJI.js");
+    const { ensureDOMParser } = await import("./dom-37K6YOH4.js");
     ensureDOMParser();
     const doc = new DOMParser().parseFromString(compositionHtml, "text/html");
     const rootEl = doc.querySelector("[data-composition-id]");

package/dist/{render-batch-YURBS54Q.js → render-batch-GGUOK3DS.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   warnOnDimensionMismatch
-} from "./chunk-THXFSPLV.js";
+} from "./chunk-ZIRIDSDB.js";
 import {
   requireStack
 } from "./chunk-H4YZZ2VQ.js";
@@ -14,30 +14,31 @@ import {
   loadProjectVariableSchema,
   reportVariableIssues,
   validateVariablesAgainstSchema
-} from "./chunk-BM5PX3DJ.js";
-import "./chunk-5Z63TBTX.js";
+} from "./chunk-LW6HO6U3.js";
+import "./chunk-FH7WODJH.js";
 import {
   errorBox
-} from "./chunk-IHFUKJOR.js";
-import "./chunk-PFCFR3KZ.js";
+} from "./chunk-K2FLNJVB.js";
+import "./chunk-442JNXRM.js";
 import {
   failCommand,
   setCommandExitCode
 } from "./chunk-PBN6GBJE.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-TQFG7HTI.js";
-import "./chunk-GK4AIFIH.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 {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";

package/dist/{renderCancellation-373ASJTO.js → renderCancellation-PZRWB53I.js}

@@ -7,33 +7,33 @@ var __dirname = __hf_dirname(__filename);
 import {
   createRenderCancellationScope,
   stoppedByCancelSignal
-} from "./chunk-3A5AAPMP.js";
-import "./chunk-E6SDW5FV.js";
-import "./chunk-35RSNI77.js";
-import "./chunk-A4KQZXZI.js";
+} from "./chunk-UICWP23D.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-LAOCA3MQ.js";
 import "./chunk-LCSMOLGX.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-GK4AIFIH.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-3GXQPCJC.js";
 import "./chunk-M2WBOQ2Q.js";
 export {

package/dist/renderSetupWorker.js

@@ -16,15 +16,15 @@ import "./chunk-LCSMOLGX.js";
 import "./chunk-TWWSYAKJ.js";
 import {
   lintProject
-} from "./chunk-WY5OODN5.js";
-import "./chunk-24OWOBQH.js";
-import "./chunk-JFKL3WAE.js";
-import "./chunk-HBBJFK6I.js";
+} from "./chunk-XONFUK3M.js";
+import "./chunk-IWFLMU2N.js";
+import "./chunk-APDLWWFG.js";
 import "./chunk-PJ3HDUCY.js";
-import "./chunk-TQFG7HTI.js";
-import "./chunk-GK4AIFIH.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-KNU5COPB.js";
 import "./chunk-M2WBOQ2Q.js";
 

package/dist/{resolver-FE3GBZ4T.js → resolver-S5VK6UCB.js}

@@ -11,25 +11,26 @@ import {
   resolveItemWithDependencies,
   resolveItemsByTag,
   unreachableRegistryMessage
-} from "./chunk-IKVBTDLO.js";
-import "./chunk-Q65ZQFF2.js";
+} from "./chunk-HW4AKJ5F.js";
+import "./chunk-TAMQYQGJ.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.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-TQFG7HTI.js";
-import "./chunk-GK4AIFIH.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-M2WBOQ2Q.js";
 export {
   listRegistryItems,

package/dist/{screenshotCapture-ECBTLCU6.js → screenshotCapture-TEUIWXWN.js}

@@ -4,13 +4,20 @@ 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 {
+  DEFAULT_MAX_SCREENSHOTS
+} from "./chunk-P36MALQF.js";
 import {
   isDegradableEvaluateTimeoutError
 } from "./chunk-AWNBM3MZ.js";
 import {
+  CaptureDirRefusedError,
   ensureCaptureDirSync,
   writeCaptureFileSync
 } from "./chunk-MRF4AMKD.js";
+import {
+  normalizeErrorMessage
+} from "./chunk-KNU5COPB.js";
 import "./chunk-M2WBOQ2Q.js";
 
 // src/capture/screenshotCapture.ts
@@ -35,13 +42,15 @@ async function captureFullPagePlate(page, screenshotsDir, budget = {}) {
     const docHeight = await page.evaluate(
       `Math.max(document.body.scrollHeight, document.documentElement.scrollHeight)`
     );
-    if (docHeight > MAX_PLATE_HEIGHT_PX) return null;
-    if ((budget.remainingMs?.() ?? 1) <= 0) return null;
+    if (docHeight > MAX_PLATE_HEIGHT_PX) return { kind: "omitted", reason: "height-limit" };
+    if ((budget.remainingMs?.() ?? 1) <= 0) return { kind: "omitted", reason: "budget-exhausted" };
     const buffer = await page.screenshot({ type: "png", fullPage: true });
     const produced = pngHeight(buffer);
-    if (produced != null && produced > MAX_PLATE_HEIGHT_PX) return null;
+    if (produced != null && produced > MAX_PLATE_HEIGHT_PX)
+      return { kind: "omitted", reason: "height-limit" };
     writeCaptureFileSync(join(screenshotsDir, "full-page.png"), buffer);
-    return "screenshots/full-page.png";
+    budget.files?.push("screenshots/full-page.png");
+    return { kind: "captured", file: "screenshots/full-page.png" };
   } finally {
     try {
       await page.evaluate(
@@ -57,9 +66,21 @@ async function captureFullPagePlate(page, screenshotsDir, budget = {}) {
 async function captureScrollScreenshots(page, outputDir, budget = {}) {
   const screenshotsDir = join(outputDir, "screenshots");
   ensureCaptureDirSync(outputDir, screenshotsDir);
-  const MAX_SCREENSHOTS = 20;
-  const filePaths = [];
-  if ((budget.remainingMs?.() ?? 1) <= 0) return filePaths;
+  const maxScreenshots = budget.maxScreenshots ?? DEFAULT_MAX_SCREENSHOTS;
+  const viewportLimit = Math.max(1, maxScreenshots - 1);
+  const filePaths = budget.files ?? [];
+  filePaths.length = 0;
+  const filenames = /* @__PURE__ */ new Set();
+  const result = { files: filePaths, interruption: null };
+  const budgetSpent = () => {
+    if ((budget.remainingMs?.() ?? 1) > 0) return false;
+    result.interruption = {
+      reason: "budget-exhausted",
+      message: "post-navigation budget exhausted during screenshots"
+    };
+    return true;
+  };
+  if (budgetSpent()) return result;
   try {
     await page.evaluate(() => {
       const selectors = [
@@ -126,50 +147,49 @@ async function captureScrollScreenshots(page, outputDir, budget = {}) {
       `Math.max(document.body.scrollHeight, document.documentElement.scrollHeight)`
     );
     const viewportHeight = await page.evaluate(`window.innerHeight`);
-    const step = Math.floor(viewportHeight * 0.7);
-    const positions = [0];
-    for (let y = step; y < scrollHeight - viewportHeight; y += step) {
-      positions.push(y);
-    }
+    const step = Math.max(1, Math.floor(viewportHeight * 0.7));
     const lastPos = Math.max(0, scrollHeight - viewportHeight);
-    if (positions[positions.length - 1] !== lastPos) {
-      positions.push(lastPos);
-    }
-    let finalPositions = positions;
-    if (positions.length > MAX_SCREENSHOTS) {
-      finalPositions = [positions[0]];
-      const stride = (positions.length - 1) / (MAX_SCREENSHOTS - 1);
-      for (let i = 1; i < MAX_SCREENSHOTS - 1; i++) {
-        finalPositions.push(positions[Math.round(i * stride)]);
-      }
-      finalPositions.push(positions[positions.length - 1]);
+    const positionCount = Math.ceil(lastPos / step) + 1;
+    const count = Math.min(viewportLimit, positionCount);
+    const finalPositions = [];
+    for (let i = 0; i < count; i++) {
+      const positionIndex = count === 1 ? 0 : Math.round(i * (positionCount - 1) / (count - 1));
+      finalPositions.push(Math.min(positionIndex * step, lastPos));
     }
     for (let i = 0; i < finalPositions.length; i++) {
-      if ((budget.remainingMs?.() ?? 1) <= 0) break;
+      if (budgetSpent()) break;
       await page.evaluate(`window.scrollTo(0, ${finalPositions[i]})`);
       await new Promise((r) => setTimeout(r, 400));
       const pct = Math.round(
         finalPositions[i] / Math.max(1, scrollHeight - viewportHeight) * 100
       );
-      const filename = `scroll-${String(Math.min(pct, 100)).padStart(3, "0")}.png`;
+      const stem = `scroll-${String(Math.min(pct, 100)).padStart(3, "0")}`;
+      let filename = `${stem}.png`;
+      if (filenames.has(filename)) filename = `${stem}-${i}.png`;
+      filenames.add(filename);
       const filePath = join(screenshotsDir, filename);
-      if ((budget.remainingMs?.() ?? 1) <= 0) break;
+      if (budgetSpent()) break;
       const buffer = await page.screenshot({ type: "png" });
       writeCaptureFileSync(filePath, buffer);
       filePaths.push(`screenshots/${filename}`);
     }
     await page.evaluate(`window.scrollTo(0, 0)`);
     await new Promise((r) => setTimeout(r, 200));
-    if ((budget.remainingMs?.() ?? 1) > 0) {
-      const plate = await captureFullPagePlate(page, screenshotsDir, budget);
-      if (plate) filePaths.push(plate);
+    if (filePaths.length < maxScreenshots && !budgetSpent()) {
+      const plate = await captureFullPagePlate(page, screenshotsDir, {
+        ...budget,
+        files: filePaths
+      });
+      if (plate.kind === "omitted" && plate.reason === "budget-exhausted") budgetSpent();
     }
   } catch (err) {
-    if (isDegradableEvaluateTimeoutError(err)) {
-      throw err;
-    }
+    if (err instanceof CaptureDirRefusedError) throw err;
+    result.interruption = {
+      reason: isDegradableEvaluateTimeoutError(err) ? "request-timeout" : "internal-error",
+      message: normalizeErrorMessage(err)
+    };
   }
-  return filePaths;
+  return result;
 }
 export {
   MAX_PLATE_HEIGHT_PX,