playwright-cucumber-ts-steps 1.1.12 → 1.2.0

package/dist/backend/actions/mobile.d.ts

@@ -1,75 +1,53 @@
 /**
  * Taps on the currently stored (active) element.
  * Uses a "Hybrid Tap" strategy: tries to tap, falls back to click if touch is unsupported.
- *
- * ```gherkin
+ * @example
  * When I tap
- * ```
  */
-export declare const TapStoredElement: void;
+export declare function tapStoredElement(page: any): Promise<void>;
 /**
  * Finds an element by selector and taps it.
- * Uses a "Hybrid Tap" strategy.
- *
- * ```gherkin
+ * @example
  * When I tap element "#menu-toggle"
- * ```
- *
  * @param selector - The CSS selector of the element.
  */
-export declare const TapElementBySelector: void;
+export declare function tapElementBySelector(page: any, selector: string): Promise<void>;
 /**
  * Taps at specific X, Y coordinates on the screen.
- * Implemented via `mouse.click` which works reliably across both desktop and mobile viewports.
- *
- * ```gherkin
+ * @example
  * When I tap coordinates x:50 y:200
- * ```
- *
  * @param x - The X-coordinate.
  * @param y - The Y-coordinate.
  */
-export declare const TapCoordinates: void;
+export declare function tapCoordinates(page: any, x: number, y: number): Promise<void>;
 /**
  * Resizes the browser window/viewport to specific dimensions.
- *
- * ```gherkin
+ * @example
  * When I resize window to width 375 and height 812
- * ```
- *
  * @param width - The width in pixels.
  * @param height - The height in pixels.
  */
-export declare const ResizeWindow: void;
+export declare function resizeWindow(page: any, width: number, height: number): Promise<void>;
 /**
  * Resizes the viewport to match a specific device preset.
- *
- * ```gherkin
+ * @example
  * When I simulate device "iPhone 12"
- * ```
- *
  * @param deviceName - The name of the device. Supported: "iPhone 12", "iPhone SE", "iPad", "Pixel 5", "Samsung Galaxy S8", "Desktop".
  */
-export declare const SimulateDevice: void;
+export declare function simulateDevice(page: any, deviceName: string): Promise<void>;
 /**
  * Sets the geolocation coordinates for the browser context and auto-grants permission.
- *
- * ```gherkin
+ * @example
  * When I set geolocation to lat: 37.7749 long: -122.4194
- * ```
- *
  * @param lat - The latitude (float).
  * @param long - The longitude (float).
  */
-export declare const SetGeolocation: void;
+export declare function setGeolocation(page: any, lat: number, long: number): Promise<void>;
 /**
  * Grants a specific browser permission to the current context.
- *
- * ```gherkin
+ * @example
  * When I grant permission "notifications"
- * ```
- *
  * @param permission - The permission name (e.g., "geolocation", "notifications", "camera").
  */
-export declare const GrantPermission: void;
+export declare function grantPermission(page: any, permission: string): Promise<void>;
 //# sourceMappingURL=mobile.d.ts.map

package/dist/backend/actions/mobile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mobile.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/mobile.ts"],"names":[],"mappings":"AA8BA;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,MAI3B,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,MAI/B,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,MAIzB,CAAC;AAMH;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,MAMxB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,MAiBzB,CAAC;AAMH;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,MAO1B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,MAG1B,CAAC"}
+{"version":3,"file":"mobile.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/mobile.ts"],"names":[],"mappings":"AA+BA;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/D;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnF;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1F;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlF"}

package/dist/backend/actions/mobile.js

@@ -1,25 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GrantPermission = exports.SetGeolocation = exports.SimulateDevice = exports.ResizeWindow = exports.TapCoordinates = exports.TapElementBySelector = exports.TapStoredElement = void 0;
+exports.tapStoredElement = tapStoredElement;
+exports.tapElementBySelector = tapElementBySelector;
+exports.tapCoordinates = tapCoordinates;
+exports.resizeWindow = resizeWindow;
+exports.simulateDevice = simulateDevice;
+exports.setGeolocation = setGeolocation;
+exports.grantPermission = grantPermission;
 const registry_1 = require("../../core/registry");
 const state_1 = require("../utils/state");
