@roxybrowser/playwright 2.0.2-beta.0

package/dist/screencast.d.ts

@@ -0,0 +1,57 @@
+import type { ProtocolPageAdapter } from "./protocol/adapter.js";
+import type { ScreencastFrame } from "./types/events.js";
+import type { Disposable, Screencast as ScreencastApi } from "./types/api.js";
+export declare class RoxyScreencast implements ScreencastApi {
+    private readonly adapter;
+    private started;
+    private onFrame;
+    private manualRecorder;
+    private readonly activeRecorders;
+    constructor(adapter: ProtocolPageAdapter);
+    start(options?: {
+        onFrame?: (frame: ScreencastFrame) => Promise<any> | any;
+        path?: string;
+        size?: {
+            width: number;
+            height: number;
+        };
+        quality?: number;
+        annotate?: {
+            duration?: number;
+            position?: "top-left" | "top" | "top-right" | "bottom-left" | "bottom" | "bottom-right";
+            fontSize?: number;
+        };
+    }): Promise<Disposable>;
+    startBackgroundRecording(options: {
+        path: string;
+        size?: {
+            width: number;
+            height: number;
+        };
+        quality?: number;
+        showActions?: {
+            duration?: number;
+            position?: "top-left" | "top" | "top-right" | "bottom-left" | "bottom" | "bottom-right";
+            fontSize?: number;
+        };
+    }): Promise<Disposable>;
+    stop(): Promise<void>;
+    showActions(options?: {
+        duration?: number;
+        position?: "top-left" | "top" | "top-right" | "bottom-left" | "bottom" | "bottom-right";
+        fontSize?: number;
+        cursor?: "none" | "pointer";
+    }): Promise<Disposable>;
+    hideActions(): Promise<void>;
+    showOverlay(html: string, options?: {
+        duration?: number;
+    }): Promise<Disposable>;
+    showChapter(title: string, options?: {
+        description?: string;
+        duration?: number;
+    }): Promise<void>;
+    showOverlays(): Promise<void>;
+    hideOverlays(): Promise<void>;
+    private createRecorder;
+}
+//# sourceMappingURL=screencast.d.ts.map

package/dist/screencast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screencast.d.ts","sourceRoot":"","sources":["../src/screencast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,IAAI,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAyB9E,qBAAa,cAAe,YAAW,aAAa;IAMtC,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAiE;IAChF,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;gBAEzC,OAAO,EAAE,mBAAmB;IASnD,KAAK,CAAC,OAAO,GAAE;QACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACzD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE;YACL,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE;YACT,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,QAAQ,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,cAAc,CAAC;YACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;KACE,GAAG,OAAO,CAAC,UAAU,CAAC;IA8BtB,wBAAwB,CAAC,OAAO,EAAE;QACtC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE;YACL,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE;YACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,QAAQ,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,cAAc,CAAC;YACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;KACH,GAAG,OAAO,CAAC,UAAU,CAAC;IA2BjB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBrB,WAAW,CAAC,OAAO,CAAC,EAAE;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,cAAc,CAAC;QACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC7B,GAAG,OAAO,CAAC,UAAU,CAAC;IAKjB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,UAAU,CAAC;IAQhB,WAAW,CACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,IAAI,CAAC;IAQV,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,OAAO,CAAC,cAAc;CAmBvB"}

package/dist/screencast.js

