@playq/core 0.2.77

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

@@ -0,0 +1,95 @@
+import type { Page, Locator } from "playwright";
+/**
+ * Web: Get Text -field: {param} -options: {param}
+ *
+ * Returns the inner text of the resolved element.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Label/selector or Locator of the element
+ * @param options - Optional JSON string or object ({ pattern, actionTimeout })
+ * @returns The element's inner text
+ * @throws Error if page is not initialized or element resolution fails
+ */
+export declare function getText(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<any>;
+/**
+ * Web: Get Value -field: {param} -options: {param}
+ *
+ * Returns the input value of the resolved element.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Label/selector or Locator of the element
+ * @param options - Optional JSON string or object ({ pattern, actionTimeout })
+ * @returns The input's current value
+ * @throws Error if page is not initialized or element resolution fails
+ */
+export declare function getValue(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<any>;
+/**
+ * Web: Get Attribute -field: {param} -name: {param} -options: {param}
+ *
+ * Returns the value of an attribute from the resolved element.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Label/selector or Locator of the element
+ * @param name - Attribute name
+ * @param options - Optional JSON string or object ({ pattern, actionTimeout })
+ * @returns The attribute value or null
+ * @throws Error if page is not initialized or element resolution fails
+ */
+export declare function getAttribute(page: Page, field: string | Locator, name: string, options?: string | Record<string, any>): Promise<any>;
+/**
+ * Web: Has Class -field: {param} -className: {param} -options: {param}
+ *
+ * Checks whether the element has the specified CSS class.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Label/selector or Locator of the element
+ * @param className - Class name to check
+ * @param options - Optional JSON string or object ({ pattern, actionTimeout })
+ * @returns True when class present; false otherwise
+ * @throws Error if page is not initialized or element resolution fails
+ */
+export declare function hasClass(page: Page, field: string | Locator, className: string, options?: string | Record<string, any>): Promise<any>;
+/**
+ * Web: Get HTML -field: {param} -options: {param}
+ *
+ * Returns the inner HTML of the resolved element.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Label/selector or Locator of the element
+ * @param options - Optional JSON string or object ({ pattern, actionTimeout })
+ * @returns The element's inner HTML
+ * @throws Error if page is not initialized or element resolution fails
+ */
+export declare function getHtml(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<any>;
+/**
+ * Web: Store element text in Variable -field: {param} into variable: {param} -options: {param}
+ * Stores the text content of a web element into a variable for later use.
+ * @param page - Playwright Page instance.
+ * @param field - The label, text, id, name, or selector of the web element.
+ * @param variableName - The name of the variable to store the text content.
+ * @param options - Optional JSON string or object:
+ *  - actionTimeout: [number] Optional timeout in milliseconds. Default: Configured timeout.
+ * - pattern: [string] Optional pattern to refine element search.
+ * - attribute: [string] If provided, reads specific attribute instead of text/value.
+ * - trim: [boolean] Whether to trim whitespace. Default: true.
+ * - normalizeWhitespace: [boolean] Whether to normalize whitespace. Default: true.
+ * - screenshot: [boolean] Capture screenshot after storing text. Default: false.
+ * - screenshotText: [string] Description for the screenshot.
+ */
+export declare function storeElementTextInVariable(page: Page, field: string | Locator, variableName: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Get All Texts -selector/field: {param} -options: {param}
+ *
+ * Returns an array of inner texts of all elements matching the selector or field.
+ *
+ * @param page - Playwright Page instance
+ * @param field - CSS selector, label, or Locator
+ * @param options - Optional JSON string or object:
+ *   - pattern: [string] Pattern for pattern engine
+ *   - fieldType: [string] Pattern engine field type (default: 'field')
+ *   - itemSelector: [string] Sub-selector to locate text inside each element
+ *   - attribute: [string] Attribute to extract instead of innerText (e.g., 'textContent', 'value')
+ *   - actionTimeout: [number] Timeout in ms
+ * @returns Array of strings representing the text of each element
+ */
+export declare function getAllTexts(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<string[]>;

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

@@ -0,0 +1,326 @@
+"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.getText = getText;
+exports.getValue = getValue;
+exports.getAttribute = getAttribute;
+exports.hasClass = hasClass;
+exports.getHtml = getHtml;
+exports.storeElementTextInVariable = storeElementTextInVariable;
+exports.getAllTexts = getAllTexts;
+/**
+ * @file elementReaderActions.ts
+ *
+ * Element reader helpers for PlayQ web actions.
+ * Provides text/value/attribute/class/html readers and a utility to store
+ * element text into a PlayQ variable, with runner-aware step wrappers.
+ *
+ * Authors: PlayQ Team
+ * Version: v1.0.0
+ */
+const allure = __importStar(require("allure-js-commons"));
+const global_1 = require("../../../global");
+const screenshotActions_1 = require("./screenshotActions");
+const commonActions_1 = require("../comm/commonActions");
+const config = {};
+function isPlaywrightRunner() { return process.env.TEST_RUNNER === 'playwright'; }
+const __allureAny_reader = allure;
+if (typeof __allureAny_reader.step !== 'function') {
+    __allureAny_reader.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: Get Text -field: {param} -options: {param}
+ *
+ * Returns the inner text of the resolved element.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Label/selector or Locator of the element
+ * @param options - Optional JSON string or object ({ pattern, actionTimeout })
+ * @returns The element's inner text
+ * @throws Error if page is not initialized or element resolution fails
+ */
+async function getText(page, field, options) {
+    const options_json = typeof options === 'string' ? global_1.vars.parseLooseJson(options) : options || {};
+    const stepName = `Web: Get Text -field: ${typeof field === 'string' ? field : '<locator>'}`;
+    const run = async () => {
+        if (!page)
+            throw new Error("Page not initialized");
+        const locator = typeof field === 'string'
+            ? await (0, global_1.webLocResolver)((options_json === null || options_json === void 0 ? void 0 : options_json.fieldType) || '', field, page, options_json === null || options_json === void 0 ? void 0 : options_json.pattern, typeof (options_json === null || options_json === void 0 ? void 0 : options_json.actionTimeout) === 'number' ? options_json.actionTimeout : undefined, (options_json === null || options_json === void 0 ? void 0 : options_json.smartAiRefresh) || '')
+            : field;
+        return locator.innerText();
+    };
+    if (isPlaywrightRunner()) {
+        return __allureAny_reader.step(stepName, run);
+    }
+    return run();
+}
+/**
+ * Web: Get Value -field: {param} -options: {param}
+ *
+ * Returns the input value of the resolved element.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Label/selector or Locator of the element
+ * @param options - Optional JSON string or object ({ pattern, actionTimeout })
+ * @returns The input's current value
+ * @throws Error if page is not initialized or element resolution fails
+ */
+async function getValue(page, field, options) {
+    const options_json = typeof options === 'string' ? global_1.vars.parseLooseJson(options) : options || {};
+    const stepName = `Web: Get Value -field: ${typeof field === 'string' ? field : '<locator>'}`;
+    const run = async () => {
+        if (!page)
+            throw new Error("Page not initialized");
+        const locator = typeof field === 'string'
+            ? await (0, global_1.webLocResolver)((options_json === null || options_json === void 0 ? void 0 : options_json.fieldType) || '', field, page, options_json === null || options_json === void 0 ? void 0 : options_json.pattern, typeof (options_json === null || options_json === void 0 ? void 0 : options_json.actionTimeout) === 'number' ? options_json.actionTimeout : undefined, (options_json === null || options_json === void 0 ? void 0 : options_json.smartAiRefresh) || '')
+            : field;
+        return locator.inputValue();
+    };
+    if (isPlaywrightRunner()) {
+        return __allureAny_reader.step(stepName, run);
+    }
+    return run();
+}
+/**
+ * Web: Get Attribute -field: {param} -name: {param} -options: {param}
+ *
+ * Returns the value of an attribute from the resolved element.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Label/selector or Locator of the element
+ * @param name - Attribute name
+ * @param options - Optional JSON string or object ({ pattern, actionTimeout })
+ * @returns The attribute value or null
+ * @throws Error if page is not initialized or element resolution fails
+ */
+async function getAttribute(page, field, name, options) {
+    const options_json = typeof options === 'string' ? global_1.vars.parseLooseJson(options) : options || {};
+    const stepName = `Web: Get Attribute -field: ${typeof field === 'string' ? field : '<locator>'} -name: ${name}`;
+    const run = async () => {
+        if (!page)
+            throw new Error("Page not initialized");
+        const locator = typeof field === 'string'
+            ? await (0, global_1.webLocResolver)((options_json === null || options_json === void 0 ? void 0 : options_json.fieldType) || '', field, page, options_json === null || options_json === void 0 ? void 0 : options_json.pattern, typeof (options_json === null || options_json === void 0 ? void 0 : options_json.actionTimeout) === 'number' ? options_json.actionTimeout : undefined, (options_json === null || options_json === void 0 ? void 0 : options_json.smartAiRefresh) || '')
+            : field;
+        return locator.getAttribute(name);
+    };
+    if (isPlaywrightRunner()) {
+        return __allureAny_reader.step(stepName, run);
+    }
+    return run();
+}
+/**
+ * Web: Has Class -field: {param} -className: {param} -options: {param}
+ *
+ * Checks whether the element has the specified CSS class.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Label/selector or Locator of the element
+ * @param className - Class name to check
+ * @param options - Optional JSON string or object ({ pattern, actionTimeout })
+ * @returns True when class present; false otherwise
+ * @throws Error if page is not initialized or element resolution fails
+ */
+async function hasClass(page, field, className, options) {
+    const options_json = typeof options === 'string' ? global_1.vars.parseLooseJson(options) : options || {};
+    const stepName = `Web: Has Class -field: ${typeof field === 'string' ? field : '<locator>'} -className: ${className}`;
+    const run = async () => {
+        if (!page)
+            throw new Error("Page not initialized");
+        const locator = typeof field === 'string'
+            ? await (0, global_1.webLocResolver)((options_json === null || options_json === void 0 ? void 0 : options_json.fieldType) || '', field, page, options_json === null || options_json === void 0 ? void 0 : options_json.pattern, typeof (options_json === null || options_json === void 0 ? void 0 : options_json.actionTimeout) === 'number' ? options_json.actionTimeout : undefined, (options_json === null || options_json === void 0 ? void 0 : options_json.smartAiRefresh) || '')
+            : field;
+        const cls = await locator.getAttribute('class');
+        return (cls || '').split(/\s+/).includes(className);
+    };
+    if (isPlaywrightRunner()) {
+        return __allureAny_reader.step(stepName, run);
+    }
+    return run();
+}
+/**
+ * Web: Get HTML -field: {param} -options: {param}
+ *
+ * Returns the inner HTML of the resolved element.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Label/selector or Locator of the element
+ * @param options - Optional JSON string or object ({ pattern, actionTimeout })
+ * @returns The element's inner HTML
+ * @throws Error if page is not initialized or element resolution fails
+ */
+async function getHtml(page, field, options) {
+    const options_json = typeof options === 'string' ? global_1.vars.parseLooseJson(options) : options || {};
+    const stepName = `Web: Get HTML -field: ${typeof field === 'string' ? field : '<locator>'}`;
+    const run = async () => {
+        if (!page)
+            throw new Error("Page not initialized");
+        const locator = typeof field === 'string'
+            ? await (0, global_1.webLocResolver)((options_json === null || options_json === void 0 ? void 0 : options_json.fieldType) || '', field, page, options_json === null || options_json === void 0 ? void 0 : options_json.pattern, typeof (options_json === null || options_json === void 0 ? void 0 : options_json.actionTimeout) === 'number' ? options_json.actionTimeout : undefined, (options_json === null || options_json === void 0 ? void 0 : options_json.smartAiRefresh) || '')
+            : field;
+        return locator.innerHTML();
+    };
+    if (isPlaywrightRunner()) {
+        return __allureAny_reader.step(stepName, run);
+    }
+    return run();
+}
+/**
+ * Web: Store element text in Variable -field: {param} into variable: {param} -options: {param}
+ * Stores the text content of a web element into a variable for later use.
+ * @param page - Playwright Page instance.
+ * @param field - The label, text, id, name, or selector of the web element.
+ * @param variableName - The name of the variable to store the text content.
+ * @param options - Optional JSON string or object:
+ *  - actionTimeout: [number] Optional timeout in milliseconds. Default: Configured timeout.
+ * - pattern: [string] Optional pattern to refine element search.
+ * - attribute: [string] If provided, reads specific attribute instead of text/value.
+ * - trim: [boolean] Whether to trim whitespace. Default: true.
+ * - normalizeWhitespace: [boolean] Whether to normalize whitespace. Default: true.
+ * - screenshot: [boolean] Capture screenshot after storing text. Default: false.
+ * - screenshotText: [string] Description for the screenshot.
+ */
+async function storeElementTextInVariable(page, field, variableName, options) {
+    var _a;
+    const options_json = typeof options === "string" ? global_1.vars.parseLooseJson(options) : options || {};
+    // Default fieldType to "input" if not provided or falsy
+    const { actionTimeout = ((_a = config === null || config === void 0 ? void 0 : config.testExecution) === null || _a === void 0 ? void 0 : _a.actionTimeout) || Number(global_1.vars.getConfigValue("testExecution.actionTimeout")) || 30000, pattern, fieldType = "input", attribute = "", trim = true, normalizeWhitespace = true, screenshot = false, screenshotText = "", screenshotFullPage = true, } = options_json;
+    if (isPlaywrightRunner()) {
+        await __allureAny_web.step(`Web: Store element text in Variable -field: ${field} into variable: ${variableName} -options: ${JSON.stringify(options_json)}`, async () => {
+            await doStoreElementTextInVariable();
+        });
+    }
+    else {
+        await doStoreElementTextInVariable();
+    }
+    async function doStoreElementTextInVariable() {
+        if (!page)
+            throw new Error("Page not initialized");
+        const target = typeof field === "string"
+            ? await (0, global_1.webLocResolver)(fieldType, field, page, pattern, actionTimeout)
+            : field;
+        await target.waitFor({ state: "visible", timeout: actionTimeout });
+        const tag = await target.evaluate((el) => el.tagName.toLowerCase());
+        let raw;
+        if (attribute) {
+            raw = await target.getAttribute(attribute);
+        }
+        else if (tag === "input" || tag === "textarea" || tag === "select") {
+            raw = await target.inputValue();
+        }
+        else {
+            raw = await target.innerText();
+        }
+        let value = (raw !== null && raw !== void 0 ? raw : "").toString();
+        if (trim)
+            value = value.trim();
+        if (normalizeWhitespace)
+            value = value.replace(/\s+/g, " ");
+        if (typeof global_1.vars.setValue === "function") {
+            global_1.vars.setValue(variableName, value);
+        }
+        else if (typeof global_1.vars.set === "function") {
+            global_1.vars.set(variableName, value);
+        }
+        else {
+            throw new Error(`No supported setter found on vars to store "${variableName}"`);
+        }
+        await (0, commonActions_1.attachLog)(`✅ Stored element text into "${variableName}": "${value}"`, "text/plain");
+        await (0, screenshotActions_1.processScreenshot)(page, screenshot, screenshotText || `Stored text for: ${variableName}`, screenshotFullPage);
+    }
+}
+/**
+ * Web: Get All Texts -selector/field: {param} -options: {param}
+ *
+ * Returns an array of inner texts of all elements matching the selector or field.
+ *
+ * @param page - Playwright Page instance
+ * @param field - CSS selector, label, or Locator
+ * @param options - Optional JSON string or object:
+ *   - pattern: [string] Pattern for pattern engine
+ *   - fieldType: [string] Pattern engine field type (default: 'field')
+ *   - itemSelector: [string] Sub-selector to locate text inside each element
+ *   - attribute: [string] Attribute to extract instead of innerText (e.g., 'textContent', 'value')
+ *   - actionTimeout: [number] Timeout in ms
+ * @returns Array of strings representing the text of each element
+ */
+async function getAllTexts(page, field, options) {
+    var _a;
+    const options_json = typeof options === "string" ? global_1.vars.parseLooseJson(options) : options || {};
+    const { pattern = '', fieldType = 'field', itemSelector = '', attribute = 'innerText', actionTimeout = ((_a = config === null || config === void 0 ? void 0 : config.testExecution) === null || _a === void 0 ? void 0 : _a.actionTimeout) || Number(global_1.vars.getConfigValue("testExecution.actionTimeout")) || 30000 } = options_json;
+    const stepName = `Web: Get All Texts -field: ${typeof field === 'string' ? field : '<locator>'} -options: ${JSON.stringify(options_json)}`;
+    const run = async () => {
+        if (!page)
+            throw new Error("Page not initialized");
+        // Resolve locator
+        const locator = typeof field === 'string'
+            ? await (0, global_1.webLocResolver)(fieldType, field, page, pattern, actionTimeout)
+            : field;
+        const count = await locator.count();
+        if (count === 0) {
+            await (0, commonActions_1.attachLog)(`❌ No elements found for field/selector "${field}"`, "text/plain");
+            return [];
+        }
+        const texts = [];
+        for (let i = 0; i < count; i++) {
+            let el = locator.nth(i);
+            if (itemSelector)
+                el = el.locator(itemSelector);
+            let value;
+            if (attribute === 'innerText') {
+                value = (await el.innerText()).trim();
+            }
+            else if (attribute === 'textContent') {
+                value = (await el.textContent() || '').trim();
+            }
+            else {
+                value = (await el.getAttribute(attribute) || '').trim();
+            }
+            texts.push(value.replace(/\s+/g, ' '));
+        }
+        await (0, commonActions_1.attachLog)(`✅ Retrieved texts for "${field}": ${texts.join(', ')}`, "text/plain");
+        return texts;
+    };
+    if (isPlaywrightRunner()) {
+        return __allureAny_reader.step(stepName, run);
+    }
+    return run();
+}

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

@@ -0,0 +1,122 @@
+import { Page, Locator } from "@playwright/test";
+/**
+ * Web: Fill -field: {param} -value: {param} -options: {param}
+ *
+ * Fills a form input field (e.g., text box, textarea) with the specified value.
+ *
+ * @param field - The label, placeholder, id, name, or pattern of the input field (e.g., "Username", "Email", "search").
+ * @param value - The text value to fill in the input field (e.g., "JohnDoe", "test@example.com").
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Timeout in ms (default: 30000)
+ *   - pattern: [string] Optional pattern to refine element search. Default: Configured pattern.
+ *   - screenshot: [boolean] Capture a screenshot after filling the input. Default: false.
+ *   - screenshotText: [string] Text description for the screenshot. Default: "".
+ *   - screenshotFullPage: [boolean] Capture a full page screenshot. Default: true.
+ *   - screenshotField: [boolean] Capture screenshot of the field (input element) only. Overrides fullPage. Default: false.
+ *
+ * @example
+ *  Web: Fill -field: "Username" -value: "JohnDoe" -options: "{screenshot: true, screenshotText: 'After filling Username', screenshotField: true}"
+ */
+export declare function fill(page: Page, field: string | Locator, value: string | number, options?: string | Record<string, any>): Promise<void>;
+export declare const input: typeof fill;
+export declare const type: typeof fill;
+export declare const set: typeof fill;
+export declare const enter: typeof fill;
+/**
+ * Web: Append -field: {param} -value: {param} -options: {param}
+ *
+ * Appends text to an input or textarea without clearing existing content.
+ *
+ * @param page - Playwright Page instance
+ * @param field - The label, placeholder, id, name, or pattern of the input field
+ * @param value - The text value to append
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Timeout in ms (default: 30000)
+ *   - pattern: [string] Optional pattern to refine element search
+ *   - screenshot: [boolean] Capture a screenshot after appending (default: false)
+ *   - screenshotText: [string] Text description for the screenshot
+ *   - screenshotFullPage: [boolean] Capture a full page screenshot (default: true)
+ *   - screenshotField: [boolean] Capture screenshot of the field (input element) only (default: false)
+ */
+export declare function append(page: Page, field: string | Locator, value: string | number, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Select Option -field: {param} -value: {param} -options: {param}
+ *
+ * Selects an option in a dropdown by label or value.
+ * Delegates to core `selectDropdown`.
+ *
+ * @param page Playwright Page instance
+ * @param field Dropdown locator or string selector
+ * @param value Option label or value
+ * @param options Optional JSON string or object ({ actionTimeout, pattern })
+ */
+/**
+ * Web: Select Dropdown -field: {param} -value: {param} -options: {param}
+ *
+ * Selects a dropdown option by visible text or value.
+ * Works with both native <select> elements and custom dropdowns.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Locator or label of the dropdown
+ * @param value - Value or label of the option to select
+ * @param options - Optional string or object containing:
+ *   - actionTimeout: custom timeout
+ *   - pattern: extra pattern string for locator resolution
+ *   - screenshot: boolean (default false)
+ *   - screenshotText: text for screenshot description
+ *   - screenshotFullPage: boolean (default true)
+ *   - smartIQ_refreshLoc: optional override for locator refresh key
+ */
+export declare function selectOption(page: Page, field: string | Locator, value: string | number, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Upload File -field: {param} -file: {param} -options: {param}
+ *
+ * Uploads a file to an input element.
+ * Delegates to core `uploadFile`.
+ *
+ * @param page Playwright Page instance
+ * @param field File input locator or string selector
+ * @param file Local file path
+ * @param options Optional JSON string or object ({ actionTimeout })
+ */
+export declare function uploadFile(page: Page, field: string | Locator, file: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Select Dropdown by Index -field: {param} -index: {param} -options: {param}
+ *
+ * Selects a dropdown option by its index (zero-based).
+ * Works with both native <select> elements and custom dropdowns.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Locator or label of the dropdown
+ * @param index - Index of the option to select (zero-based)
+ * @param options - Optional string or object containing:
+ *   - actionTimeout: custom timeout
+ *   - pattern: extra pattern string for locator resolution
+ *   - screenshot: boolean (default false)
+ *   - screenshotText: text for screenshot description
+ *   - screenshotFullPage: boolean (default true)
+ *   - smartIQ_refreshLoc: optional override for locator refresh key
+ */
+export declare function selectOptionByIndex(page: Page, field: string | Locator, index: number, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Select Dropdown -field: {param} -value: {param} -options: {param}
+ *
+ * Selects a dropdown option by visible text or value.
+ * Works with both native <select> elements and custom dropdowns.
+ *
+ * @param page - Playwright Page instance
+ * @param field - Locator or label of the dropdown
+ * @param value - Value or label of the option to select
+ * @param options - Optional string or object containing:
+ *   - actionTimeout: custom timeout
+ *   - pattern: extra pattern string for locator resolution
+ *   - screenshot: boolean (default false)
+ *   - screenshotText: text for screenshot description
+ *   - screenshotFullPage: boolean (default true)
+ *   - smartIQ_refreshLoc: optional override for locator refresh key
+ */
+export declare function selectDropdown(page: Page, field: string | Locator, value: string | number, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Alias: Select Dropdown by Index (wrapper to selectOptionByIndex)
+ */
+export declare function selectDropdownByIndex(page: Page, field: string | Locator, index: number, options?: string | Record<string, any>): Promise<void>;