playwright-cucumber-ts-steps 1.1.8 → 1.1.9

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

@@ -1,2 +1,75 @@
-export {};
+/**
+ * Taps on the currently stored (active) element.
+ * Uses a "Hybrid Tap" strategy: tries to tap, falls back to click if touch is unsupported.
+ *
+ * ```gherkin
+ * When I tap
+ * ```
+ */
+export declare const TapStoredElement: void;
+/**
+ * Finds an element by selector and taps it.
+ * Uses a "Hybrid Tap" strategy.
+ *
+ * ```gherkin
+ * When I tap element "#menu-toggle"
+ * ```
+ *
+ * @param selector - The CSS selector of the element.
+ */
+export declare const TapElementBySelector: void;
+/**
+ * Taps at specific X, Y coordinates on the screen.
+ * Implemented via `mouse.click` which works reliably across both desktop and mobile viewports.
+ *
+ * ```gherkin
+ * When I tap coordinates x:50 y:200
+ * ```
+ *
+ * @param x - The X-coordinate.
+ * @param y - The Y-coordinate.
+ */
+export declare const TapCoordinates: void;
+/**
+ * Resizes the browser window/viewport to specific dimensions.
+ *
+ * ```gherkin
+ * 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;
+/**
+ * Resizes the viewport to match a specific device preset.
+ *
+ * ```gherkin
+ * 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;
+/**
+ * Sets the geolocation coordinates for the browser context and auto-grants permission.
+ *
+ * ```gherkin
+ * 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;
+/**
+ * Grants a specific browser permission to the current context.
+ *
+ * ```gherkin
+ * When I grant permission "notifications"
+ * ```
+ *
+ * @param permission - The permission name (e.g., "geolocation", "notifications", "camera").
+ */
+export declare const GrantPermission: 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":""}
+{"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"}

package/dist/backend/actions/mobile.js

@@ -1,9 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrantPermission = exports.SetGeolocation = exports.SimulateDevice = exports.ResizeWindow = exports.TapCoordinates = exports.TapElementBySelector = exports.TapStoredElement = void 0;
 const registry_1 = require("../../core/registry");
 const state_1 = require("../utils/state");
 /**
- * Helper: Tries to tap. If the context doesn't support touch, falls back to click.
+ * 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 {
@@ -24,28 +30,45 @@ async function safeTap(target) {
 // 1. TOUCH INTERACTIONS
 // ==================================================
 /**
- * Taps on the currently stored element.
- * Pattern: When I tap
+ * Taps on the currently stored (active) element.
+ * Uses a "Hybrid Tap" strategy: tries to tap, falls back to click if touch is unsupported.
+ *
+ * ```gherkin
+ * When I tap
+ * ```
  */
