playwright-cucumber-ts-steps 0.1.7 → 1.0.1

package/lib/actions/mouseSteps.d.ts

@@ -1 +1,143 @@
-export {};
+import { CustomWorld } from "../helpers/world";
+/**
+ * Scrolls the element matching the given selector into view.
+ * This is useful for making sure an element is visible before interacting with it.
+ *
+ * ```gherkin
+ * When I scroll {string} into view
+ * ```
+ *
+ * @param selector - The CSS selector of the element to scroll into view.
+ *
+ * @example
+ * When I scroll ".footer-section" into view
+ *
+ * @remarks
+ * This step uses Playwright's `locator.scrollIntoViewIfNeeded()`.
+ * It will scroll the page or scrollable container as little as possible to bring
+ * the element into the viewport.
+ * @category Scrolling Steps
+ */
+export declare function When_I_scroll_element_into_view(this: CustomWorld, selector: string): Promise<void>;
+/**
+ * Scrolls the element matching the given selector to a specific X and Y position.
+ * The scrolling is relative to the element's own scrollable area.
+ *
+ * ```gherkin
+ * When I scroll {string} to position x:{int} y:{int}
+ * ```
+ *
+ * @param selector - The CSS selector of the element to scroll.
+ * @param x - The X-coordinate (horizontal) to scroll to within the element.
+ * @param y - The Y-coordinate (vertical) to scroll to within the element.
+ *
+ * @example
+ * When I scroll ".my-scrollable-div" to position x:100 y:200
+ *
+ * @remarks
+ * This step uses `locator.evaluate()` to execute `element.scrollTo()` directly
+ * in the browser context. This is typically used for scrolling within a specific
+ * scrollable HTML element, not the main window.
+ * @category Scrolling Steps
+ */
+export declare function When_I_scroll_element_to_position(this: CustomWorld, selector: string, x: number, // Changed to number as Cucumber's {int} already parses it
+y: number): Promise<void>;
+/**
+ * Scrolls the entire window to specific X and Y coordinates.
+ * The coordinates are absolute positions on the page.
+ *
+ * ```gherkin
+ * When I scroll to coordinates x:{int} y:{int}
+ * ```
+ *
+ * @param x - The X-coordinate (horizontal) to scroll the window to.
+ * @param y - The Y-coordinate (vertical) to scroll the window to.
+ *
+ * @example
+ * When I scroll to coordinates x:0 y:500
+ *
+ * @remarks
+ * This step uses `page.evaluate()` to execute `window.scrollTo()` directly
+ * in the browser context. This controls the main browser window's scroll position.
+ * @category Scrolling Steps
+ */
+export declare function When_I_scroll_to_coordinates(this: CustomWorld, x: number, // Changed to number
+y: number): Promise<void>;
+/**
+ * Scrolls the entire window to a specified top and left position with a smooth animation.
+ *
+ * ```gherkin
+ * When I scroll window to position top:{int} left:{int}
+ * ```
+ *
+ * @param top - The Y-coordinate (vertical) to scroll the window to.
+ * @param left - The X-coordinate (horizontal) to scroll the window to.
+ *
+ * @example
+ * When I scroll window to position top:0 left:100
+ *
+ * @remarks
+ * This step uses `page.evaluate()` to execute `window.scrollTo()` with a `behavior: "smooth"`
+ * option in the browser context, providing a native smooth scrolling experience.
+ * @category Scrolling Steps
+ */
+export declare function When_I_scroll_mouse_window_to_position(this: CustomWorld, top: number, // Changed to number
+left: number): Promise<void>;
+/**
+ * Scrolls the window to a predefined direction (top, bottom, left, or right) with smooth behavior.
+ *
+ * ```gherkin
+ * When I scroll to "{word}"
+ * ```
+ *
+ * @param direction - The direction to scroll to: "top", "bottom", "left", or "right".
+ *
+ * @example
+ * When I scroll to "bottom"
+ * When I scroll to "top"
+ *
+ * @remarks
+ * This step evaluates `window.scrollTo()` in the browser context, setting the `top`
+ * or `left` property based on the `direction`. It includes a short `waitForTimeout`
+ * to allow the smooth scroll animation to complete.
+ * @category Scrolling Steps
+ */
+export declare function When_I_scroll_to_direction(this: CustomWorld, direction: string): Promise<void>;
+/**
+ * Hovers the mouse cursor over the element matching the given selector.
+ *
+ * ```gherkin
+ * When I hover over the element {string}
+ * ```
+ *
+ * @param selector - The CSS selector of the element to hover over.
+ *
+ * @example
+ * When I hover over the element ".dropdown-menu-trigger"
+ * Then I should see element ".dropdown-content"
+ *
+ * @remarks
+ * This step simulates a mouse hover event. It also stores the hovered element
+ * in {@link CustomWorld.element | this.element} for potential subsequent actions.
+ * @category Mouse Interaction Steps
+ */
+export declare function When_I_hover_over_the_element(this: CustomWorld, selector: string): Promise<void>;
+/**
+ * Moves the mouse cursor to the given absolute X and Y coordinates on the page.
+ *
+ * ```gherkin
+ * When I move mouse to coordinates {int}, {int}
+ * ```
+ *
+ * @param x - The X-coordinate in pixels.
+ * @param y - The Y-coordinate in pixels.
+ *
+ * @example
+ * When I move mouse to coordinates 100, 200
+ *
+ * @remarks
+ * This step directly controls the mouse cursor position using Playwright's
+ * `page.mouse.move()`. This is a low-level mouse action.
+ * @category Mouse Interaction Steps
+ */
+export declare function When_I_move_mouse_to_coordinates(this: CustomWorld, x: number, y: number): Promise<void>;

