playwright-cucumber-ts-steps 1.3.0 → 1.3.1

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

@@ -1,90 +1,174 @@
 /**
  * Clicks on the currently stored (active) element.
+ * @param page - The Playwright page object
+ * @param table - Optional table data for click options
  * @example When I click
  */
 export declare function clickStoredElement(page: any, table?: any): Promise<void>;
 /**
  * Clicks on an element matching the given CSS/XPath selector.
  * Supports fixtures for reusable selectors.
+ * @param page - The Playwright page object
+ * @param selectorKey - The selector key (can be a fixture key or raw CSS/XPath selector)
+ * @param table - Optional table data for click options
  * @example When I click on element ".my-element"
  *          When I click on element "login.submitButton"
  */
 export declare function clickElementBySelector(page: any, selectorKey: string, table?: any): Promise<void>;
 /**
  * Clicks on a button role element with the specified label.
+ * @param page - The Playwright page object
+ * @param label - The button label text
+ * @param table - Optional table data for click options
  * @example When I click on button "Submit"
  */
 export declare function clickButtonByLabel(page: any, label: string, table?: any): Promise<void>;
+/**
+ * Clicks on a button role element with the EXACT specified text.
+ * @example When I click on exact button text "Submit"
+ */
+export declare function clickButtonByExactText(page: any, exactText: string, table?: any): Promise<void>;
 /**
  * Clicks on a link role element with the specified text.
+ * @param page - The Playwright page object
+ * @param text - The link text
+ * @param table - Optional table data for click options
  * @example When I click on link "Home"
  */
 export declare function clickLinkByText(page: any, text: string, table?: any): Promise<void>;
 /**
  * Clicks on a form label element.
+ * @param page - The Playwright page object
+ * @param labelText - The label text
+ * @param table - Optional table data for click options
  * @example When I click on label "Email"
  */
 export declare function clickLabelByText(page: any, labelText: string, table?: any): Promise<void>;
 /**
  * Clicks on the first visible element containing the specified text (partial match).
+ * @param page - The Playwright page object
+ * @param rawText - The text to search for (can be a variable alias starting with @)
+ * @param table - Optional table data for click options
  * @example When I click on text "Login"
  */
 export declare function clickByText(page: any, rawText: string, table?: any): Promise<void>;
 /**
  * Clicks on an element containing the EXACT specified text.
+ * @param page - The Playwright page object
+ * @param exactText - The exact text to match
+ * @param table - Optional table data for click options
  * @example When I click on exact text "Submit"
  */
 export declare function clickByExactText(page: any, exactText: string, table?: any): Promise<void>;
 /**
  * Clicks on a selector provided via Regex match.
+ * @param page - The Playwright page object
+ * @param selector - The CSS selector string
  * @example When I click on selector "#btn-id"
  */
 export declare function clickByRegexSelector(page: any, selector: string): Promise<void>;
 /**
  * Iterates through ALL currently stored active elements and clicks them one by one.
+ * @param page - The Playwright page object
+ * @param table - Optional table data for click options
  * @example When I click all
  */
 export declare function clickAllStoredElements(page: any, table?: any): Promise<void>;
 /**
  * Double-clicks on the currently stored (active) element.
+ * @param page - The Playwright page object
+ * @param table - Optional table data for click options
  * @example When I double click
  */
 export declare function doubleClickStoredElement(page: any, table?: any): Promise<void>;
 /**
  * Double-clicks on the first element containing the specified text.
+ * @param page - The Playwright page object
+ * @param text - The text to search for
+ * @param table - Optional table data for click options
  * @example When I double click on text "Button"
  */
 export declare function doubleClickByText(page: any, text: string, table?: any): Promise<void>;