@@ -0,0 +1,155 @@
+import { ScreencastFrameRecorder } from "./video.js";
+class DisposableStub {
+    disposeCallback;
+    constructor(dispose) {
+        this.disposeCallback = dispose;
+    }
+    async [Symbol.asyncDispose]() {
+        await this.dispose();
+    }
+    async dispose() {
+        if (!this.disposeCallback) {
+            return;
+        }
+        const dispose = this.disposeCallback;
+        this.disposeCallback = undefined;
+        await dispose();
+    }
+}
+export class RoxyScreencast {
+    adapter;
+    started = false;
+    onFrame = null;
+    manualRecorder = null;
+    activeRecorders = new Set();
+    constructor(adapter) {
+        this.adapter = adapter;
+        this.adapter.on("screencastFrame", (frame) => {
+            for (const recorder of this.activeRecorders) {
+                recorder.writeFrame(frame.data, frame.timestamp);
+            }
+            void this.onFrame?.(frame);
+        });
+    }
+    async start(options = {}) {
+        if (this.started) {
+            throw new Error("Screencast is already started");
+        }
+        this.started = true;
+        this.onFrame = options.onFrame ?? null;
+        const recorder = options.path ? this.createRecorder(options.path, options.size, options.quality) : null;
+        this.manualRecorder = recorder;
+        try {
+            await recorder?.ready();
+            await this.adapter.screencastStart({
+                sendFrames: Boolean(options.onFrame || recorder),
+                ...(options.size ? { size: options.size } : {}),
+                ...(options.quality !== undefined ? { quality: options.quality } : {}),
+                ...(options.annotate ? { annotate: options.annotate } : {})
+            });
+            if (recorder) {
+                this.activeRecorders.add(recorder);
+            }
+        }
+        catch (error) {
+            this.started = false;
+            this.onFrame = null;
+            this.manualRecorder = null;
+            throw error;
+        }
+        return new DisposableStub(() => this.stop());
+    }
+    async startBackgroundRecording(options) {
+        const recorder = this.createRecorder(options.path, options.size, options.quality);
+        await recorder.ready();
+        await this.adapter.screencastStart({
+            sendFrames: true,
+            ...(options.size ? { size: options.size } : {}),
+            ...(options.quality !== undefined ? { quality: options.quality } : {})
+        });
+        this.activeRecorders.add(recorder);
+        const actions = options.showActions
+            ? await this.showActions(options.showActions)
+            : null;
+        return new DisposableStub(async () => {
+            this.activeRecorders.delete(recorder);
+            try {
+                if (actions) {
+                    await actions.dispose();
+                }
+                await this.adapter.screencastStop();
+            }
+            finally {
+                await recorder.stop();
+            }
+        });
+    }
+    async stop() {
+        if (!this.started) {
+            return;
+        }
+        const recorder = this.manualRecorder;
+        this.started = false;
+        this.onFrame = null;
+        this.manualRecorder = null;
+        if (recorder) {
+            this.activeRecorders.delete(recorder);
+        }
+        try {
+            await this.adapter.screencastStop();
+        }
+        finally {
+            await recorder?.stop();
+        }
+    }
+    async showActions(options) {
+        await this.adapter.screencastShowActions(options);
+        return new DisposableStub(() => this.adapter.screencastHideActions());
+    }
+    async hideActions() {
+        await this.adapter.screencastHideActions();
+    }
+    async showOverlay(html, options) {
+        const result = await this.adapter.screencastShowOverlay({
+            html,
+            ...(options?.duration !== undefined ? { duration: options.duration } : {})
+        });
+        return new DisposableStub(() => this.adapter.screencastRemoveOverlay(result.id));
+    }
+    async showChapter(title, options) {
+        await this.adapter.screencastChapter({
+            title,
+            ...(options?.description !== undefined ? { description: options.description } : {}),
+            ...(options?.duration !== undefined ? { duration: options.duration } : {})
+        });
+    }
+    async showOverlays() {
+        await this.adapter.screencastSetOverlayVisible(true);
+    }
+    async hideOverlays() {
+        await this.adapter.screencastSetOverlayVisible(false);
+    }
+    createRecorder(path, size, quality) {
+        const recordingSize = size ?? deriveDefaultVideoSize(this.adapter.viewportSize());
+        return new ScreencastFrameRecorder({
+            path,
+            size: recordingSize,
+            captureFallbackFrame: async () => this.adapter.screenshot({
+                type: "jpeg",
+                ...(quality !== undefined ? { quality } : {})
+            })
+        });
+    }
+}
+function deriveDefaultVideoSize(viewport) {
+    const resolvedViewport = viewport ?? {
+        width: 800,
+        height: 600
+    };
+    const scale = Math.min(1, 800 / Math.max(resolvedViewport.width, resolvedViewport.height));
+    return {
+        width: Math.max(2, Math.floor(resolvedViewport.width * scale)) & ~1,
+        height: Math.max(2, Math.floor(resolvedViewport.height * scale)) & ~1
+    };
+}
+//# sourceMappingURL=screencast.js.map