package/lib/actions/mouseSteps.js

@@ -1,32 +1,155 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.When_I_scroll_element_into_view = When_I_scroll_element_into_view;
+exports.When_I_scroll_element_to_position = When_I_scroll_element_to_position;
+exports.When_I_scroll_to_coordinates = When_I_scroll_to_coordinates;
+exports.When_I_scroll_mouse_window_to_position = When_I_scroll_mouse_window_to_position;
+exports.When_I_scroll_to_direction = When_I_scroll_to_direction;
+exports.When_I_hover_over_the_element = When_I_hover_over_the_element;
+exports.When_I_move_mouse_to_coordinates = When_I_move_mouse_to_coordinates;
 // e2e/step_definitions/common/mouseSteps.ts
 const cucumber_1 = require("@cucumber/cucumber");
-// 🧭 SCROLLING
-//
-(0, cucumber_1.When)(/^I scroll "([^"]+)" into view$/, async function (selector) {
-    await this.page.locator(selector).scrollIntoViewIfNeeded();
-});
-(0, cucumber_1.When)(/^I scroll "([^"]+)" to position x:(\d+) y:(\d+)$/, async function (selector, x, y) {
-    await this.page.locator(selector).evaluate((el, x, y) => {
-        el.scrollTo(parseInt(x), parseInt(y));
-    }, x, y);
-});
-(0, cucumber_1.When)(/^I scroll to coordinates x:(\d+) y:(\d+)$/, async function (x, y) {
-    await this.page.evaluate((x, y) => {
-        window.scrollTo(parseInt(x), parseInt(y));
-    }, x, y);
-});
-(0, cucumber_1.When)(/^I scroll window to position top:(\d+) left:(\d+)$/, async function (top, left) {
-    await this.page.evaluate((top, left) => {
+// ===================================================================================
+// MOUSE ACTIONS: SCROLLING
+// ===================================================================================
+/**
+ * Scrolls the element matching the given selector into view.
+ * This is useful for making sure an element is visible before interacting with it.
+ *
+ * ```gherkin
+ * When I scroll {string} into view
+ * ```
+ *
+ * @param selector - The CSS selector of the element to scroll into view.
+ *
+ * @example
+ * When I scroll ".footer-section" into view
+ *
+ * @remarks
+ * This step uses Playwright's `locator.scrollIntoViewIfNeeded()`.
+ * It will scroll the page or scrollable container as little as possible to bring
+ * the element into the viewport.
+ * @category Scrolling Steps
+ */
+async function When_I_scroll_element_into_view(selector) {
+    const locator = this.getScope().locator(selector);
+    await locator.scrollIntoViewIfNeeded();
+    this.log?.(`🖱️ Scrolled element "${selector}" into view.`);
+}
+(0, cucumber_1.When)(/^I scroll "([^"]+)" into view$/, When_I_scroll_element_into_view);
+/**
+ * Scrolls the element matching the given selector to a specific X and Y position.
+ * The scrolling is relative to the element's own scrollable area.
+ *
+ * ```gherkin
+ * When I scroll {string} to position x:{int} y:{int}
+ * ```
+ *
+ * @param selector - The CSS selector of the element to scroll.
+ * @param x - The X-coordinate (horizontal) to scroll to within the element.
+ * @param y - The Y-coordinate (vertical) to scroll to within the element.
+ *
+ * @example
+ * When I scroll ".my-scrollable-div" to position x:100 y:200
+ *
+ * @remarks
+ * This step uses `locator.evaluate()` to execute `element.scrollTo()` directly
+ * in the browser context. This is typically used for scrolling within a specific
+ * scrollable HTML element, not the main window.
+ * @category Scrolling Steps
+ */
+async function When_I_scroll_element_to_position(selector, x, // Changed to number as Cucumber's {int} already parses it
+y // Changed to number
+) {
+    const locator = this.getScope().locator(selector);
+    await locator.evaluate((el, coords) => {
+        el.scrollTo(coords.x, coords.y);
+    }, { x, y } // Pass coordinates as an object
+    );
+    this.log?.(`🖱️ Scrolled element "${selector}" to position x:${x} y:${y}.`);
+}
+(0, cucumber_1.When)(/^I scroll "([^"]+)" to position x:(\d+) y:(\d+)$/, When_I_scroll_element_to_position);
+/**
+ * Scrolls the entire window to specific X and Y coordinates.
+ * The coordinates are absolute positions on the page.
+ *
+ * ```gherkin
+ * When I scroll to coordinates x:{int} y:{int}
+ * ```
+ *
+ * @param x - The X-coordinate (horizontal) to scroll the window to.
+ * @param y - The Y-coordinate (vertical) to scroll the window to.
+ *
+ * @example
+ * When I scroll to coordinates x:0 y:500
+ *
+ * @remarks
+ * This step uses `page.evaluate()` to execute `window.scrollTo()` directly
+ * in the browser context. This controls the main browser window's scroll position.
+ * @category Scrolling Steps
+ */
+async function When_I_scroll_to_coordinates(x, // Changed to number
+y // Changed to number
+) {
+    await this.page.evaluate((coords) => {
+        window.scrollTo(coords.x, coords.y);
+    }, { x, y } // Pass coordinates as an object
+    );
+    this.log?.(`🖱️ Scrolled window to coordinates x:${x} y:${y}.`);
+}
+(0, cucumber_1.When)(/^I scroll to coordinates x:(\d+) y:(\d+)$/, When_I_scroll_to_coordinates);
+/**
+ * Scrolls the entire window to a specified top and left position with a smooth animation.
+ *
+ * ```gherkin
+ * When I scroll window to position top:{int} left:{int}
+ * ```
+ *
+ * @param top - The Y-coordinate (vertical) to scroll the window to.
+ * @param left - The X-coordinate (horizontal) to scroll the window to.
+ *
+ * @example
+ * When I scroll window to position top:0 left:100
+ *
+ * @remarks
+ * This step uses `page.evaluate()` to execute `window.scrollTo()` with a `behavior: "smooth"`
+ * option in the browser context, providing a native smooth scrolling experience.
+ * @category Scrolling Steps
+ */
+async function When_I_scroll_mouse_window_to_position(top, // Changed to number
+left // Changed to number
+) {
+    await this.page.evaluate((coords) => {
         window.scrollTo({
-            top: parseInt(top),
-            left: parseInt(left),
+            top: coords.top,
+            left: coords.left,
             behavior: "smooth",
         });
-    }, top, left);
-});
-(0, cucumber_1.When)('I scroll to "{word}"', async function (direction) {
+    }, { top, left } // Pass coordinates as an object
+    );
+    this.log?.(`🖱️ Scrolled window to position top:${top} left:${left} (smooth).`);
+}
+(0, cucumber_1.When)(/^I scroll mouse window to position top:(\d+) left:(\d+)$/, When_I_scroll_mouse_window_to_position);
+/**
+ * Scrolls the window to a predefined direction (top, bottom, left, or right) with smooth behavior.
+ *
+ * ```gherkin
+ * When I scroll to "{word}"
+ * ```
+ *
+ * @param direction - The direction to scroll to: "top", "bottom", "left", or "right".
+ *
+ * @example
+ * When I scroll to "bottom"
+ * When I scroll to "top"
+ *
+ * @remarks
+ * This step evaluates `window.scrollTo()` in the browser context, setting the `top`
+ * or `left` property based on the `direction`. It includes a short `waitForTimeout`
+ * to allow the smooth scroll animation to complete.
+ * @category Scrolling Steps
+ */
+async function When_I_scroll_to_direction(direction) {
     const validDirections = ["top", "bottom", "left", "right"];
     if (!validDirections.includes(direction)) {
         throw new Error(`Invalid scroll direction "${direction}". Must be one of: ${validDirections.join(", ")}.`);
@@ -40,27 +163,72 @@ const cucumber_1 = require("@cucumber/cucumber");
                 scrollOptions.top = 0;
                 break;
             case "bottom":
+                // Scroll to the bottom of the body's scroll height
                 scrollOptions.top = document.body.scrollHeight;
                 break;
             case "left":
                 scrollOptions.left = 0;
                 break;
             case "right":
+                // Scroll to the rightmost edge of the body's scroll width
                 scrollOptions.left = document.body.scrollWidth;
                 break;
         }
         window.scrollTo(scrollOptions);
     }, direction);
