@riddledc/riddle-proof 0.7.138 → 0.7.139

package/README.md

@@ -482,6 +482,12 @@ and `click_count_value_total`.
 profile carries its own hosted Riddle worker budget; an explicit CLI `--timeout`
 still overrides the profile value for one-off runs.
 
+Profile final viewport screenshots are full-page by default. Set
+`target.screenshot_full_page: false`, `target.screenshotFullPage: false`, or
+`target.screenshot_mode: "viewport"` when the automatic final screenshots
+should capture only the current viewport, for example when fixed or sticky
+headers make full-page captures misleading.
+
 Use `allowed_console_patterns` / `allowed_console_texts` on
 `no_fatal_console_errors` when a negative-path profile intentionally triggers a
 known browser console error, such as a mocked `503` that the app recovers from:

package/dist/{chunk-N75EAJNG.js → chunk-DB6J53V5.js}

@@ -875,6 +875,42 @@ function normalizeSetupActions(value) {
   if (!Array.isArray(value)) throw new Error("target.setup_actions must be an array.");
   return value.map(normalizeSetupAction);
 }
+function normalizeTargetScreenshotFullPage(input) {
+  const directFullPage = booleanValue(valueFromOwn(
+    input,
+    "screenshot_full_page",
+    "screenshotFullPage",
+    "final_screenshot_full_page",
+    "finalScreenshotFullPage",
+    "full_page_screenshots",
+    "fullPageScreenshots"
+  ));
+  const viewportOnly = booleanValue(valueFromOwn(
+    input,
+    "viewport_screenshots",
+    "viewportScreenshots",
+    "viewport_only_screenshots",
+    "viewportOnlyScreenshots"
+  ));
+  const modeInput = stringFromOwn(input, "screenshot_mode", "screenshotMode", "final_screenshot_mode", "finalScreenshotMode");
+  let modeFullPage;
+  if (modeInput) {
+    const mode = modeInput.trim().toLowerCase().replace(/[-\s]+/g, "_");
+    if (mode === "full_page" || mode === "fullpage" || mode === "page" || mode === "document") {
+      modeFullPage = true;
+    } else if (mode === "viewport" || mode === "view") {
+      modeFullPage = false;
+    } else {
+      throw new Error(`target.screenshot_mode ${modeInput} is not supported. Supported modes: full_page, viewport.`);
+    }
+  }
+  const values = [directFullPage, viewportOnly === void 0 ? void 0 : !viewportOnly, modeFullPage].filter((value) => value !== void 0);
+  if (!values.length) return void 0;
+  if (values.some((value) => value !== values[0])) {
+    throw new Error("target has conflicting screenshot full_page / viewport mode options.");
+  }
+  return values[0];
+}
 function normalizeNetworkMock(input, index) {
   if (!isRecord(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
   const url = stringValue(input.url) || stringValue(input.glob) || stringValue(input.pattern);
@@ -1443,6 +1479,7 @@ function normalizeRiddleProofProfile(input, options = {}) {
       timeout_sec: timeoutSecValue(targetInput.timeout_sec) ?? timeoutSecValue(targetInput.timeoutSec) ?? timeoutSecValue(targetInput.riddle_timeout_sec) ?? timeoutSecValue(targetInput.riddleTimeoutSec),
       wait_for_selector: stringValue(targetInput.wait_for_selector) || stringValue(targetInput.waitForSelector),
       wait_ms: numberValue(targetInput.wait_ms) ?? numberValue(targetInput.waitMs),
+      screenshot_full_page: normalizeTargetScreenshotFullPage(targetInput),
       setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions),
       network_mocks: normalizeNetworkMocks(targetInput.network_mocks ?? targetInput.networkMocks)
     },
@@ -6890,7 +6927,9 @@ async function captureViewport(viewport) {
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
   try {
-    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel);
+    const screenshotOptions = {};
+    if (profile.target && profile.target.screenshot_full_page !== undefined) screenshotOptions.fullPage = profile.target.screenshot_full_page !== false;
+    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel, screenshotOptions);
   } catch (error) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }

package/dist/cli.cjs

@@ -7812,6 +7812,42 @@ function normalizeSetupActions(value) {
   if (!Array.isArray(value)) throw new Error("target.setup_actions must be an array.");
   return value.map(normalizeSetupAction);
 }
