browser-debugger-cli 0.15.0 → 0.16.0

package/dist/commands/dom/helpers/screenshot.d.ts

@@ -1,34 +1,29 @@
 /**
- * CDP-relay helpers for screenshot capture.
- *
- * Covers page, element, and element-bounds operations plus the scroll-into-
- * view primitives used by page screenshots with `--scroll`.
+ * Screenshot capture for `bdg dom screenshot`: the daemon measures, captures
+ * and puts back the page's emulation (`dom_screenshot`); this writes the image
+ * it returns.
  */
-import type { ScreenshotResult, ScreenshotOptions, ElementBounds, NodeRef } from '../../../types.js';
+import { type InterruptSignal } from '../../shared/interrupt.js';
+import { CommandError } from '../../../errors/index.js';
+import type { DomScreenshotCommand } from '../../../ipc/protocol/commands.js';
+import type { ScreenshotResult } from '../../../types.js';
 /**
- * Get the bounding box (border box, so padding and border are included) of an
- * element via CDP DOM.getBoxModel.
+ * The error of a screenshot interrupted by Ctrl-C or SIGTERM.
  *
- * @param ref - Node reference
- * @returns Element bounds in CSS pixels
- */
-export declare function getElementBounds(ref: NodeRef): Promise<ElementBounds>;
-/**
- * Capture a screenshot of the page. Auto-resizes oversized pages by default
- * to keep Claude Vision token cost bounded; falls back to viewport capture
- * when the page is taller than the tall-page threshold.
+ * @param signal - The signal
+ * @returns Command error (exit 130, or 143 for SIGTERM)
  */
-export declare function capturePageScreenshot(outputPath: string, options?: ScreenshotOptions): Promise<ScreenshotResult>;
+export declare function screenshotInterrupted(signal: InterruptSignal): CommandError;
 /**
- * Capture a screenshot of a single element: its border box, grown to include
- * content overflowing it ({@link captureArea}). The box model is relative to
- * the viewport and the capture clip to the page, so the page scroll is added
- * (the reported bounds are page coordinates, like `dom layout`'s).
+ * Capture the page (or the element `backendNodeId` names) and write the
+ * image.
+ *
+ * @param outputPath - File to write
+ * @param request - What to capture and how
+ * @param interrupt - Aborted on Ctrl-C or SIGTERM: the capture is cancelled
+ * @returns What was captured, with the file's absolute path
+ * @throws CommandError with the daemon's error (Chrome's, when the capture
+ *   failed) and exit code, or 130/143 when interrupted
  */
-export declare function captureElementScreenshot(outputPath: string, ref: NodeRef, options?: {
-    format?: 'png' | 'jpeg';
-    quality?: number;
-    noResize?: boolean;
-    padding?: number;
-}): Promise<ScreenshotResult>;
+export declare function captureScreenshot(outputPath: string, request: DomScreenshotCommand, interrupt?: AbortSignal): Promise<ScreenshotResult>;
 //# sourceMappingURL=screenshot.d.ts.map