@wopee-io/wopee.wdio 4.0.0

package/build/desktopBrowser/helpers/utils.js

@@ -0,0 +1,77 @@
+/**
+ * Adjusts data values based on the device pixel ratio.
+ *
+ * @param {T} data - The data to be adjusted.
+ * @param {number} devicePixelRatio - The device pixel ratio to scale the data.
+ * @returns {T} - The adjusted data.
+ */
+export function calculateDprData(data, devicePixelRatio) {
+    // Loop through each property in the data object
+    for (const key in data) {
+        if (typeof data[key] === 'number') {
+            // Multiply numeric values by the device pixel ratio
+            // @ts-ignore
+            data[key] *= devicePixelRatio;
+        }
+    }
+    return data;
+}
+/**
+ * Waits for a specified amount of time.
+ *
+ * @param milliseconds - The time to wait in milliseconds.
+ * @returns A Promise that resolves after the specified time.
+ */
+export async function waitFor(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+/**
+ * Retrieves the size of a screenshot in pixels, adjusted for device pixel ratio.
+ *
+ * @param screenshot - The screenshot data in base64 format.
+ * @param devicePixelRatio - The device pixel ratio (default is 1).
+ * @returns An object containing the width and height of the screenshot.
+ */
+export function getScreenshotSize(screenshot, devicePixelRatio = 1) {
+    const buffer = Buffer.from(screenshot, 'base64');
+    const height = buffer.readUInt32BE(20) / devicePixelRatio;
+    const width = buffer.readUInt32BE(16) / devicePixelRatio;
+    return { width, height };
+}
+/**
+ * Retrieve various screen dimensions for mobile run.
+ *
+ * @returns {ScreenDimensions} - An object containing dimensions for body, HTML, and window properties.
+ */
+export async function getScreenDimensionsMobile(methods) {
+    const size = await methods.getWindowSize();
+    const { width, height } = size;
+    const bodyDimensions = {
+        scrollHeight: 0,
+        offsetHeight: 0,
+    };
+    const htmlDimensions = {
+        clientHeight: height,
+        clientWidth: width,
+        scrollHeight: 0,
+        scrollWidth: 0,
+        offsetHeight: 0,
+    };
+    const windowDimensions = {
+        innerWidth: width,
+        innerHeight: height,
+        outerHeight: height,
+        outerWidth: width,
+        devicePixelRatio: 1,
+        screenWidth: width,
+        screenHeight: height,
+    };
+    return {
+        dimensions: {
+            body: bodyDimensions,
+            html: htmlDimensions,
+            window: windowDimensions,
+        },
+    };
+}
+//# sourceMappingURL=utils.js.map

package/build/desktopBrowser/helpers/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../lib/desktopBrowser/helpers/utils.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAI,IAAO,EAAE,gBAAwB;IACnE,gDAAgD;IAChD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;YAClC,oDAAoD;YACpD,aAAa;YACb,IAAI,CAAC,GAAG,CAAC,IAAI,gBAAgB,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,YAAoB;IAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,gBAAgB,GAAG,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC;IAEzD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,OAAgB;IAC9D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;IAC3C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE/B,MAAM,cAAc,GAAG;QACrB,YAAY,EAAE,CAAC;QACf,YAAY,EAAE,CAAC;KAChB,CAAC;IAEF,MAAM,cAAc,GAAG;QACrB,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;KAChB,CAAC;IAEF,MAAM,gBAAgB,GAAG;QACvB,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,KAAK;QACjB,gBAAgB,EAAE,CAAC;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,MAAM;KACrB,CAAC;IAEF,OAAO;QACL,UAAU,EAAE;YACV,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,gBAAgB;SACzB;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { Methods } from '../../domain/model/methods.interface.js';\nimport { ScreenshotSize } from '../../domain/model/screenshotSize.interface.js';\nimport { ScreenDimensions } from '../clientSideScript/screenDimensions.interfaces.js';\n\n/**\n * Adjusts data values based on the device pixel ratio.\n *\n * @param {T} data - The data to be adjusted.\n * @param {number} devicePixelRatio - The device pixel ratio to scale the data.\n * @returns {T} - The adjusted data.\n */\nexport function calculateDprData<T>(data: T, devicePixelRatio: number): T {\n  // Loop through each property in the data object\n  for (const key in data) {\n    if (typeof data[key] === 'number') {\n      // Multiply numeric values by the device pixel ratio\n      // @ts-ignore\n      data[key] *= devicePixelRatio;\n    }\n  }\n\n  return data;\n}\n\n/**\n * Waits for a specified amount of time.\n *\n * @param milliseconds - The time to wait in milliseconds.\n * @returns A Promise that resolves after the specified time.\n */\nexport async function waitFor(milliseconds: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, milliseconds));\n}\n\n/**\n * Retrieves the size of a screenshot in pixels, adjusted for device pixel ratio.\n *\n * @param screenshot - The screenshot data in base64 format.\n * @param devicePixelRatio - The device pixel ratio (default is 1).\n * @returns An object containing the width and height of the screenshot.\n */\nexport function getScreenshotSize(screenshot: string, devicePixelRatio = 1): ScreenshotSize {\n  const buffer = Buffer.from(screenshot, 'base64');\n  const height = buffer.readUInt32BE(20) / devicePixelRatio;\n  const width = buffer.readUInt32BE(16) / devicePixelRatio;\n\n  return { width, height };\n}\n\n/**\n * Retrieve various screen dimensions for mobile run.\n *\n * @returns {ScreenDimensions} - An object containing dimensions for body, HTML, and window properties.\n */\nexport async function getScreenDimensionsMobile(methods: Methods): Promise<ScreenDimensions> {\n  const size = await methods.getWindowSize();\n  const { width, height } = size;\n\n  const bodyDimensions = {\n    scrollHeight: 0,\n    offsetHeight: 0,\n  };\n\n  const htmlDimensions = {\n    clientHeight: height,\n    clientWidth: width,\n    scrollHeight: 0,\n    scrollWidth: 0,\n    offsetHeight: 0,\n  };\n\n  const windowDimensions = {\n    innerWidth: width,\n    innerHeight: height,\n    outerHeight: height,\n    outerWidth: width,\n    devicePixelRatio: 1,\n    screenWidth: width,\n    screenHeight: height,\n  };\n\n  return {\n    dimensions: {\n      body: bodyDimensions,\n      html: htmlDimensions,\n      window: windowDimensions,\n    },\n  };\n}\n"]}

package/build/desktopBrowser/index.d.ts

@@ -0,0 +1,8 @@
+import { ScreenshotOutput } from '../domain/model/screenshotOutput.interface.js';
+import trackElement from './commands/trackElement.js';
+import trackFullPageScreen from './commands/trackFullPageScreen.js';
+import trackImage from './commands/trackImage.js';
+import trackScreen from './commands/trackScreen.js';
+import { InstanceData } from './methods/instanceData.interfaces.js';
+export { trackImage, ScreenshotOutput, trackScreen, trackElement, trackFullPageScreen, InstanceData };
+//# sourceMappingURL=index.d.ts.map

package/build/desktopBrowser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/desktopBrowser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACjF,OAAO,YAAY,MAAM,4BAA4B,CAAC;AACtD,OAAO,mBAAmB,MAAM,mCAAmC,CAAC;AACpE,OAAO,UAAU,MAAM,0BAA0B,CAAC;AAClD,OAAO,WAAW,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,CAAC"}

package/build/desktopBrowser/index.js

@@ -0,0 +1,6 @@
+import trackElement from './commands/trackElement.js';
+import trackFullPageScreen from './commands/trackFullPageScreen.js';
+import trackImage from './commands/trackImage.js';
+import trackScreen from './commands/trackScreen.js';
+export { trackImage, trackScreen, trackElement, trackFullPageScreen };
+//# sourceMappingURL=index.js.map

package/build/desktopBrowser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/desktopBrowser/index.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,4BAA4B,CAAC;AACtD,OAAO,mBAAmB,MAAM,mCAAmC,CAAC;AACpE,OAAO,UAAU,MAAM,0BAA0B,CAAC;AAClD,OAAO,WAAW,MAAM,2BAA2B,CAAC;AAGpD,OAAO,EAAE,UAAU,EAAoB,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAgB,CAAC","sourcesContent":["import { ScreenshotOutput } from '../domain/model/screenshotOutput.interface.js';\nimport trackElement from './commands/trackElement.js';\nimport trackFullPageScreen from './commands/trackFullPageScreen.js';\nimport trackImage from './commands/trackImage.js';\nimport trackScreen from './commands/trackScreen.js';\nimport { InstanceData } from './methods/instanceData.interfaces.js';\n\nexport { trackImage, ScreenshotOutput, trackScreen, trackElement, trackFullPageScreen, InstanceData };\n"]}

package/build/desktopBrowser/methods/elementPosition.d.ts

@@ -0,0 +1,23 @@
+import { ElementPosition } from '../../core/domain/valueObjects/elementPosition.interface.js';
+import { WopeeService } from '../../domain/service/wopeeService.js';
+import { Executor } from './methods.interface.js';
+/**
+ * Get the position of an element on a desktop browser.
+ *
+ * @param {Executor} executor         - The function to execute JavaScript in the browser.
+ * @param {HTMLElement} element       - The element for which the position is to be determined.
+ * @param {Object} options            - Additional options for calculating the position.
+ * @param {number} options.innerHeight - The inner height of the screen.
+ * @param {number} options.screenshotHeight - The height of the screenshot.
+ *
+ * @returns {Promise<ElementPosition>} - A Promise that resolves to an object with position properties.
+ * @property {number} height - The height of the element.
+ * @property {number} width - The width of the element.
+ * @property {number} x - The X-coordinate of the element's top-left corner.
+ * @property {number} y - The Y-coordinate of the element's top-left corner.
+ */
+export declare function getElementPositionDesktop(wopeeService: WopeeService, executor: Executor, element: WebdriverIO.Element, { innerHeight, screenshotHeight }: {
+    innerHeight: number;
+    screenshotHeight: number;
+}): Promise<ElementPosition>;
+//# sourceMappingURL=elementPosition.d.ts.map

package/build/desktopBrowser/methods/elementPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementPosition.d.ts","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/elementPosition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6DAA6D,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,WAAW,CAAC,OAAO,EAC5B,EAAE,WAAW,EAAE,gBAAgB,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GACnF,OAAO,CAAC,eAAe,CAAC,CAQ1B"}

package/build/desktopBrowser/methods/elementPosition.js

@@ -0,0 +1,26 @@
+/**
+ * Get the position of an element on a desktop browser.
+ *
+ * @param {Executor} executor         - The function to execute JavaScript in the browser.
+ * @param {HTMLElement} element       - The element for which the position is to be determined.
+ * @param {Object} options            - Additional options for calculating the position.
+ * @param {number} options.innerHeight - The inner height of the screen.
+ * @param {number} options.screenshotHeight - The height of the screenshot.
+ *
+ * @returns {Promise<ElementPosition>} - A Promise that resolves to an object with position properties.
+ * @property {number} height - The height of the element.
+ * @property {number} width - The width of the element.
+ * @property {number} x - The X-coordinate of the element's top-left corner.
+ * @property {number} y - The Y-coordinate of the element's top-left corner.
+ */
+export async function getElementPositionDesktop(wopeeService, executor, element, { innerHeight, screenshotHeight }) {
+    if (screenshotHeight > innerHeight) {
+        // Calculate position using DOM method when screenshot height is greater than inner height.
+        return wopeeService.clientSideScript.getElementPositionTopDom(executor, element);
+    }
+    else {
+        // Calculate position using window method when screenshot height is not greater than inner height.
+        return wopeeService.clientSideScript.getElementPositionTopWindow(executor, element);
+    }
+}
+//# sourceMappingURL=elementPosition.js.map

package/build/desktopBrowser/methods/elementPosition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementPosition.js","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/elementPosition.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,YAA0B,EAC1B,QAAkB,EAClB,OAA4B,EAC5B,EAAE,WAAW,EAAE,gBAAgB,EAAqD;IAEpF,IAAI,gBAAgB,GAAG,WAAW,EAAE,CAAC;QACnC,2FAA2F;QAC3F,OAAO,YAAY,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;SAAM,CAAC;QACN,kGAAkG;QAClG,OAAO,YAAY,CAAC,gBAAgB,CAAC,2BAA2B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtF,CAAC;AACH,CAAC","sourcesContent":["import { ElementPosition } from '../../core/domain/valueObjects/elementPosition.interface.js';\nimport { WopeeService } from '../../domain/service/wopeeService.js';\nimport { Executor } from './methods.interface.js';\n\n/**\n * Get the position of an element on a desktop browser.\n *\n * @param {Executor} executor         - The function to execute JavaScript in the browser.\n * @param {HTMLElement} element       - The element for which the position is to be determined.\n * @param {Object} options            - Additional options for calculating the position.\n * @param {number} options.innerHeight - The inner height of the screen.\n * @param {number} options.screenshotHeight - The height of the screenshot.\n *\n * @returns {Promise<ElementPosition>} - A Promise that resolves to an object with position properties.\n * @property {number} height - The height of the element.\n * @property {number} width - The width of the element.\n * @property {number} x - The X-coordinate of the element's top-left corner.\n * @property {number} y - The Y-coordinate of the element's top-left corner.\n */\nexport async function getElementPositionDesktop(\n  wopeeService: WopeeService,\n  executor: Executor,\n  element: WebdriverIO.Element,\n  { innerHeight, screenshotHeight }: { innerHeight: number; screenshotHeight: number },\n): Promise<ElementPosition> {\n  if (screenshotHeight > innerHeight) {\n    // Calculate position using DOM method when screenshot height is greater than inner height.\n    return wopeeService.clientSideScript.getElementPositionTopDom(executor, element);\n  } else {\n    // Calculate position using window method when screenshot height is not greater than inner height.\n    return wopeeService.clientSideScript.getElementPositionTopWindow(executor, element);\n  }\n}\n"]}

package/build/desktopBrowser/methods/images.d.ts

@@ -0,0 +1,27 @@
+import { CroppedBase64Image, RotateBase64ImageOptions } from './images.interfaces.js';
+import { FullPageScreenshotsData } from './screenshots.interfaces.js';
+/**
+ * Create a cropped base64 image using Canvas.
+ *
+ * @param {CroppedBase64Image} params - Parameters for creating the cropped image.
+ * @returns {Promise<string>} - A Promise that resolves to the base64 representation of the cropped image.
+ */
+export declare function makeCroppedBase64Image({ base64Image, devicePixelRatio, isLandscape, rectangles, instanceData, croppingOptions, }: CroppedBase64Image): Promise<string>;
+/**
+ * Create a full-page image from a series of screenshots and return it as a base64-encoded string.
+ * @param screenshotsData - Information about the screenshots and their placement.
+ * @param devicePixelRatio - The device's pixel ratio for rendering.
+ * @returns A base64-encoded string representing the full-page image.
+ */
+export declare function makeFullPageBase64Image(screenshotsData: FullPageScreenshotsData, { devicePixelRatio, isLandscape }: {
+    devicePixelRatio: number;
+    isLandscape: boolean;
+}): Promise<string>;
+/**
+ * Rotate a base64 image by the specified number of degrees.
+ *
+ * @param {RotateBase64ImageOptions} options - Options for rotating the base64 image.
+ * @returns {Promise<string>} - A Promise that resolves to the base64 representation of the rotated image.
+ */
+export declare function rotateBase64Image({ base64Image, degrees, newHeight, newWidth, }: RotateBase64ImageOptions): Promise<string>;
+//# sourceMappingURL=images.d.ts.map

package/build/desktopBrowser/methods/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/images.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGtE;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8CtC;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,eAAe,EAAE,uBAAuB,EACxC,EAAE,gBAAgB,EAAE,WAAW,EAAE,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GACpF,OAAO,CAAC,MAAM,CAAC,CAiDjB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,WAAW,EACX,OAAO,EACP,SAAS,EACT,QAAQ,GACT,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB5C"}

package/build/desktopBrowser/methods/images.interfaces.d.ts

@@ -0,0 +1,31 @@
+import { CroppingOptions } from '../../domain/model/config.interface.js';
+import { InstanceData } from './instanceData.interfaces.js';
+import { RectanglesOutput } from './rectangles.interfaces.js';
+/**
+ * Represents a cropped image in base64 format with associated metadata.
+ */
+export interface CroppedBase64Image {
+    /** The base64 encoded image. */
+    base64Image: string;
+    /** The device pixel ratio. */
+    devicePixelRatio: number;
+    isLandscape: boolean;
+    /** Output rectangles information. */
+    rectangles: RectanglesOutput;
+    instanceData: InstanceData;
+    croppingOptions: CroppingOptions;
+}
+/**
+ * Represents options for rotating a base64 encoded image.
+ */
+export interface RotateBase64ImageOptions {
+    /** The base64 encoded image. */
+    base64Image: string;
+    /** The degrees to rotate the image by. */
+    degrees: number;
+    /** The new height of the rotated image. */
+    newHeight: number;
+    /** The new width of the rotated image. */
+    newWidth: number;
+}
+//# sourceMappingURL=images.interfaces.d.ts.map

package/build/desktopBrowser/methods/images.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.interfaces.d.ts","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/images.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,qCAAqC;IACrC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/build/desktopBrowser/methods/images.interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=images.interfaces.js.map

package/build/desktopBrowser/methods/images.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.interfaces.js","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/images.interfaces.ts"],"names":[],"mappings":"","sourcesContent":["import { CroppingOptions } from '../../domain/model/config.interface.js';\nimport { InstanceData } from './instanceData.interfaces.js';\nimport { RectanglesOutput } from './rectangles.interfaces.js';\n\n/**\n * Represents a cropped image in base64 format with associated metadata.\n */\nexport interface CroppedBase64Image {\n  /** The base64 encoded image. */\n  base64Image: string;\n  /** The device pixel ratio. */\n  devicePixelRatio: number;\n  isLandscape: boolean;\n  /** Output rectangles information. */\n  rectangles: RectanglesOutput;\n  instanceData: InstanceData;\n  croppingOptions: CroppingOptions;\n}\n\n/**\n * Represents options for rotating a base64 encoded image.\n */\nexport interface RotateBase64ImageOptions {\n  /** The base64 encoded image. */\n  base64Image: string;\n  /** The degrees to rotate the image by. */\n  degrees: number;\n  /** The new height of the rotated image. */\n  newHeight: number;\n  /** The new width of the rotated image. */\n  newWidth: number;\n}\n"]}

package/build/desktopBrowser/methods/images.js

@@ -0,0 +1,109 @@
+import { getScreenshotSize } from '../helpers/utils.js';
+import { createCanvas, loadImage } from 'canvas';
+/**
+ * Create a cropped base64 image using Canvas.
+ *
+ * @param {CroppedBase64Image} params - Parameters for creating the cropped image.
+ * @returns {Promise<string>} - A Promise that resolves to the base64 representation of the cropped image.
+ */
+export async function makeCroppedBase64Image({ base64Image, devicePixelRatio, isLandscape, rectangles, instanceData, croppingOptions, }) {
+    // Determine if the image is rotated
+    const { height: screenshotHeight, width: screenshotWidth } = getScreenshotSize(base64Image, devicePixelRatio);
+    const isRotated = isLandscape && screenshotHeight > screenshotWidth;
+    // Rotate the image if necessary
+    const newBase64Image = isRotated
+        ? await rotateBase64Image({
+            base64Image,
+            degrees: -90,
+            newHeight: screenshotWidth,
+            newWidth: screenshotHeight,
+        })
+        : base64Image;
+    const { height, width } = rectangles;
+    let canvasWidth = null;
+    let canvasHeight = null;
+    if (instanceData.isMobile) {
+        canvasWidth = screenshotWidth;
+        canvasHeight = screenshotHeight;
+    }
+    else {
+        canvasHeight = height;
+        canvasWidth = width;
+    }
+    // Create a canvas and load the image
+    const canvas = createCanvas(canvasWidth, canvasHeight);
+    const image = await loadImage(`data:image/png;base64,${newBase64Image}`);
+    const ctx = canvas.getContext('2d');
+    const xCropLeft = croppingOptions.xCropLeft;
+    const xCropRight = croppingOptions.xCropRight;
+    const yCropTop = croppingOptions.yCropTop;
+    const yCropBottom = croppingOptions.yCropBottom;
+    const sourceXStart = xCropLeft;
+    const sourceYStart = yCropTop;
+    canvasHeight = canvasHeight - yCropTop - yCropBottom;
+    canvasWidth = canvasWidth - xCropLeft - xCropRight;
+    // Draw the cropped portion of the image onto the canvas
+    ctx.drawImage(image, sourceXStart, sourceYStart, canvasWidth, canvasHeight, 0, 0, canvasWidth, canvasHeight);
+    // Convert the canvas to a base64 data URL and return it
+    return canvas.toDataURL().replace(/^data:image\/png;base64,/, '');
+}
+/**
+ * Create a full-page image from a series of screenshots and return it as a base64-encoded string.
+ * @param screenshotsData - Information about the screenshots and their placement.
+ * @param devicePixelRatio - The device's pixel ratio for rendering.
+ * @returns A base64-encoded string representing the full-page image.
+ */
+export async function makeFullPageBase64Image(screenshotsData, { devicePixelRatio, isLandscape }) {
+    // Calculate the canvas dimensions
+    const canvasWidth = screenshotsData.fullPageWidth;
+    const canvasHeight = screenshotsData.fullPageHeight;
+    // Create a canvas element and get its 2D rendering context
+    const canvas = createCanvas(canvasWidth, canvasHeight);
+    const ctx = canvas.getContext('2d');
+    // Iterate through the screenshots and render them onto the canvas
+    for (let i = 0; i < screenshotsData.data.length; i++) {
+        const screenshotData = screenshotsData.data[i];
+        const currentScreenshot = screenshotData.screenshot;
+        // Determine if the image needs to be rotated
+        const { height: screenshotHeight, width: screenshotWidth } = getScreenshotSize(currentScreenshot, devicePixelRatio);
+        const isRotated = isLandscape && screenshotHeight > screenshotWidth;
+        // Rotate the image if necessary
+        const newBase64Image = isRotated
+            ? await rotateBase64Image({
+                base64Image: currentScreenshot,
+                degrees: -90,
+                newHeight: screenshotWidth,
+                newWidth: screenshotHeight,
+            })
+            : currentScreenshot;
+        // Load the rotated image
+        const image = await loadImage(`data:image/png;base64,${newBase64Image}`);
+        // Draw the image onto the canvas
+        ctx.drawImage(image, screenshotData.imageXPosition, screenshotData.imageYPosition, screenshotData.imageWidth, screenshotData.imageHeight, 0, screenshotData.canvasYPosition, screenshotData.imageWidth, screenshotData.imageHeight);
+    }
+    // Convert the canvas to a base64-encoded PNG
+    const base64Image = canvas.toDataURL().replace(/^data:image\/png;base64,/, '');
+    return base64Image;
+}
+/**
+ * Rotate a base64 image by the specified number of degrees.
+ *
+ * @param {RotateBase64ImageOptions} options - Options for rotating the base64 image.
+ * @returns {Promise<string>} - A Promise that resolves to the base64 representation of the rotated image.
+ */
+export async function rotateBase64Image({ base64Image, degrees, newHeight, newWidth, }) {
+    // Create a canvas and load the image
+    const canvas = createCanvas(newWidth, newHeight);
+    const ctx = canvas.getContext('2d');
+    const image = await loadImage(`data:image/png;base64,${base64Image}`);
+    // Set canvas dimensions based on rotation angle
+    canvas.width = degrees % 180 === 0 ? image.width : image.height;
+    canvas.height = degrees % 180 === 0 ? image.height : image.width;
+    // Translate and rotate the image on the canvas
+    ctx.translate(canvas.width / 2, canvas.height / 2);
+    ctx.rotate((degrees * Math.PI) / 180);
+    ctx.drawImage(image, image.width / -2, image.height / -2);
+    // Return the rotated image as base64
+    return canvas.toDataURL().replace(/^data:image\/png;base64,/, '');
+}
+//# sourceMappingURL=images.js.map

package/build/desktopBrowser/methods/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/images.ts"],"names":[],"mappings":"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","sourcesContent":["import { getScreenshotSize } from '../helpers/utils.js';\nimport { CroppedBase64Image, RotateBase64ImageOptions } from './images.interfaces.js';\nimport { FullPageScreenshotsData } from './screenshots.interfaces.js';\nimport { createCanvas, loadImage } from 'canvas';\n\n/**\n * Create a cropped base64 image using Canvas.\n *\n * @param {CroppedBase64Image} params - Parameters for creating the cropped image.\n * @returns {Promise<string>} - A Promise that resolves to the base64 representation of the cropped image.\n */\nexport async function makeCroppedBase64Image({\n  base64Image,\n  devicePixelRatio,\n  isLandscape,\n  rectangles,\n  instanceData,\n  croppingOptions,\n}: CroppedBase64Image): Promise<string> {\n  // Determine if the image is rotated\n  const { height: screenshotHeight, width: screenshotWidth } = getScreenshotSize(base64Image, devicePixelRatio);\n  const isRotated = isLandscape && screenshotHeight > screenshotWidth;\n\n  // Rotate the image if necessary\n  const newBase64Image = isRotated\n    ? await rotateBase64Image({\n        base64Image,\n        degrees: -90,\n        newHeight: screenshotWidth,\n        newWidth: screenshotHeight,\n      })\n    : base64Image;\n\n  const { height, width } = rectangles;\n  let canvasWidth = null;\n  let canvasHeight = null;\n  if (instanceData.isMobile) {\n    canvasWidth = screenshotWidth;\n    canvasHeight = screenshotHeight;\n  } else {\n    canvasHeight = height;\n    canvasWidth = width;\n  }\n\n  // Create a canvas and load the image\n  const canvas = createCanvas(canvasWidth, canvasHeight);\n  const image = await loadImage(`data:image/png;base64,${newBase64Image}`);\n  const ctx = canvas.getContext('2d');\n\n  const xCropLeft = croppingOptions.xCropLeft;\n  const xCropRight = croppingOptions.xCropRight;\n  const yCropTop = croppingOptions.yCropTop;\n  const yCropBottom = croppingOptions.yCropBottom;\n\n  const sourceXStart = xCropLeft;\n  const sourceYStart = yCropTop;\n  canvasHeight = canvasHeight - yCropTop - yCropBottom;\n  canvasWidth = canvasWidth - xCropLeft - xCropRight;\n\n  // Draw the cropped portion of the image onto the canvas\n  ctx.drawImage(image, sourceXStart, sourceYStart, canvasWidth, canvasHeight, 0, 0, canvasWidth, canvasHeight);\n\n  // Convert the canvas to a base64 data URL and return it\n  return canvas.toDataURL().replace(/^data:image\\/png;base64,/, '');\n}\n\n/**\n * Create a full-page image from a series of screenshots and return it as a base64-encoded string.\n * @param screenshotsData - Information about the screenshots and their placement.\n * @param devicePixelRatio - The device's pixel ratio for rendering.\n * @returns A base64-encoded string representing the full-page image.\n */\nexport async function makeFullPageBase64Image(\n  screenshotsData: FullPageScreenshotsData,\n  { devicePixelRatio, isLandscape }: { devicePixelRatio: number; isLandscape: boolean },\n): Promise<string> {\n  // Calculate the canvas dimensions\n  const canvasWidth = screenshotsData.fullPageWidth;\n  const canvasHeight = screenshotsData.fullPageHeight;\n\n  // Create a canvas element and get its 2D rendering context\n  const canvas = createCanvas(canvasWidth, canvasHeight);\n  const ctx = canvas.getContext('2d');\n\n  // Iterate through the screenshots and render them onto the canvas\n  for (let i = 0; i < screenshotsData.data.length; i++) {\n    const screenshotData = screenshotsData.data[i];\n    const currentScreenshot = screenshotData.screenshot;\n\n    // Determine if the image needs to be rotated\n    const { height: screenshotHeight, width: screenshotWidth } = getScreenshotSize(currentScreenshot, devicePixelRatio);\n    const isRotated = isLandscape && screenshotHeight > screenshotWidth;\n\n    // Rotate the image if necessary\n    const newBase64Image = isRotated\n      ? await rotateBase64Image({\n          base64Image: currentScreenshot,\n          degrees: -90,\n          newHeight: screenshotWidth,\n          newWidth: screenshotHeight,\n        })\n      : currentScreenshot;\n\n    // Load the rotated image\n    const image = await loadImage(`data:image/png;base64,${newBase64Image}`);\n\n    // Draw the image onto the canvas\n    ctx.drawImage(\n      image,\n      screenshotData.imageXPosition,\n      screenshotData.imageYPosition,\n      screenshotData.imageWidth,\n      screenshotData.imageHeight,\n      0,\n      screenshotData.canvasYPosition,\n      screenshotData.imageWidth,\n      screenshotData.imageHeight,\n    );\n  }\n\n  // Convert the canvas to a base64-encoded PNG\n  const base64Image = canvas.toDataURL().replace(/^data:image\\/png;base64,/, '');\n\n  return base64Image;\n}\n\n/**\n * Rotate a base64 image by the specified number of degrees.\n *\n * @param {RotateBase64ImageOptions} options - Options for rotating the base64 image.\n * @returns {Promise<string>} - A Promise that resolves to the base64 representation of the rotated image.\n */\nexport async function rotateBase64Image({\n  base64Image,\n  degrees,\n  newHeight,\n  newWidth,\n}: RotateBase64ImageOptions): Promise<string> {\n  // Create a canvas and load the image\n  const canvas = createCanvas(newWidth, newHeight);\n  const ctx = canvas.getContext('2d');\n  const image = await loadImage(`data:image/png;base64,${base64Image}`);\n\n  // Set canvas dimensions based on rotation angle\n  canvas.width = degrees % 180 === 0 ? image.width : image.height;\n  canvas.height = degrees % 180 === 0 ? image.height : image.width;\n\n  // Translate and rotate the image on the canvas\n  ctx.translate(canvas.width / 2, canvas.height / 2);\n  ctx.rotate((degrees * Math.PI) / 180);\n  ctx.drawImage(image, image.width / -2, image.height / -2);\n\n  // Return the rotated image as base64\n  return canvas.toDataURL().replace(/^data:image\\/png;base64,/, '');\n}\n"]}

package/build/desktopBrowser/methods/instanceData.interfaces.d.ts

@@ -0,0 +1,10 @@
+import { ScreenDimensions } from '../clientSideScript/screenDimensions.interfaces.js';
+export interface InstanceData {
+    browserName: string;
+    browserVersion: string;
+    isMobile: boolean;
+    capabilities: WebdriverIO.Capabilities;
+}
+export interface EnrichedInstanceData extends ScreenDimensions, InstanceData {
+}
+//# sourceMappingURL=instanceData.interfaces.d.ts.map

package/build/desktopBrowser/methods/instanceData.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instanceData.interfaces.d.ts","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/instanceData.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AAGtF,MAAM,WAAW,YAAY;IAE3B,WAAW,EAAE,MAAM,CAAC;IAEpB,cAAc,EAAE,MAAM,CAAC;IAEvB,QAAQ,EAAE,OAAO,CAAC;IAElB,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC;CACxC;AAGD,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB,EAAE,YAAY;CAAG"}

package/build/desktopBrowser/methods/instanceData.interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=instanceData.interfaces.js.map

package/build/desktopBrowser/methods/instanceData.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instanceData.interfaces.js","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/instanceData.interfaces.ts"],"names":[],"mappings":"","sourcesContent":["import { ScreenDimensions } from '../clientSideScript/screenDimensions.interfaces.js';\n\n// Represents the data associated with an instance.\nexport interface InstanceData {\n  // The name of the browser used by the instance.\n  browserName: string;\n  // The version of the browser used by the instance.\n  browserVersion: string;\n  // Is mobile or not\n  isMobile: boolean;\n  // Browser capabilities\n  capabilities: WebdriverIO.Capabilities;\n}\n\n// Represents enriched instance data combining screen dimensions and instance options.\nexport interface EnrichedInstanceData extends ScreenDimensions, InstanceData {}\n"]}

package/build/desktopBrowser/methods/methods.interface.d.ts

@@ -0,0 +1,13 @@
+/**
+ * A type representing a function that captures a screenshot.
+ * @returns A promise that resolves with the file path to the screenshot image.
+ */
+export type TakeScreenShot = () => Promise<string>;
+/**
+ * A type representing a function that executes JavaScript code.
+ * @param script - The JavaScript code or function to execute.
+ * @param var_args - Optional arguments to pass to the script.
+ * @returns A promise that resolves with the result of the execution.
+ */
+export type Executor = <T>(script: string | Function, ...args: any[]) => Promise<T>;
+//# sourceMappingURL=methods.interface.d.ts.map

package/build/desktopBrowser/methods/methods.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.interface.d.ts","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/methods.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;AAEnD;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/build/desktopBrowser/methods/methods.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=methods.interface.js.map

package/build/desktopBrowser/methods/methods.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.interface.js","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/methods.interface.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * A type representing a function that captures a screenshot.\n * @returns A promise that resolves with the file path to the screenshot image.\n */\nexport type TakeScreenShot = () => Promise<string>;\n\n/**\n * A type representing a function that executes JavaScript code.\n * @param script - The JavaScript code or function to execute.\n * @param var_args - Optional arguments to pass to the script.\n * @returns A promise that resolves with the result of the execution.\n */\n// eslint-disable-next-line\nexport type Executor = <T>(script: string | Function, ...args: any[]) => Promise<T>;\n"]}

package/build/desktopBrowser/methods/rectangles.d.ts

@@ -0,0 +1,23 @@
+import { WopeeService } from '../../domain/service/wopeeService.js';
+import { Executor } from './methods.interface.js';
+import { ElementRectanglesOptions, RectanglesOutput, ScreenRectanglesOptions } from './rectangles.interfaces.js';
+/**
+ * Determine the rectangles occupied by an element on a page or screenshot.
+ *
+ * @param {Object} options - The options for determining element rectangles.
+ * @param {Function} options.executor - The executor function.
+ * @param {string} options.base64Image - The base64 encoded screenshot image.
+ * @param {Object} options.element - The element to determine rectangles for.
+ * @returns {Promise<Object>} A Promise that resolves to an object containing element rectangles.
+ * @throws {Error} If the element is not visible.
+ */
+export declare function determineElementRectangles(wopeeService: WopeeService, executor: Executor, base64Image: string, options: ElementRectanglesOptions, element: WebdriverIO.Element): Promise<RectanglesOutput>;
+/**
+ * Calculate the optimal screen rectangles for capturing a screenshot.
+ *
+ * @param {string} base64Image - The base64 encoded screenshot image.
+ * @param {ScreenRectanglesOptions} options - Options including devicePixelRatio, innerHeight, and innerWidth.
+ * @returns {RectanglesOutput} - An object containing the calculated rectangles.
+ */
+export declare function determineScreenRectangles(base64Image: string, options: ScreenRectanglesOptions): RectanglesOutput;
+//# sourceMappingURL=rectangles.d.ts.map

package/build/desktopBrowser/methods/rectangles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectangles.d.ts","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/rectangles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAGpE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAEjH;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,WAAW,CAAC,OAAO,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAqBjH"}

package/build/desktopBrowser/methods/rectangles.interfaces.d.ts

@@ -0,0 +1,23 @@
+import { Executor } from './methods.interface.js';
+export interface RectanglesOptions {
+    devicePixelRatio: number;
+    isLandscape: boolean;
+    innerHeight: number;
+}
+export interface ScreenRectanglesOptions extends RectanglesOptions {
+    innerWidth: number;
+}
+export interface ElementRectanglesOptions extends RectanglesOptions {
+}
+export interface RectanglesOutput {
+    height: number;
+    width: number;
+    x: number;
+    y: number;
+}
+export interface ElementRectangles {
+    executor: Executor;
+    base64Image: string;
+    element: HTMLElement;
+}
+//# sourceMappingURL=rectangles.interfaces.d.ts.map

package/build/desktopBrowser/methods/rectangles.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectangles.interfaces.d.ts","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/rectangles.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,MAAM,WAAW,iBAAiB;IAEhC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,WAAW,EAAE,OAAO,CAAC;IAErB,WAAW,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAEhE,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;CAAG;AAGtE,MAAM,WAAW,gBAAgB;IAE/B,MAAM,EAAE,MAAM,CAAC;IAEf,KAAK,EAAE,MAAM,CAAC;IAEd,CAAC,EAAE,MAAM,CAAC;IAEV,CAAC,EAAE,MAAM,CAAC;CACX;AAGD,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,EAAE,QAAQ,CAAC;IAEnB,WAAW,EAAE,MAAM,CAAC;IAEpB,OAAO,EAAE,WAAW,CAAC;CACtB"}

package/build/desktopBrowser/methods/rectangles.interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rectangles.interfaces.js.map

package/build/desktopBrowser/methods/rectangles.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectangles.interfaces.js","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/rectangles.interfaces.ts"],"names":[],"mappings":"","sourcesContent":["import { Executor } from './methods.interface.js';\n\n// Represents the options for calculating rectangles.\nexport interface RectanglesOptions {\n  // The device pixel ratio of the screen/device.\n  devicePixelRatio: number;\n  // Signals if Landscape or Portrait.\n  isLandscape: boolean;\n  // The inner height of a screen.\n  innerHeight: number;\n}\n\n// Represents additional options for calculating screen rectangles.\nexport interface ScreenRectanglesOptions extends RectanglesOptions {\n  // The inner width of a screen.\n  innerWidth: number;\n}\n\n// Represents additional options for calculating element rectangles.\nexport interface ElementRectanglesOptions extends RectanglesOptions {}\n\n// Represents the output rectangles.\nexport interface RectanglesOutput {\n  // The height of the rectangle.\n  height: number;\n  // The width of the rectangle.\n  width: number;\n  // The X-coordinate of the rectangle.\n  x: number;\n  // The Y-coordinate of the rectangle.\n  y: number;\n}\n\n// Represents the rectangles related to an element.\nexport interface ElementRectangles {\n  // The executor responsible for the element.\n  executor: Executor;\n  // The base64 encoded image of the element.\n  base64Image: string;\n  // The element for which rectangles are calculated.\n  element: HTMLElement;\n}\n"]}

package/build/desktopBrowser/methods/rectangles.js

@@ -0,0 +1,51 @@
+import { calculateDprData, getScreenshotSize } from '../helpers/utils.js';
+import { getElementPositionDesktop } from './elementPosition.js';
+/**
+ * Determine the rectangles occupied by an element on a page or screenshot.
+ *
+ * @param {Object} options - The options for determining element rectangles.
+ * @param {Function} options.executor - The executor function.
+ * @param {string} options.base64Image - The base64 encoded screenshot image.
+ * @param {Object} options.element - The element to determine rectangles for.
+ * @returns {Promise<Object>} A Promise that resolves to an object containing element rectangles.
+ * @throws {Error} If the element is not visible.
+ */
+export async function determineElementRectangles(wopeeService, executor, base64Image, options, element) {
+    const { devicePixelRatio, innerHeight } = options;
+    const { height } = getScreenshotSize(base64Image, devicePixelRatio);
+    // Determine the element position on the screenshot
+    const elementPosition = await getElementPositionDesktop(wopeeService, executor, element, {
+        innerHeight,
+        screenshotHeight: height,
+    });
+    // Determine the rectangles based on the device pixel ratio
+    return calculateDprData({
+        height: elementPosition.height,
+        width: elementPosition.width,
+        x: elementPosition.x,
+        y: elementPosition.y,
+    }, devicePixelRatio);
+}
+/**
+ * Calculate the optimal screen rectangles for capturing a screenshot.
+ *
+ * @param {string} base64Image - The base64 encoded screenshot image.
+ * @param {ScreenRectanglesOptions} options - Options including devicePixelRatio, innerHeight, and innerWidth.
+ * @returns {RectanglesOutput} - An object containing the calculated rectangles.
+ */
+export function determineScreenRectangles(base64Image, options) {
+    const { devicePixelRatio, isLandscape, innerHeight, innerWidth } = options;
+    const screenshotWidth = innerWidth;
+    const screenshotHeight = innerHeight;
+    // Check if the screenshot is rotated
+    const isRotated = isLandscape;
+    // Determine the screen rectangles
+    const screenRectangles = calculateDprData({
+        height: isRotated ? screenshotWidth : screenshotHeight,
+        width: isRotated ? screenshotHeight : screenshotWidth,
+        x: 0,
+        y: 0,
+    }, devicePixelRatio);
+    return screenRectangles;
+}
+//# sourceMappingURL=rectangles.js.map

package/build/desktopBrowser/methods/rectangles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectangles.js","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/rectangles.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAIjE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,YAA0B,EAC1B,QAAkB,EAClB,WAAmB,EACnB,OAAiC,EACjC,OAA4B;IAE5B,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAEpE,mDAAmD;IACnD,MAAM,eAAe,GAAG,MAAM,yBAAyB,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE;QACvF,WAAW;QACX,gBAAgB,EAAE,MAAM;KACzB,CAAC,CAAC;IAEH,2DAA2D;IAC3D,OAAO,gBAAgB,CACrB;QACE,MAAM,EAAE,eAAe,CAAC,MAAM;QAC9B,KAAK,EAAE,eAAe,CAAC,KAAK;QAC5B,CAAC,EAAE,eAAe,CAAC,CAAC;QACpB,CAAC,EAAE,eAAe,CAAC,CAAC;KACrB,EACD,gBAAgB,CACjB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAAmB,EAAE,OAAgC;IAC7F,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAE3E,MAAM,eAAe,GAAG,UAAU,CAAC;IACnC,MAAM,gBAAgB,GAAG,WAAW,CAAC;IAErC,qCAAqC;IACrC,MAAM,SAAS,GAAG,WAAW,CAAC;IAE9B,kCAAkC;IAClC,MAAM,gBAAgB,GAAG,gBAAgB,CACvC;QACE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,gBAAgB;QACtD,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe;QACrD,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;KACL,EACD,gBAAgB,CACjB,CAAC;IAEF,OAAO,gBAAgB,CAAC;AAC1B,CAAC","sourcesContent":["import { WopeeService } from '../../domain/service/wopeeService.js';\nimport { calculateDprData, getScreenshotSize } from '../helpers/utils.js';\nimport { getElementPositionDesktop } from './elementPosition.js';\nimport { Executor } from './methods.interface.js';\nimport { ElementRectanglesOptions, RectanglesOutput, ScreenRectanglesOptions } from './rectangles.interfaces.js';\n\n/**\n * Determine the rectangles occupied by an element on a page or screenshot.\n *\n * @param {Object} options - The options for determining element rectangles.\n * @param {Function} options.executor - The executor function.\n * @param {string} options.base64Image - The base64 encoded screenshot image.\n * @param {Object} options.element - The element to determine rectangles for.\n * @returns {Promise<Object>} A Promise that resolves to an object containing element rectangles.\n * @throws {Error} If the element is not visible.\n */\nexport async function determineElementRectangles(\n  wopeeService: WopeeService,\n  executor: Executor,\n  base64Image: string,\n  options: ElementRectanglesOptions,\n  element: WebdriverIO.Element,\n): Promise<RectanglesOutput> {\n  const { devicePixelRatio, innerHeight } = options;\n  const { height } = getScreenshotSize(base64Image, devicePixelRatio);\n\n  // Determine the element position on the screenshot\n  const elementPosition = await getElementPositionDesktop(wopeeService, executor, element, {\n    innerHeight,\n    screenshotHeight: height,\n  });\n\n  // Determine the rectangles based on the device pixel ratio\n  return calculateDprData(\n    {\n      height: elementPosition.height,\n      width: elementPosition.width,\n      x: elementPosition.x,\n      y: elementPosition.y,\n    },\n    devicePixelRatio,\n  );\n}\n\n/**\n * Calculate the optimal screen rectangles for capturing a screenshot.\n *\n * @param {string} base64Image - The base64 encoded screenshot image.\n * @param {ScreenRectanglesOptions} options - Options including devicePixelRatio, innerHeight, and innerWidth.\n * @returns {RectanglesOutput} - An object containing the calculated rectangles.\n */\nexport function determineScreenRectangles(base64Image: string, options: ScreenRectanglesOptions): RectanglesOutput {\n  const { devicePixelRatio, isLandscape, innerHeight, innerWidth } = options;\n\n  const screenshotWidth = innerWidth;\n  const screenshotHeight = innerHeight;\n\n  // Check if the screenshot is rotated\n  const isRotated = isLandscape;\n\n  // Determine the screen rectangles\n  const screenRectangles = calculateDprData(\n    {\n      height: isRotated ? screenshotWidth : screenshotHeight,\n      width: isRotated ? screenshotHeight : screenshotWidth,\n      x: 0,\n      y: 0,\n    },\n    devicePixelRatio,\n  );\n\n  return screenRectangles;\n}\n"]}

package/build/desktopBrowser/methods/screenshots.d.ts

@@ -0,0 +1,29 @@
+import { WopeeService } from '../../domain/service/wopeeService.js';
+import { Executor, TakeScreenShot } from './methods.interface.js';
+import { FullPageScreenshotDataOptions, FullPageScreenshotOptions, FullPageScreenshotsData } from './screenshots.interfaces.js';
+/**
+ * Takes a full page screenshot.
+ *
+ * @param {TakeScreenShot} takeScreenshot - Function to capture a screenshot.
+ * @param {Executor} executor - Function to execute JavaScript in the browser.
+ * @param {FullPageScreenshotDataOptions} options - Screenshot data options.
+ * @returns {Promise<FullPageScreenshotsData>} - Promise with full page screenshots data.
+ */
+export declare function getBase64FullPageScreenshotsData(wopeeService: WopeeService, takeScreenshot: TakeScreenShot, executor: Executor, options: FullPageScreenshotDataOptions): Promise<FullPageScreenshotsData>;
+/**
+ * Takes a full page screenshot for desktop.
+ *
+ * @param {TakeScreenShot} takeScreenshot - Function to capture a screenshot.
+ * @param {Executor} executor - Function to execute JavaScript in the browser.
+ * @param {FullPageScreenshotOptions} options - Screenshot options.
+ * @returns {Promise<FullPageScreenshotsData>} - Promise with full page screenshots data.
+ */
+export declare function getFullPageScreenshotsDataDesktop(wopeeService: WopeeService, takeScreenshot: TakeScreenShot, executor: Executor, options: FullPageScreenshotOptions): Promise<FullPageScreenshotsData>;
+/**
+ * Takes a screenshot.
+ *
+ * @param {TakeScreenShot} takeScreenshot - Function to capture a screenshot.
+ * @returns {Promise<string>} - Promise with base64 encoded screenshot data.
+ */
+export declare function takeBase64Screenshot(takeScreenshot: TakeScreenShot): Promise<string>;
+//# sourceMappingURL=screenshots.d.ts.map

package/build/desktopBrowser/methods/screenshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots.d.ts","sourceRoot":"","sources":["../../../lib/desktopBrowser/methods/screenshots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAErC;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CACpD,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,uBAAuB,CAAC,CASlC;AAED;;;;;;;GAOG;AACH,wBAAsB,iCAAiC,CACrD,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,uBAAuB,CAAC,CAyElC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F"}