package/dist/screencast.js.map

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

package/dist/screencastActions.d.ts

@@ -0,0 +1,2 @@
+export declare const RENDER_SCREENCAST_ACTIONS_SOURCE: string;
+//# sourceMappingURL=screencastActions.d.ts.map

package/dist/screencastActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screencastActions.d.ts","sourceRoot":"","sources":["../src/screencastActions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gCAAgC,QAqL3C,CAAC"}

package/dist/screencastActions.js

@@ -0,0 +1,183 @@
+export const RENDER_SCREENCAST_ACTIONS_SOURCE = String.raw `(payload) => {
+  const styleId = "__roxy_screencast_actions_style__";
+  const containerTag = "x-pw-action-overlays";
+  const highlightTag = "x-pw-highlight";
+  const pointTag = "x-pw-action-point";
+  const titleTag = "x-pw-title";
+  const cursorTag = "x-pw-action-cursor";
+
+  const ensureStyle = () => {
+    if (document.getElementById(styleId))
+      return;
+    const style = document.createElement("style");
+    style.id = styleId;
+    style.textContent = [
+      containerTag + " {",
+      "  position: fixed;",
+      "  inset: 0;",
+      "  pointer-events: none;",
+      "  z-index: 2147483647;",
+      "}",
+      highlightTag + ", " + pointTag + ", " + titleTag + ", " + cursorTag + " {",
+      "  position: fixed;",
+      "  pointer-events: none;",
+      "  box-sizing: border-box;",
+      "}",
+      highlightTag + " {",
+      "  background: rgba(0, 128, 255, 0.15);",
+      "  border: 2px solid rgba(0, 128, 255, 0.6);",
+      "  border-radius: 8px;",
+      "}",
+      pointTag + " {",
+      "  width: 20px;",
+      "  height: 20px;",
+      "  margin-left: -10px;",
+      "  margin-top: -10px;",
+      "  background: rgb(255, 0, 0);",
+      "  border-radius: 10px;",
+      "}",
+      titleTag + " {",
+      "  color: rgb(255, 255, 255);",
+      "  background: rgba(0, 0, 0, 0.8);",
+      "  border-radius: 6px;",
+      "  padding: 6px;",
+      "  font: 14px/1.4 sans-serif;",
+      "}",
+      cursorTag + " {",
+      "  width: 18px;",
+      "  height: 22px;",
+      "  margin-left: 2px;",
+      "  margin-top: 2px;",
+      "  transition: top 160ms ease, left 160ms ease;",
+      "}",
+      cursorTag + " svg {",
+      "  display: block;",
+      "  width: 18px;",
+      "  height: 22px;",
+      "}"
+    ].join("\n");
+    document.head.appendChild(style);
+  };
+
+  const ensureContainer = () => {
+    let container = document.querySelector(containerTag);
+    if (container instanceof HTMLElement)
+      return container;
+    container = document.createElement(containerTag);
+    container.setAttribute("aria-hidden", "true");
+    const highlight = document.createElement(highlightTag);
+    highlight.hidden = true;
+    container.appendChild(highlight);
+    const point = document.createElement(pointTag);
+    point.hidden = true;
+    container.appendChild(point);
+    const title = document.createElement(titleTag);
+    title.hidden = true;
+    container.appendChild(title);
+    const cursor = document.createElement(cursorTag);
+    cursor.hidden = true;
+    cursor.innerHTML = [
+      '<svg viewBox="0 0 18 22" xmlns="http://www.w3.org/2000/svg">',
+      '<path d="M1 1 L1 17 L5.5 13 L8 20.5 L11 19.5 L8.5 12 L15 12 Z" fill="white" stroke="black" stroke-width="1.5" stroke-linejoin="round"></path>',
+      "</svg>"
+    ].join("");
+    container.appendChild(cursor);
+    document.documentElement.appendChild(container);
+    return container;
+  };
+
+  const applyTitlePosition = (element, position) => {
+    element.style.top = "";
+    element.style.bottom = "";
+    element.style.left = "";
+    element.style.right = "";
+    element.style.transform = "";
+    switch (position) {
+      case "top-left":
+        element.style.top = "6px";
+        element.style.left = "6px";
+        return;
+      case "top":
+        element.style.top = "6px";
+        element.style.left = "50%";
+        element.style.transform = "translateX(-50%)";
+        return;
+      case "bottom-left":
+        element.style.bottom = "6px";
+        element.style.left = "6px";
+        return;
+      case "bottom":
+        element.style.bottom = "6px";
+        element.style.left = "50%";
+        element.style.transform = "translateX(-50%)";
+        return;
+      case "bottom-right":
+        element.style.bottom = "6px";
+        element.style.right = "6px";
+        return;
+      case "top-right":
+      default:
+        element.style.top = "6px";
+        element.style.right = "6px";
+    }
+  };
+
+  ensureStyle();
+  const container = ensureContainer();
+  const highlight = container.querySelector(highlightTag);
+  const point = container.querySelector(pointTag);
+  const title = container.querySelector(titleTag);
+  const cursor = container.querySelector(cursorTag);
+
+  if (!(highlight instanceof HTMLElement) || !(point instanceof HTMLElement) || !(title instanceof HTMLElement) || !(cursor instanceof HTMLElement))
+    return;
+
+  const hasAnnotation = !!payload.enabled && !!payload.annotation;
+  container.hidden = !hasAnnotation;
+
+  if (!hasAnnotation) {
+    highlight.hidden = true;
+    point.hidden = true;
+    title.hidden = true;
+    cursor.hidden = true;
+    return;
+  }
+
+  const annotation = payload.annotation;
+
+  if (annotation.highlightBox) {
+    highlight.hidden = false;
+    highlight.style.left = annotation.highlightBox.left + "px";
+    highlight.style.top = annotation.highlightBox.top + "px";
+    highlight.style.width = annotation.highlightBox.width + "px";
+    highlight.style.height = annotation.highlightBox.height + "px";
+  } else {
+    highlight.hidden = true;
+  }
+
+  if (annotation.point) {
+    point.hidden = false;
+    point.style.left = annotation.point.x + "px";
+    point.style.top = annotation.point.y + "px";
+  } else {
+    point.hidden = true;
+  }
+
+  if (annotation.title) {
+    title.hidden = false;
+    title.textContent = annotation.title;
+    title.style.fontSize = annotation.fontSize ? annotation.fontSize + "px" : "";
+    applyTitlePosition(title, annotation.position);
+  } else {
+    title.hidden = true;
+  }
+
+  if (annotation.cursorPoint && annotation.cursor !== "none") {
+    cursor.hidden = false;
+    cursor.style.left = annotation.cursorPoint.x + "px";
+    cursor.style.top = annotation.cursorPoint.y + "px";
+  } else {
+    cursor.hidden = true;
+  }
+}`;
+//# sourceMappingURL=screencastActions.js.map

