playwright-cucumber-ts-steps 1.1.7 → 1.1.9

package/dist/backend/db/steps.d.ts

@@ -1,2 +1,36 @@
-export {};
+/**
+ * @module DatabaseSteps
+ */
+/**
+ * Executes a raw SQL query against the configured database.
+ * The results are stored in the internal `dbState` for subsequent assertions.
+ * * @example
+ * ```gherkin
+ * When I run the database query "SELECT * FROM users WHERE email = 'test@example.com'"
+ * ```
+ * * @param query - The SQL query string to execute.
+ */
+export declare const RunDbQuery: void;
+/**
+ * Asserts that the last executed database query returned a specific number of records.
+ * * @example
+ * ```gherkin
+ * Then I expect the database to return 1 record
+ * ```
+ * * @param count - The expected number of rows in the result set.
+ */
+export declare const ExpectDbRecordCount: void;
+/**
+ * Asserts that the first record of the last database result set contains specific column values.
+ * Performs a loose equality check (converts values to strings) to handle type mismatches.
+ * * @example
+ * ```gherkin
+ * Then I expect the first database record to contain
+ * | username | admin             |
+ * | is_active| 1                 |
+ * | role     | superuser         |
+ * ```
+ * * @param tableData - A Gherkin Data Table containing column names (keys) and expected values.
+ */
+export declare const ExpectFirstDbRecordToContain: void;
 //# sourceMappingURL=steps.d.ts.map

package/dist/backend/db/steps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../src/backend/db/steps.ts"],"names":[],"mappings":""}
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../src/backend/db/steps.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,MAGrB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,MAW/B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,MAgCxC,CAAC"}

package/dist/backend/db/steps.js

@@ -1,43 +1,76 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpectFirstDbRecordToContain = exports.ExpectDbRecordCount = exports.RunDbQuery = void 0;
+const test_1 = require("@playwright/test");
 const registry_1 = require("../../core/registry");
 const state_1 = require("./state");
