automation_model 1.0.511-dev → 1.0.511

package/lib/snapshot_validation.d.ts

@@ -0,0 +1,37 @@
+export declare function highlightSnapshot(snapshot: any, scope: any): Promise<void>;
+/**
+ * One flattened line of an ARIA snapshot
+ */
+interface SnapshotLine {
+    /** original 0-based line number in the file that was parsed */
+    line: number;
+    /** the ARIA role / node name: “text”, “button”, “listitem”…   */
+    key: string;
+    /** the textual value after the role, or null */
+    value: string | null;
+    /** indentation depth (0 = root, 1 = child of the previous level, …) */
+    level: number;
+    /** validation / parsing flags */
+    error: string | null;
+    /** interpret `value` as a RegExp instead of literal text */
+    regex: boolean;
+    /** the original line text */
+    line_text: string;
+}
+export declare function fromLinesToSnapshotLines(lines: string[]): SnapshotLine[];
+/**
+ * Successful-/error-report returned by `matchSnapshot`.
+ *
+ *  ─ matchingLines … full-snapshot **original** line numbers that correspond
+ *                    to every line in the sub-snapshot (same order & length).
+ *  ─ errorLine …..  first sub-snapshot index that could **not** be matched,
+ *                    or -1 when the whole sub-snapshot was found.
+ */
+export interface MatchResult {
+    matchingLines: number[];
+    errorLine: number;
+    errorLineText: string | null;
+}
+export declare function snapshotValidation(snapshot: string, referanceSnapshot: string, snapshotName: string): MatchResult;
+export declare function matchSnapshot(full: SnapshotLine[], sub: SnapshotLine[], snapshotName: string): MatchResult;
+export {};

package/lib/snapshot_validation.js