package/dist/screencastActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screencastActions.js","sourceRoot":"","sources":["../src/screencastActions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqLxD,CAAC"}

package/dist/screencastOverlay.d.ts

@@ -0,0 +1,3 @@
+export declare const RENDER_SCREencast_OVERLAYS_SOURCE: string;
+export declare function createChapterOverlayHtml(title: string, description?: string): string;
+//# sourceMappingURL=screencastOverlay.d.ts.map

package/dist/screencastOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screencastOverlay.d.ts","sourceRoot":"","sources":["../src/screencastOverlay.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iCAAiC,QAwG5C,CAAC;AAEH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAIpF"}

package/dist/screencastOverlay.js

@@ -0,0 +1,119 @@
+export const RENDER_SCREencast_OVERLAYS_SOURCE = String.raw `(payload) => {
+  const styleId = "__roxy_screencast_overlay_style__";
+  const containerTag = "x-pw-user-overlays";
+  const overlayClassName = "x-pw-user-overlay";
+
+  const ensureStyle = () => {
+    if (document.getElementById(styleId))
+      return;
+    const style = document.createElement("style");
+    style.id = styleId;
+    style.textContent = [
+      containerTag + ", ." + overlayClassName + " {",
+      "  position: fixed;",
+      "  inset: 0;",
+      "}",
+      containerTag + " {",
+      "  pointer-events: none;",
+      "  z-index: 2147483647;",
+      "}",
+      "." + overlayClassName + " {",
+      "  pointer-events: none;",
+      "}",
+      "." + overlayClassName + "[data-roxy-kind=\"chapter\"] {",
+      "  display: flex;",
+      "  align-items: center;",
+      "  justify-content: center;",
+      "  background: rgba(0, 0, 0, 0.24);",
+      "  backdrop-filter: blur(8px);",
+      "}",
+      "." + overlayClassName + "[data-roxy-kind=\"chapter\"] > div {",
+      "  background: rgba(0, 0, 0, 0.62);",
+      "  color: white;",
+      "  padding: 24px 28px;",
+      "  border-radius: 16px;",
+      "  max-width: min(720px, calc(100vw - 48px));",
+      "  text-align: center;",
+      "  box-shadow: 0 18px 48px rgba(0, 0, 0, 0.28);",
+      "}",
+      "." + overlayClassName + "[data-roxy-kind=\"chapter\"] h1 {",
+      "  margin: 0;",
+      "  font-size: 32px;",
+      "  line-height: 1.2;",
+      "}",
+      "." + overlayClassName + "[data-roxy-kind=\"chapter\"] p {",
+      "  margin: 12px 0 0;",
+      "  font-size: 18px;",
+      "  line-height: 1.4;",
+      "  opacity: 0.92;",
+      "}"
+    ].join("\n");
+    document.head.appendChild(style);
+  };
+
+  const ensureContainer = () => {
+    let container = document.querySelector(containerTag);
+    if (container instanceof HTMLElement)
+      return container;
+    container = document.createElement(containerTag);
+    container.setAttribute("aria-hidden", "true");
+    document.documentElement.appendChild(container);
+    return container;
+  };
+
+  const sanitizeOverlay = (element) => {
+    for (const script of element.querySelectorAll("script"))
+      script.remove();
+    for (const child of element.querySelectorAll("*")) {
+      for (const attribute of [...child.attributes]) {
+        if (attribute.name.toLowerCase().startsWith("on"))
+          child.removeAttribute(attribute.name);
+      }
+    }
+  };
+
+  ensureStyle();
+  const container = ensureContainer();
+  const desiredIds = new Set(payload.overlays.map((entry) => entry.id));
+  const existingSelector = "." + overlayClassName + "[data-roxy-overlay-id]";
+
+  for (const existing of [...container.querySelectorAll(existingSelector)]) {
+    const id = existing.getAttribute("data-roxy-overlay-id");
+    if (!id || !desiredIds.has(id))
+      existing.remove();
+  }
+
+  for (const entry of payload.overlays) {
+    const overlaySelector = "." + overlayClassName + "[data-roxy-overlay-id=\"" + entry.id + "\"]";
+    let element = container.querySelector(overlaySelector);
+    if (!(element instanceof HTMLElement)) {
+      element = document.createElement("div");
+      element.className = overlayClassName;
+      element.setAttribute("data-roxy-overlay-id", entry.id);
+      container.appendChild(element);
+    }
+    if (entry.kind)
+      element.setAttribute("data-roxy-kind", entry.kind);
+    else
+      element.removeAttribute("data-roxy-kind");
+
+    element.innerHTML = entry.html;
+    sanitizeOverlay(element);
+  }
+
+  container.hidden = !payload.visible || payload.overlays.length === 0;
+}`;
+export function createChapterOverlayHtml(title, description) {
+    const escapedTitle = escapeHtml(title);
+    const descriptionHtml = description ? `<p>${escapeHtml(description)}</p>` : "";
+    return `<div><h1>${escapedTitle}</h1>${descriptionHtml}</div>`;
+}
+function escapeHtml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+//# sourceMappingURL=screencastOverlay.js.map

