@playq/core 0.2.77

package/dist/helper/actions/web/keyboardActions.js

@@ -0,0 +1,118 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pressKey = pressKey;
+exports.pressEnter = pressEnter;
+exports.pressTab = pressTab;
+/**
+ * @file keyboardActions.ts
+ *
+ * Keyboard interaction utilities for PlayQ web actions.
+ * Provides typing and key press helpers with screenshot options and
+ * runner-aware step wrappers.
+ *
+ * Authors: PlayQ Team
+ * Version: v1.0.0
+ */
+const allure = __importStar(require("allure-js-commons"));
+const waitActions_1 = require("./waitActions");
+const screenshotActions_1 = require("./screenshotActions");
+const vars_1 = require("../../bundle/vars");
+function isPlaywrightRunner() { return process.env.TEST_RUNNER === 'playwright'; }
+const __allureAny_keys = allure;
+if (typeof __allureAny_keys.step !== 'function') {
+    __allureAny_keys.step = async (_n, f) => await f();
+}
+// Allure compatibility shim: if step is unavailable, just run the body
+const __allureAny_web = allure;
+if (typeof __allureAny_web.step !== 'function') {
+    __allureAny_web.step = async (_name, fn) => await fn();
+}
+/**
+ * Web: Press Key -key: {param} -options: {param}
+ *
+ * Presses a keyboard key on the page or a specific element.
+ *
+ * @param page - Playwright Page instance
+ * @param key - The key to press (e.g., "Enter", "Tab", "ArrowDown", "a", etc.)
+ * @param options - Optional string or object:
+ *   - screenshot: [boolean] Capture screenshot after pressing the key. Default: false.
+ *   - screenshotText: [string] Description for the screenshot. Default: "".
+ *   - screenshotFullPage: [boolean] Full page screenshot. Default: true.
+ *
+ * @example
+ *   await pressKey(page, 'Enter', { field: 'Username', screenshot: true });
+ */
+async function pressKey(page, key, options) {
+    const options_json = typeof options === "string" ? (0, vars_1.parseLooseJson)(options) : options || {};
+    const { screenshot = false, screenshotText = "", screenshotFullPage = true, } = options_json;
+    if (!page)
+        throw new Error("Page not initialized");
+    if (isPlaywrightRunner()) {
+        await __allureAny_keys.step(`Web: Press Key -key: ${key} -options: ${JSON.stringify(options_json)}`, async () => {
+            await doPressKey();
+        });
+    }
+    else {
+        await doPressKey();
+    }
+    async function doPressKey() {
+        await (0, waitActions_1.waitForPageToLoad)(page);
+        await page.keyboard.press(key, { delay: 0 });
+        await (0, screenshotActions_1.processScreenshot)(page, screenshot, screenshotText || `Pressed key: ${key}`, screenshotFullPage);
+    }
+}
+/**
+ * Web: Press Enter -options: {param}
+ *
+ * Convenience wrapper to press the Enter key.
+ *
+ * @param page Playwright Page instance
+ * @param options Optional JSON string or object ({ delay })
+ */
+async function pressEnter(page, options) {
+    return pressKey(page, "Enter", options);
+}
+/**
+ * Web: Press Tab -options: {param}
+ *
+ * Convenience wrapper to press the Tab key.
+ *
+ * @param page Playwright Page instance
+ * @param options Optional JSON string or object ({ delay })
+ */
+async function pressTab(page, options) {
+    return pressKey(page, "Tab", options);
+}

package/dist/helper/actions/web/localStorageActions.d.ts