-(0, registry_1.Step)("I tap", async (page) => {
+exports.TapStoredElement = (0, registry_1.Step)("I tap", async (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.
- * Pattern: When I tap element "#submit-btn"
+ * Uses a "Hybrid Tap" strategy.
+ *
+ * ```gherkin
+ * When I tap element "#menu-toggle"
+ * ```
+ *
+ * @param selector - The CSS selector of the element.
  */
-(0, registry_1.Step)("I tap element {string}", async (page, selector) => {
+exports.TapElementBySelector = (0, registry_1.Step)("I tap element {string}", async (page, selector) => {
     const element = page.locator(selector);
     const action = await safeTap(element);
     console.log(`👆 ${action === "tapped" ? "Tapped" : "Clicked"} element "${selector}"`);
 });
 /**
- * Taps at specific coordinates.
- * Pattern: When I tap coordinates x:100 y:200
+ * Taps at specific X, Y coordinates on the screen.
+ * Implemented via `mouse.click` which works reliably across both desktop and mobile viewports.
+ *
+ * ```gherkin
+ * When I tap coordinates x:50 y:200
+ * ```
+ *
+ * @param x - The X-coordinate.
+ * @param y - The Y-coordinate.
  */
-(0, registry_1.Step)("I tap coordinates x:{int} y:{int}", async (page, x, y) => {
+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
     await page.mouse.click(x, y);
     console.log(`👆 Tapped at (${x}, ${y})`);
@@ -53,11 +76,30 @@ async function safeTap(target) {
 // ==================================================
 // 2. VIEWPORT & EMULATION
 // ==================================================
-(0, registry_1.Step)("I resize window to width {int} and height {int}", async (page, width, height) => {
+/**
+ * Resizes the browser window/viewport to specific dimensions.
+ *
+ * ```gherkin
+ * 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) => {
     await page.setViewportSize({ width, height });
     console.log(`📱 Resized viewport to ${width}x${height}`);
 });
-(0, registry_1.Step)("I simulate device {string}", async (page, deviceName) => {
+/**
+ * Resizes the viewport to match a specific device preset.
+ *
+ * ```gherkin
+ * 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) => {
     const devices = {
         "iPhone 12": { width: 390, height: 844 },
         "iPhone SE": { width: 375, height: 667 },
@@ -76,12 +118,31 @@ async function safeTap(target) {
 // ==================================================
 // 3. GEOLOCATION & PERMISSIONS
 // ==================================================
-(0, registry_1.Step)("I set geolocation to lat: {float} long: {float}", async (page, lat, long) => {
+/**
+ * Sets the geolocation coordinates for the browser context and auto-grants permission.
+ *
+ * ```gherkin
+ * 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) => {
     await page.context().setGeolocation({ latitude: lat, longitude: long });
     await page.context().grantPermissions(["geolocation"]);
     console.log(`🌍 Geolocation set to ${lat}, ${long}`);
 });
-(0, registry_1.Step)("I grant permission {string}", async (page, permission) => {
+/**
+ * Grants a specific browser permission to the current context.
+ *
+ * ```gherkin
+ * 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) => {
     await page.context().grantPermissions([permission]);
     console.log(`🛡️ Granted permission: "${permission}"`);
 });

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

@@ -1,2 +1,80 @@
-export {};
+/**
+ * Scrolls a specific element into the visible viewport.
+ * Useful when an element is off-screen and needs to be visible before interaction.
+ *
+ * ```gherkin
+ * When I scroll ".footer-section" into view
+ * ```
+ *
+ * @param selector - The CSS selector of the element.
+ */
+export declare const ScrollIntoView: void;
+/**
+ * Scrolls the internal content of a specific element (overflow container) to X, Y coordinates.
+ *
+ * ```gherkin
+ * 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;
+/**
+ * Scrolls the entire main browser window to specific X, Y coordinates immediately.
+ *
+ * ```gherkin
+ * 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;
+/**
+ * Scrolls the entire main browser window smoothly to specific coordinates.
+ *
+ * ```gherkin
+ * 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;
+/**
+ * Scrolls the window to a general direction edge (top, bottom, left, right).
+ * Includes a short wait for smooth scrolling animation to complete.
+ *
+ * ```gherkin
+ * When I scroll to "bottom"
+ * ```
+ *
+ * @param direction - One of: "top", "bottom", "left", "right".
+ */
+export declare const ScrollToDirection: void;
+/**
+ * Simulates a mouse hover over an element.
+ * **Important:** Sets the hovered element as the "Active Element" for subsequent steps.
+ *
+ * ```gherkin
+ * When I hover over the element ".dropdown-toggle"
+ * ```
+ *
+ * @param selector - The CSS selector to hover over.
+ */
+export declare const HoverElement: void;
+/**
+ * Moves the mouse cursor to specific absolute screen coordinates.
+ * Useful for canvas interactions or testing mouse tracking.
+ *
+ * ```gherkin
+ * When I move mouse to coordinates 100, 200
+ * ```
+ *
+ * @param x - The X-coordinate.
+ * @param y - The Y-coordinate.
+ */
+export declare const MoveMouseToCoordinates: 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":""}
+{"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"}

package/dist/backend/actions/mouse.js

@@ -1,24 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoveMouseToCoordinates = exports.HoverElement = exports.ScrollToDirection = exports.ScrollWindowSmoothly = exports.ScrollWindowToCoordinates = exports.ScrollElementToPosition = exports.ScrollIntoView = void 0;
 const registry_1 = require("../../core/registry");
 const state_1 = require("../utils/state");
 // ===================================================================================
 // MOUSE ACTIONS: SCROLLING
 // ===================================================================================
 /**
- * Scrolls the element matching the selector into view.
- * Pattern: When I scroll ".footer" into view
+ * Scrolls a specific element into the visible viewport.
+ * Useful when an element is off-screen and needs to be visible before interaction.
+ *
+ * ```gherkin
+ * When I scroll ".footer-section" into view
+ * ```
+ *
+ * @param selector - The CSS selector of the element.
  */
-(0, registry_1.Step)("I scroll {string} into view", async (page, selector) => {
+exports.ScrollIntoView = (0, registry_1.Step)("I scroll {string} into view", async (page, selector) => {
     const locator = page.locator(selector);
     await locator.scrollIntoViewIfNeeded();
     console.log(`🖱️ Scrolled element "${selector}" into view.`);
 });
 /**
- * Scrolls a specific element to internal X, Y coordinates.
- * Pattern: When I scroll "#box" to position x:100 y:200
+ * Scrolls the internal content of a specific element (overflow container) to X, Y coordinates.
+ *
+ * ```gherkin
+ * 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).
  */
-(0, registry_1.Step)("I scroll {string} to position x:{int} y:{int}", async (page, selector, x, y) => {
+exports.ScrollElementToPosition = (0, registry_1.Step)("I scroll {string} to position x:{int} y:{int}", async (page, selector, x, y) => {
     const locator = page.locator(selector);
     await locator.evaluate((el, coords) => {
         el.scrollTo(coords.x, coords.y);
@@ -26,20 +40,32 @@ const state_1 = require("../utils/state");
     console.log(`🖱️ Scrolled element "${selector}" to position x:${x} y:${y}.`);
 });
 /**
- * Scrolls the entire window to specific coordinates.
- * Pattern: When I scroll to coordinates x:0 y:500
+ * Scrolls the entire main browser window to specific X, Y coordinates immediately.
+ *
+ * ```gherkin
+ * When I scroll to coordinates x:0 y:0
+ * ```
+ *
+ * @param x - The absolute horizontal position.
+ * @param y - The absolute vertical position.
  */
-(0, registry_1.Step)("I scroll to coordinates x:{int} y:{int}", async (page, x, y) => {
+exports.ScrollWindowToCoordinates = (0, registry_1.Step)("I scroll to coordinates x:{int} y:{int}", async (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 window smoothly to specific coordinates.
- * Pattern: When I scroll mouse window to position top:0 left:100
+ * Scrolls the entire main browser window smoothly to specific coordinates.
+ *
+ * ```gherkin
+ * When I scroll mouse window to position top:0 left:0
+ * ```
+ *
+ * @param top - The vertical position (Y).
+ * @param left - The horizontal position (X).
  */
-(0, registry_1.Step)("I scroll mouse window to position top:{int} left:{int}", async (page, top, left) => {
+exports.ScrollWindowSmoothly = (0, registry_1.Step)("I scroll mouse window to position top:{int} left:{int}", async (page, top, left) => {
     await page.evaluate((coords) => {
         window.scrollTo({
             top: coords.top,
@@ -50,10 +76,16 @@ const state_1 = require("../utils/state");
     console.log(`🖱️ Scrolled window to position top:${top} left:${left} (smooth).`);
 });
 /**
- * Scrolls to a general direction (top, bottom, left, right).
- * Pattern: When I scroll to "bottom"
+ * Scrolls the window to a general direction edge (top, bottom, left, right).
+ * Includes a short wait for smooth scrolling animation to complete.
+ *
+ * ```gherkin
+ * When I scroll to "bottom"
+ * ```
+ *
+ * @param direction - One of: "top", "bottom", "left", "right".
  */
-(0, registry_1.Step)("I scroll to {string}", async (page, direction) => {
+exports.ScrollToDirection = (0, registry_1.Step)("I scroll to {string}", async (page, direction) => {
     const validDirections = ["top", "bottom", "left", "right"];
     const dir = direction.toLowerCase();
     if (!validDirections.includes(dir)) {
@@ -85,10 +117,16 @@ const state_1 = require("../utils/state");
 // MOUSE ACTIONS: HOVERING / MOVEMENT
 // ===================================================================================
 /**
- * Hovers over an element and sets it as the active element.
- * Pattern: When I hover over the element ".menu-item"
+ * Simulates a mouse hover over an element.
+ * **Important:** Sets the hovered element as the "Active Element" for subsequent steps.
+ *
+ * ```gherkin
+ * When I hover over the element ".dropdown-toggle"
+ * ```
+ *
+ * @param selector - The CSS selector to hover over.
  */
-(0, registry_1.Step)("I hover over the element {string}", async (page, selector) => {
+exports.HoverElement = (0, registry_1.Step)("I hover over the element {string}", async (page, selector) => {
     const element = page.locator(selector);
     await element.hover();
     // 🔥 Store the hovered element so we can click/assert on it immediately after
@@ -96,10 +134,17 @@ const state_1 = require("../utils/state");
     console.log(`🖱️ Hovered over: "${selector}".`);
 });
 /**
- * Moves mouse to absolute coordinates.
- * Pattern: When I move mouse to coordinates 100, 200
+ * Moves the mouse cursor to specific absolute screen coordinates.
+ * Useful for canvas interactions or testing mouse tracking.
+ *
+ * ```gherkin
+ * When I move mouse to coordinates 100, 200
+ * ```
+ *
+ * @param x - The X-coordinate.
+ * @param y - The Y-coordinate.
  */
-(0, registry_1.Step)("I move mouse to coordinates {int}, {int}", async (page, x, y) => {
+exports.MoveMouseToCoordinates = (0, registry_1.Step)("I move mouse to coordinates {int}, {int}", async (page, x, y) => {
     await page.mouse.move(x, y);
     console.log(`🧭 Mouse moved to (${x}, ${y}).`);
 });

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

@@ -1,2 +1,49 @@
-export {};
+/**
+ * Navigates the browser to a specific absolute URL.
+ *
+ * ```gherkin
+ * Given I visit "[https://www.google.com](https://www.google.com)"
+ * ```
+ *
+ * @param url - The full URL string (must include http/https).
+ */
+export declare const VisitUrl: void;
+/**
+ * Reloads the current page (simulates hitting the Refresh button).
+ *
+ * ```gherkin
+ * When I reload the page
+ * ```
+ */
+export declare const ReloadPage: void;
+/**
+ * Navigates back one step in the browser history.
+ * Simulates clicking the browser's "Back" button.
+ *
+ * ```gherkin
+ * When I go back
+ * ```
+ */
+export declare const GoBack: void;
+/**
+ * Navigates forward one step in the browser history.
+ * Simulates clicking the browser's "Forward" button.
+ *
+ * ```gherkin
+ * When I go forward
+ * ```
+ */
+export declare const GoForward: 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
+ * When I navigate to "/dashboard/login"
+ * ```
+ *
+ * @param path - The relative path or URL to navigate to.
+ */
+export declare const NavigateToPath: void;
 //# sourceMappingURL=navigation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/navigation.ts"],"names":[],"mappings":""}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/navigation.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,MAGnB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,MAGrB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,MAGjB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,MAGpB,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,MAGzB,CAAC"}

package/dist/backend/actions/navigation.js

@@ -1,43 +1,70 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.NavigateToPath = exports.GoForward = exports.GoBack = exports.ReloadPage = exports.VisitUrl = void 0;
 const registry_1 = require("../../core/registry");
+// =============================
+// NAVIGATION STEPS
+// =============================
 /**
- * Visits a specific URL.
- * Pattern: Given I visit "https://google.com"
+ * Navigates the browser to a specific absolute URL.
+ *
+ * ```gherkin
+ * Given I visit "[https://www.google.com](https://www.google.com)"
+ * ```
+ *
+ * @param url - The full URL string (must include http/https).
  */
-(0, registry_1.Step)("I visit {string}", async (page, url) => {
+exports.VisitUrl = (0, registry_1.Step)("I visit {string}", async (page, url) => {
     await page.goto(url);
     console.log(`🌍 Visiting: ${url}`);
 });
 /**
- * Reloads the current page.
- * Pattern: When I reload the page
+ * Reloads the current page (simulates hitting the Refresh button).
+ *
+ * ```gherkin
+ * When I reload the page
+ * ```
  */
-(0, registry_1.Step)("I reload the page", async (page) => {
+exports.ReloadPage = (0, registry_1.Step)("I reload the page", async (page) => {
     await page.reload();
     console.log("🔄 Page reloaded");
 });
 /**
- * Navigates back in browser history.
- * Pattern: When I go back
+ * Navigates back one step in the browser history.
+ * Simulates clicking the browser's "Back" button.
+ *
+ * ```gherkin
+ * When I go back
+ * ```
  */
-(0, registry_1.Step)("I go back", async (page) => {
+exports.GoBack = (0, registry_1.Step)("I go back", async (page) => {
     await page.goBack();
     console.log("⬅️ Went back");
 });
 /**
- * Navigates forward in browser history.
- * Pattern: When I go forward
+ * Navigates forward one step in the browser history.
+ * Simulates clicking the browser's "Forward" button.
+ *
+ * ```gherkin
+ * When I go forward
+ * ```
  */
-(0, registry_1.Step)("I go forward", async (page) => {
+exports.GoForward = (0, registry_1.Step)("I go forward", async (page) => {
     await page.goForward();
     console.log("➡️ Went forward");
 });
 /**
- * Navigates to a specific path (relative to base URL if set).
- * Pattern: When I navigate to "/login"
+ * 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
+ * When I navigate to "/dashboard/login"
+ * ```
+ *
+ * @param path - The relative path or URL to navigate to.
  */
-(0, registry_1.Step)("I navigate to {string}", async (page, path) => {
+exports.NavigateToPath = (0, registry_1.Step)("I navigate to {string}", async (page, path) => {
     await page.goto(path);
     console.log(`🌍 Navigated to path: ${path}`);
 });

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

@@ -1,2 +1,56 @@
-export {};
+/**
+ * Waits for the network to reach an "idle" state.
+ * In Playwright terms, this means there are no new network connections for at least 500ms.
+ *
+ * ```gherkin
+ * When I wait for network idle
+ * ```
+ *
+ * @remarks
+ * **Warning:** This can be flaky on pages that have constant background polling (e.g., real-time chats, analytics).
+ * If the test times out here, consider using `I wait for element to be visible` instead.
+ */
+export declare const WaitForNetworkIdle: void;
+/**
+ * Waits for the page to reach a specific load lifecycle event.
+ *
+ * ```gherkin
+ * When I wait for load state "domcontentloaded"
+ * ```
+ *
+ * @param state - The state to wait for. Options:
+ * - `"load"`: Window load event fired.
+ * - `"domcontentloaded"`: DOM is ready (scripts might still be loading).
+ * - `"networkidle"`: No network connections for 500ms.
+ */
+export declare const WaitForLoadState: void;
+/**
+ * Explicitly waits for the currently stored (active) element to become visible.
+ * Useful for ensuring animations complete or modals appear before proceeding.
+ *
+ * ```gherkin
+ * When I wait for element to be visible
+ * ```
+ */
+export declare const WaitForElementVisible: void;
+/**
+ * Explicitly waits for the currently stored (active) element to become hidden or detached from the DOM.
+ * Useful for verifying that loading spinners have disappeared.
+ *
+ * ```gherkin
+ * When I wait for element to be hidden
+ * ```
+ */
+export declare const WaitForElementHidden: void;
+/**
+ * Waits until the page URL contains the specified substring (Regex match).
+ * Useful for verifying redirects (e.g., after login).
+ *
+ * ```gherkin
+ * When I wait for URL to contain "dashboard"
+ * ```
+ *
+ * @param urlPart - The substring to look for in the current URL.
+ */
+export declare const WaitForUrlContain: void;
 //# sourceMappingURL=waits.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"waits.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/waits.ts"],"names":[],"mappings":""}
+{"version":3,"file":"waits.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/waits.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,MAG7B,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,MAQ3B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,MAIhC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,MAI/B,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,MAM7B,CAAC"}