package/dist/screencastOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screencastOverlay.js","sourceRoot":"","sources":["../src/screencastOverlay.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwGzD,CAAC;AAEH,MAAM,UAAU,wBAAwB,CAAC,KAAa,EAAE,WAAoB;IAC1E,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,eAAe,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,OAAO,YAAY,YAAY,QAAQ,eAAe,QAAQ,CAAC;AACjE,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC"}

package/dist/screenshotOptions.d.ts

@@ -0,0 +1,26 @@
+import type { ScreenshotClipOrigin } from "./protocol/adapter.js";
+import type { Rect, ScreenshotOptions, ScreenshotType, ViewportSize } from "./types/options.js";
+export type InternalScreenshotOptions = ScreenshotOptions & {
+    __fitsViewport?: boolean;
+};
+export interface NormalizedScreenshot {
+    fitsViewport: boolean;
+    options: InternalScreenshotOptions;
+}
+export declare function determineScreenshotType(options: {
+    path?: string;
+    type?: ScreenshotType;
+}): ScreenshotType | undefined;
+export declare function validateScreenshotOptions(options: ScreenshotOptions): "jpeg" | "png";
+export declare function trimClipToSize(clip: Rect, size: ViewportSize): Rect;
+export declare function normalizePageScreenshotOptions(options: ScreenshotOptions, page: {
+    evaluate<R, Arg>(pageFunction: (arg: Arg) => R | Promise<R>, arg: Arg): Promise<R>;
+    evaluate<R>(pageFunction: () => R | Promise<R>, arg?: any): Promise<R>;
+    viewportSize(): ViewportSize | null;
+}, clipOrigin?: ScreenshotClipOrigin): Promise<NormalizedScreenshot>;
+export declare function screenshotOptionsWithFitsViewport(options: ScreenshotOptions, fitsViewport: boolean): InternalScreenshotOptions;
+export declare function normalizeElementScreenshotClip(box: Rect, element: {
+    evaluate<R>(pageFunction: () => R | Promise<R>, arg?: any): Promise<R>;
+}, clipOrigin?: ScreenshotClipOrigin): Promise<Rect>;
+export declare function enclosingIntRect(rect: Rect): Rect;
+//# sourceMappingURL=screenshotOptions.d.ts.map

package/dist/screenshotOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshotOptions.d.ts","sourceRoot":"","sources":["../src/screenshotOptions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEhG,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,GAAG;IAC1D,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,yBAAyB,CAAC;CACpC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,cAAc,CAAA;CAAE,GAAG,cAAc,GAAG,SAAS,CAgBrH;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,KAAK,CAyBpF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAcnE;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE;IACJ,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnF,QAAQ,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvE,YAAY,IAAI,YAAY,GAAG,IAAI,CAAC;CACrC,EACD,UAAU,GAAE,oBAAiC,GAC5C,OAAO,CAAC,oBAAoB,CAAC,CAqD/B;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,iBAAiB,EAC1B,YAAY,EAAE,OAAO,GACpB,yBAAyB,CAK3B;AAED,wBAAsB,8BAA8B,CAClD,GAAG,EAAE,IAAI,EACT,OAAO,EAAE;IACP,QAAQ,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACxE,EACD,UAAU,GAAE,oBAAiC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAWjD"}