-    this.log?.(`🖱️ Scrolled to "${direction}"`);
-    await this.page.waitForTimeout(500); // allow scroll to complete
-});
-(0, cucumber_1.When)("I hover over the element {string}", async function (selector) {
+    this.log?.(`🖱️ Scrolled to "${direction}".`);
+    // Allow a brief moment for the smooth scroll animation to complete
+    await this.page.waitForTimeout(500);
+}
+(0, cucumber_1.When)('I scroll to "{word}"', When_I_scroll_to_direction);
+// ===================================================================================
+// MOUSE ACTIONS: HOVERING / MOVEMENT
+// ===================================================================================
+/**
+ * Hovers the mouse cursor over the element matching the given selector.
+ *
+ * ```gherkin
+ * When I hover over the element {string}
+ * ```
+ *
+ * @param selector - The CSS selector of the element to hover over.
+ *
+ * @example
+ * When I hover over the element ".dropdown-menu-trigger"
+ * Then I should see element ".dropdown-content"
+ *
+ * @remarks
+ * This step simulates a mouse hover event. It also stores the hovered element
+ * in {@link CustomWorld.element | this.element} for potential subsequent actions.
+ * @category Mouse Interaction Steps
+ */
+async function When_I_hover_over_the_element(selector) {
     const element = this.getScope().locator(selector);
     await element.hover();
-    this.element = element;
-    this.log?.(`🖱️ Hovered: ${selector}`);
-});
-(0, cucumber_1.When)("I move mouse to coordinates {int}, {int}", async function (x, y) {
+    this.element = element; // Store the hovered element as the current element
+    this.log?.(`🖱️ Hovered over: "${selector}".`);
+}
+(0, cucumber_1.When)("I hover over the element {string}", When_I_hover_over_the_element);
+/**
+ * Moves the mouse cursor to the given absolute X and Y coordinates on the page.
+ *
+ * ```gherkin
+ * When I move mouse to coordinates {int}, {int}
+ * ```
+ *
+ * @param x - The X-coordinate in pixels.
+ * @param y - The Y-coordinate in pixels.
+ *
+ * @example
+ * When I move mouse to coordinates 100, 200
+ *
+ * @remarks
+ * This step directly controls the mouse cursor position using Playwright's
+ * `page.mouse.move()`. This is a low-level mouse action.
+ * @category Mouse Interaction Steps
+ */
+async function When_I_move_mouse_to_coordinates(x, y) {
     await this.page.mouse.move(x, y);
-    this.log?.(`🧭 Mouse moved to (${x}, ${y})`);
-});
+    this.log?.(`🧭 Mouse moved to (${x}, ${y}).`);
+}
+(0, cucumber_1.When)("I move mouse to coordinates {int}, {int}", When_I_move_mouse_to_coordinates);