@@ -0,0 +1,360 @@
+export async function highlightSnapshot(snapshot, scope) {
+    const lines = snapshot.split("\n");
+    const nodes = fromLinesToSnapshotLines(lines);
+    // build a SnapshotNode tree
+    const root = new SnapshotNode("root", null);
+    const stack = [root];
+    const allNodes = [];
+    for (const node of nodes) {
+        const newNode = new SnapshotNode(node.key, node.value);
+        allNodes.push(newNode);
+        newNode.level = node.level;
+        newNode.regex = node.regex;
+        if (node.level > stack.length - 1) {
+            // add to the last node
+            stack[stack.length - 1].children.push(newNode);
+            newNode.parent = stack[stack.length - 1];
+            stack.push(newNode);
+        }
+        else {
+            // pop the stack until we find the right level
+            while (stack.length > node.level + 1) {
+                stack.pop();
+            }
+            // add to the parent
+            stack[stack.length - 1].children.push(newNode);
+            newNode.parent = stack[stack.length - 1];
+            stack.push(newNode);
+        }
+    }
+    // go over all the nodes in the tree and generate an array of full locators
+    const locators = [];
+    for (const node of allNodes) {
+        const locator = node.getFullLocator();
+        locators.push(locator);
+    }
+    const elements = [];
+    // go over all the locators and find the elements
+    for (const locator of locators) {
+        const l = scope.locator(locator);
+        let count = 0;
+        try {
+            count = await l.count();
+        }
+        catch (e) {
+            //console.log("Error in locator", locator, e);
+            continue;
+        }
+        for (let i = 0; i < count; i++) {
+            const element = l.nth(i);
+            elements.push(element);
+        }
+    }
+    // go over all the elements and highlight them
+    for (const element of elements) {
+        try {
+            await element.evaluate((el) => {
+                if (!el?.style)
+                    return;
+                const originalOutline = el.style.outline;
+                el.__previousOutline = originalOutline;
+                el.style.outline = "2px solid red";
+                if (window) {
+                    window.addEventListener("beforeunload", function () {
+                        el.style.outline = originalOutline;
+                    });
+                }
+                setTimeout(() => {
+                    el.style.outline = originalOutline;
+                }, 4000);
+            });
+        }
+        catch (e) { }
+    }
+}
+/*
+- banner:
+  - heading "Shop NOW" [level=6]
+- text: Log In Username
+- textbox "Username"
+- text: Password
+- textbox "Password"
+- button "Login"
+- paragraph: "Accepted usernames are:"
+- list:
+  - listitem:
+    - paragraph: blinq_user
+  - listitem:
+    - paragraph: blinq_admin
+- paragraph: "Password for all users:"
+- paragraph: let_me_in
+*/
+class SnapshotNode {
+    key;
+    value;
+    role;
+    name;
+    level = 0;
+    regex = false;
+    children = [];
+    parent = null;
+    constructor(key, value) {
+        this.key = key;
+        this.value = value;
+        if (!key) {
+            throw new Error("Key cannot be null or undefined");
+        }
+        this.role = key.split(" ")[0];
+        if (this.value) {
+            this.name = this.value;
+        }
+        else {
+            // the value will be from the first " to the last "
+            const start = key.indexOf('"') + 1;
+            const end = key.lastIndexOf('"');
+            if (start > -1 && end > -1 && start < end) {
+                this.name = key.substring(start, end);
+            }
+            else {
+                this.name = null;
+            }
+        }
+    }
+    generateNodeLocator() {
+        let locator = `internal:role=${this.role}`;
+        switch (this.role) {
+            case "paragraph":
+                // internal:role=paragraph >> internal:text='blinq_user'"
+                return `internal:role=${this.role} >> internal:text=${this.name}`;
+            default:
+                // "internal:role=textbox[name=\"Password\"]"
+                if (this.name) {
+                    locator += `[name="${this.name}"]`;
+                }
+                return locator;
+        }
+    }
+    getFullLocator() {
+        // create an array of all the parents and current node locators
+        const locators = [];
+        let currentNode = this;
+        while (currentNode) {
+            if (currentNode.role !== "root") {
+                locators.unshift(currentNode.generateNodeLocator());
+            }
+            currentNode = currentNode.parent;
+        }
+        // join the locators with " >> "
+        return locators.join(" >> ");
+    }
+}
+export function fromLinesToSnapshotLines(lines) {
+    // the input is yaml text split into lines, 2 spaces is 1 level
+    const nodes = [];
+    // identify the space count for tabulation
+    let previouseLineSpaceCount = -1;
+    let foundTabulationCount = -1;
+    // look for 2 consecutive lines that have different space counts, the absolute difference is the space count for tabulation
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmedLine = line.trim();
+        if (trimmedLine.length === 0) {
+            continue;
+        }
+        // count the number of leading spaces
+        const match = line.match(/^ */); // Matches spaces at the beginning
+        const count = match ? match[0].length : 0;
+        if (previouseLineSpaceCount !== -1 && previouseLineSpaceCount !== count) {
+            foundTabulationCount = Math.abs(previouseLineSpaceCount - count);
+            break;
+        }
+        previouseLineSpaceCount = count;
+    }
+    if (foundTabulationCount === -1) {
+        foundTabulationCount = 2;
+    }
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmedLine = line.trim();
+        if (trimmedLine.length === 0) {
+            continue;
+        }
+        // count the number of leading spaces
+        let level = 0;
+        const match = line.match(/^ */); // Matches spaces at the beginning
+        const count = match ? match[0].length : 0;
+        level = count / foundTabulationCount; // 2 spaces is 1 level
+        // find the start of the line: - and space
+        const start = line.indexOf("- ") + 2;
+        if (start === -1) {
+            // no - found, set it to error
+            nodes.push({
+                line: i,
+                line_text: line,
+                key: line,
+                value: null,
+                level,
+                error: "No - found",
+                regex: false,
+            });
+            continue;
+        }
+        // first we need to extract the role, we should find the first space or : after the start
+        const end = line.indexOf(" ", start);
+        const end2 = line.indexOf(":", start);
+        if (end === -1 && end2 === -1) {
+            // no space or : found, set it to error
+            nodes.push({
+                line: i,
+                line_text: line,
+                key: line,
+                value: null,
+                level,
+                error: "No space or : found",
+                regex: false,
+            });
+            continue;
+        }
+        const endIndex = end === -1 ? end2 : end2 === -1 ? end : Math.min(end, end2);
+        const key = line.substring(start, endIndex).trim();
+        // define value is string or null
+        let value = line.substring(endIndex + 1).trim();
+        if (value.startsWith('"')) {
+            const lastQuote = value.lastIndexOf('"');
+            if (lastQuote !== -1) {
+                value = value.substring(0, lastQuote + 1);
+            }
+        }
+        // improved regex detection
+        const rawValue = value.endsWith(":") ? value.slice(0, -1) : value;
+        const regex = rawValue.startsWith("/") && /\/[a-z]*$/.test(rawValue);
+        nodes.push({
+            line: i,
+            line_text: line,
+            key,
+            value: value.length > 0 ? value : null,
+            level,
+            error: null,
+            regex,
+        });
+    }
+    return nodes;
+}
+/**
+ * Turn a “/pattern/flags” string into a real RegExp.
+ */
+function toRegExp(raw) {
+    // Remove trailing colon from YAML-style key: /pattern/: → /pattern/
+    const sanitized = raw.endsWith(":") ? raw.slice(0, -1) : raw;
+    if (!sanitized.startsWith("/"))
+        return new RegExp(sanitized);
+    const lastSlash = sanitized.lastIndexOf("/");
+    const pattern = sanitized.slice(1, lastSlash);
+    const flags = sanitized.slice(lastSlash + 1); // i, g, etc.
+    return new RegExp(pattern, flags);
+}
+/**
+ * Single-line comparison with fixed regex handling.
+ */
+function lineMatches(full, sub) {
+    let status = { status: false };
+    if (full.key !== sub.key)
+        return status;
+    // We handle level offset outside this function
+    if (sub.value === null) {
+        status.status = true;
+        return status;
+    }
+    if (sub.regex) {
+        status.status = toRegExp(sub.value).test(full.value ?? "");
+    }
+    else if (full.regex) {
+        status.status = toRegExp(full.value).test(sub.value ?? "");
+    }
+    else {
+        status.status = full.value === sub.value;
+    }
+    return status;
+}
+export function snapshotValidation(snapshot, referanceSnapshot, snapshotName) {
+    const lines = snapshot.split("\n");
+    console.log("Size of page snapshot :", lines?.length || 0);
+    const nodes = fromLinesToSnapshotLines(lines);
+    const subLines = referanceSnapshot.split("\n");
+    console.log("Size of reference snapshot :", subLines?.length || 0);
+    const subNodes = fromLinesToSnapshotLines(subLines);
+    return matchSnapshot(nodes, subNodes, snapshotName);
+}
+export function matchSnapshot(full, sub, snapshotName) {
+    const parentIdx = sub.map((_, i) => {
+        for (let j = i - 1; j >= 0; j--)
+            if (sub[j].level < sub[i].level)
+                return j;
+        return -1;
+    });
+    const fullIdx = new Array(sub.length);
+    const mapping = new Array(sub.length);
+    let failureAt = -1;
+    function dfs(s, fFrom, baseLevelOffset) {
+        if (s === sub.length)
+            return true;
+        for (let f = fFrom; f < full.length; f++) {
+            let levelMatch = true;
+            if (baseLevelOffset !== null) {
+                // Must match levels relative to initial offset
+                if (full[f].level !== sub[s].level + baseLevelOffset)
+                    continue;
+            }
+            const status = lineMatches(full[f], sub[s]);
+            if (!status.status)
+                continue;
+            // For first match, set level offset
+            const nextBaseOffset = baseLevelOffset !== null ? baseLevelOffset : full[f].level - sub[s].level;
+            const pSub = parentIdx[s];
+            if (pSub !== -1) {
+                let pFull = f - 1;
+                while (pFull >= 0 && full[pFull].level >= full[f].level)
+                    pFull--;
+                if (pFull < 0 || pFull !== fullIdx[pSub])
+                    continue;
+            }
+            fullIdx[s] = f;
+            mapping[s] = full[f].line;
+            if (dfs(s + 1, f + 1, nextBaseOffset))
+                return true;
+        }
+        if (failureAt === -1)
+            failureAt = s;
+        return false;
+    }
+    const found = dfs(0, 0, null);
+    console.log("Snapshot validation result:", found ? "MATCH" : `NO MATCH`);
+    let error = null;
+    if (!found) {
+        error = `Snapshot file: ${snapshotName}\nLine no.: ${sub[failureAt].line}\nLine: ${sub[failureAt].line_text}`;
+    }
+    return {
+        matchingLines: found ? mapping : mapping.slice(0, failureAt),
+        errorLine: found ? -1 : failureAt,
+        errorLineText: error,
+    };
+}
+// let ttt = `- banner:
+//   - heading "Shop NOW" [level=6]
+// - text: Log In Username
+// - textbox "Username"
+// - text: Password
+// - textbox "Password"
+// - button "Login"
+// - paragraph: "Accepted usernames are:"
+// - list:
+//   - listitem:
+//     - paragraph: blinq_user
+//   - listitem:
+//     - paragraph: blinq_admin
+// - paragraph: "Password for all users:"
+// - paragraph: let_me_in`;
+// const lines = ttt.split("\n");
+// const nodes = fromLinesToSnapshotLines(lines);
+// console.log("nodes", nodes);
+//# sourceMappingURL=snapshot_validation.js.map