-const test_1 = require("@playwright/test");
-// 1. Run Query
-(0, registry_1.Step)("I run the database query {string}", async (page, query) => {
+/**
+ * @module DatabaseSteps
+ */
+/**
+ * Executes a raw SQL query against the configured database.
+ * The results are stored in the internal `dbState` for subsequent assertions.
+ * * @example
+ * ```gherkin
+ * When I run the database query "SELECT * FROM users WHERE email = 'test@example.com'"
+ * ```
+ * * @param query - The SQL query string to execute.
+ */
+exports.RunDbQuery = (0, registry_1.Step)("I run the database query {string}", async (page, query) => {
     await state_1.dbState.executeQuery(query);
+    console.log(`🗄️ Executed DB Query: ${query}`);
 });
-// 2. Count Check
-(0, registry_1.Step)("I expect the database to return {int} record(s)", async (page, count) => {
+/**
+ * Asserts that the last executed database query returned a specific number of records.
+ * * @example
+ * ```gherkin
+ * Then I expect the database to return 1 record
+ * ```
+ * * @param count - The expected number of rows in the result set.
+ */
+exports.ExpectDbRecordCount = (0, registry_1.Step)("I expect the database to return {int} record(s)", async (page, count) => {
     const result = state_1.dbState.getLastResult();
     if (Array.isArray(result)) {
         (0, test_1.expect)(result.length).toBe(count);
+        console.log(`✅ Database returned exactly ${count} record(s).`);
     }
     else {
-        throw new Error(`Expected array result but got: ${typeof result}`);
+        throw new Error(`Expected array result from database but got: ${typeof result}`);
     }
 });
-// 3. JSON/Table Check
-// CHANGE: Removed the colon ':' at the end of the string below
-(0, registry_1.Step)("I expect the first database record to contain", async (page, tableData) => {
+/**
+ * Asserts that the first record of the last database result set contains specific column values.
+ * Performs a loose equality check (converts values to strings) to handle type mismatches.
+ * * @example
+ * ```gherkin
+ * Then I expect the first database record to contain
+ * | username | admin             |
+ * | is_active| 1                 |
+ * | role     | superuser         |
+ * ```
+ * * @param tableData - A Gherkin Data Table containing column names (keys) and expected values.
+ */
+exports.ExpectFirstDbRecordToContain = (0, registry_1.Step)("I expect the first database record to contain", async (page, tableData) => {
     const result = state_1.dbState.getLastResult();
     // Guard Clauses
     if (!Array.isArray(result) || result.length === 0) {
-        throw new Error("Database returned no records to check.");
+        throw new Error("❌ Database returned no records to check.");
     }
     if (!tableData) {
-        throw new Error("This step requires a Data Table.");
+        throw new Error("❌ This step requires a Data Table.");
     }
-    const firstRow = result[0]; // Check the first record found
-    // tableData is [ ["name", "Alice"], ["email", "alice@db.com"] ]
+    const firstRow = result[0];
+    // tableData is [ ["column", "value"], ... ]
     for (const row of tableData) {
         const key = row[0];
         const expectedValue = row[1];
         // Check if the key exists in the DB result
         if (!(key in firstRow)) {
-            throw new Error(`DB Record does not have column: ${key}`);
+            throw new Error(`❌ DB Record does not have column: "${key}"`);
         }
         // Loose equality check (DB might return int, Gherkin sends string)
-        (0, test_1.expect)(String(firstRow[key])).toBe(expectedValue);
+        const actualValue = String(firstRow[key]);
+        (0, test_1.expect)(actualValue).toBe(expectedValue);
     }
+    console.log("✅ First DB record matches the expected data table.");
 });

package/dist/backend/elements/alerts.d.ts

@@ -1,2 +1,36 @@
-export {};
+/**
+ * @module DialogActions
+ */
+/**
+ * Sets up a listener to automatically click "OK" or "Accept" on the very next browser dialog
+ * (alert, confirm, or prompt) that appears.
+ * * **Note:** This must be called *before* the action that triggers the dialog.
+ * * * @example
+ * ```gherkin
+ * Given I accept the next dialog
+ * When I click "#delete-button"
+ * ```
+ */
+export declare const AcceptNextDialog: void;
+/**
+ * Sets up a listener to automatically click "Cancel" or "Dismiss" on the very next browser dialog.
+ * * **Note:** This must be called *before* the action that triggers the dialog.
+ * * * @example
+ * ```gherkin
+ * Given I dismiss the next dialog
+ * When I click "#reset-settings"
+ * ```
+ */
+export declare const DismissNextDialog: void;
+/**
+ * Sets up a listener to type a specific string into the next browser prompt and then accept it.
+ * * **Note:** This must be called *before* the action that triggers the prompt.
+ * * * @example
+ * ```gherkin
+ * Given I type "My New Folder" into the next prompt and accept
+ * When I click "button:has-text('Create')"
+ * ```
+ * * @param text - The string to be entered into the prompt input field.
+ */
+export declare const TypeAndAcceptPrompt: void;
 //# sourceMappingURL=alerts.d.ts.map

package/dist/backend/elements/alerts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../../src/backend/elements/alerts.ts"],"names":[],"mappings":""}
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../../src/backend/elements/alerts.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,MAK3B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,MAK5B,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,MAQ/B,CAAC"}

package/dist/backend/elements/alerts.js

@@ -1,21 +1,54 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeAndAcceptPrompt = exports.DismissNextDialog = exports.AcceptNextDialog = void 0;
 const registry_1 = require("../../core/registry");
-// Accept the next popup (Alert/Confirm/Prompt)
-(0, registry_1.Step)("I accept the next dialog", async (page) => {
+/**
+ * @module DialogActions
+ */
+/**
+ * Sets up a listener to automatically click "OK" or "Accept" on the very next browser dialog
+ * (alert, confirm, or prompt) that appears.
+ * * **Note:** This must be called *before* the action that triggers the dialog.
+ * * * @example
+ * ```gherkin
+ * Given I accept the next dialog
+ * When I click "#delete-button"
+ * ```
+ */
+exports.AcceptNextDialog = (0, registry_1.Step)("I accept the next dialog", async (page) => {
     page.once("dialog", async (dialog) => {
         await dialog.accept();
+        console.log(`✅ Accepted dialog: [${dialog.type()}] "${dialog.message()}"`);
     });
 });
-// Dismiss (Cancel) the next popup
-(0, registry_1.Step)("I dismiss the next dialog", async (page) => {
+/**
+ * Sets up a listener to automatically click "Cancel" or "Dismiss" on the very next browser dialog.
+ * * **Note:** This must be called *before* the action that triggers the dialog.
+ * * * @example
+ * ```gherkin
+ * Given I dismiss the next dialog
+ * When I click "#reset-settings"
+ * ```
+ */
+exports.DismissNextDialog = (0, registry_1.Step)("I dismiss the next dialog", async (page) => {
     page.once("dialog", async (dialog) => {
         await dialog.dismiss();
+        console.log(`❌ Dismissed dialog: [${dialog.type()}] "${dialog.message()}"`);
     });
 });
-// Type text into a prompt and accept
-(0, registry_1.Step)("I type {string} into the next prompt and accept", async (page, text) => {
+/**
+ * Sets up a listener to type a specific string into the next browser prompt and then accept it.
+ * * **Note:** This must be called *before* the action that triggers the prompt.
+ * * * @example
+ * ```gherkin
+ * Given I type "My New Folder" into the next prompt and accept
+ * When I click "button:has-text('Create')"
+ * ```
+ * * @param text - The string to be entered into the prompt input field.
+ */
+exports.TypeAndAcceptPrompt = (0, registry_1.Step)("I type {string} into the next prompt and accept", async (page, text) => {
     page.once("dialog", async (dialog) => {
         await dialog.accept(text);
+        console.log(`✍️ Typed "${text}" into prompt and accepted.`);
     });
 });

package/dist/backend/elements/forms.d.ts

@@ -1,2 +1,45 @@
-export {};
+/**
+ * @module FormActions
+ */
+/**
+ * Selects an option from a `<select>` dropdown menu.
+ * It first attempts to match by the visible label; if that fails, it tries to match by the underlying `value` attribute.
+ * * @example
+ * ```gherkin
+ * When I select option "Canada" from "#country-selector"
+ * When I select option "CA" from "#country-selector"
+ * ```
+ * * @param option - The visible text (label) or the value attribute of the option.
+ * @param selector - The CSS or Playwright selector for the select element.
+ */
+export declare const SelectDropdownOption: void;
+/**
+ * Checks a checkbox or radio button.
+ * * @example
+ * ```gherkin
+ * When I check "#terms-and-conditions"
+ * ```
+ * * @param selector - The selector for the checkbox or radio input.
+ */
+export declare const CheckInput: void;
+/**
+ * Unchecks a checkbox.
+ * * @example
+ * ```gherkin
+ * When I uncheck "#subscribe-newsletter"
+ * ```
+ * * @param selector - The selector for the checkbox input.
+ */
+export declare const UncheckInput: void;
+/**
+ * Uploads a file to an `<input type="file">` element.
+ * The file path is resolved relative to the current working directory of the project.
+ * * @example
+ * ```gherkin
+ * When I upload file "test-data/profile.jpg" to "#avatar-upload"
+ * ```
+ * * @param fileName - The relative path to the file from the project root.
+ * @param selector - The selector for the file input element.
+ */
+export declare const UploadFile: void;
 //# sourceMappingURL=forms.d.ts.map

package/dist/backend/elements/forms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../../src/backend/elements/forms.ts"],"names":[],"mappings":""}
+{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../../src/backend/elements/forms.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,MAShC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,MAGrB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,MAGvB,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,MAOtB,CAAC"}

package/dist/backend/elements/forms.js

@@ -33,27 +33,66 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-const registry_1 = require("../../core/registry");
+exports.UploadFile = exports.UncheckInput = exports.CheckInput = exports.SelectDropdownOption = void 0;
 const path = __importStar(require("path"));
-// Dropdown: Select by value or label
-(0, registry_1.Step)("I select option {string} from {string}", async (page, option, selector) => {
+const registry_1 = require("../../core/registry");
+/**
+ * @module FormActions
+ */
+/**
+ * Selects an option from a `<select>` dropdown menu.
+ * It first attempts to match by the visible label; if that fails, it tries to match by the underlying `value` attribute.
+ * * @example
+ * ```gherkin
+ * When I select option "Canada" from "#country-selector"
+ * When I select option "CA" from "#country-selector"
+ * ```
+ * * @param option - The visible text (label) or the value attribute of the option.
+ * @param selector - The CSS or Playwright selector for the select element.
+ */
+exports.SelectDropdownOption = (0, registry_1.Step)("I select option {string} from {string}", async (page, option, selector) => {
     await page.selectOption(selector, { label: option }).catch(() => {
         // Fallback: try selecting by value if label fails
         return page.selectOption(selector, { value: option });
     });
+    console.log(`✅ Selected option "${option}" from "${selector}"`);
 });
-// Checkboxes & Radio Buttons
-(0, registry_1.Step)("I check {string}", async (page, selector) => {
+/**
+ * Checks a checkbox or radio button.
+ * * @example
+ * ```gherkin
+ * When I check "#terms-and-conditions"
+ * ```
+ * * @param selector - The selector for the checkbox or radio input.
+ */
+exports.CheckInput = (0, registry_1.Step)("I check {string}", async (page, selector) => {
     await page.check(selector);
+    console.log(`✅ Checked "${selector}"`);
 });
-(0, registry_1.Step)("I uncheck {string}", async (page, selector) => {
+/**
+ * Unchecks a checkbox.
+ * * @example
+ * ```gherkin
+ * When I uncheck "#subscribe-newsletter"
+ * ```
+ * * @param selector - The selector for the checkbox input.
+ */
+exports.UncheckInput = (0, registry_1.Step)("I uncheck {string}", async (page, selector) => {
     await page.uncheck(selector);
+    console.log(`✅ Unchecked "${selector}"`);
 });
-// File Upload
-// Usage: When I upload file "data.csv" to "#upload-input"
-(0, registry_1.Step)("I upload file {string} to {string}", async (page, fileName, selector) => {
-    // We assume the user puts files in a 'fixtures' or root folder.
-    // You might want to customize this path resolution.
+/**
+ * Uploads a file to an `<input type="file">` element.
+ * The file path is resolved relative to the current working directory of the project.
+ * * @example
+ * ```gherkin
+ * When I upload file "test-data/profile.jpg" to "#avatar-upload"
+ * ```
+ * * @param fileName - The relative path to the file from the project root.
+ * @param selector - The selector for the file input element.
+ */
+exports.UploadFile = (0, registry_1.Step)("I upload file {string} to {string}", async (page, fileName, selector) => {
     const filePath = path.resolve(process.cwd(), fileName);
     await page.setInputFiles(selector, filePath);
+    console.log(`📁 Uploaded file "${fileName}" to "${selector}"`);
 });

package/dist/backend/elements/frames.d.ts

@@ -1,2 +1,37 @@
-export {};
+/**
+ * @module FrameActions
+ */
+/**
+ * Clicks an element located inside a specific `<iframe>`.
+ * * @example
+ * ```gherkin
+ * When I click "button#submit" inside frame "#payment-iframe"
+ * ```
+ * * @param elementSelector - The CSS/Playwright selector for the element to click.
+ * @param frameSelector - The selector for the iframe element itself.
+ */
+export declare const ClickInsideFrame: void;
+/**
+ * Fills an input field located inside a specific `<iframe>`.
+ * * @example
+ * ```gherkin
+ * When I fill "input[name='card-number']" inside frame "#checkout-frame" with "42424242"
+ * ```
+ * * @param elementSelector - The selector for the input field inside the frame.
+ * @param frameSelector - The selector for the iframe.
+ * @param value - The text to type into the input.
+ */
+export declare const FillInsideFrame: void;
+/**
+ * Asserts that an element inside a specific `<iframe>` contains the expected text.
+ * Uses Playwright's web-first assertions for automatic retries.
+ * * @example
+ * ```gherkin
+ * Then I expect ".success-msg" inside frame "#upload-frame" to have text "Upload Complete"
+ * ```
+ * * @param elementSelector - The selector for the element inside the frame.
+ * @param frameSelector - The selector for the iframe.
+ * @param text - The text expected to be found.
+ */
+export declare const ExpectTextInsideFrame: void;
 //# sourceMappingURL=frames.d.ts.map

package/dist/backend/elements/frames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../../src/backend/elements/frames.ts"],"names":[],"mappings":""}
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../../src/backend/elements/frames.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,MAO5B,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,MAO3B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,MAUjC,CAAC"}

package/dist/backend/elements/frames.js

@@ -1,25 +1,55 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpectTextInsideFrame = exports.FillInsideFrame = exports.ClickInsideFrame = void 0;
+const test_1 = require("@playwright/test");
 const registry_1 = require("../../core/registry");
-// Click inside a specific frame
-(0, registry_1.Step)("I click {string} inside frame {string}", async (page, elementSelector, frameSelector) => {
+/**
+ * @module FrameActions
+ */
+/**
+ * Clicks an element located inside a specific `<iframe>`.
+ * * @example
+ * ```gherkin
+ * When I click "button#submit" inside frame "#payment-iframe"
+ * ```
+ * * @param elementSelector - The CSS/Playwright selector for the element to click.
+ * @param frameSelector - The selector for the iframe element itself.
+ */
+exports.ClickInsideFrame = (0, registry_1.Step)("I click {string} inside frame {string}", async (page, elementSelector, frameSelector) => {
     const frame = page.frameLocator(frameSelector);
     await frame.locator(elementSelector).click();
+    console.log(`🖼️ Clicked "${elementSelector}" inside frame "${frameSelector}".`);
 });
-// Fill input inside a specific frame
-(0, registry_1.Step)("I fill {string} inside frame {string} with {string}", async (page, elementSelector, frameSelector, value) => {
+/**
+ * Fills an input field located inside a specific `<iframe>`.
+ * * @example
+ * ```gherkin
+ * When I fill "input[name='card-number']" inside frame "#checkout-frame" with "42424242"
+ * ```
+ * * @param elementSelector - The selector for the input field inside the frame.
+ * @param frameSelector - The selector for the iframe.
+ * @param value - The text to type into the input.
+ */
+exports.FillInsideFrame = (0, registry_1.Step)("I fill {string} inside frame {string} with {string}", async (page, elementSelector, frameSelector, value) => {
     const frame = page.frameLocator(frameSelector);
     await frame.locator(elementSelector).fill(value);
+    console.log(`🖼️ Filled "${elementSelector}" inside frame "${frameSelector}" with value.`);
 });
-// Assert text inside a specific frame
-(0, registry_1.Step)("I expect {string} inside frame {string} to have text {string}", async (page, elementSelector, frameSelector, text) => {
+/**
+ * Asserts that an element inside a specific `<iframe>` contains the expected text.
+ * Uses Playwright's web-first assertions for automatic retries.
+ * * @example
+ * ```gherkin
+ * Then I expect ".success-msg" inside frame "#upload-frame" to have text "Upload Complete"
+ * ```
+ * * @param elementSelector - The selector for the element inside the frame.
+ * @param frameSelector - The selector for the iframe.
+ * @param text - The text expected to be found.
+ */
+exports.ExpectTextInsideFrame = (0, registry_1.Step)("I expect {string} inside frame {string} to have text {string}", async (page, elementSelector, frameSelector, text) => {
     const frame = page.frameLocator(frameSelector);
     const locator = frame.locator(elementSelector);
-    // We need to import expect for this assertion, or use a custom check
-    // Since we are inside 'elements', let's just do a basic wait/check or re-export expect
-    await locator.waitFor();
-    const actualText = await locator.textContent();
-    if (!actualText?.includes(text)) {
-        throw new Error(`Expected text "${text}" but found "${actualText}" in frame`);
-    }
+    // Using Playwright expect for robust retries
+    await (0, test_1.expect)(locator).toContainText(text);
+    console.log(`✅ Frame "${frameSelector}" element "${elementSelector}" contains "${text}".`);
 });

package/dist/backend/utils/state.d.ts

@@ -0,0 +1,18 @@
+import { Page, Locator } from "@playwright/test";
+export declare function setActiveElement(page: Page, element: Locator): void;
+export declare function getActiveElement(page: Page): Locator;
+export declare function setActiveElements(page: Page, elements: Locator): void;
+export declare function getActiveElements(page: Page): Locator;
+export declare function setVariable(page: Page, key: string, value: any): void;
+export declare function getVariable(page: Page, key: string): any;
+export declare function parseClickOptions(table: any): {
+    force?: boolean;
+    button?: "left" | "right" | "middle";
+    modifiers?: Array<"Alt" | "Control" | "Meta" | "Shift">;
+    position?: {
+        x: number;
+        y: number;
+    };
+    timeout?: number;
+};
+//# sourceMappingURL=state.d.ts.map

package/dist/backend/utils/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/backend/utils/state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAKjD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,QAE5D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAQpD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,QAE9D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAMrD;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,QAK9D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAGxD;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,GAAG;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrC,SAAS,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACxD,QAAQ,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAwCA"}

package/dist/backend/utils/state.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setActiveElement = setActiveElement;
+exports.getActiveElement = getActiveElement;
+exports.setActiveElements = setActiveElements;
+exports.getActiveElements = getActiveElements;
+exports.setVariable = setVariable;
+exports.getVariable = getVariable;
+exports.parseClickOptions = parseClickOptions;
+// 1. STATE MANAGEMENT
+// We attach data to the Playwright Page object so it persists between steps.
+function setActiveElement(page, element) {
+    page.__bdd_element = element;
+}
+function getActiveElement(page) {
+    const el = page.__bdd_element;
+    if (!el) {
+        throw new Error("❌ No stored element found. Did you forget a 'When I find...' step?");
+    }
+    return el;
+}
+function setActiveElements(page, elements) {
+    page.__bdd_elements = elements;
+}
+function getActiveElements(page) {
+    const els = page.__bdd_elements;
+    if (!els) {
+        throw new Error("❌ No stored elements list found.");
+    }
+    return els;
+}
+// 2. DATA / ALIAS MANAGEMENT (for @variable support)
+function setVariable(page, key, value) {
+    if (!page.__bdd_data) {
+        page.__bdd_data = {};
+    }
+    page.__bdd_data[key] = value;
+}
+function getVariable(page, key) {
+    const data = page.__bdd_data;
+    return data ? data[key] : undefined;
+}
+// 3. OPTION PARSERS
+// Converts Gherkin DataTables into Playwright ClickOptions
+function parseClickOptions(table) {
+    if (!table)
+        return {};
+    let hash = {};
+    // Handle Cucumber DataTable object (legacy) or raw Array
+    if (typeof table.rowsHash === "function") {
+        hash = table.rowsHash();
+    }
+    else if (Array.isArray(table)) {
+        // Convert Array of Arrays [['force', 'true']] to Object { force: 'true' }
+        table.forEach((row) => {
+            if (Array.isArray(row) && row.length >= 2) {
+                hash[row[0].toString()] = row[1].toString();
+            }
+        });
+    }
+    else {
+        return {};
+    }
+    const options = {};
+    // Parse specific boolean/number values
+    if (hash["force"] === "true")
+        options.force = true;
+    if (hash["button"])
+        options.button = hash["button"];
+    if (hash["timeout"])
+        options.timeout = parseInt(hash["timeout"], 10);
+    // Handle modifiers (comma separated)
+    if (hash["modifiers"]) {
+        options.modifiers = hash["modifiers"].split(",").map((m) => m.trim());
+    }
+    // Handle position (x,y)
+    if (hash["x"] && hash["y"]) {
+        options.position = {
+            x: parseInt(hash["x"], 10),
+            y: parseInt(hash["y"], 10),
+        };
+    }
+    return options;
+}

package/dist/core/registry.d.ts

@@ -1,23 +1,23 @@
 import { CucumberExpression } from "@cucumber/cucumber-expressions";
 import { Page } from "@playwright/test";
 /**
- * Registers a new Step Definition.
- * * @param pattern - The Gherkin pattern (e.g., 'I click {string}')
- * @param fn - The async function to execute. It receives the Playwright Page object as the first argument.
- * * @example
- * ```ts
- * Step('I scroll to bottom', async (page) => {
- * await page.evaluate(() => window.scrollTo(0, document.body.scrollHeight));
- * });
- * ```
+ * Define the type of function for our steps.
+ * Every step automatically gets 'page' as the first argument.
  */
 export type StepAction = (page: Page, ...args: any[]) => Promise<void>;
-interface StepDefinition {
-    expression: CucumberExpression;
+/**
+ * 1. StepDefinition Interface
+ * Updated to allow both CucumberExpression (legacy) AND RegExp (standard)
+ */
+export interface StepDefinition {
+    expression: CucumberExpression | RegExp;
     fn: StepAction;
-    pattern: string;
+    pattern: string | RegExp;
 }
 export declare const stepRegistry: StepDefinition[];
-export declare function Step(pattern: string, fn: StepAction): void;
-export {};
+/**
+ * 3. The Function to Register Steps
+ * Supports passing a string (converted to CucumberExpression) OR a direct RegExp.
+ */
+export declare function Step(pattern: string | RegExp, fn: StepAction): void;
 //# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAEnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC;;;;;;;;;;GAUG;AAGH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvE,UAAU,cAAc;IACtB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,eAAO,MAAM,YAAY,EAAE,cAAc,EAAO,CAAC;AAMjD,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,QAQnD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAEnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAAC;IACxC,EAAE,EAAE,UAAU,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAGD,eAAO,MAAM,YAAY,EAAE,cAAc,EAAO,CAAC;AAIjD;;;GAGG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,UAAU,QAgB5D"}