@@ -0,0 +1,51 @@
+import type { Page } from "playwright";
+/**
+ * Web: LocalStorage Set -key: {param} -value: {param}
+ *
+ * Sets a key/value pair in window.localStorage.
+ *
+ * @param page - Playwright Page instance
+ * @param key - Storage key (required)
+ * @param value - Storage value
+ * @param options - Optional JSON string or object (reserved for future flags)
+ * @throws Error if page is not initialized or key is missing
+ */
+export declare function setItem(page: Page, key: string, value: string, options?: any): Promise<void>;
+export declare const localStorageSet: typeof setItem;
+/**
+  * Web: LocalStorage Get -key: {param} -options: {param}
+  *
+  * Retrieves a value by key from window.localStorage.
+  *
+  * @param page - Playwright Page instance
+  * @param key - Storage key (required)
+  * @param options - Optional JSON string or object:
+  *  - assert: [boolean] If true, throws when value is null/undefined (default: false)
+  * @returns Stored value or null
+  * @throws Error if page is not initialized or key is missing
+  */
+export declare function getItem(page: Page, key: string, options?: any): Promise<any>;
+export declare const localStorageGet: typeof getItem;
+/**
+ * Web: LocalStorage Remove -key: {param}
+ *
+ * Removes a key from window.localStorage.
+ *
+ * @param page - Playwright Page instance
+ * @param key - Storage key (required)
+ * @param options - Optional JSON string or object (reserved for future flags)
+ * @throws Error if page is not initialized or key is missing
+ */
+export declare function removeItem(page: Page, key: string, options?: any): Promise<void>;
+export declare const localStorageRemove: typeof removeItem;
+/**
+ * Web: LocalStorage Clear -options: {param}
+ *
+ * Clears all keys from window.localStorage.
+ *
+ * @param page - Playwright Page instance
+ * @param options - Optional JSON string or object (reserved for future flags)
+ * @throws Error if page is not initialized
+ */
+export declare function clearStorage(page: Page, options?: any): Promise<void>;
+export declare const localStorageClear: typeof clearStorage;

package/dist/helper/actions/web/localStorageActions.js

@@ -0,0 +1,163 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.localStorageClear = exports.localStorageRemove = exports.localStorageGet = exports.localStorageSet = void 0;
+exports.setItem = setItem;
+exports.getItem = getItem;
+exports.removeItem = removeItem;
+exports.clearStorage = clearStorage;
+/**
+ * @file localStorageActions.ts
+ *
+ * window.localStorage helpers for PlayQ web actions.
+ * Provides set/get/remove/clear with runner-aware step wrappers.
+ *
+ * Authors: PlayQ Team
+ * Version: v1.0.0
+ */
+const allure = __importStar(require("allure-js-commons"));
+const global_1 = require("../../../global");
+function isPlaywrightRunner() { return process.env.TEST_RUNNER === 'playwright'; }
+const __allureAny_ls = allure;
+if (typeof __allureAny_ls.step !== 'function') {
+    __allureAny_ls.step = async (_n, f) => await f();
+}
+/**
+ * Web: LocalStorage Set -key: {param} -value: {param}
+ *
+ * Sets a key/value pair in window.localStorage.
+ *
+ * @param page - Playwright Page instance
+ * @param key - Storage key (required)
+ * @param value - Storage value
+ * @param options - Optional JSON string or object (reserved for future flags)
+ * @throws Error if page is not initialized or key is missing
+ */
+async function setItem(page, key, value, options) {
+    const stepName = `Web: LocalStorage Set -key: ${key}`;
+    if (!page)
+        throw new Error("Page not initialized");
+    if (!key)
+        throw new Error("LocalStorage.setItem: 'key' is required");
+    const _opts = typeof options === 'string' ? global_1.vars.parseLooseJson(options) : (options || {}); // reserved for future flags
+    const run = async () => page.evaluate(([k, v]) => localStorage.setItem(k, v), [key, value]);
+    if (isPlaywrightRunner()) {
+        await __allureAny_ls.step(stepName, run);
+    }
+    else {
+        await run();
+    }
+}
+// Friendly aliases
+exports.localStorageSet = setItem;
+/**
+  * Web: LocalStorage Get -key: {param} -options: {param}
+  *
+  * Retrieves a value by key from window.localStorage.
+  *
+  * @param page - Playwright Page instance
+  * @param key - Storage key (required)
+  * @param options - Optional JSON string or object:
+  *  - assert: [boolean] If true, throws when value is null/undefined (default: false)
+  * @returns Stored value or null
+  * @throws Error if page is not initialized or key is missing
+  */
+async function getItem(page, key, options) {
+    const stepName = `Web: LocalStorage Get -key: ${key}`;
+    if (!page)
+        throw new Error("Page not initialized");
+    if (!key)
+        throw new Error("LocalStorage.getItem: 'key' is required");
+    const _opts = typeof options === 'string' ? global_1.vars.parseLooseJson(options) : (options || {});
+    const run = async () => page.evaluate((k) => localStorage.getItem(k), key);
+    const result = isPlaywrightRunner() ? await __allureAny_ls.step(stepName, run) : await run();
+    if ((_opts === null || _opts === void 0 ? void 0 : _opts.assert) === true && (result === null || result === undefined)) {
+        throw new Error(`LocalStorage.getItem: No value found for key '${key}'`);
+    }
+    return result;
+}
+// Friendly aliases
+exports.localStorageGet = getItem;
+/**
+ * Web: LocalStorage Remove -key: {param}
+ *
+ * Removes a key from window.localStorage.
+ *
+ * @param page - Playwright Page instance
+ * @param key - Storage key (required)
+ * @param options - Optional JSON string or object (reserved for future flags)
+ * @throws Error if page is not initialized or key is missing
+ */
+async function removeItem(page, key, options) {
+    const stepName = `Web: LocalStorage Remove -key: ${key}`;
+    if (!page)
+        throw new Error("Page not initialized");
+    if (!key)
+        throw new Error("LocalStorage.removeItem: 'key' is required");
+    const _opts = typeof options === 'string' ? global_1.vars.parseLooseJson(options) : (options || {}); // reserved for future flags
+    const run = async () => page.evaluate((k) => localStorage.removeItem(k), key);
+    if (isPlaywrightRunner()) {
+        await __allureAny_ls.step(stepName, run);
+    }
+    else {
+        await run();
+    }
+}
+// Friendly aliases
+exports.localStorageRemove = removeItem;
+/**
+ * Web: LocalStorage Clear -options: {param}
+ *
+ * Clears all keys from window.localStorage.
+ *
+ * @param page - Playwright Page instance
+ * @param options - Optional JSON string or object (reserved for future flags)
+ * @throws Error if page is not initialized
+ */
+async function clearStorage(page, options) {
+    const stepName = `Web: LocalStorage Clear`;
+    if (!page)
+        throw new Error("Page not initialized");
+    const _opts = typeof options === 'string' ? global_1.vars.parseLooseJson(options) : (options || {}); // reserved for future flags
+    const run = async () => page.evaluate(() => localStorage.clear());
+    if (isPlaywrightRunner()) {
+        await __allureAny_ls.step(stepName, run);
+    }
+    else {
+        await run();
+    }
+}
+// Friendly aliases
+exports.localStorageClear = clearStorage;