+// ==================================================
+// HELPER FUNCTIONS
+// ==================================================
 /**
  * Helper: Tries to perform a touch tap.
  * If the current browser context does not support touch events (e.g., Desktop Chrome),
  * it gracefully falls back to a standard mouse click.
- *
  * @param target - The Playwright Locator to interact with.
  * @returns "tapped" or "clicked (fallback)" based on what occurred.
  */
 async function safeTap(target) {
     try {
-        // Try native touch tap
         await target.tap();
         return "tapped";
     }
     catch (error) {
         if (error.message.includes("does not support tap")) {
-            // Fallback for Desktop Contexts
             await target.click();
             return "clicked (fallback)";
         }
@@ -27,79 +33,59 @@ async function safeTap(target) {
     }
 }
 // ==================================================
-// 1. TOUCH INTERACTIONS
+// CORE FUNCTIONS
 // ==================================================
 /**
  * Taps on the currently stored (active) element.
  * Uses a "Hybrid Tap" strategy: tries to tap, falls back to click if touch is unsupported.
- *
- * ```gherkin
+ * @example
  * When I tap
- * ```
  */
-exports.TapStoredElement = (0, registry_1.Step)("I tap", async (page) => {
+async function tapStoredElement(page) {
     const element = (0, state_1.getActiveElement)(page);
     const action = await safeTap(element);
     console.log(`👆 ${action === "tapped" ? "Tapped" : "Clicked"} stored element`);
-});
+}
 /**
  * Finds an element by selector and taps it.
- * Uses a "Hybrid Tap" strategy.
- *
- * ```gherkin
+ * @example
  * When I tap element "#menu-toggle"
- * ```
- *
  * @param selector - The CSS selector of the element.
  */
-exports.TapElementBySelector = (0, registry_1.Step)("I tap element {string}", async (page, selector) => {
+async function tapElementBySelector(page, selector) {
     const element = page.locator(selector);
     const action = await safeTap(element);
     console.log(`👆 ${action === "tapped" ? "Tapped" : "Clicked"} element "${selector}"`);
-});
+}
 /**
  * Taps at specific X, Y coordinates on the screen.
- * Implemented via `mouse.click` which works reliably across both desktop and mobile viewports.
- *
- * ```gherkin
+ * @example
  * When I tap coordinates x:50 y:200
- * ```
- *
  * @param x - The X-coordinate.
  * @param y - The Y-coordinate.
  */
-exports.TapCoordinates = (0, registry_1.Step)("I tap coordinates x:{int} y:{int}", async (page, x, y) => {
-    // page.mouse.click works for both desktop and mobile viewports
+async function tapCoordinates(page, x, y) {
     await page.mouse.click(x, y);
     console.log(`👆 Tapped at (${x}, ${y})`);
-});
-// ==================================================
-// 2. VIEWPORT & EMULATION
-// ==================================================
+}
 /**
  * Resizes the browser window/viewport to specific dimensions.
- *
- * ```gherkin
+ * @example
  * When I resize window to width 375 and height 812
- * ```
- *
  * @param width - The width in pixels.
  * @param height - The height in pixels.
  */
-exports.ResizeWindow = (0, registry_1.Step)("I resize window to width {int} and height {int}", async (page, width, height) => {
+async function resizeWindow(page, width, height) {
     await page.setViewportSize({ width, height });
     console.log(`📱 Resized viewport to ${width}x${height}`);
-});
+}
 /**
  * Resizes the viewport to match a specific device preset.
- *
- * ```gherkin
+ * @example
  * When I simulate device "iPhone 12"
- * ```
- *
  * @param deviceName - The name of the device. Supported: "iPhone 12", "iPhone SE", "iPad", "Pixel 5", "Samsung Galaxy S8", "Desktop".
  */
-exports.SimulateDevice = (0, registry_1.Step)("I simulate device {string}", async (page, deviceName) => {
+async function simulateDevice(page, deviceName) {
     const devices = {
         "iPhone 12": { width: 390, height: 844 },
         "iPhone SE": { width: 375, height: 667 },
@@ -114,35 +100,36 @@ exports.SimulateDevice = (0, registry_1.Step)("I simulate device {string}", asyn
     }
     await page.setViewportSize(size);
     console.log(`📱 Simulated device "${deviceName}" (${size.width}x${size.height})`);
-});
-// ==================================================
-// 3. GEOLOCATION & PERMISSIONS
-// ==================================================
+}
 /**
  * Sets the geolocation coordinates for the browser context and auto-grants permission.
- *
- * ```gherkin
+ * @example
  * When I set geolocation to lat: 37.7749 long: -122.4194
- * ```
- *
  * @param lat - The latitude (float).
  * @param long - The longitude (float).
  */
-exports.SetGeolocation = (0, registry_1.Step)("I set geolocation to lat: {float} long: {float}", async (page, lat, long) => {
+async function setGeolocation(page, lat, long) {
     await page.context().setGeolocation({ latitude: lat, longitude: long });
     await page.context().grantPermissions(["geolocation"]);
     console.log(`🌍 Geolocation set to ${lat}, ${long}`);
-});
+}
 /**
  * Grants a specific browser permission to the current context.
- *
- * ```gherkin
+ * @example
  * When I grant permission "notifications"
- * ```
- *
  * @param permission - The permission name (e.g., "geolocation", "notifications", "camera").
  */
-exports.GrantPermission = (0, registry_1.Step)("I grant permission {string}", async (page, permission) => {
+async function grantPermission(page, permission) {
     await page.context().grantPermissions([permission]);
     console.log(`🛡️ Granted permission: "${permission}"`);
-});
+}
+// ==================================================
+// GLUE STEPS
+// ==================================================
+(0, registry_1.Step)("I tap", tapStoredElement);
+(0, registry_1.Step)("I tap element {string}", tapElementBySelector);
+(0, registry_1.Step)("I tap coordinates x:{int} y:{int}", tapCoordinates);
+(0, registry_1.Step)("I resize window to width {int} and height {int}", resizeWindow);
+(0, registry_1.Step)("I simulate device {string}", simulateDevice);
+(0, registry_1.Step)("I set geolocation to lat: {float} long: {float}", setGeolocation);
+(0, registry_1.Step)("I grant permission {string}", grantPermission);

package/dist/backend/actions/mouse.d.ts

@@ -1,80 +1,73 @@
 /**
  * Scrolls a specific element into the visible viewport.
  * Useful when an element is off-screen and needs to be visible before interaction.
- *
- * ```gherkin
+ * @example
  * When I scroll ".footer-section" into view
- * ```
- *
  * @param selector - The CSS selector of the element.
  */
-export declare const ScrollIntoView: void;
+export declare function scrollIntoView(page: any, selector: string): Promise<void>;
 /**
  * Scrolls the internal content of a specific element (overflow container) to X, Y coordinates.
- *
- * ```gherkin
+ * @example
  * When I scroll "#chat-box" to position x:0 y:500
- * ```
- *
  * @param selector - The CSS selector of the scrollable container.
  * @param x - The horizontal scroll position (pixels).
  * @param y - The vertical scroll position (pixels).
  */
-export declare const ScrollElementToPosition: void;
+export declare function scrollElementToPosition(page: any, selector: string, x: number, y: number): Promise<void>;
 /**
  * Scrolls the entire main browser window to specific X, Y coordinates immediately.
- *
- * ```gherkin
+ * @example
  * When I scroll to coordinates x:0 y:0
- * ```
- *
  * @param x - The absolute horizontal position.
  * @param y - The absolute vertical position.
  */
-export declare const ScrollWindowToCoordinates: void;
+export declare function scrollWindowToCoordinates(page: any, x: number, y: number): Promise<void>;
 /**
  * Scrolls the entire main browser window smoothly to specific coordinates.
- *
- * ```gherkin
+ * @example
  * When I scroll mouse window to position top:0 left:0
- * ```
- *
  * @param top - The vertical position (Y).
  * @param left - The horizontal position (X).
  */
-export declare const ScrollWindowSmoothly: void;
+export declare function scrollWindowSmoothly(page: any, top: number, left: number): Promise<void>;
 /**
  * Scrolls the window to a general direction edge (top, bottom, left, right).
  * Includes a short wait for smooth scrolling animation to complete.
- *
- * ```gherkin
+ * @example
  * When I scroll to "bottom"
- * ```
- *
  * @param direction - One of: "top", "bottom", "left", "right".
  */
-export declare const ScrollToDirection: void;
+export declare function scrollToDirection(page: any, direction: string): Promise<void>;
 /**
  * Simulates a mouse hover over an element.
- * **Important:** Sets the hovered element as the "Active Element" for subsequent steps.
- *
- * ```gherkin
+ * Sets the hovered element as the "Active Element" for subsequent steps.
+ * @example
  * When I hover over the element ".dropdown-toggle"
- * ```
- *
  * @param selector - The CSS selector to hover over.
  */
-export declare const HoverElement: void;
+export declare function hoverElement(page: any, selector: string): Promise<void>;
 /**
  * Moves the mouse cursor to specific absolute screen coordinates.
  * Useful for canvas interactions or testing mouse tracking.
- *
- * ```gherkin
+ * @example
  * When I move mouse to coordinates 100, 200
- * ```
- *
  * @param x - The X-coordinate.
  * @param y - The Y-coordinate.
  */
-export declare const MoveMouseToCoordinates: void;
+export declare function moveMouseToCoordinates(page: any, x: number, y: number): Promise<void>;
+/**
+ * Hovers over the Nth element containing the specified text.
+ * @example
+ * When I hover on 1st element "Profile"
+ * When I hover on 3rd element "Settings"
+ * | timeout | 2000 |
+ */
+export declare function hoverNthElementByText(page: any, indexStr: string, text: string, table?: any): Promise<void>;
+/**
+ * Hovers over the Nth element matching a CSS or XPath selector.
+ * @example
+ * When I hover on 1st selector ".user-avatar"
+ */
+export declare function hoverNthElementBySelector(page: any, indexStr: string, selector: string, table?: any): Promise<void>;
 //# sourceMappingURL=mouse.d.ts.map

package/dist/backend/actions/mouse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/mouse.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,MAIzB,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,MAYnC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,MAWrC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,MAehC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,MAgC5B,CAAC;AAMH;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,MAQvB,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,MAMlC,CAAC"}
+{"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/mouse.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/E;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,MAAM,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9F;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY9F;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCnF;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7E;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3F;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,GAAG,GACV,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,GAAG,GACV,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/backend/actions/mouse.js

@@ -1,71 +1,67 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MoveMouseToCoordinates = exports.HoverElement = exports.ScrollToDirection = exports.ScrollWindowSmoothly = exports.ScrollWindowToCoordinates = exports.ScrollElementToPosition = exports.ScrollIntoView = void 0;
+exports.scrollIntoView = scrollIntoView;
+exports.scrollElementToPosition = scrollElementToPosition;
+exports.scrollWindowToCoordinates = scrollWindowToCoordinates;
+exports.scrollWindowSmoothly = scrollWindowSmoothly;
+exports.scrollToDirection = scrollToDirection;
+exports.hoverElement = hoverElement;
+exports.moveMouseToCoordinates = moveMouseToCoordinates;
+exports.hoverNthElementByText = hoverNthElementByText;
+exports.hoverNthElementBySelector = hoverNthElementBySelector;
 const registry_1 = require("../../core/registry");
 const state_1 = require("../utils/state");
-// ===================================================================================
-// MOUSE ACTIONS: SCROLLING
-// ===================================================================================
+// ==================================================
+// CORE FUNCTIONS
+// ==================================================
 /**
  * Scrolls a specific element into the visible viewport.
  * Useful when an element is off-screen and needs to be visible before interaction.
- *
- * ```gherkin
+ * @example
  * When I scroll ".footer-section" into view
- * ```
- *
  * @param selector - The CSS selector of the element.
  */
-exports.ScrollIntoView = (0, registry_1.Step)("I scroll {string} into view", async (page, selector) => {
+async function scrollIntoView(page, selector) {
     const locator = page.locator(selector);
     await locator.scrollIntoViewIfNeeded();
     console.log(`🖱️ Scrolled element "${selector}" into view.`);
-});
+}
 /**
  * Scrolls the internal content of a specific element (overflow container) to X, Y coordinates.
- *
- * ```gherkin
+ * @example
  * When I scroll "#chat-box" to position x:0 y:500
- * ```
- *
  * @param selector - The CSS selector of the scrollable container.
  * @param x - The horizontal scroll position (pixels).
  * @param y - The vertical scroll position (pixels).
  */
-exports.ScrollElementToPosition = (0, registry_1.Step)("I scroll {string} to position x:{int} y:{int}", async (page, selector, x, y) => {
+async function scrollElementToPosition(page, selector, x, y) {
     const locator = page.locator(selector);
     await locator.evaluate((el, coords) => {
         el.scrollTo(coords.x, coords.y);
     }, { x, y });
     console.log(`🖱️ Scrolled element "${selector}" to position x:${x} y:${y}.`);
-});
+}
 /**
  * Scrolls the entire main browser window to specific X, Y coordinates immediately.
- *
- * ```gherkin
+ * @example
  * When I scroll to coordinates x:0 y:0
- * ```
- *
  * @param x - The absolute horizontal position.
  * @param y - The absolute vertical position.
  */
-exports.ScrollWindowToCoordinates = (0, registry_1.Step)("I scroll to coordinates x:{int} y:{int}", async (page, x, y) => {
+async function scrollWindowToCoordinates(page, x, y) {
     await page.evaluate((coords) => {
         window.scrollTo(coords.x, coords.y);
     }, { x, y });
     console.log(`🖱️ Scrolled window to coordinates x:${x} y:${y}.`);
-});
+}
 /**
  * Scrolls the entire main browser window smoothly to specific coordinates.
- *
- * ```gherkin
+ * @example
  * When I scroll mouse window to position top:0 left:0
- * ```
- *
  * @param top - The vertical position (Y).
  * @param left - The horizontal position (X).
  */
-exports.ScrollWindowSmoothly = (0, registry_1.Step)("I scroll mouse window to position top:{int} left:{int}", async (page, top, left) => {
+async function scrollWindowSmoothly(page, top, left) {
     await page.evaluate((coords) => {
         window.scrollTo({
             top: coords.top,
@@ -74,18 +70,15 @@ exports.ScrollWindowSmoothly = (0, registry_1.Step)("I scroll mouse window to po
         });
     }, { top, left });
     console.log(`🖱️ Scrolled window to position top:${top} left:${left} (smooth).`);
-});
+}
 /**
  * Scrolls the window to a general direction edge (top, bottom, left, right).
  * Includes a short wait for smooth scrolling animation to complete.
- *
- * ```gherkin
+ * @example
  * When I scroll to "bottom"
- * ```
- *
  * @param direction - One of: "top", "bottom", "left", "right".
  */
-exports.ScrollToDirection = (0, registry_1.Step)("I scroll to {string}", async (page, direction) => {
+async function scrollToDirection(page, direction) {
     const validDirections = ["top", "bottom", "left", "right"];
     const dir = direction.toLowerCase();
     if (!validDirections.includes(dir)) {
@@ -112,39 +105,71 @@ exports.ScrollToDirection = (0, registry_1.Step)("I scroll to {string}", async (
     console.log(`🖱️ Scrolled to "${dir}".`);
     // Wait a moment for smooth scroll to finish
     await page.waitForTimeout(500);
-});
-// ===================================================================================
-// MOUSE ACTIONS: HOVERING / MOVEMENT
-// ===================================================================================
+}
 /**
  * Simulates a mouse hover over an element.
- * **Important:** Sets the hovered element as the "Active Element" for subsequent steps.
- *
- * ```gherkin
+ * Sets the hovered element as the "Active Element" for subsequent steps.
+ * @example
  * When I hover over the element ".dropdown-toggle"
- * ```
- *
  * @param selector - The CSS selector to hover over.
  */
-exports.HoverElement = (0, registry_1.Step)("I hover over the element {string}", async (page, selector) => {
+async function hoverElement(page, selector) {
     const element = page.locator(selector);
     await element.hover();
-    // 🔥 Store the hovered element so we can click/assert on it immediately after
     (0, state_1.setActiveElement)(page, element);
     console.log(`🖱️ Hovered over: "${selector}".`);
-});
+}
 /**
  * Moves the mouse cursor to specific absolute screen coordinates.
  * Useful for canvas interactions or testing mouse tracking.
- *
- * ```gherkin
+ * @example
  * When I move mouse to coordinates 100, 200
- * ```
- *
  * @param x - The X-coordinate.
  * @param y - The Y-coordinate.
  */
-exports.MoveMouseToCoordinates = (0, registry_1.Step)("I move mouse to coordinates {int}, {int}", async (page, x, y) => {
+async function moveMouseToCoordinates(page, x, y) {
     await page.mouse.move(x, y);
     console.log(`🧭 Mouse moved to (${x}, ${y}).`);
-});
+}
+/**
+ * Hovers over the Nth element containing the specified text.
+ * @example
+ * When I hover on 1st element "Profile"
+ * When I hover on 3rd element "Settings"
+ * | timeout | 2000 |
+ */
+async function hoverNthElementByText(page, indexStr, text, table) {
+    const index = parseInt(indexStr, 10);
+    const options = (0, state_1.parseClickOptions)(table);
+    const locator = page.getByText(text, { exact: false }).nth(index - 1);
+    await locator.waitFor({ state: "visible", timeout: options.timeout || 5000 });
+    await locator.hover(options);
+    (0, state_1.setActiveElement)(page, locator);
+    console.log(`✨ Hovered over ${indexStr} element with text "${text}"`);
+}
+/**
+ * Hovers over the Nth element matching a CSS or XPath selector.
+ * @example
+ * When I hover on 1st selector ".user-avatar"
+ */
+async function hoverNthElementBySelector(page, indexStr, selector, table) {
+    const index = parseInt(indexStr, 10);
+    const options = (0, state_1.parseClickOptions)(table);
+    const locator = page.locator(selector).nth(index - 1);
+    await locator.waitFor({ state: "visible", timeout: options.timeout || 5000 });
+    await locator.hover(options);
+    (0, state_1.setActiveElement)(page, locator);
+    console.log(`✨ Hovered over ${indexStr} selector "${selector}"`);
+}
+// ==================================================
+// GLUE STEPS
+// ==================================================
+(0, registry_1.Step)("I scroll {string} into view", scrollIntoView);
+(0, registry_1.Step)("I scroll {string} to position x:{int} y:{int}", scrollElementToPosition);
+(0, registry_1.Step)("I scroll to coordinates x:{int} y:{int}", scrollWindowToCoordinates);
+(0, registry_1.Step)("I scroll mouse window to position top:{int} left:{int}", scrollWindowSmoothly);
+(0, registry_1.Step)("I scroll to {string}", scrollToDirection);
+(0, registry_1.Step)("I hover over the element {string}", hoverElement);
+(0, registry_1.Step)("I move mouse to coordinates {int}, {int}", moveMouseToCoordinates);
+(0, registry_1.Step)(/^I hover on (\d+)(?:st|nd|rd|th) element "([^"]+)"$/, hoverNthElementByText);
+(0, registry_1.Step)(/^I hover on (\d+)(?:st|nd|rd|th) selector "([^"]+)"$/, hoverNthElementBySelector);

package/dist/backend/actions/navigation.d.ts

@@ -1,49 +1,37 @@
 /**
  * Navigates the browser to a specific absolute URL.
- *
- * ```gherkin
- * Given I visit "[https://www.google.com](https://www.google.com)"
- * ```
- *
+ * @example
+ * Given I visit "https://www.google.com"
  * @param url - The full URL string (must include http/https).
  */
-export declare const VisitUrl: void;
+export declare function visitUrl(page: any, url: string): Promise<void>;
 /**
  * Reloads the current page (simulates hitting the Refresh button).
- *
- * ```gherkin
+ * @example
  * When I reload the page
- * ```
  */
-export declare const ReloadPage: void;
+export declare function reloadPage(page: any): Promise<void>;
 /**
  * Navigates back one step in the browser history.
  * Simulates clicking the browser's "Back" button.
- *
- * ```gherkin
+ * @example
  * When I go back
- * ```
  */
-export declare const GoBack: void;
+export declare function goBack(page: any): Promise<void>;
 /**
  * Navigates forward one step in the browser history.
  * Simulates clicking the browser's "Forward" button.
- *
- * ```gherkin
+ * @example
  * When I go forward
- * ```
  */
-export declare const GoForward: void;
+export declare function goForward(page: any): Promise<void>;
 /**
  * Navigates to a specific path.
  * If a `baseURL` is configured in your Playwright config, this is relative to it.
  * Otherwise, it treats the string as a direct URL.
- *
- * ```gherkin
+ * @example
  * When I navigate to "/dashboard/login"
- * ```
- *
  * @param path - The relative path or URL to navigate to.
  */
-export declare const NavigateToPath: void;
+export declare function navigateToPath(page: any, path: string): Promise<void>;
 //# sourceMappingURL=navigation.d.ts.map