package/lib/actions/scrollSteps.d.ts

@@ -1 +1,82 @@
-export {};
+import { CustomWorld } from "../helpers/world";
+/**
+ * Scrolls the previously selected element into the viewport if it's not already visible.
+ *
+ * ```gherkin
+ * When I scroll into view
+ * ```
+ *
+ * @example
+ * When I find element by selector ".my-long-content-element"
+ * And I scroll into view
+ *
+ * @remarks
+ * This step requires a preceding step that sets the {@link CustomWorld.element | current element}
+ * (e.g., "When I find element by selector"). It uses Playwright's `locator.scrollIntoViewIfNeeded()`,
+ * which scrolls the least amount necessary to make the element visible.
+ * @category Scrolling Steps
+ */
+export declare function When_I_scroll_into_view(this: CustomWorld): Promise<void>;
+/**
+ * Scrolls the main browser window to the given X (horizontal) and Y (vertical) pixel coordinates.
+ *
+ * ```gherkin
+ * When I scroll to position {int} {int}
+ * ```
+ *
+ * @param x - The X-coordinate in pixels to scroll to.
+ * @param y - The Y-coordinate in pixels to scroll to.
+ *
+ * @example
+ * When I scroll to position 0 500
+ *
+ * @remarks
+ * This step directly executes `window.scrollTo(x, y)` in the browser's context.
+ * It sets the absolute scroll position of the main document.
+ * This is similar to `When I scroll window to position {int} {int}` and `When I scroll window to x {int} and y {int}`.
+ * Consider consolidating if their functionality is identical.
+ * @category Scrolling Steps
+ */
+export declare function When_I_scroll_to_position(this: CustomWorld, x: number, y: number): Promise<void>;
+/**
+ * Scrolls the main browser window to the given X (horizontal) and Y (vertical) pixel coordinates.
+ * This step is an alias for "When I scroll to position {int} {int}".
+ *
+ * ```gherkin
+ * When I scroll window to position {int} {int}
+ * ```
+ *
+ * @param x - The X-coordinate in pixels to scroll to.
+ * @param y - The Y-coordinate in pixels to scroll to.
+ *
+ * @example
+ * When I scroll window to position 0 500
+ *
+ * @remarks
+ * This step is functionally identical to {@link When_I_scroll_to_position | "When I scroll to position {int} {int}"}.
+ * It executes `window.scrollTo(x, y)` in the browser's context.
+ * @category Scrolling Steps
+ */
+export declare function When_I_scroll_window_to_position(this: CustomWorld, x: number, y: number): Promise<void>;
+/**
+ * Scrolls the main browser window to the given X (horizontal) and Y (vertical) pixel coordinates.
+ * This step is another alias for "When I scroll to position {int} {int}".
+ *
+ * ```gherkin
+ * When I scroll window to x {int} and y {int}
+ * ```
+ *
+ * @param x - The X-coordinate in pixels to scroll to.
+ * @param y - The Y-coordinate in pixels to scroll to.
+ *
+ * @example
+ * When I scroll window to x 0 and y 500
+ *
+ * @remarks
+ * This step is functionally identical to {@link When_I_scroll_to_position | "When I scroll to position {int} {int}"}
+ * and {@link When_I_scroll_window_to_position | "When I scroll window to position {int} {int}"}.
+ * It executes `window.scrollTo(x, y)` in the browser's context.
+ * It's recommended to choose one consistent step pattern for window scrolling.
+ * @category Scrolling Steps
+ */
+export declare function When_I_scroll_window_to_x_and_y(this: CustomWorld, x: number, y: number): Promise<void>;

