@vforsh/argus-watcher 0.5.2 → 0.5.4

package/dist/cdp/recordingSession.js

@@ -0,0 +1,157 @@
+import { tryEvaluateInPage } from './pageState.js';
+import { delay } from '@vforsh/argus-core';
+/**
+ * Scroll a selector target into view before the capture plan measures it.
+ *
+ * A screencast only ever carries the visible viewport, so an element below the fold has no pixels
+ * to crop. `Page.captureScreenshot` has no such limit, which is why `screenshot --selector` works
+ * on an off-screen element and `record --selector` cannot — it used to silently emit a 2px sliver.
+ *
+ * Best-effort: a selector that matches nothing is reported by the capture plan, which produces a
+ * better message than anything this could throw.
+ */
+export const scrollSelectorIntoView = async (session, selector) => {
+    await tryEvaluateInPage(session, `document.querySelector(${JSON.stringify(selector)})?.scrollIntoView({ block: 'center', inline: 'center', behavior: 'instant' })`, { timeoutMs: 5_000 });
+    // Let scroll-linked layout settle before the box model is read.
+    await delay(100);
+};
+/** Smallest visible edge, in CSS pixels, that still makes a recordable region. */
+const MIN_VISIBLE_EXTENT_PX = 2;
+/**
+ * Reject a crop the screencast cannot actually deliver.
+ *
+ * The encoder clamps an out-of-frame rectangle to the nearest legal one, so an off-screen target
+ * used to encode cleanly as a 2-pixel sliver and only look wrong when someone played the file.
+ *
+ * @throws {Error} When the crop lies (almost) entirely outside the captured viewport.
+ */
+export const assertClipIsVisible = (clip, viewport, subject) => {
+    if (!viewport) {
+        return;
+    }
+    const visibleWidth = Math.min(clip.x + clip.width, viewport.width) - Math.max(clip.x, 0);
+    const visibleHeight = Math.min(clip.y + clip.height, viewport.height) - Math.max(clip.y, 0);
+    if (visibleWidth >= MIN_VISIBLE_EXTENT_PX && visibleHeight >= MIN_VISIBLE_EXTENT_PX) {
+        return;
+    }
+    throw new Error(`${subject} is outside the visible viewport (${Math.round(clip.width)}x${Math.round(clip.height)} at ${Math.round(clip.x)},${Math.round(clip.y)}; viewport is ${Math.round(viewport.width)}x${Math.round(viewport.height)}). ` +
+        'Recordings capture only what the page is showing — scroll the target into view, or record the viewport and crop later.');
+};
+/**
+ * Start (or restart) Chrome's screencast for this recording.
+ *
+ * Called once at start and again after every top-frame navigation: Chrome tears the screencast
+ * down on a cross-process navigation and never says so, which used to leave the encoder repeating
+ * the last pre-navigation frame for the rest of the capture.
+ */
+export const armScreencast = async (state) => {
+    await state.session.sendAndWait('Page.startScreencast', {
+        format: state.frameCodec,
+        quality: state.frameCodec === 'jpeg' ? state.quality : undefined,
+        everyNthFrame: 1,
+    });
+};
+/** Subscribe to screencast frames and top-frame navigations for the lifetime of the recording. */
+export const subscribeToScreencast = (state) => {
+    state.removeFrameHandler = state.session.onEvent('Page.screencastFrame', (params) => {
+        handleScreencastFrame(state, params);
+    });
+    state.removeNavigationHandler = state.session.onEvent('Page.frameNavigated', (params) => {
+        // Subframe navigations do not disturb the screencast; only the top frame does.
+        if (params.frame?.parentId) {
+            return;
+        }
+        if (state.state !== 'recording' && state.state !== 'starting') {
+            return;
+        }
+        state.navigations += 1;
+        void armScreencast(state).catch(() => {
+            // The renderer may still be swapping; the next navigation or stop reports the gap.
+        });
+    });
+};
+const handleScreencastFrame = (state, params) => {
+    if (typeof params.data !== 'string') {
+        return;
+    }
+    const frame = Buffer.from(params.data, 'base64');
+    state.latestFrame = frame;
+    state.resolveFirstFrame(frame);
+    if (typeof params.sessionId === 'number') {
+        void state.session.sendAndWait('Page.screencastFrameAck', { sessionId: params.sessionId }).catch(() => { });
+    }
+};
+/**
+ * Frames wall-clock time says should exist by now.
+ *
+ * Recomputed from elapsed time rather than incremented once per timer tick: `setInterval` drifts
+ * under load and silently under-delivers, so a counter produced files whose duration did not match
+ * the capture window — a 5s recording that played back as 3.4s.
+ */
+const targetFrameCount = (state, elapsedMs) => Math.max(1, Math.round((elapsedMs / 1000) * state.fps));
+/**
+ * Write frames until the encoder has `target` of them.
+ *
+ * The deficit left by backpressure is never dropped — it is paid down over successive calls — but
+ * one call writes at most a second's worth, so a stalled encoder cannot make us buffer an unbounded
+ * burst of full frames in its stdin.
+ */
+const writeFramesUpTo = (state, target) => {
+    if (!state.latestFrame || !state.ffmpeg || state.pumpBlocked || state.ffmpeg.child.stdin.destroyed) {
+        return;
+    }
+    let budget = Math.max(1, state.fps);
+    while (state.frameCount < target && budget > 0) {
+        budget -= 1;
+        state.frameCount += 1;
+        const ready = state.ffmpeg.child.stdin.write(state.latestFrame);
+        if (!ready) {
+            state.pumpBlocked = true;
+            state.ffmpeg.child.stdin.once('drain', () => {
+                state.pumpBlocked = false;
+                writeFramesUpTo(state, target);
+            });
+            return;
+        }
+    }
+};
+/** Bring the encoder up to date with how long the recording has been running. */
+export const pumpFrames = (state) => {
+    writeFramesUpTo(state, targetFrameCount(state, Math.max(0, Date.now() - state.startedAt)));
+};
+/** Write the frames the final capture window still owes, then wait for the encoder to drain them. */
+export const flushFrames = async (state, elapsedMs) => {
+    const target = targetFrameCount(state, elapsedMs);
+    writeFramesUpTo(state, target);
+    while (state.frameCount < target || state.pumpBlocked) {
+        if (!state.ffmpeg || state.ffmpeg.child.stdin.destroyed) {
+            return;
+        }
+        await delay(10);
+        writeFramesUpTo(state, target);
+    }
+};
+/** Clear every timer the recording owns. Safe to call more than once. */
+export const clearRecordingTimers = (state) => {
+    if (state.firstFrameTimer) {
+        clearTimeout(state.firstFrameTimer);
+        state.firstFrameTimer = null;
+    }
+    if (state.sampleTimer) {
+        clearInterval(state.sampleTimer);
+        state.sampleTimer = null;
+    }
+    if (state.maxDurationTimer) {
+        clearTimeout(state.maxDurationTimer);
+        state.maxDurationTimer = null;
+    }
+    if (state.endTimer) {
+        clearTimeout(state.endTimer);
+        state.endTimer = null;
+    }
+    if (state.untilTimer) {
+        clearInterval(state.untilTimer);
+        state.untilTimer = null;
+    }
+};
+//# sourceMappingURL=recordingSession.js.map