+/**
+ * Double-clicks on the first element containing the EXACT specified text.
+ * @example When I double click on exact text "Button"
+ */
+export declare function doubleClickByExactText(page: any, exactText: string, table?: any): Promise<void>;
 /**
  * Double-clicks at specific X, Y coordinates on the page.
+ * @param page - The Playwright page object
+ * @param x - The X coordinate
+ * @param y - The Y coordinate
+ * @param table - Optional table data for click options
  * @example When I double click position 100 200
  */
 export declare function doubleClickPosition(page: any, x: number, y: number, table?: any): Promise<void>;
 /**
  * Right-clicks (Context Click) on the currently stored element.
+ * @param page - The Playwright page object
+ * @param table - Optional table data for click options
  * @example When I right click
  */
 export declare function rightClickStoredElement(page: any, table?: any): Promise<void>;
 /**
  * Right-clicks on the first element containing the specified text.
+ * @param page - The Playwright page object
+ * @param text - The text to search for
+ * @param table - Optional table data for click options
  * @example When I right click on text "Menu"
  */
 export declare function rightClickByText(page: any, text: string, table?: any): Promise<void>;
 /**
  * Right-clicks at specific X, Y coordinates on the page.
+ * @param page - The Playwright page object
+ * @param x - The X coordinate
+ * @param y - The Y coordinate
+ * @param table - Optional table data for click options
  * @example When I right click position 100 200
  */
 export declare function rightClickPosition(page: any, x: number, y: number, table?: any): Promise<void>;
 /**
  * Clicks on the Nth element containing the specified text.
  * Handles 1st, 2nd, 3rd, 4th, etc.
+ * @param page - The Playwright page object
+ * @param indexStr - The index string (1st, 2nd, 3rd, etc.)
+ * @param text - The text to search for
+ * @param table - Optional table data for click options
  * @example When I click on 1st element "Login"
  *          When I click on 2nd element "Submit"
  */
 export declare function clickNthElementByText(page: any, indexStr: string, text: string, table?: any): Promise<void>;
 /**
  * Clicks on the Nth element matching a CSS or XPath selector.
+ * @param page - The Playwright page object
+ * @param indexStr - The index string (1st, 2nd, 3rd, etc.)
+ * @param selectorKey - The selector key (can be a fixture key or raw CSS/XPath selector)
+ * @param table - Optional table data for click options
  * @example When I click on 1st selector ".btn"
  */
 export declare function clickNthElementBySelector(page: any, indexStr: string, selectorKey: string, table?: any): Promise<void>;
+/**
+ * Clicks on a specific column in a specific row of a table.
+ * @param page - The Playwright page object
+ * @param columnIndex - The 1-based index of the column to click (1st, 2nd, 3rd, etc.)
+ * @param rowIndex - The selector key for the row (can be a fixture key or raw CSS selector)
+ * @param table - Optional table data for click options
+ * @example And I click on column 1 in row 1
+ * @example And I click on column 2 in row 3
+ * @example And I click on column 3 in row 2
+ * @example And I click on column 4 in row 5
+ */
+export declare function clickOnColumnInRow(page: any, columnIndex: number, rowIndex: number, table?: any): Promise<void>;
+/**
+ * Clicks on a specific column in a row identified by a selector.
+ * @param page - The Playwright page object
+ * @param columnIndex - The 1-based index of the column to click
+ * @param rowSelectorKey - The selector key for the row (can be a fixture key or raw CSS selector)
+ * @param table - Optional table data for click options
+ * @example When I click on 1st column in row "table#users tbody tr:first-child"
+ * @example When I click on 2nd column in row "tr.user-row"
+ * @example When I click on 3rd column in row ".data-table tbody tr:last-child"
+ * @example When I click on 4th column in row "tr[data-id='123']"
+ */
+export declare function clickOnNthColumnInRow(page: any, columnIndex: number, rowSelectorKey: string, table?: any): Promise<void>;
 //# sourceMappingURL=click.d.ts.map

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

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

package/dist/backend/actions/click.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.clickStoredElement = clickStoredElement;
 exports.clickElementBySelector = clickElementBySelector;
 exports.clickButtonByLabel = clickButtonByLabel;
+exports.clickButtonByExactText = clickButtonByExactText;
 exports.clickLinkByText = clickLinkByText;
 exports.clickLabelByText = clickLabelByText;
 exports.clickByText = clickByText;
@@ -11,12 +12,15 @@ exports.clickByRegexSelector = clickByRegexSelector;
 exports.clickAllStoredElements = clickAllStoredElements;
 exports.doubleClickStoredElement = doubleClickStoredElement;
 exports.doubleClickByText = doubleClickByText;