+function normalizeTargetScreenshotFullPage(input) {
+  const directFullPage = booleanValue(valueFromOwn(
+    input,
+    "screenshot_full_page",
+    "screenshotFullPage",
+    "final_screenshot_full_page",
+    "finalScreenshotFullPage",
+    "full_page_screenshots",
+    "fullPageScreenshots"
+  ));
+  const viewportOnly = booleanValue(valueFromOwn(
+    input,
+    "viewport_screenshots",
+    "viewportScreenshots",
+    "viewport_only_screenshots",
+    "viewportOnlyScreenshots"
+  ));
+  const modeInput = stringFromOwn(input, "screenshot_mode", "screenshotMode", "final_screenshot_mode", "finalScreenshotMode");
+  let modeFullPage;
+  if (modeInput) {
+    const mode = modeInput.trim().toLowerCase().replace(/[-\s]+/g, "_");
+    if (mode === "full_page" || mode === "fullpage" || mode === "page" || mode === "document") {
+      modeFullPage = true;
+    } else if (mode === "viewport" || mode === "view") {
+      modeFullPage = false;
+    } else {
+      throw new Error(`target.screenshot_mode ${modeInput} is not supported. Supported modes: full_page, viewport.`);
+    }
+  }
+  const values = [directFullPage, viewportOnly === void 0 ? void 0 : !viewportOnly, modeFullPage].filter((value) => value !== void 0);
+  if (!values.length) return void 0;
+  if (values.some((value) => value !== values[0])) {
+    throw new Error("target has conflicting screenshot full_page / viewport mode options.");
+  }
+  return values[0];
+}
 function normalizeNetworkMock(input, index) {
   if (!isRecord(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
   const url = stringValue2(input.url) || stringValue2(input.glob) || stringValue2(input.pattern);
@@ -8380,6 +8416,7 @@ function normalizeRiddleProofProfile(input, options = {}) {
       timeout_sec: timeoutSecValue(targetInput.timeout_sec) ?? timeoutSecValue(targetInput.timeoutSec) ?? timeoutSecValue(targetInput.riddle_timeout_sec) ?? timeoutSecValue(targetInput.riddleTimeoutSec),
       wait_for_selector: stringValue2(targetInput.wait_for_selector) || stringValue2(targetInput.waitForSelector),
       wait_ms: numberValue(targetInput.wait_ms) ?? numberValue(targetInput.waitMs),
+      screenshot_full_page: normalizeTargetScreenshotFullPage(targetInput),
       setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions),
       network_mocks: normalizeNetworkMocks(targetInput.network_mocks ?? targetInput.networkMocks)
     },
@@ -13811,7 +13848,9 @@ async function captureViewport(viewport) {
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
   try {
-    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel);
+    const screenshotOptions = {};
+    if (profile.target && profile.target.screenshot_full_page !== undefined) screenshotOptions.fullPage = profile.target.screenshot_full_page !== false;
+    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel, screenshotOptions);
   } catch (error) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-N75EAJNG.js";
+} from "./chunk-DB6J53V5.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport

package/dist/index.cjs

@@ -9608,6 +9608,42 @@ function normalizeSetupActions(value) {
   if (!Array.isArray(value)) throw new Error("target.setup_actions must be an array.");
   return value.map(normalizeSetupAction);
 }
+function normalizeTargetScreenshotFullPage(input) {
+  const directFullPage = booleanValue(valueFromOwn(
+    input,
+    "screenshot_full_page",
+    "screenshotFullPage",
+    "final_screenshot_full_page",
+    "finalScreenshotFullPage",
+    "full_page_screenshots",
+    "fullPageScreenshots"
+  ));
+  const viewportOnly = booleanValue(valueFromOwn(
+    input,
+    "viewport_screenshots",
+    "viewportScreenshots",
+    "viewport_only_screenshots",
+    "viewportOnlyScreenshots"
+  ));
+  const modeInput = stringFromOwn(input, "screenshot_mode", "screenshotMode", "final_screenshot_mode", "finalScreenshotMode");
+  let modeFullPage;
+  if (modeInput) {
+    const mode = modeInput.trim().toLowerCase().replace(/[-\s]+/g, "_");
+    if (mode === "full_page" || mode === "fullpage" || mode === "page" || mode === "document") {
+      modeFullPage = true;
+    } else if (mode === "viewport" || mode === "view") {
+      modeFullPage = false;
+    } else {
+      throw new Error(`target.screenshot_mode ${modeInput} is not supported. Supported modes: full_page, viewport.`);
+    }
+  }
+  const values = [directFullPage, viewportOnly === void 0 ? void 0 : !viewportOnly, modeFullPage].filter((value) => value !== void 0);
+  if (!values.length) return void 0;
+  if (values.some((value) => value !== values[0])) {
+    throw new Error("target has conflicting screenshot full_page / viewport mode options.");
+  }
+  return values[0];
+}
 function normalizeNetworkMock(input, index) {
   if (!isRecord2(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
   const url = stringValue5(input.url) || stringValue5(input.glob) || stringValue5(input.pattern);
@@ -10176,6 +10212,7 @@ function normalizeRiddleProofProfile(input, options = {}) {
       timeout_sec: timeoutSecValue(targetInput.timeout_sec) ?? timeoutSecValue(targetInput.timeoutSec) ?? timeoutSecValue(targetInput.riddle_timeout_sec) ?? timeoutSecValue(targetInput.riddleTimeoutSec),
       wait_for_selector: stringValue5(targetInput.wait_for_selector) || stringValue5(targetInput.waitForSelector),
       wait_ms: numberValue3(targetInput.wait_ms) ?? numberValue3(targetInput.waitMs),
+      screenshot_full_page: normalizeTargetScreenshotFullPage(targetInput),
       setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions),
       network_mocks: normalizeNetworkMocks(targetInput.network_mocks ?? targetInput.networkMocks)
     },
@@ -15623,7 +15660,9 @@ async function captureViewport(viewport) {
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
   try {
-    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel);
+    const screenshotOptions = {};
+    if (profile.target && profile.target.screenshot_full_page !== undefined) screenshotOptions.fullPage = profile.target.screenshot_full_page !== false;
+    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel, screenshotOptions);
   } catch (error) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }

package/dist/index.js

@@ -62,7 +62,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-N75EAJNG.js";
+} from "./chunk-DB6J53V5.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -922,6 +922,42 @@ function normalizeSetupActions(value) {
   if (!Array.isArray(value)) throw new Error("target.setup_actions must be an array.");
   return value.map(normalizeSetupAction);
 }
+function normalizeTargetScreenshotFullPage(input) {
+  const directFullPage = booleanValue(valueFromOwn(
+    input,
+    "screenshot_full_page",
+    "screenshotFullPage",
+    "final_screenshot_full_page",
+    "finalScreenshotFullPage",
+    "full_page_screenshots",
+    "fullPageScreenshots"
+  ));
+  const viewportOnly = booleanValue(valueFromOwn(
+    input,
+    "viewport_screenshots",
+    "viewportScreenshots",
+    "viewport_only_screenshots",
+    "viewportOnlyScreenshots"
+  ));
+  const modeInput = stringFromOwn(input, "screenshot_mode", "screenshotMode", "final_screenshot_mode", "finalScreenshotMode");
+  let modeFullPage;
+  if (modeInput) {
+    const mode = modeInput.trim().toLowerCase().replace(/[-\s]+/g, "_");
+    if (mode === "full_page" || mode === "fullpage" || mode === "page" || mode === "document") {
+      modeFullPage = true;
+    } else if (mode === "viewport" || mode === "view") {
+      modeFullPage = false;
+    } else {
+      throw new Error(`target.screenshot_mode ${modeInput} is not supported. Supported modes: full_page, viewport.`);
+    }
+  }
+  const values = [directFullPage, viewportOnly === void 0 ? void 0 : !viewportOnly, modeFullPage].filter((value) => value !== void 0);
+  if (!values.length) return void 0;
+  if (values.some((value) => value !== values[0])) {
+    throw new Error("target has conflicting screenshot full_page / viewport mode options.");
+  }
+  return values[0];
+}
 function normalizeNetworkMock(input, index) {
   if (!isRecord(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
   const url = stringValue(input.url) || stringValue(input.glob) || stringValue(input.pattern);
@@ -1490,6 +1526,7 @@ function normalizeRiddleProofProfile(input, options = {}) {
       timeout_sec: timeoutSecValue(targetInput.timeout_sec) ?? timeoutSecValue(targetInput.timeoutSec) ?? timeoutSecValue(targetInput.riddle_timeout_sec) ?? timeoutSecValue(targetInput.riddleTimeoutSec),
       wait_for_selector: stringValue(targetInput.wait_for_selector) || stringValue(targetInput.waitForSelector),
       wait_ms: numberValue(targetInput.wait_ms) ?? numberValue(targetInput.waitMs),
+      screenshot_full_page: normalizeTargetScreenshotFullPage(targetInput),
       setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions),
       network_mocks: normalizeNetworkMocks(targetInput.network_mocks ?? targetInput.networkMocks)
     },
@@ -6937,7 +6974,9 @@ async function captureViewport(viewport) {
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
   try {
-    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel);
+    const screenshotOptions = {};
+    if (profile.target && profile.target.screenshot_full_page !== undefined) screenshotOptions.fullPage = profile.target.screenshot_full_page !== false;
+    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel, screenshotOptions);
   } catch (error) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }

package/dist/profile.d.cts

@@ -203,6 +203,7 @@ interface RiddleProofProfileTarget {
     timeout_sec?: number;
     wait_for_selector?: string;
     wait_ms?: number;
+    screenshot_full_page?: boolean;
     setup_actions?: RiddleProofProfileSetupAction[];
     network_mocks?: RiddleProofProfileNetworkMock[];
 }

package/dist/profile.d.ts

@@ -203,6 +203,7 @@ interface RiddleProofProfileTarget {
     timeout_sec?: number;
     wait_for_selector?: string;
     wait_ms?: number;
+    screenshot_full_page?: boolean;
     setup_actions?: RiddleProofProfileSetupAction[];
     network_mocks?: RiddleProofProfileNetworkMock[];
 }

package/dist/profile.js

@@ -23,7 +23,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-N75EAJNG.js";
+} from "./chunk-DB6J53V5.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.7.138",
+  "version": "0.7.139",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",