package/dist/cdp/recordingSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordingSession.js","sourceRoot":"","sources":["../../src/cdp/recordingSession.ts"],"names":[],"mappings":"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"}

package/dist/cdp/scenarioBridge.d.ts

@@ -1,10 +1,12 @@
 import type { LogBuffer } from '../buffer/LogBuffer.js';
 import type { Screenshotter } from './screenshot.js';
+import type { Recorder } from './recording.js';
 import type { CdpSessionHandle } from './connection.js';
 /** Host services exposed to a bundled scenario for the lifetime of one eval. */
 export type ScenarioBridgeServices = {
     buffer: LogBuffer;
     screenshotter: Screenshotter;
+    recorder: Recorder;
 };
 /** A scenario-wrapped expression plus cleanup for its temporary CDP binding. */
 export type InstalledScenarioBridge = {

package/dist/cdp/scenarioBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scenarioBridge.d.ts","sourceRoot":"","sources":["../../src/cdp/scenarioBridge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,wBAAwB,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAgB,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAsBrE,gFAAgF;AAChF,MAAM,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,SAAS,CAAA;IACjB,aAAa,EAAE,aAAa,CAAA;CAC5B,CAAA;AAED,gFAAgF;AAChF,MAAM,MAAM,uBAAuB,GAAG;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B,CAAA;AAED,6GAA6G;AAC7G,eAAO,MAAM,qBAAqB,GACjC,SAAS,gBAAgB,EACzB,YAAY,MAAM,EAClB,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACxC,UAAU,sBAAsB,EAChC,YAAY,MAAM,KAChB,OAAO,CAAC,uBAAuB,CAwCjC,CAAA"}
+{"version":3,"file":"scenarioBridge.d.ts","sourceRoot":"","sources":["../../src/cdp/scenarioBridge.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,wBAAwB,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAgB,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAsBrE,gFAAgF;AAChF,MAAM,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,SAAS,CAAA;IACjB,aAAa,EAAE,aAAa,CAAA;IAC5B,QAAQ,EAAE,QAAQ,CAAA;CAClB,CAAA;AAED,gFAAgF;AAChF,MAAM,MAAM,uBAAuB,GAAG;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B,CAAA;AAED,6GAA6G;AAC7G,eAAO,MAAM,qBAAqB,GACjC,SAAS,gBAAgB,EACzB,YAAY,MAAM,EAClB,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACxC,UAAU,sBAAsB,EAChC,YAAY,MAAM,KAChB,OAAO,CAAC,uBAAuB,CAwCjC,CAAA"}

package/dist/cdp/scenarioBridge.js

@@ -1,5 +1,5 @@
 import { randomUUID } from 'node:crypto';
-import { LOG_LEVELS } from '@vforsh/argus-core';
+import { LOG_LEVELS, RECORD_FORMATS, } from '@vforsh/argus-core';
 import { formatError } from '@vforsh/argus-core';
 const SCENARIO_ACTION_TIMEOUT_MS = 30_000;
 const DEFAULT_LOG_LIMIT = 500;
@@ -89,6 +89,16 @@ const handleBridgeRequest = async (request, services) => {
             const fileName = name.endsWith('.png') ? name : `${name}.png`;
             return services.screenshotter.capture({ ...options, outFile: `scenarios/checkpoints/${fileName}` });
         }
+        case 'record.start': {
+            const payload = requireRecord(request.payload, 'record.start payload');
+            const name = parseArtifactName(payload.name, 'recording name');
+            const options = parseRecordOptions(payload.options);
+            const format = options.format ?? 'mp4';
+            const fileName = name.endsWith(`.${format}`) ? name : `${name}.${format}`;
+            return services.recorder.start({ ...options, format, outFile: `scenarios/recordings/${fileName}` });
+        }
+        case 'record.stop':
+            return services.recorder.stop({});
         case 'logs.cursor':
             return { cursor: services.buffer.beginLogEpoch() };
         case 'logs.read':
@@ -126,9 +136,40 @@ const parseClip = (value) => {
     return { x, y, width, height };
 };
 const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
-const parseCheckpointName = (value) => {
+const parseCheckpointName = (value) => parseArtifactName(value, 'checkpoint name');
+/** Artifact names are path segments the scenario chooses, so they may not traverse or nest. */
+const parseArtifactName = (value, label) => {
     if (typeof value !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$/.test(value)) {
-        throw new Error('checkpoint name must be 1-100 characters using letters, numbers, dot, underscore, or dash');
+        throw new Error(`${label} must be 1-100 characters using letters, numbers, dot, underscore, or dash`);
+    }
+    return value;
+};
+const parseRecordOptions = (value) => {
+    if (value == null)
+        return {};
+    const record = requireRecord(value, 'record options');
+    const { selector, clip } = parseScreenshotOptions(record);
+    return {
+        selector,
+        clip,
+        fps: parseBoundedNumber(record.fps, 'fps', 1, 60),
+        quality: parseBoundedNumber(record.quality, 'quality', 1, 100),
+        maxDurationMs: parseBoundedNumber(record.maxDurationMs, 'maxDurationMs', 1, Number.MAX_SAFE_INTEGER),
+        format: parseRecordFormat(record.format),
+    };
+};
+const parseRecordFormat = (value) => {
+    if (value == null)
+        return undefined;
+    if (typeof value === 'string' && RECORD_FORMATS.includes(value))
+        return value;
+    throw new Error(`format must be one of ${RECORD_FORMATS.join(', ')}`);
+};
+const parseBoundedNumber = (value, label, min, max) => {
+    if (value == null)
+        return undefined;
+    if (!isFiniteNumber(value) || value < min || value > max) {
+        throw new Error(`${label} must be a number from ${min} to ${max}`);
     }
     return value;
 };
@@ -262,11 +303,16 @@ const buildScenarioExpression = (expression, options) => `(async () => {
         });
       },
     });
+    const record = Object.freeze({
+      start: (name, recordOptions) => request('record.start', { name, options: recordOptions }),
+      stop: () => request('record.stop'),
+    });
     const context = Object.freeze({
       args: Object.freeze(${JSON.stringify(options.args)}),
       screenshot: (screenshotOptions) => request('screenshot', screenshotOptions),
       checkpoint: (name, screenshotOptions) => request('checkpoint', { name, options: screenshotOptions }),
       logs,
+      record,
     });
     return {
       context,

package/dist/cdp/scenarioBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"scenarioBridge.js","sourceRoot":"","sources":["../../src/cdp/scenarioBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,UAAU,EAAoF,MAAM,oBAAoB,CAAA;AAIjI,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,MAAM,0BAA0B,GAAG,MAAM,CAAA;AACzC,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAC7B,MAAM,aAAa,GAAG,KAAK,CAAA;AA6B3B,6GAA6G;AAC7G,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACzC,OAAyB,EACzB,UAAkB,EAClB,IAAwC,EACxC,QAAgC,EAChC,SAAkB,EACiB,EAAE;IACrC,MAAM,KAAK,GAAG,UAAU,EAAE,CAAA;IAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IACxC,MAAM,WAAW,GAAG,uBAAuB,MAAM,EAAE,CAAA;IACnD,MAAM,YAAY,GAAG,0BAA0B,MAAM,EAAE,CAAA;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE;QACvE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,QAA8B,CAAA;QAC5E,IAAI,IAAI,KAAK,WAAW,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,kBAAkB,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC5I,OAAM;QACP,CAAC;QAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAM;QACP,CAAC;QAED,KAAK,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;IAC3G,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC;QACJ,MAAM,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,GAAG,EAAE,CAAA;QACL,MAAM,KAAK,CAAA;IACZ,CAAC;IAED,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,OAAO;QACN,UAAU,EAAE,uBAAuB,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QACvG,OAAO,EAAE,KAAK,IAAI,EAAE;YACnB,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YACf,GAAG,EAAE,CAAA;YACL,IAAI,CAAC;gBACJ,MAAM,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;YACzF,CAAC;YAAC,MAAM,CAAC;gBACR,wDAAwD;YACzD,CAAC;QACF,CAAC;KACD,CAAA;AACF,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,OAAe,EAAE,KAAa,EAAgC,EAAE;IAC3F,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAA;QAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,OAAO,IAAI,CAAA;QACZ,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,MAAiC,CAAA;QACtG,IAAI,YAAY,KAAK,KAAK,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACvH,OAAO,IAAI,CAAA;QACZ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAA;IACpE,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC,CAAA;AAED,MAAM,sBAAsB,GAAG,KAAK,EACnC,OAAyB,EACzB,YAAoB,EACpB,OAA8B,EAC9B,QAAgC,EAChC,kBAA0B,EAC1B,IAAkB,EAClB,SAAkB,EACF,EAAE;IAClB,IAAI,QAAwB,CAAA;IAC5B,IAAI,CAAC;QACJ,QAAQ,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAA;IAC9F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,QAAQ,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAA;IACpE,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;IAC/F,CAAC;IAAC,MAAM,CAAC;QACR,0EAA0E;IAC3E,CAAC;AACF,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,KAAK,EAAE,OAA8B,EAAE,QAAgC,EAAoB,EAAE;IACxH,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,YAAY,CAAC,CAAC,CAAC;YACnB,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACvD,OAAO,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC/C,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YACnB,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAA;YACpE,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YAC9C,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAA;YAC7D,OAAO,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,yBAAyB,QAAQ,EAAE,EAAE,CAAC,CAAA;QACpG,CAAC;QACD,KAAK,aAAa;YACjB,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,CAAA;QACnD,KAAK,WAAW;YACf,OAAO,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAC1D;YACC,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACnE,CAAC;AACF,CAAC,CAAA;AAED,MAAM,sBAAsB,GAAG,CAAC,KAAc,EAAkC,EAAE;IACjF,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,EAAE,CAAA;IAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAA;IACzD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IAExB,IAAI,QAAQ,IAAI,IAAI,IAAI,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACvD,CAAC;IACD,IAAI,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;IAC5D,CAAC;IAED,OAAO;QACN,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QAC7D,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;KAChD,CAAA;AACF,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,CAAC,KAAc,EAAuD,EAAE;IACzF,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACzC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACpC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QACnG,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;IACtF,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AAC/B,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAE/G,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAAU,EAAE;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,mCAAmC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,2FAA2F,CAAC,CAAA;IAC7G,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,MAAiB,EAAE,KAAc,EAA2B,EAAE;IACvF,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAA;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAC7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IAChE,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3D,OAAO,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;AACrD,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,CAAC,KAAc,EAA0C,EAAE;IAClF,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAA;IACnE,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACtD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;IACvD,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAE1C,OAAO;QACN,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;QAClC,KAAK;KACL,CAAA;AACF,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,KAAc,EAA0B,EAAE;IACjE,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAA;IACjE,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACtE,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,CAAC,KAAc,EAAqB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAiB,CAAC,CAAA;AAI7H,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAgB,EAAE;IAC1D,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,WAAW;QAAE,OAAO,WAAW,CAAA;IAC9D,IAAI,KAAK,KAAK,aAAa;QAAE,OAAO,KAAK,CAAA;IACzC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;AAC9D,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,CAAC,KAAc,EAAE,SAAuB,EAAwB,EAAE;IACzF,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAC3C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAA;IAClF,CAAC;IAED,IAAI,CAAC;QACJ,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,SAAS,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;IACrG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,iCAAiC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACvE,CAAC;AACF,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;AAE3G,MAAM,cAAc,GAAG,CAAC,KAAc,EAAsB,EAAE;IAC7D,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAA;IAC3D,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;AACrD,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,KAAc,EAAU,EAAE;IAChD,MAAM,KAAK,GAAG,KAAK,IAAI,iBAAiB,CAAA;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,aAAa;QAAE,OAAO,KAAK,CAAA;IAC9G,MAAM,IAAI,KAAK,CAAC,sCAAsC,aAAa,EAAE,CAAC,CAAA;AACvE,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,KAAa,EAA2B,EAAE;IAChF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAA;IAC9C,CAAC;IACD,OAAO,KAAgC,CAAA;AACxC,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,KAAK,EAC/B,OAAyB,EACzB,YAAoB,EACpB,QAAwB,EACxB,kBAA0B,EAC1B,IAAkB,EAClB,SAAkB,EACF,EAAE;IAClB,MAAM,OAAO,CAAC,WAAW,CACxB,kBAAkB,EAClB;QACC,UAAU,EAAE,cAAc,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG;QACxF,SAAS,EAAE,kBAAkB;QAC7B,aAAa,EAAE,IAAI;QACnB,MAAM,EAAE,IAAI;KACZ,EACD,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS,EAAE,CACrD,CAAA;AACF,CAAC,CAAA;AAED,MAAM,uBAAuB,GAAG,CAC/B,UAAkB,EAClB,OAAmG,EAC1F,EAAE,CAAC;;8BAEiB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC;;;;0BAIvC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC;;;;;;;;;;;;;;;;kEAgBI,0BAA0B;WACjF,0BAA0B;;;uCAGE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;4BAuBxC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;oBAmBpC,UAAU;;;;;KAKzB,CAAA"}
+{"version":3,"file":"scenarioBridge.js","sourceRoot":"","sources":["../../src/cdp/scenarioBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EACN,UAAU,EACV,cAAc,GAMd,MAAM,oBAAoB,CAAA;AAK3B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,MAAM,0BAA0B,GAAG,MAAM,CAAA;AACzC,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAC7B,MAAM,aAAa,GAAG,KAAK,CAAA;AA8B3B,6GAA6G;AAC7G,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACzC,OAAyB,EACzB,UAAkB,EAClB,IAAwC,EACxC,QAAgC,EAChC,SAAkB,EACiB,EAAE;IACrC,MAAM,KAAK,GAAG,UAAU,EAAE,CAAA;IAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IACxC,MAAM,WAAW,GAAG,uBAAuB,MAAM,EAAE,CAAA;IACnD,MAAM,YAAY,GAAG,0BAA0B,MAAM,EAAE,CAAA;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE;QACvE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,QAA8B,CAAA;QAC5E,IAAI,IAAI,KAAK,WAAW,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,kBAAkB,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC5I,OAAM;QACP,CAAC;QAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAM;QACP,CAAC;QAED,KAAK,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;IAC3G,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC;QACJ,MAAM,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,GAAG,EAAE,CAAA;QACL,MAAM,KAAK,CAAA;IACZ,CAAC;IAED,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,OAAO;QACN,UAAU,EAAE,uBAAuB,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QACvG,OAAO,EAAE,KAAK,IAAI,EAAE;YACnB,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YACf,GAAG,EAAE,CAAA;YACL,IAAI,CAAC;gBACJ,MAAM,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;YACzF,CAAC;YAAC,MAAM,CAAC;gBACR,wDAAwD;YACzD,CAAC;QACF,CAAC;KACD,CAAA;AACF,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,OAAe,EAAE,KAAa,EAAgC,EAAE;IAC3F,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAA;QAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,OAAO,IAAI,CAAA;QACZ,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,MAAiC,CAAA;QACtG,IAAI,YAAY,KAAK,KAAK,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACvH,OAAO,IAAI,CAAA;QACZ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAA;IACpE,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC,CAAA;AAED,MAAM,sBAAsB,GAAG,KAAK,EACnC,OAAyB,EACzB,YAAoB,EACpB,OAA8B,EAC9B,QAAgC,EAChC,kBAA0B,EAC1B,IAAkB,EAClB,SAAkB,EACF,EAAE;IAClB,IAAI,QAAwB,CAAA;IAC5B,IAAI,CAAC;QACJ,QAAQ,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAA;IAC9F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,QAAQ,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAA;IACpE,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;IAC/F,CAAC;IAAC,MAAM,CAAC;QACR,0EAA0E;IAC3E,CAAC;AACF,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,KAAK,EAAE,OAA8B,EAAE,QAAgC,EAAoB,EAAE;IACxH,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,YAAY,CAAC,CAAC,CAAC;YACnB,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACvD,OAAO,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC/C,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YACnB,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAA;YACpE,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YAC9C,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAA;YAC7D,OAAO,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,yBAAyB,QAAQ,EAAE,EAAE,CAAC,CAAA;QACpG,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACrB,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAA;YACtE,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAA;YAC9D,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACnD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAA;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,EAAE,CAAA;YACzE,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,QAAQ,EAAE,EAAE,CAAC,CAAA;QACpG,CAAC;QACD,KAAK,aAAa;YACjB,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAClC,KAAK,aAAa;YACjB,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,CAAA;QACnD,KAAK,WAAW;YACf,OAAO,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAC1D;YACC,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACnE,CAAC;AACF,CAAC,CAAA;AAED,MAAM,sBAAsB,GAAG,CAAC,KAAc,EAAkC,EAAE;IACjF,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,EAAE,CAAA;IAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAA;IACzD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IAExB,IAAI,QAAQ,IAAI,IAAI,IAAI,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACvD,CAAC;IACD,IAAI,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;IAC5D,CAAC;IAED,OAAO;QACN,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QAC7D,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;KAChD,CAAA;AACF,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,CAAC,KAAc,EAAuD,EAAE;IACzF,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACzC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACpC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QACnG,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;IACtF,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AAC/B,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAE/G,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAA;AAEnG,+FAA+F;AAC/F,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAE,KAAa,EAAU,EAAE;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,mCAAmC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,4EAA4E,CAAC,CAAA;IACtG,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAA8B,EAAE;IACzE,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,EAAE,CAAA;IAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAA;IACrD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAEzD,OAAO;QACN,QAAQ;QACR,IAAI;QACJ,GAAG,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC;QAC9D,aAAa,EAAE,kBAAkB,CAAC,MAAM,CAAC,aAAa,EAAE,eAAe,EAAE,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC;QACpG,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC;KACxC,CAAA;AACF,CAAC,CAAA;AAED,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAA4B,EAAE;IACtE,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,CAAC,QAAQ,CAAC,KAAqB,CAAC;QAAE,OAAO,KAAqB,CAAA;IAC7G,MAAM,IAAI,KAAK,CAAC,yBAAyB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACtE,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAE,KAAa,EAAE,GAAW,EAAE,GAAW,EAAsB,EAAE;IAC1G,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IACnC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,0BAA0B,GAAG,OAAO,GAAG,EAAE,CAAC,CAAA;IACnE,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,MAAiB,EAAE,KAAc,EAA2B,EAAE;IACvF,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAA;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAC7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IAChE,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3D,OAAO,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;AACrD,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,CAAC,KAAc,EAA0C,EAAE;IAClF,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAA;IACnE,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACtD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;IACvD,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAE1C,OAAO;QACN,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;QAClC,KAAK;KACL,CAAA;AACF,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,KAAc,EAA0B,EAAE;IACjE,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAA;IACjE,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACtE,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,CAAC,KAAc,EAAqB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAiB,CAAC,CAAA;AAI7H,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAgB,EAAE;IAC1D,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,WAAW;QAAE,OAAO,WAAW,CAAA;IAC9D,IAAI,KAAK,KAAK,aAAa;QAAE,OAAO,KAAK,CAAA;IACzC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;AAC9D,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,CAAC,KAAc,EAAE,SAAuB,EAAwB,EAAE;IACzF,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAC3C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAA;IAClF,CAAC;IAED,IAAI,CAAC;QACJ,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,SAAS,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;IACrG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,iCAAiC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACvE,CAAC;AACF,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;AAE3G,MAAM,cAAc,GAAG,CAAC,KAAc,EAAsB,EAAE;IAC7D,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAA;IAC3D,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;AACrD,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,KAAc,EAAU,EAAE;IAChD,MAAM,KAAK,GAAG,KAAK,IAAI,iBAAiB,CAAA;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,aAAa;QAAE,OAAO,KAAK,CAAA;IAC9G,MAAM,IAAI,KAAK,CAAC,sCAAsC,aAAa,EAAE,CAAC,CAAA;AACvE,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,KAAa,EAA2B,EAAE;IAChF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAA;IAC9C,CAAC;IACD,OAAO,KAAgC,CAAA;AACxC,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,KAAK,EAC/B,OAAyB,EACzB,YAAoB,EACpB,QAAwB,EACxB,kBAA0B,EAC1B,IAAkB,EAClB,SAAkB,EACF,EAAE;IAClB,MAAM,OAAO,CAAC,WAAW,CACxB,kBAAkB,EAClB;QACC,UAAU,EAAE,cAAc,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG;QACxF,SAAS,EAAE,kBAAkB;QAC7B,aAAa,EAAE,IAAI;QACnB,MAAM,EAAE,IAAI;KACZ,EACD,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS,EAAE,CACrD,CAAA;AACF,CAAC,CAAA;AAED,MAAM,uBAAuB,GAAG,CAC/B,UAAkB,EAClB,OAAmG,EAC1F,EAAE,CAAC;;8BAEiB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC;;;;0BAIvC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC;;;;;;;;;;;;;;;;kEAgBI,0BAA0B;WACjF,0BAA0B;;;uCAGE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA2BxC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;oBAoBpC,UAAU;;;;;KAKzB,CAAA"}

package/dist/cdp/screenshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/cdp/screenshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAYvD,MAAM,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;CACpE,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,SAAS;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,KAAG,aAuBlI,CAAA"}
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/cdp/screenshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAYvD,MAAM,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;CACpE,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,SAAS;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,KAAG,aAwBlI,CAAA"}

package/dist/cdp/screenshot.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs/promises';
 import { ensureArtifactsDir, ensureParentDir, resolveArtifactPath } from '../artifacts.js';
-import { createVisualCapturePlan } from './visualCapture.js';
+import { createVisualCapturePlan, toPageClip } from './visualCapture.js';
 const SCREENSHOT_CDP_TIMEOUT_MS = 20_000;
 const SCREENSHOT_CDP_MAX_ATTEMPTS = 2;
 export const createScreenshotter = (options) => {
@@ -16,7 +16,8 @@ export const createScreenshotter = (options) => {
         const capturePlan = await createVisualCapturePlan(options.session, options.pageSession, request);
         const result = await captureScreenshot(capturePlan.session, {
             format,
-            clip: capturePlan.clip,
+            // `Page.captureScreenshot` clips in document coordinates, not viewport ones.
+            clip: capturePlan.clip && toPageClip(capturePlan.clip, capturePlan.pageOffset),
         });
         await fs.writeFile(absolutePath, Buffer.from(result.data, 'base64'));
         return { ok: true, outFile: absolutePath, clipped: result.clipped };

package/dist/cdp/screenshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/cdp/screenshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/cdp/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAGjC,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1F,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAA0B,MAAM,oBAAoB,CAAA;AAEhG,MAAM,yBAAyB,GAAG,MAAM,CAAA;AACxC,MAAM,2BAA2B,GAAG,CAAC,CAAA;AAWrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAA4F,EAAiB,EAAE;IAClJ,MAAM,OAAO,GAAG,KAAK,EAAE,OAA0B,EAA+B,EAAE;QACjF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAA;QACtC,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAA;QAC5D,CAAC;QAED,MAAM,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;QAC9C,MAAM,WAAW,GAAG,eAAe,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAA;QACvF,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;QAC5F,MAAM,eAAe,CAAC,YAAY,CAAC,CAAA;QACnC,MAAM,WAAW,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;QAEhG,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,OAAO,EAAE;YAC3D,MAAM;YACN,6EAA6E;YAC7E,IAAI,EAAE,WAAW,CAAC,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,UAAU,CAAC;SAC9E,CAAC,CAAA;QAEF,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAA;QACpE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;IACpE,CAAC,CAAA;IAED,OAAO,EAAE,OAAO,EAAE,CAAA;AACnB,CAAC,CAAA;AAED,MAAM,iBAAiB,GAAG,KAAK,EAAE,OAAyB,EAAE,OAAoD,EAA0B,EAAE;IAC3I,IAAI,SAAkB,CAAA;IAEtB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,2BAA2B,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC;YACJ,kFAAkF;YAClF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,CACxC,wBAAwB,EACxB;gBACC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,OAAO,CAAC,IAAI;aAClB,EACD,EAAE,SAAS,EAAE,yBAAyB,EAAE,CACxC,CAAA;YAED,MAAM,QAAQ,GAAG,OAA4B,CAAA;YAC7C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;YAChD,CAAC;YAED,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAA;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,SAAS,GAAG,KAAK,CAAA;YACjB,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,2BAA2B,EAAE,CAAC;gBAC5E,MAAM,KAAK,CAAA;YACZ,CAAC;QACF,CAAC;IACF,CAAC;IAED,MAAM,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;AACzF,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAAW,EAAE,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,6BAA6B,CAAC,CAAA"}

package/dist/cdp/visualCapture.d.ts

@@ -24,11 +24,31 @@ export type VisualCaptureRequest = {
     selector?: string;
     clip?: ScreenshotClipRegion;
 };
+/**
+ * A resolved capture target.
+ *
+ * `clip` is always **viewport-relative** CSS pixels — the space `DOM.getBoxModel` reports and the
+ * space a screencast frame lives in. `Page.captureScreenshot` instead wants document coordinates,
+ * so a screenshot adds {@link VisualCapturePlan.pageOffset} before it sends the clip. Keeping one
+ * space here and converting at the one call site that needs the other is what stops the two
+ * consumers from disagreeing about what a clip means.
+ */
 export type VisualCapturePlan = {
     session: CdpSessionHandle;
+    /** Crop rectangle in viewport-relative CSS pixels. */
     clip?: VisualCaptureClip;
     viewport?: VisualCaptureViewport;
+    /** Scroll offset of the captured viewport within the document. Set whenever `clip` is. */
+    pageOffset?: {
+        x: number;
+        y: number;
+    };
 };
+/** Translate a viewport-relative clip into the document coordinates `Page.captureScreenshot` expects. */
+export declare const toPageClip: (clip: VisualCaptureClip, pageOffset: {
+    x: number;
+    y: number;
+} | undefined) => VisualCaptureClip;
 /**
  * Resolve a viewport/selector/clip request into the top-level page session that can capture pixels.
  * Frame targets use their selected frame session for DOM lookup, then translate the clip to page pixels.

package/dist/cdp/visualCapture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visualCapture.d.ts","sourceRoot":"","sources":["../../src/cdp/visualCapture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,iBAAiB,CAAA;AAGzE,MAAM,MAAM,iBAAiB,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtG,MAAM,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,CAAA;AAE/I,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,oBAAoB,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,gBAAgB,CAAA;IACzB,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACxB,QAAQ,CAAC,EAAE,qBAAqB,CAAA;CAChC,CAAA;AAID;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GACnC,SAAS,gBAAgB,EACzB,aAAa,gBAAgB,GAAG,SAAS,EACzC,SAAS,oBAAoB,KAC3B,OAAO,CAAC,iBAAiB,CAsB3B,CAAA;AA0DD,eAAO,MAAM,2BAA2B,GAAI,SAAS,oBAAoB,KAAG,oBAQ3E,CAAA"}
+{"version":3,"file":"visualCapture.d.ts","sourceRoot":"","sources":["../../src/cdp/visualCapture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,iBAAiB,CAAA;AAGzE,MAAM,MAAM,iBAAiB,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtG,MAAM,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,CAAA;AAE/I,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,oBAAoB,CAAA;CAC3B,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,gBAAgB,CAAA;IACzB,sDAAsD;IACtD,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACxB,QAAQ,CAAC,EAAE,qBAAqB,CAAA;IAChC,0FAA0F;IAC1F,UAAU,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACrC,CAAA;AAED,yGAAyG;AACzG,eAAO,MAAM,UAAU,GAAI,MAAM,iBAAiB,EAAE,YAAY;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,KAAG,iBAIrG,CAAA;AAIF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GACnC,SAAS,gBAAgB,EACzB,aAAa,gBAAgB,GAAG,SAAS,EACzC,SAAS,oBAAoB,KAC3B,OAAO,CAAC,iBAAiB,CAwB3B,CAAA;AAqED,eAAO,MAAM,2BAA2B,GAAI,SAAS,oBAAoB,KAAG,oBAQ3E,CAAA"}

package/dist/cdp/visualCapture.js

@@ -1,5 +1,11 @@
 import { evaluateInPage } from './pageState.js';
 import { resolveFirstSelectorNodeId } from './dom/selector.js';
+/** Translate a viewport-relative clip into the document coordinates `Page.captureScreenshot` expects. */
+export const toPageClip = (clip, pageOffset) => ({
+    ...clip,
+    x: clip.x + (pageOffset?.x ?? 0),
+    y: clip.y + (pageOffset?.y ?? 0),
+});
 /**
  * Resolve a viewport/selector/clip request into the top-level page session that can capture pixels.
  * Frame targets use their selected frame session for DOM lookup, then translate the clip to page pixels.
@@ -15,58 +21,65 @@ export const createVisualCapturePlan = async (session, pageSession, request) =>
             subject,
         });
     }
-    const clip = await resolveSubjectClip(session, subject);
-    if (!clip) {
+    // Whole-viewport capture needs no geometry at all, so it costs no round-trips.
+    if (subject.kind === 'viewport') {
         return { session };
     }
+    const viewport = await resolveViewportState(session);
     return {
         session,
-        clip,
-        viewport: await resolveViewportSize(session),
+        clip: await resolveSubjectClip(session, subject, viewport),
+        viewport: viewport.size,
+        pageOffset: viewport.offset,
     };
 };
 const createFrameCapturePlan = async (options) => {
-    const frameClip = await resolveFrameViewportClip(options.pageSession, options.frameContext.frameId);
-    const pageViewport = await resolveViewportSize(options.pageSession);
-    const subjectClip = await resolveSubjectClip(options.frameSession, options.subject);
-    if (!subjectClip) {
+    const pageViewport = await resolveViewportState(options.pageSession);
+    const frameClip = await resolveFrameViewportClip(options.pageSession, options.frameContext.frameId, pageViewport);
+    if (options.subject.kind === 'viewport') {
         return {
             session: options.pageSession,
             clip: frameClip,
-            viewport: pageViewport,
+            viewport: pageViewport.size,
+            pageOffset: pageViewport.offset,
         };
     }
+    const frameViewport = await resolveViewportState(options.frameSession);
+    const subjectClip = await resolveSubjectClip(options.frameSession, options.subject, frameViewport);
     return {
         session: options.pageSession,
+        // Both are viewport-relative to their own document, so the sum lands in page-viewport space.
         clip: offsetClip(frameClip, subjectClip),
-        viewport: pageViewport,
+        viewport: pageViewport.size,
+        pageOffset: pageViewport.offset,
     };
 };
-const resolveFrameViewportClip = async (pageSession, frameId) => {
+const resolveFrameViewportClip = async (pageSession, frameId, viewport) => {
     const owner = await pageSession.sendAndWait('DOM.getFrameOwner', {
         frameId,
     });
     if (owner.backendNodeId == null && owner.nodeId == null) {
         throw new Error(`Unable to resolve iframe owner for frame: ${frameId}`);
     }
-    return resolveNodeClip(pageSession, owner);
+    return resolveNodeClip(pageSession, owner, viewport);
 };
-const resolveSelectorClip = async (session, selector) => {
+const resolveSelectorClip = async (session, selector, viewport) => {
     const nodeId = await resolveFirstSelectorNodeId(session, selector);
     if (!nodeId) {
         throw new Error(`No element found for selector: ${selector}`);
     }
-    return resolveNodeClip(session, { nodeId });
+    return resolveNodeClip(session, { nodeId }, viewport);
 };
-const resolveSubjectClip = async (session, subject) => {
-    switch (subject.kind) {
-        case 'viewport':
-            return null;
-        case 'selector':
-            return resolveSelectorClip(session, subject.selector);
-        case 'clip':
-            return resolveViewportRectClip(session, subject.clip);
+/** Resolve a crop subject. Viewport subjects never reach here — they have no rectangle to resolve. */
+const resolveSubjectClip = async (session, subject, viewport) => {
+    if (subject.kind === 'selector') {
+        return resolveSelectorClip(session, subject.selector, viewport);
     }
+    return {
+        ...subject.clip,
+        // CDP clip rectangles always need the current viewport scale, even when x/y are already viewport-relative.
+        scale: viewport.scale,
+    };
 };
 export const resolveVisualCaptureSubject = (request) => {
     if (request.selector) {
@@ -77,18 +90,7 @@ export const resolveVisualCaptureSubject = (request) => {
     }
     return { kind: 'viewport' };
 };
-const resolveViewportRectClip = async (session, clip) => {
-    const viewport = await resolveVisualViewport(session);
-    return {
-        x: clip.x,
-        y: clip.y,
-        width: clip.width,
-        height: clip.height,
-        // CDP clip rectangles always need the current viewport scale, even when x/y are already viewport-relative.
-        scale: viewport?.scale ?? 1,
-    };
-};
-const resolveNodeClip = async (session, target) => {
+const resolveNodeClip = async (session, target, viewport) => {
     const boxResult = await session.sendAndWait('DOM.getBoxModel', target.nodeId != null ? { nodeId: target.nodeId } : { backendNodeId: target.backendNodeId });
     const quad = boxResult.model?.content ??
         boxResult.model?.border;
@@ -99,16 +101,18 @@ const resolveNodeClip = async (session, target) => {
     if (rect.width <= 0 || rect.height <= 0) {
         throw new Error('Element has zero area');
     }
-    const viewport = await resolveVisualViewport(session);
-    const pageX = viewport?.pageX ?? 0;
-    const pageY = viewport?.pageY ?? 0;
-    const scale = viewport?.scale ?? 1;
+    /**
+     * No scroll offset is subtracted here: `DOM.getBoxModel` already reports viewport-relative CSS
+     * pixels, matching `getBoundingClientRect`. Subtracting `pageY` as well double-counted the
+     * scroll, which was invisible at scroll offset 0 and put the crop entirely off-frame anywhere
+     * else — a blank screenshot, or a 2px-tall recording.
+     */
     return {
-        x: rect.x - pageX,
-        y: rect.y - pageY,
+        x: rect.x,
+        y: rect.y,
         width: rect.width,
         height: rect.height,
-        scale,
+        scale: viewport.scale,
     };
 };
 const resolveVisualViewport = async (session) => {
@@ -116,8 +120,15 @@ const resolveVisualViewport = async (session) => {
     const payload = metrics;
     return payload.cssVisualViewport ?? payload.visualViewport;
 };
-const resolveViewportSize = async (session) => {
+const resolveViewportState = async (session) => {
     const viewport = await resolveVisualViewport(session);
+    return {
+        size: await resolveViewportSize(session, viewport),
+        offset: { x: viewport?.pageX ?? 0, y: viewport?.pageY ?? 0 },
+        scale: viewport?.scale ?? 1,
+    };
+};
+const resolveViewportSize = async (session, viewport) => {
     if (isPositiveFiniteNumber(viewport?.clientWidth) && isPositiveFiniteNumber(viewport?.clientHeight)) {
         return { width: viewport.clientWidth, height: viewport.clientHeight };
     }

package/dist/cdp/visualCapture.js.map

@@ -1 +1 @@
-{"version":3,"file":"visualCapture.js","sourceRoot":"","sources":["../../src/cdp/visualCapture.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"visualCapture.js","sourceRoot":"","sources":["../../src/cdp/visualCapture.ts"],"names":[],"mappings":"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"}

package/dist/http/endpoints.d.ts

@@ -6,7 +6,7 @@ import type { LogLevel, NetParty, NetRequestBodyPart, NetScope } from '@vforsh/a
  * used to be hand-maintained in both files, so adding a route meant editing the same 61 literals
  * twice or emitting an endpoint the public event could not name.
  */
-export declare const WATCHER_ENDPOINTS: readonly ["logs", "tail", "net", "net/requests", "net/request", "net/request/body", "net/tail", "net/clear", "net/mock", "net/mock/add", "net/mock/remove", "net/mock/clear", "net/ws", "net/ws/connection", "net/sse", "auth/cookies", "auth/cookies/get", "auth/cookies/set", "auth/cookies/delete", "auth/cookies/clear", "auth/state", "auth/state/load", "eval", "trace/start", "trace/stop", "record", "record/start", "record/stop", "screenshot", "snapshot", "locate/role", "locate/text", "locate/label", "code/list", "code/read", "code/grep", "code/edit", "dom/tree", "dom/info", "dom/hover", "dom/click", "dom/drag", "dom/keydown", "dom/add", "dom/remove", "dom/modify", "dom/set-file", "dom/focus", "dom/fill", "dom/scroll", "dom/scroll-to", "emulation", "throttle", "dialog/status", "dialog/handle", "visibility", "storage/local", "storage/session", "reload", "shutdown", "tabs", "extension/diagnostics", "targets", "attach", "detach"];
+export declare const WATCHER_ENDPOINTS: readonly ["logs", "tail", "net", "net/requests", "net/request", "net/request/body", "net/tail", "net/clear", "net/mock", "net/mock/add", "net/mock/remove", "net/mock/clear", "net/ws", "net/ws/connection", "net/sse", "auth/cookies", "auth/cookies/get", "auth/cookies/set", "auth/cookies/delete", "auth/cookies/clear", "auth/state", "auth/state/load", "eval", "trace/start", "trace/stop", "record", "record/start", "record/stop", "record/status", "screenshot", "snapshot", "locate/role", "locate/text", "locate/label", "code/list", "code/read", "code/grep", "code/edit", "dom/tree", "dom/info", "dom/hover", "dom/click", "dom/drag", "dom/keydown", "dom/add", "dom/remove", "dom/modify", "dom/set-file", "dom/focus", "dom/fill", "dom/scroll", "dom/scroll-to", "emulation", "throttle", "dialog/status", "dialog/handle", "visibility", "storage/local", "storage/session", "reload", "shutdown", "tabs", "extension/diagnostics", "targets", "attach", "detach"];
 /** An endpoint the watcher serves. */
 export type WatcherEndpoint = (typeof WATCHER_ENDPOINTS)[number];
 /**

package/dist/http/endpoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../src/http/endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE1F;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,w6BAkEpB,CAAA;AAEV,sCAAsC;AACtC,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhE;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,kBAAkB,CAAA;IACzB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,CAAC,EAAE,WAAW,GAAG,aAAa,CAAA;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA"}
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../src/http/endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE1F;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,y7BAmEpB,CAAA;AAEV,sCAAsC;AACtC,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhE;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,kBAAkB,CAAA;IACzB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,CAAC,EAAE,WAAW,GAAG,aAAa,CAAA;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA"}