package/dist/helper/actions/web/mouseActions.d.ts

@@ -0,0 +1,240 @@
+import { Page, Locator, BrowserContext } from "@playwright/test";
+/**
+ * Web: Click Element -field: {param} -options: {param}
+ *
+ * Clicks an element on the page using the given fieldType.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Label, text, selector, or Locator
+ * @param options - Optional JSON string or object:
+ *   - fieldType: [string] Field type to resolve (button | action | div | text | link etc.)
+ *   - actionTimeout: [number] Timeout in ms
+ *   - pattern: [string] PatternIQ config override
+ *   - isDoubleClick: [boolean]
+ *   - screenshot: [boolean]
+ *   - screenshotBefore: [boolean]
+ *   - screenshotText: [string]
+ *   - screenshotFullPage: [boolean]
+ */
+export declare function click(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Mouseover on link -field: {param} -options: {param}
+ *
+ * Performs a mouse hover over a link element on the page, identified by text, label, id, name, or pattern.
+ *
+ * @param field - The text, label, id, name, or selector of the link to hover over (e.g., "Account", "Login", "Help").
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds for waiting. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search. Default: Configured pattern.
+ *   - screenshot: [boolean] Capture a screenshot after hovering over the link. Default: false.
+ *   - screenshotText: [string] Text description for the screenshot. Default: "".
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ * @example
+ *  Web: Mouseover on link -field: "{{top_menu}} My account" -options: "{screenshot: true, screenshotText: 'Hovered on My Account'}"
+ */
+export declare function mouseoverOnLink(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Mouseover on text -text: {param} -options: {param}
+ *
+ * Performs a mouse hover over an element identified by its visible text.
+ *
+ * @param page - Playwright Page instance
+ * @param text - The visible text of the element to hover over
+ * @param options - Optional string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds for waiting. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - screenshot: [boolean] Capture a screenshot after hovering. Default: false.
+ *   - screenshotText: [string] Description for the screenshot.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ * @example
+ *  Web: Mouseover on text -text: "Menu" -options: "{screenshot: true, screenshotText: 'Hovered on Menu'}"
+ */
+export declare function mouseoverOnText(page: Page, text: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Click Button -field: {param} -options: {param}
+ *
+ * Clicks a button element on the page, identified by text, label, id, name, pattern, or locator.
+ *
+ * @param field - The label, text, id, name, or selector of the button to click (e.g., "Submit", "Save", "Cancel").
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds for waiting. Default: Configured testExecution > actionTimeout or 10000 milliseconds.
+ *   - pattern: [string] Optional pattern to refine element search. Default: Configured pattern.
+ *   - screenshot: [boolean] Capture a screenshot after clicking the button. Default: false.
+ *   - screenshotText: [string] Text description for the screenshot. Default: "".
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *   - screenshotBefore: [boolean] Capture a screenshot before clicking. Default: false.
+ *
+ * @example
+ *  Web: Click Button -field: "Register" -options: "{screenshot: true, screenshotText: 'After clicking Register'}"
+ */
+export declare function clickButton(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Click Link -field: {param} -options: {param}
+ *
+ * Clicks a link element on the page, identified by link text, label, id, name, or pattern.
+ *
+ * @param field - The text, label, id, name, or selector of the link to click (e.g., "Home", "Login", "Forgot Password").
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds for waiting. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search. Default: Configured pattern.
+ *   - screenshot: [boolean] Capture a screenshot after clicking the link. Default: false.
+ *   - screenshotText: [string] Text description for the screenshot. Default: "".
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *   - screenshotBefore: [boolean] Capture a screenshot before clicking. Default: false.
+ *
+ * @example
+ *  Web: Click Link -field: "Register" -options: "{screenshot: true, screenshotText: 'After clicking Register'}"
+ */
+export declare function clickLink(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Click tab -field: {param} -options: {param}
+ *
+ * Clicks a tab element on the page, identified by link text, label, id, name, or pattern.
+ *
+ * @param field - The text, label, id, name, or selector of the link to click (e.g., "Home", "Login", "Forgot Password").
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds for waiting. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search. Default: Configured pattern.
+ *   - screenshot: [boolean] Capture a screenshot after clicking the link. Default: false.
+ *   - screenshotText: [string] Text description for the screenshot. Default: "".
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *   - screenshotBefore: [boolean] Capture a screenshot before clicking. Default: false.
+ *
+ * @example
+ *  Web: Click tab -field: "Register" -options: "{screenshot: true, screenshotText: 'After clicking Register'}"
+ */
+export declare function clickTab(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Click radio button -field: {param} -options: {param}
+ *
+ * Selects a radio button element on the page, identified by label, text, id, name, or pattern.
+ *
+ * @param field - The label, text, id, name, or selector of the radio button to select (e.g., "Yes", "No", "Subscribe").
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds for waiting. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search. Default: Configured pattern.
+ *   - force: [boolean] Force the action (e.g., ignore actionability checks). Default: true.
+ *   - screenshot: [boolean] Capture a screenshot after selecting the radio button. Default: false.
+ *   - screenshotText: [string] Text description for the screenshot. Default: "".
+ *   - screenshotFullPage: [boolean] Capture a full page screenshot. Default: true.
+ *   - screenshotBefore: [boolean] Capture a screenshot before selecting the radio button. Default: false.
+ *
+ * @example
+ *  Web: Click radio button -field: "{radio_group:: Newsletter} Yes" -options: "{screenshot: true, screenshotText: 'After selecting Yes for Newsletter'}"
+ */
+export declare function clickRadioButton(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Click checkbox -field: {param} -options: {param}
+ *
+ * Selects a checkbox element on the page, identified by label, text, id, name, or pattern.
+ *
+ * @param field - The label, text, id, name, or selector of the checkbox to select (e.g., "Agree", "Subscribe").
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds for waiting. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search. Default: Configured pattern.
+ *   - force: [boolean] Force the action (e.g., ignore actionability checks). Default: true.
+ *   - screenshot: [boolean] Capture a screenshot after selecting the checkbox. Default: false.
+ *   - screenshotText: [string] Text description for the screenshot. Default: "".
+ *   - screenshotFullPage: [boolean] Capture a full page screenshot. Default: true.
+ *   - screenshotBefore: [boolean] Capture a screenshot before selecting the checkbox. Default: false.
+ *
+ *  @example
+ *  Web: Click checkbox -field: "{checkbox_group:: Accept Terms} Agree" -options: "{screenshot: true, screenshotText: 'After selecting Agree for Accept Terms'}"
+ */
+export declare function clickCheckbox(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Click at Coordinates -x: {param} -y: {param} -options: {param}
+ *
+ * Clicks at the specified page coordinates (default: 0,0).
+ *
+ * @param page - Playwright Page instance
+ * @param x - X coordinate (default: 0)
+ * @param y - Y coordinate (default: 0)
+ * @param options - Optional string or object:
+ *   - screenshot: [boolean] Capture screenshot after clicking (default: false)
+ *   - screenshotText: [string] Description for screenshot
+ *   - screenshotFullPage: [boolean] Full page screenshot (default: true)
+ *
+ * @example
+ *   await clickAtCoordinates(page); // Clicks at (0,0)
+ *   await clickAtCoordinates(page, 100, 200, { screenshot: true });
+ */
+export declare function clickAtCoordinates(page: Page, x?: number, y?: number, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Drag and Drop -source: {param} -target: {param} -options: {param}
+ *
+ * Drags an element from source to target location.
+ *
+ * @param page Playwright Page instance
+ * @param source The source element to drag (label, text, id, name, or selector).
+ * @param target The target element to drop onto (label, text, id, name, or selector).
+ * @param options Optional JSON string or object:
+ *   - fieldType: [string] Type of the elements (e.g., "item", "icon"). Default: "".
+ *  - actionTimeout: [number] Optional timeout in milliseconds for waiting. Default: Configured timeout.
+ *  - pattern: [string] Optional pattern to refine element search. Default: Configured pattern.
+ *  - screenshot: [boolean] Capture a screenshot after drag and drop. Default: false.
+ *  - screenshotText: [string] Text description for the screenshot. Default: "".
+ *  - screenshotFullPage: [boolean] Capture a full page screenshot. Default: true.
+ *  - screenshotBefore: [boolean] Capture a screenshot before drag and drop. Default: false.
+ *
+ * @example
+ *  Web: Drag and Drop -source: "Item A" -target: "Item B" -options: "{screenshot: true, screenshotText: 'After drag and drop'}"
+ */
+export declare function dragAndDrop(page: Page, source: string | Locator, target: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Scroll To -x: {param} -y: {param} -options: {param}
+ *
+ * Scrolls the page to the specified x and y coordinates.
+ *
+ * @param page Playwright Page instance
+ * @param x The x-coordinate to scroll to.
+ * @param y The y-coordinate to scroll to.
+ * @param options Optional JSON string or object (reserved for future use).
+ *
+ * @example
+ *  Web: Scroll To -x: 0 -y: 500 -options: "{}"
+ */
+export declare function scrollTo(page: Page, x: number, y: number, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Scroll Up -amount: {param} -options: {param}
+ *
+ * Scrolls the page up by the specified amount.
+ *
+ * @param page Playwright Page instance
+ * @param amount The amount in pixels to scroll up (default: 200).
+ * @param options Optional JSON string or object (reserved for future use).
+ *
+ * @example
+ *  Web: Scroll Up -amount: 300 -options: "{}"
+ */
+export declare function scrollUp(page: Page, amount?: number, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Scroll Down -amount: {param} -options: {param}
+ *
+ * Scrolls the page down by the specified amount.
+ *
+ * @param page Playwright Page instance
+ * @param amount The amount in pixels to scroll down (default: 200).
+ * @param options Optional JSON string or object (reserved for future use).
+ *
+ * @example
+ *  Web: Scroll Down -amount: 300 -options: "{}"
+ */
+export declare function scrollDown(page: Page, amount?: number, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Click and Wait for New Page -field: {param} -options: {param}
+ *
+ * Clicks a button or link and waits for a new page (tab) to open.
+ *
+ * @param context - Playwright BrowserContext
+ * @param page - Current Playwright Page
+ * @param field - The button/link text or locator to click
+ * @param options - Options for clickButton/clickLink
+ * @returns The new Page object
+ *
+ * @example
+ *   const newPage = await clickAndWaitForNewPage(context, page, "Open Tab", { screenshot: true });
+ */
+export declare function clickAndWaitForNewPage(context: BrowserContext, page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<any>;