package/lib/snapshot_validation.js.map

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

package/lib/stable_browser.d.ts

@@ -1,5 +1,52 @@
 import type { Browser, Page } from "playwright";
-type Params = Record<string, string>;
+import { Params } from "./utils.js";
+export declare const Types: {
+    CLICK: string;
+    WAIT_ELEMENT: string;
+    NAVIGATE: string;
+    GO_BACK: string;
+    GO_FORWARD: string;
+    FILL: string;
+    EXECUTE: string;
+    OPEN: string;
+    COMPLETE: string;
+    ASK: string;
+    GET_PAGE_STATUS: string;
+    CLICK_ROW_ACTION: string;
+    VERIFY_ELEMENT_CONTAINS_TEXT: string;
+    VERIFY_PAGE_CONTAINS_TEXT: string;
+    VERIFY_PAGE_CONTAINS_NO_TEXT: string;
+    ANALYZE_TABLE: string;
+    SELECT: string;
+    VERIFY_PROPERTY: string;
+    VERIFY_PAGE_PATH: string;
+    VERIFY_PAGE_TITLE: string;
+    TYPE_PRESS: string;
+    PRESS: string;
+    HOVER: string;
+    CHECK: string;
+    UNCHECK: string;
+    EXTRACT: string;
+    EXTRACT_PROPERTY: string;
+    CLOSE_PAGE: string;
+    TABLE_OPERATION: string;
+    SET_DATE_TIME: string;
+    SET_VIEWPORT: string;
+    VERIFY_VISUAL: string;
+    LOAD_DATA: string;
+    SET_INPUT: string;
+    WAIT_FOR_TEXT_TO_DISAPPEAR: string;
+    VERIFY_ATTRIBUTE: string;
+    VERIFY_TEXT_WITH_RELATION: string;
+    BRUNO: string;
+    VERIFY_FILE_EXISTS: string;
+    SET_INPUT_FILES: string;
+    SNAPSHOT_VALIDATION: string;
+    REPORT_COMMAND: string;
+    STEP_COMPLETE: string;
+    SLEEP: string;
+    CONDITIONAL_WAIT: string;
+};
 export declare const apps: {};
 declare class StableBrowser {
     browser: Browser;
@@ -7,40 +54,50 @@ declare class StableBrowser {
     logger: any;
     context: any;
     world?: any;
+    fastMode: boolean;
+    stepTags: string[];
     project_path: null;
     webLogFile: null;
     networkLogger: null;
     configuration: null;
     appName: string;
-    constructor(browser: Browser, page: Page, logger?: any, context?: any, world?: any);
+    tags: null;
+    isRecording: boolean;
+    initSnapshotTaken: boolean;
+    onlyFailuresScreenshot: boolean;
+    inStepReport: boolean;
+    constructor(browser: Browser, page: Page, logger?: any, context?: any, world?: any, fastMode?: boolean, stepTags?: string[]);
     registerEventListeners(context: any): void;
     switchApp(appName: any): Promise<void>;
-    _copyContext(from: any, to: any): void;
-    getWebLogFile(logFolder: string): string;
+    switchTab(tabTitleOrIndex: number | string): Promise<void>;
     registerConsoleLogListener(page: Page, context: any): void;
     registerRequestListener(page: Page, context: any, logFile: string): void;
-    goto(url: string): Promise<void>;
-    _fixUsingParams(text: any, _params: Params): any;
-    _fixLocatorUsingParams(locator: any, _params: Params): any;
-    _isObject(value: any): any;
-    scanAndManipulate(currentObj: any, _params: Params): void;
-    _getLocator(locator: any, scope: any, _params: any): any;
+    goto(url: string, world?: null, options?: {}): Promise<void>;
+    goBack(options: any, world?: null): Promise<void>;
+    goForward(options: any, world?: null): Promise<void>;
+    _getLocator(locator: any, scope: any, _params: any): Promise<any>;
     _locateElmentByTextClimbCss(scope: any, text: any, climb: any, css: any, _params: Params): Promise<string | undefined>;
-    _locateElementByText(scope: any, text1: any, tag1: any, regex1: boolean | undefined, partial1: any, _params: Params): Promise<any>;
-    _collectLocatorInformation(selectorHierarchy: any, index: number | undefined, scope: any, foundLocators: any, _params: Params, info: any, visibleOnly?: boolean): Promise<void>;
+    _locateElementByText(scope: any, text1: any, tag1: any, regex1: boolean | undefined, partial1: any, ignoreCase: boolean | undefined, _params: Params): Promise<{
+        elementCount: number;
+        randomToken: string;
+    }>;
+    _collectLocatorInformation(selectorHierarchy: any, index: number | undefined, scope: any, foundLocators: any, _params: Params, info: any, visibleOnly?: boolean, allowDisabled?: boolean | undefined, element_name?: null, logErrors?: boolean | undefined): Promise<void>;
     closeUnexpectedPopups(info: any, _params: any): Promise<{
         rerun: boolean;
     }>;
-    _locate(selectors: any, info: any, _params?: Params, timeout: any): Promise<any>;
+    getFilePath(): string | null;
+    getFullElementLocators(selectors: any, filePath: any): any;
+    _locate(selectors: any, info: any, _params?: Params, timeout: any, allowDisabled?: boolean | undefined): Promise<any>;
     _findFrameScope(selectors: any, timeout: number | undefined, info: any): Promise<any>;
     _getDocumentBody(selectors: any, timeout: number | undefined, info: any): Promise<any>;
-    _locate_internal(selectors: any, info: any, _params?: Params, timeout?: number): Promise<any>;
-    _scanLocatorsGroup(locatorsGroup: any, scope: any, _params: any, info: any, visibleOnly: any): Promise<{
+    _locate_internal(selectors: any, info: any, _params?: Params, timeout?: number, allowDisabled?: boolean | undefined): Promise<any>;
+    _scanLocatorsGroup(locatorsGroup: any, scope: any, _params: any, info: any, visibleOnly: any, allowDisabled?: boolean | undefined, element_name: any, logErrors?: boolean | undefined): Promise<{
         foundElements: any[];
     }>;
     simpleClick(elementDescription: any, _params?: Params, options?: {}, world?: null): Promise<void>;
     simpleClickType(elementDescription: any, value: any, _params?: Params, options?: {}, world?: null): Promise<void>;
     click(selectors: any, _params?: Params, options?: {}, world?: null): Promise<any>;
+    waitForElement(selectors: any, _params?: Params, options?: {}, world?: null): Promise<boolean>;
     setCheck(selectors: any, checked?: boolean, _params?: Params, options?: {}, world?: null): Promise<any>;
     hover(selectors: any, _params?: Params, options?: {}, world?: null): Promise<any>;
     selectOption(selectors: any, values: any, _params?: null, options?: {}, world?: null): Promise<any>;
@@ -49,6 +106,7 @@ declare class StableBrowser {
     setDateTime(selectors: any, value: any, format?: null, enter?: boolean, _params?: null, options?: {}, world?: null): Promise<void>;
     clickType(selectors: any, _value: any, enter?: boolean, _params?: null, options?: {}, world?: null): Promise<any>;
     fill(selectors: any, value: any, enter?: boolean, _params?: null, options?: {}, world?: null): Promise<any>;
+    setInputFiles(selectors: any, files: any, _params?: null, options?: {}, world?: null): Promise<any>;
     getText(selectors: any, _params?: null, options?: {}, info?: {}, world?: null): Promise<{
         text: any;
         screenshotId: any;
@@ -77,9 +135,10 @@ declare class StableBrowser {
     }>;
     containsPattern(selectors: any, pattern: any, text: any, _params?: null, options?: {}, world?: null): Promise<any>;
     containsText(selectors: any, text: any, climb: any, _params?: null, options?: {}, world?: null): Promise<any>;
-    _getDataFile(world?: null): string;
+    snapshotValidation(frameSelectors: any, referanceSnapshot: any, _params?: null, options?: {}, world?: null): Promise<any>;
     waitForUserInput(message: any, world?: null): Promise<void>;
     setTestData(testData: any, world?: null): void;
+    overwriteTestData(testData: any, world?: null): void;
     _getDataFilePath(fileName: any): string;
     _parseCSVSync(filePath: any): Promise<unknown>;
     loadTestData(type: string, dataSelector: string, world?: null): {
@@ -88,51 +147,92 @@ declare class StableBrowser {
         totp: string | null;
     };
     loadTestDataAsync(type: string, dataSelector: string, world?: null): Promise<any>;
-    getTestData(world?: null): {};
+    getTestData(world?: null): any;
     _screenShot(options?: {}, world?: null, info?: null): Promise<{}>;
-    takeScreenshot(screenshotPath: any): Promise<any>;
+    takeScreenshot(screenshotPath: any, fullPage?: boolean): Promise<any>;
     verifyElementExistInPage(selectors: any, _params?: null, options?: {}, world?: null): Promise<any>;
     extractAttribute(selectors: any, attribute: any, variable: any, _params?: null, options?: {}, world?: null): Promise<any>;
+    extractProperty(selectors: any, property: any, variable: any, _params?: null, options?: {}, world?: null): Promise<any>;
+    verifyAttribute(selectors: any, attribute: any, value: any, _params?: null, options?: {}, world?: null): Promise<any>;
+    verifyProperty(selectors: any, property: any, value: any, _params?: null, options?: {}, world?: null): Promise<any>;
+    conditionalWait(selectors: any, condition: any, timeout?: number, _params?: null, options?: {}, world?: null): Promise<{}>;
     extractEmailData(emailAddress: any, options: any, world: any): Promise<{
         emailUrl: any;
         emailCode: any;
     }>;
     _highlightElements(scope: any, css: any): Promise<void>;
-    verifyPagePath(pathPart: any, options?: {}, world?: null): Promise<{} | undefined>;
+    _matcher(text: any): {
+        matcher: any;
+        queryText: any;
+    };
+    _getDomain(url: string): string;
+    /**
+     * Verify the page path matches the given path.
+     * @param {string} pathPart - The path to verify.
+     * @param {object} options - Options for verification.
+     * @param {object} world - The world context.
+     * @returns {Promise<object>} - The state info after verification.
+     */
+    verifyPagePath(pathPart: string, options?: object, world?: object): Promise<object>;
+    /**
+     * Verify the page title matches the given title.
+     * @param {string} title - The title to verify.
+     * @param {object} options - Options for verification.
+     * @param {object} world - The world context.
+     * @returns {Promise<object>} - The state info after verification.
+     */
+    verifyPageTitle(title: string, options?: object, world?: object): Promise<object>;
+    findTextInAllFrames(dateAlternatives: any, numberAlternatives: any, text: any, state: any, partial?: boolean, ignoreCase?: boolean): Promise<{
+        elementCount: number;
+        randomToken: string;
+    }[]>;
     verifyTextExistInPage(text: any, options?: {}, world?: null): Promise<any>;
     waitForTextToDisappear(text: any, options?: {}, world?: null): Promise<any>;
-    _getServerUrl(): string;
+    verifyTextRelatedToText(textAnchor: string, climb: number, textToVerify: string, options?: {}, world?: any): Promise<any>;
+    findRelatedTextInAllFrames(textAnchor: string, climb: number, textToVerify: string, params?: Params, options?: {}, world?: any): Promise<{
+        elementCount: number;
+        randomToken: string;
+    }[]>;
     visualVerification(text: any, options?: {}, world?: null): Promise<{} | undefined>;
     verifyTableData(selectors: any, data: any, _params?: null, options?: {}, world?: null): Promise<void>;
     getTableData(selectors: any, _params?: null, options?: {}, world?: null): Promise<any>;
     analyzeTable(selectors: any, query: any, operator: any, value: any, _params?: null, options?: {}, world?: null): Promise<{} | undefined>;
+    /**
+     * Explicit wait/sleep function that pauses execution for a specified duration
+     * @param duration - Duration to sleep in milliseconds (default: 1000ms)
+     * @param options - Optional configuration object
+     * @param world - Optional world context
+     * @returns Promise that resolves after the specified duration
+     */
+    sleep(duration?: number, options?: {}, world?: null): Promise<any>;
     _replaceWithLocalData(value: any, world: any, _decrypt?: boolean, totpWait?: boolean): Promise<string>;
     _getLoadTimeout(options: any): number;
+    _getFindElementTimeout(options: any): any;
+    saveStoreState(path?: string | null, world?: any): Promise<void>;
+    restoreSaveState(path?: string | null, world?: any): Promise<void>;
     waitForPageLoad(options?: {}, world?: null): Promise<void>;
     closePage(options?: {}, world?: null): Promise<void>;
+    tableCellOperation(headerText: string, rowText: string, options: any, _params: Params, world?: null): Promise<void>;
+    saveTestDataAsGlobal(options: any, world: any): void;
     setViewportSize(width: number, hight: number, options?: {}, world?: null): Promise<void>;
     reloadPage(options?: {}, world?: null): Promise<void>;
     scrollIfNeeded(element: any, info: any): Promise<void>;
-    _reportToWorld(world: any, properties: JsonCommandReport): void;
+    beforeScenario(world: any, scenario: any): Promise<void>;
+    afterScenario(world: any, scenario: any): Promise<void>;
+    getGherkinKeyword(step: any): "" | "Given" | "When" | "Then" | "And";
+    beforeStep(world: any, step: any): Promise<void>;
+    setStepTags(tags: string[]): void;
+    getAriaSnapshot(): Promise<string | null>;
+    /**
+     * Sends command with custom payload to report.
+     * @param commandText - Title of the command to be shown in the report.
+     * @param commandStatus - Status of the command (e.g. "PASSED", "FAILED").
+     * @param content - Content of the command to be shown in the report.
+     * @param options - Options for the command. Example: { type: "json", screenshot: true }
+     * @param world - Optional world context.
+     * @public
+     */
+    addCommandToReport(commandText: string, commandStatus: "PASSED" | "FAILED", content: string, options?: any, world?: any): Promise<void>;
+    afterStep(world: any, step: any, result: any): Promise<void>;
 }
-type JsonTimestamp = number;
-type JsonResultPassed = {
-    status: "PASSED";
-    startTime: JsonTimestamp;
-    endTime: JsonTimestamp;
-};
-type JsonResultFailed = {
-    status: "FAILED";
-    startTime: JsonTimestamp;
-    endTime: JsonTimestamp;
-    message?: string;
-};
-type JsonCommandResult = JsonResultPassed | JsonResultFailed;
-type JsonCommandReport = {
-    type: string;
-    value?: string;
-    text: string;
-    screenshotId?: string;
-    result: JsonCommandResult;
-};
 export { StableBrowser };