package/lib/actions/scrollSteps.js

@@ -1,23 +1,123 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.When_I_scroll_into_view = When_I_scroll_into_view;
+exports.When_I_scroll_to_position = When_I_scroll_to_position;
+exports.When_I_scroll_window_to_position = When_I_scroll_window_to_position;
+exports.When_I_scroll_window_to_x_and_y = When_I_scroll_window_to_x_and_y;
 // e2e/step_definitions/common/scrollSteps.ts
 const cucumber_1 = require("@cucumber/cucumber");
-(0, cucumber_1.When)("I scroll into view", async function () {
+// ===================================================================================
+// SCROLLING ACTIONS
+// ===================================================================================
+/**
+ * Scrolls the previously selected element into the viewport if it's not already visible.
+ *
+ * ```gherkin
+ * When I scroll into view
+ * ```
+ *
+ * @example
+ * When I find element by selector ".my-long-content-element"
+ * And I scroll into view
+ *
+ * @remarks
+ * This step requires a preceding step that sets the {@link CustomWorld.element | current element}
+ * (e.g., "When I find element by selector"). It uses Playwright's `locator.scrollIntoViewIfNeeded()`,
+ * which scrolls the least amount necessary to make the element visible.
+ * @category Scrolling Steps
+ */
+async function When_I_scroll_into_view() {
     const element = this.element;
     if (!element)
-        throw new Error("No element selected");
+        throw new Error("No element selected. Use a 'find element' step before this.");
     await element.scrollIntoViewIfNeeded();
-    this.log("Scrolled selected element into view");
-});
-(0, cucumber_1.When)("I scroll to position {int} {int}", async function (x, y) {
-    await this.page.evaluate(([x, y]) => window.scrollTo(x, y), [x, y]);
-    this.log(`Scrolled window to position: ${x}, ${y}`);
-});
-(0, cucumber_1.When)("I scroll window to position {int} {int}", async function (x, y) {
-    await this.page.evaluate(([x, y]) => window.scrollTo(x, y), [x, y]);
-    this.log(`Window scrolled to: ${x}, ${y}`);
-});
-(0, cucumber_1.When)("I scroll window to x {int} and y {int}", async function (x, y) {
-    await this.page.evaluate(([x, y]) => window.scrollTo(x, y), [x, y]);
-    this.log(`Window scrolled to coordinates: (${x}, ${y})`);
-});
+    this.log?.("Scrolled selected element into view."); // Using optional chaining for log
+}
+(0, cucumber_1.When)("I scroll into view", When_I_scroll_into_view);
+/**
+ * Scrolls the main browser window to the given X (horizontal) and Y (vertical) pixel coordinates.
+ *
+ * ```gherkin
+ * When I scroll to position {int} {int}
+ * ```
+ *
+ * @param x - The X-coordinate in pixels to scroll to.
+ * @param y - The Y-coordinate in pixels to scroll to.
+ *
+ * @example
+ * When I scroll to position 0 500
+ *
+ * @remarks
+ * This step directly executes `window.scrollTo(x, y)` in the browser's context.
+ * It sets the absolute scroll position of the main document.
+ * This is similar to `When I scroll window to position {int} {int}` and `When I scroll window to x {int} and y {int}`.
+ * Consider consolidating if their functionality is identical.
+ * @category Scrolling Steps
+ */
+async function When_I_scroll_to_position(x, y) {
+    // FIX: Pass arguments as an object instead of an array
+    await this.page.evaluate(({ xCoord, yCoord }) => window.scrollTo(xCoord, yCoord), {
+        xCoord: x,
+        yCoord: y,
+    });
+    this.log?.(`Scrolled window to position: ${x}, ${y}.`);
+}
+(0, cucumber_1.When)("I scroll to position {int} {int}", When_I_scroll_to_position);
+/**
+ * Scrolls the main browser window to the given X (horizontal) and Y (vertical) pixel coordinates.
+ * This step is an alias for "When I scroll to position {int} {int}".
+ *
+ * ```gherkin
+ * When I scroll window to position {int} {int}
+ * ```
+ *
+ * @param x - The X-coordinate in pixels to scroll to.
+ * @param y - The Y-coordinate in pixels to scroll to.
+ *
+ * @example
+ * When I scroll window to position 0 500
+ *
+ * @remarks
+ * This step is functionally identical to {@link When_I_scroll_to_position | "When I scroll to position {int} {int}"}.
+ * It executes `window.scrollTo(x, y)` in the browser's context.
+ * @category Scrolling Steps
+ */
+async function When_I_scroll_window_to_position(x, y) {
+    // FIX: Pass arguments as an object instead of an array
+    await this.page.evaluate(({ xCoord, yCoord }) => window.scrollTo(xCoord, yCoord), {
+        xCoord: x,
+        yCoord: y,
+    });
+    this.log?.(`Window scrolled to: ${x}, ${y}.`);
+}
+(0, cucumber_1.When)("I scroll window to position {int} {int}", When_I_scroll_window_to_position);
+/**
+ * Scrolls the main browser window to the given X (horizontal) and Y (vertical) pixel coordinates.
+ * This step is another alias for "When I scroll to position {int} {int}".
+ *
+ * ```gherkin
+ * When I scroll window to x {int} and y {int}
+ * ```
+ *
+ * @param x - The X-coordinate in pixels to scroll to.
+ * @param y - The Y-coordinate in pixels to scroll to.
+ *
+ * @example
+ * When I scroll window to x 0 and y 500
+ *
+ * @remarks
+ * This step is functionally identical to {@link When_I_scroll_to_position | "When I scroll to position {int} {int}"}
+ * and {@link When_I_scroll_window_to_position | "When I scroll window to position {int} {int}"}.
+ * It executes `window.scrollTo(x, y)` in the browser's context.
+ * It's recommended to choose one consistent step pattern for window scrolling.
+ * @category Scrolling Steps
+ */
+async function When_I_scroll_window_to_x_and_y(x, y) {
+    // FIX: Pass arguments as an object instead of an array
+    await this.page.evaluate(({ xCoord, yCoord }) => window.scrollTo(xCoord, yCoord), {
+        xCoord: x,
+        yCoord: y,
+    });
+    this.log?.(`Window scrolled to coordinates: (${x}, ${y}).`);
+}
+(0, cucumber_1.When)("I scroll window to x {int} and y {int}", When_I_scroll_window_to_x_and_y);