+exports.doubleClickByExactText = doubleClickByExactText;
 exports.doubleClickPosition = doubleClickPosition;
 exports.rightClickStoredElement = rightClickStoredElement;
 exports.rightClickByText = rightClickByText;
 exports.rightClickPosition = rightClickPosition;
 exports.clickNthElementByText = clickNthElementByText;
 exports.clickNthElementBySelector = clickNthElementBySelector;
+exports.clickOnColumnInRow = clickOnColumnInRow;
+exports.clickOnNthColumnInRow = clickOnNthColumnInRow;
 //src/backend/actions/click.ts
 const registry_1 = require("../../core/registry");
 const fixtures_1 = require("../utils/fixtures");
@@ -26,6 +30,8 @@ const state_1 = require("../utils/state");
 // ==================================================
 /**
  * Clicks on the currently stored (active) element.
+ * @param page - The Playwright page object
+ * @param table - Optional table data for click options
  * @example When I click
  */
 async function clickStoredElement(page, table) {
@@ -37,6 +43,9 @@ async function clickStoredElement(page, table) {
 /**
  * Clicks on an element matching the given CSS/XPath selector.
  * Supports fixtures for reusable selectors.
+ * @param page - The Playwright page object
+ * @param selectorKey - The selector key (can be a fixture key or raw CSS/XPath selector)
+ * @param table - Optional table data for click options
  * @example When I click on element ".my-element"
  *          When I click on element "login.submitButton"
  */
@@ -52,6 +61,9 @@ async function clickElementBySelector(page, selectorKey, table) {
 }
 /**
  * Clicks on a button role element with the specified label.
+ * @param page - The Playwright page object
+ * @param label - The button label text
+ * @param table - Optional table data for click options
  * @example When I click on button "Submit"
  */
 async function clickButtonByLabel(page, label, table) {
@@ -61,8 +73,22 @@ async function clickButtonByLabel(page, label, table) {
     (0, state_1.setActiveElement)(page, button);
     console.log(`🖱️ Clicked on button "${label}"`);
 }
+/**
+ * Clicks on a button role element with the EXACT specified text.
+ * @example When I click on exact button text "Submit"
+ */
+async function clickButtonByExactText(page, exactText, table) {
+    const options = (0, state_1.parseClickOptions)(table);
+    const button = page.getByRole("button", { name: exactText });
+    await button.click(options);
+    (0, state_1.setActiveElement)(page, button);
+    console.log(`🖱️ Clicked on exact button text "${exactText}"`);
+}
 /**
  * Clicks on a link role element with the specified text.
+ * @param page - The Playwright page object
+ * @param text - The link text
+ * @param table - Optional table data for click options
  * @example When I click on link "Home"
  */
 async function clickLinkByText(page, text, table) {
@@ -74,6 +100,9 @@ async function clickLinkByText(page, text, table) {
 }
 /**
  * Clicks on a form label element.
+ * @param page - The Playwright page object
+ * @param labelText - The label text
+ * @param table - Optional table data for click options
  * @example When I click on label "Email"
  */
 async function clickLabelByText(page, labelText, table) {
@@ -85,6 +114,9 @@ async function clickLabelByText(page, labelText, table) {
 }
 /**
  * Clicks on the first visible element containing the specified text (partial match).
+ * @param page - The Playwright page object
+ * @param rawText - The text to search for (can be a variable alias starting with @)
+ * @param table - Optional table data for click options
  * @example When I click on text "Login"
  */
 async function clickByText(page, rawText, table) {
@@ -107,6 +139,9 @@ async function clickByText(page, rawText, table) {
 }
 /**
  * Clicks on an element containing the EXACT specified text.
+ * @param page - The Playwright page object
+ * @param exactText - The exact text to match
+ * @param table - Optional table data for click options
  * @example When I click on exact text "Submit"
  */
 async function clickByExactText(page, exactText, table) {
@@ -119,6 +154,8 @@ async function clickByExactText(page, exactText, table) {
 }
 /**
  * Clicks on a selector provided via Regex match.
+ * @param page - The Playwright page object
+ * @param selector - The CSS selector string
  * @example When I click on selector "#btn-id"
  */
 async function clickByRegexSelector(page, selector) {
@@ -129,6 +166,8 @@ async function clickByRegexSelector(page, selector) {
 }
 /**
  * Iterates through ALL currently stored active elements and clicks them one by one.
+ * @param page - The Playwright page object
+ * @param table - Optional table data for click options
  * @example When I click all
  */
 async function clickAllStoredElements(page, table) {
@@ -147,6 +186,8 @@ async function clickAllStoredElements(page, table) {
 }
 /**
  * Double-clicks on the currently stored (active) element.
+ * @param page - The Playwright page object
+ * @param table - Optional table data for click options
  * @example When I double click
  */
 async function doubleClickStoredElement(page, table) {
@@ -157,6 +198,9 @@ async function doubleClickStoredElement(page, table) {
 }
 /**
  * Double-clicks on the first element containing the specified text.
+ * @param page - The Playwright page object
+ * @param text - The text to search for
+ * @param table - Optional table data for click options
  * @example When I double click on text "Button"
  */
 async function doubleClickByText(page, text, table) {
@@ -165,8 +209,22 @@ async function doubleClickByText(page, text, table) {
     await element.dblclick(options);
     console.log(`🖱️ Double-clicked on text "${text}"`);
 }
+/**
+ * Double-clicks on the first element containing the EXACT specified text.
+ * @example When I double click on exact text "Button"
+ */
+async function doubleClickByExactText(page, exactText, table) {
+    const options = (0, state_1.parseClickOptions)(table);
+    const element = page.getByText(exactText, { exact: true });
+    await element.dblclick(options);
+    console.log(`🖱️ Double-clicked on exact text "${exactText}"`);
+}
 /**
  * Double-clicks at specific X, Y coordinates on the page.
+ * @param page - The Playwright page object
+ * @param x - The X coordinate
+ * @param y - The Y coordinate
+ * @param table - Optional table data for click options
  * @example When I double click position 100 200
  */
 async function doubleClickPosition(page, x, y, table) {
@@ -176,6 +234,8 @@ async function doubleClickPosition(page, x, y, table) {
 }
 /**
  * Right-clicks (Context Click) on the currently stored element.
+ * @param page - The Playwright page object
+ * @param table - Optional table data for click options
  * @example When I right click
  */
 async function rightClickStoredElement(page, table) {
@@ -186,6 +246,9 @@ async function rightClickStoredElement(page, table) {
 }
 /**
  * Right-clicks on the first element containing the specified text.
+ * @param page - The Playwright page object
+ * @param text - The text to search for
+ * @param table - Optional table data for click options
  * @example When I right click on text "Menu"
  */
 async function rightClickByText(page, text, table) {
@@ -196,6 +259,10 @@ async function rightClickByText(page, text, table) {
 }
 /**
  * Right-clicks at specific X, Y coordinates on the page.
+ * @param page - The Playwright page object
+ * @param x - The X coordinate
+ * @param y - The Y coordinate
+ * @param table - Optional table data for click options
  * @example When I right click position 100 200
  */
 async function rightClickPosition(page, x, y, table) {
@@ -206,6 +273,10 @@ async function rightClickPosition(page, x, y, table) {
 /**
  * Clicks on the Nth element containing the specified text.
  * Handles 1st, 2nd, 3rd, 4th, etc.
+ * @param page - The Playwright page object
+ * @param indexStr - The index string (1st, 2nd, 3rd, etc.)
+ * @param text - The text to search for
+ * @param table - Optional table data for click options
  * @example When I click on 1st element "Login"
  *          When I click on 2nd element "Submit"
  */
@@ -221,6 +292,10 @@ async function clickNthElementByText(page, indexStr, text, table) {
 }
 /**
  * Clicks on the Nth element matching a CSS or XPath selector.
+ * @param page - The Playwright page object
+ * @param indexStr - The index string (1st, 2nd, 3rd, etc.)
+ * @param selectorKey - The selector key (can be a fixture key or raw CSS/XPath selector)
+ * @param table - Optional table data for click options
  * @example When I click on 1st selector ".btn"
  */
 async function clickNthElementBySelector(page, indexStr, selectorKey, table) {
@@ -235,12 +310,75 @@ async function clickNthElementBySelector(page, indexStr, selectorKey, table) {
     (0, state_1.setActiveElement)(page, locator);
     console.log(`🖱️ Clicked on ${indexStr} selector "${selector}"`);
 }
+/**
+ * Clicks on a specific column in a specific row of a table.
+ * @param page - The Playwright page object
+ * @param columnIndex - The 1-based index of the column to click (1st, 2nd, 3rd, etc.)
+ * @param rowIndex - The selector key for the row (can be a fixture key or raw CSS selector)
+ * @param table - Optional table data for click options
+ * @example And I click on column 1 in row 1
+ * @example And I click on column 2 in row 3
+ * @example And I click on column 3 in row 2
+ * @example And I click on column 4 in row 5
+ */
+async function clickOnColumnInRow(page, columnIndex, rowIndex, table) {
+    const options = (0, state_1.parseClickOptions)(table);
+    // Adjust for 0-based indexing
+    const adjustedRowIndex = rowIndex - 1;
+    const adjustedColumnIndex = columnIndex - 1;
+    // Assuming standard table structure: table > tbody > tr > td/th
+    const cellLocator = page.locator(`tbody tr:nth-child(${adjustedRowIndex + 1}) td:nth-child(${adjustedColumnIndex + 1}), tbody tr:nth-child(${adjustedRowIndex + 1}) th:nth-child(${adjustedColumnIndex + 1})`);
+    await cellLocator.waitFor({ state: "visible", timeout: options.timeout || 5000 });
+    await cellLocator.click(options);
+    (0, state_1.setActiveElement)(page, cellLocator);
+    console.log(`🖱️ Clicked on column ${columnIndex} in row ${rowIndex}`);
+}
+/**
+ * Clicks on a specific column in a row identified by a selector.
+ * @param page - The Playwright page object
+ * @param columnIndex - The 1-based index of the column to click
+ * @param rowSelectorKey - The selector key for the row (can be a fixture key or raw CSS selector)
+ * @param table - Optional table data for click options
+ * @example When I click on 1st column in row "table#users tbody tr:first-child"
+ * @example When I click on 2nd column in row "tr.user-row"
+ * @example When I click on 3rd column in row ".data-table tbody tr:last-child"
+ * @example When I click on 4th column in row "tr[data-id='123']"
+ */
+async function clickOnNthColumnInRow(page, columnIndex, rowSelectorKey, table) {
+    const options = (0, state_1.parseClickOptions)(table);
+    // Resolve selector from fixtures or use raw value
+    const selectors = (0, fixtures_1.loadFixture)("selectors.json");
+    const rowSelector = (0, fixtures_1.getFixtureValue)(selectors, rowSelectorKey);
+    // Adjust for 0-based indexing
+    const adjustedColumnIndex = columnIndex - 1;
+    // Find the specific row and then the nth column within that row
+    const rowLocator = page.locator(rowSelector);
+    const cellLocator = rowLocator.locator(`td:nth-child(${adjustedColumnIndex + 1}), th:nth-child(${adjustedColumnIndex + 1})`);
+    await cellLocator.waitFor({ state: "visible", timeout: options.timeout || 5000 });
+    await cellLocator.click(options);
+    (0, state_1.setActiveElement)(page, cellLocator);
+    console.log(`🖱️ Clicked on ${columnIndex}${getOrdinalSuffix(columnIndex)} column in row "${rowSelector}"`);
+}
+/**
+ * Helper function to get the ordinal suffix (st, nd, rd, th) for a number
+ */
+function getOrdinalSuffix(num) {
+    if (num > 3 && num < 21)
+        return 'th';
+    switch (num % 10) {
+        case 1: return 'st';
+        case 2: return 'nd';
+        case 3: return 'rd';
+        default: return 'th';
+    }
+}
 // ==================================================
 // GLUE STEPS
 // ==================================================
 (0, registry_1.Step)("I click", clickStoredElement, "When");
 (0, registry_1.Step)("I click on element {string}", clickElementBySelector, "When");
 (0, registry_1.Step)("I click on button {string}", clickButtonByLabel, "When");
+(0, registry_1.Step)("I click on exact button text {string}", clickButtonByExactText, "When");
 (0, registry_1.Step)("I click on link {string}", clickLinkByText, "When");
 (0, registry_1.Step)("I click on label {string}", clickLabelByText, "When");
 (0, registry_1.Step)("I click on text {string}", clickByText, "When");
@@ -249,9 +387,21 @@ async function clickNthElementBySelector(page, indexStr, selectorKey, table) {
 (0, registry_1.Step)("I click all", clickAllStoredElements, "When");
 (0, registry_1.Step)("I double click", doubleClickStoredElement, "When");
 (0, registry_1.Step)("I double click on text {string}", doubleClickByText, "When");
+(0, registry_1.Step)("I double click on exact text {string}", doubleClickByExactText, "When");
 (0, registry_1.Step)("I double click position {int} {int}", doubleClickPosition, "When");
 (0, registry_1.Step)("I right click", rightClickStoredElement, "When");
 (0, registry_1.Step)("I right click on text {string}", rightClickByText, "When");
 (0, registry_1.Step)("I right click position {int} {int}", rightClickPosition, "When");
-(0, registry_1.Step)("I click on {int}(?:st|nd|rd|th) element {string}", clickNthElementByText, "When");
-(0, registry_1.Step)("I click on {int}(?:st|nd|rd|th) selector {string}", clickNthElementBySelector, "When");
+(0, registry_1.Step)("I click on {int}st element {string}", clickNthElementByText, "When");
+(0, registry_1.Step)("I click on {int}nd element {string}", clickNthElementByText, "When");
+(0, registry_1.Step)("I click on {int}rd element {string}", clickNthElementByText, "When");
+(0, registry_1.Step)("I click on {int}th element {string}", clickNthElementByText, "When");
+(0, registry_1.Step)("I click on {int}st selector {string}", clickNthElementBySelector, "When");
+(0, registry_1.Step)("I click on {int}nd selector {string}", clickNthElementBySelector, "When");
+(0, registry_1.Step)("I click on {int}rd selector {string}", clickNthElementBySelector, "When");
+(0, registry_1.Step)("I click on {int}th selector {string}", clickNthElementBySelector, "When");
+(0, registry_1.Step)("I click on column {int} in row {int}", clickOnColumnInRow, "And");
+(0, registry_1.Step)("I click on {int}st column in row {string}", clickOnNthColumnInRow, "When");
+(0, registry_1.Step)("I click on {int}nd column in row {string}", clickOnNthColumnInRow, "When");
+(0, registry_1.Step)("I click on {int}rd column in row {string}", clickOnNthColumnInRow, "When");
+(0, registry_1.Step)("I click on {int}th column in row {string}", clickOnNthColumnInRow, "When");

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

@@ -16,4 +16,10 @@
  * @param table - The Data Table provided in the step definition.
  */
 export declare function fillFormData(page: any, formName: string, table: any): Promise<void>;
+/**
+ * Selects an option from a React select component.
+ * This handles React's custom select implementations that may not use standard <select> elements.
+ * @example When I select react option "Option 3" from "#react-select-id"
+ */
+export declare function selectReactOption(page: any, optionText: string, selectorKey: string): Promise<void>;
 //# sourceMappingURL=form.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/form.ts"],"names":[],"mappings":"AA4FA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAmIzF"}
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/form.ts"],"names":[],"mappings":"AA4FA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAmIzF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWzG"}

package/dist/backend/actions/form.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fillFormData = fillFormData;
+exports.selectReactOption = selectReactOption;
 //src/backend/actions/form.ts
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -222,7 +223,22 @@ async function fillFormData(page, formName, table) {
         console.log(`✍️ Filled ${target} with "${resolvedValue}"`);
     }
 }
+/**
+ * Selects an option from a React select component.
+ * This handles React's custom select implementations that may not use standard <select> elements.
+ * @example When I select react option "Option 3" from "#react-select-id"
+ */
+async function selectReactOption(page, optionText, selectorKey) {
+    const selectors = (0, fixtures_1.loadFixture)("selectors.json");
+    const selector = (0, fixtures_1.getFixtureValue)(selectors, selectorKey);
+    // Click the select dropdown to reveal options
+    await page.locator(selector).click();
+    // Wait for options to appear and then click the desired option
+    await page.locator(`text=${optionText}`).click();
+    console.log(`✅ Selected react option "${optionText}" from "${selector}"`);
+}
 // ==================================================
 // GLUE STEPS
 // ==================================================
 (0, registry_1.Step)("I fill the following {string} form data", fillFormData, "When");
+(0, registry_1.Step)("I select react option {string} from {string}", selectReactOption, "When");

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

@@ -7,6 +7,7 @@ export * from "./form";
 export * from "./mouse";
 export * from "./misc";
 export * from "./mobile";
+export * from "./visual";
 export * from "./waits";
 export * from "./frames";
 export * from "./keyboard";
@@ -19,6 +20,7 @@ import "./form";
 import "./mouse";
 import "./misc";
 import "./mobile";
+import "./visual";
 import "./waits";
 import "./frames";
 import "./keyboard";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAI3B,OAAO,cAAc,CAAC;AACtB,OAAO,gBAAgB,CAAC;AACxB,OAAO,aAAa,CAAC;AACrB,OAAO,SAAS,CAAC;AACjB,OAAO,UAAU,CAAC;AAClB,OAAO,QAAQ,CAAC;AAChB,OAAO,SAAS,CAAC;AACjB,OAAO,QAAQ,CAAC;AAChB,OAAO,UAAU,CAAC;AAClB,OAAO,SAAS,CAAC;AACjB,OAAO,UAAU,CAAC;AAClB,OAAO,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAI3B,OAAO,cAAc,CAAC;AACtB,OAAO,gBAAgB,CAAC;AACxB,OAAO,aAAa,CAAC;AACrB,OAAO,SAAS,CAAC;AACjB,OAAO,UAAU,CAAC;AAClB,OAAO,QAAQ,CAAC;AAChB,OAAO,SAAS,CAAC;AACjB,OAAO,QAAQ,CAAC;AAChB,OAAO,UAAU,CAAC;AAClB,OAAO,UAAU,CAAC;AAClB,OAAO,SAAS,CAAC;AACjB,OAAO,UAAU,CAAC;AAClB,OAAO,YAAY,CAAC"}

package/dist/backend/actions/index.js

@@ -24,6 +24,7 @@ __exportStar(require("./form"), exports);
 __exportStar(require("./mouse"), exports);
 __exportStar(require("./misc"), exports);
 __exportStar(require("./mobile"), exports);
+__exportStar(require("./visual"), exports);
 __exportStar(require("./waits"), exports);
 __exportStar(require("./frames"), exports);
 __exportStar(require("./keyboard"), exports);
@@ -37,6 +38,7 @@ require("./form");
 require("./mouse");
 require("./misc");
 require("./mobile");
+require("./visual");
 require("./waits");
 require("./frames");
 require("./keyboard");

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

@@ -30,10 +30,19 @@ export declare function fillElement(page: any, selectorKey: string, value: strin
  */
 export declare function pressKeyGlobal(page: any, key: string): Promise<void>;
 /**
- * Pauses the test execution for a fixed amount of time.
- * Avoid using this unless absolutely necessary; prefer dynamic waits instead.
- * @example When I wait for 5000 milliseconds
- * @param ms - The duration to wait in milliseconds.
+ * Drags one element and drops it onto another.
+ * Supports fixtures for reusable selectors.
+ * @example When I drag "droppable.draggable" to "droppable.dropZone"
+ * @param sourceKey - The selector of the element to drag.
+ * @param targetKey - The selector of the drop target element.
+ */
+export declare function dragElementTo(page: any, sourceKey: string, targetKey: string): Promise<void>;
+/**
+ * Continues a drag operation from a previously selected element to a target.
+ * This is meant to be used after selecting an element to drag.
+ * Supports fixtures for reusable selectors.
+ * @example And I drag to "droppable.dropZone"
+ * @param targetKey - The selector of the drop target element.
  */
-export declare function hardWait(page: any, ms: number): Promise<void>;
+export declare function dragToTarget(page: any, targetKey: string): Promise<void>;
 //# sourceMappingURL=interactions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/interactions.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhF;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9F;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1E;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnE"}
+{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/interactions.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhF;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9F;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1E;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOlG;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9E"}