playwright-cucumber-ts-steps 1.1.8 → 1.1.10

package/dist/backend/actions/interactions.js

@@ -1,23 +1,78 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HardWait = exports.PressKeyGlobal = exports.FillElement = exports.ForceClickElement = exports.ClickElement = void 0;
 const registry_1 = require("../../core/registry");
-// Click
-(0, registry_1.Step)("I click {string}", async (page, selector) => {
+// =============================
+// BASIC INTERACTIONS (Direct)
+// =============================
+/**
+ * Performs a standard click on the element matching the selector.
+ *
+ * ```gherkin
+ * When I click "#submit-button"
+ * ```
+ *
+ * @param selector - The CSS or XPath selector of the element to click.
+ */
+exports.ClickElement = (0, registry_1.Step)("I click {string}", async (page, selector) => {
     await page.click(selector);
 });
-// Force Click (sometimes needed for stubborn elements)
-(0, registry_1.Step)("I force click {string}", async (page, selector) => {
+/**
+ * Performs a forced click on the element, bypassing visibility checks.
+ * Useful for elements obscured by overlays or technically "hidden" but interactable.
+ *
+ * ```gherkin
+ * When I force click "#hidden-checkbox"
+ * ```
+ *
+ * @param selector - The CSS or XPath selector.
+ * @remarks
+ * **Warning:** Use this sparingly. It disables Playwright's "actionability" checks,
+ * meaning it might click an element that a real user technically cannot click.
+ */
+exports.ForceClickElement = (0, registry_1.Step)("I force click {string}", async (page, selector) => {
     await page.click(selector, { force: true });
 });
-// Type/Fill
-(0, registry_1.Step)("I fill {string} with {string}", async (page, selector, value) => {
+/**
+ * Fills an input field with the specified value.
+ *
+ * ```gherkin
+ * When I fill "#username" with "testuser"
+ * ```
+ *
+ * @param selector - The CSS selector of the input field.
+ * @param value - The text value to type/fill.
+ */
+exports.FillElement = (0, registry_1.Step)("I fill {string} with {string}", async (page, selector, value) => {
     await page.fill(selector, value);
 });
-// Press Key (e.g., "Enter")
-(0, registry_1.Step)("I press {string}", async (page, key) => {
+/**
+ * Presses a specific key on the keyboard globally.
+ * Useful for submitting forms (Enter) or closing modals (Escape).
+ *
+ * ```gherkin
+ * When I press "Enter"
+ * When I press "Escape"
+ * ```
+ *
+ * @param key - The name of the key (e.g., "Enter", "Tab", "ArrowDown").
+ */
+exports.PressKeyGlobal = (0, registry_1.Step)("I press {string}", async (page, key) => {
     await page.keyboard.press(key);
 });
-// Wait (Hard wait - use sparingly!)
-(0, registry_1.Step)("I wait for {int} milliseconds", async (page, ms) => {
+/**
+ * Pauses the test execution for a fixed amount of time.
+ *
+ * ```gherkin
+ * When I wait for 5000 milliseconds
+ * ```
+ *
+ * @param ms - The duration to wait in milliseconds.
+ * @remarks
+ * **Anti-Pattern Warning:** Avoid using hard waits whenever possible.
+ * They make tests slower and flaky. Prefer `I wait for element to be visible`
+ * or `I wait for network idle` instead.
+ */
+exports.HardWait = (0, registry_1.Step)("I wait for {int} milliseconds", async (page, ms) => {
     await page.waitForTimeout(ms);
 });

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

@@ -1,2 +1,71 @@
-export {};
+/**
+ * Presses a specific key globally on the page.
+ * This simulates a user pressing a key without targeting any specific element,
+ * although the event will be delivered to the currently focused element.
+ *
+ * ```gherkin
+ * When I press key "Enter"
+ * When I press key "Escape"
+ * ```
+ *
+ * @param key - The name of the key (e.g., "Enter", "Tab", "ArrowDown").
+ */
+export declare const PressKey: void;
+/**
+ * Presses a specific key targeted at the currently stored (active) element.
+ * This ensures the element is focused before the key is pressed.
+ *
+ * ```gherkin
+ * When I press key "Enter" on element
+ * ```
+ *
+ * @param key - The name of the key to press.
+ */
+export declare const PressKeyOnElement: void;
+/**
+ * Types text globally using the keyboard, character by character.
+ * This acts like a real user typing on a physical keyboard, sending
+ * `keydown`, `keypress`, and `keyup` events for each character.
+ *
+ * ```gherkin
+ * When I press keys "Hello World"
+ * ```
+ *
+ * @param text - The string of text to type.
+ */
+export declare const TypeKeysGlobal: void;
+/**
+ * Performs a specific keyboard shortcut or combination.
+ * Playwright supports combinations using the "+" delimiter.
+ *
+ * ```gherkin
+ * When I press shortcut "Control+C"
+ * When I press shortcut "Meta+Shift+P"
+ * ```
+ *
+ * @param shortcut - The key combination string (e.g., "Control+V").
+ */
+export declare const PressShortcut: void;
+/**
+ * Holds down a specific key.
+ * Useful for operations like multiple selections (holding Shift) or drag-and-drop.
+ * **Important:** You must release the key later using `I release key`.
+ *
+ * ```gherkin
+ * When I hold down key "Shift"
+ * ```
+ *
+ * @param key - The name of the key to hold down.
+ */
+export declare const HoldDownKey: void;
+/**
+ * Releases a specific key that was previously held down.
+ *
+ * ```gherkin
+ * When I release key "Shift"
+ * ```
+ *
+ * @param key - The name of the key to release.
+ */
+export declare const ReleaseKey: void;
 //# sourceMappingURL=keyboard.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/keyboard.ts"],"names":[],"mappings":""}
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/keyboard.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,MAGnB,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,MAI5B,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,MAGzB,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,MAIxB,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,MAGtB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,MAGrB,CAAC"}

package/dist/backend/actions/keyboard.js

@@ -1,62 +1,98 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReleaseKey = exports.HoldDownKey = exports.PressShortcut = exports.TypeKeysGlobal = exports.PressKeyOnElement = exports.PressKey = void 0;
 const registry_1 = require("../../core/registry");
 const state_1 = require("../utils/state");
 // ==================================================
 // KEYBOARD INTERACTIONS
 // ==================================================
 /**
- * Presses a specific key globally (on the page).
- * Useful for global shortcuts like closing modals (Escape) or scrolling (PageDown).
- * Pattern: When I press key "Enter"
+ * Presses a specific key globally on the page.
+ * This simulates a user pressing a key without targeting any specific element,
+ * although the event will be delivered to the currently focused element.
+ *
+ * ```gherkin
+ * When I press key "Enter"
+ * When I press key "Escape"
+ * ```
+ *
+ * @param key - The name of the key (e.g., "Enter", "Tab", "ArrowDown").
  */
-(0, registry_1.Step)("I press key {string}", async (page, key) => {
+exports.PressKey = (0, registry_1.Step)("I press key {string}", async (page, key) => {
     await page.keyboard.press(key);
     console.log(`⌨️ Pressed key: "${key}"`);
 });
 /**
- * Presses a key on the currently stored/active element.
- * Useful for input fields or buttons.
- * Pattern: When I press key "Enter" on element
+ * Presses a specific key targeted at the currently stored (active) element.
+ * This ensures the element is focused before the key is pressed.
+ *
+ * ```gherkin
+ * When I press key "Enter" on element
+ * ```
+ *
+ * @param key - The name of the key to press.
  */
-(0, registry_1.Step)("I press key {string} on element", async (page, key) => {
+exports.PressKeyOnElement = (0, registry_1.Step)("I press key {string} on element", async (page, key) => {
     const element = (0, state_1.getActiveElement)(page);
     await element.press(key);
     console.log(`⌨️ Pressed key "${key}" on stored element`);
 });
 /**
- * Types text directly using the keyboard (global typing).
- * Unlike 'I type', this sends keystrokes one by one to the page,
- * regardless of which element is focused.
- * Pattern: When I press keys "Hello World"
+ * Types text globally using the keyboard, character by character.
+ * This acts like a real user typing on a physical keyboard, sending
+ * `keydown`, `keypress`, and `keyup` events for each character.
+ *
+ * ```gherkin
+ * When I press keys "Hello World"
+ * ```
+ *
+ * @param text - The string of text to type.
  */
-(0, registry_1.Step)("I press keys {string}", async (page, text) => {
+exports.TypeKeysGlobal = (0, registry_1.Step)("I press keys {string}", async (page, text) => {
     await page.keyboard.type(text);
     console.log(`⌨️ Typed keys: "${text}"`);
 });
 /**
- * Performs a keyboard shortcut (e.g., Ctrl+C, Meta+S).
- * Pattern: When I press shortcut "Control+C"
+ * Performs a specific keyboard shortcut or combination.
+ * Playwright supports combinations using the "+" delimiter.
+ *
+ * ```gherkin
+ * When I press shortcut "Control+C"
+ * When I press shortcut "Meta+Shift+P"
+ * ```
+ *
+ * @param shortcut - The key combination string (e.g., "Control+V").
  */
-(0, registry_1.Step)("I press shortcut {string}", async (page, shortcut) => {
+exports.PressShortcut = (0, registry_1.Step)("I press shortcut {string}", async (page, shortcut) => {
     // Playwright's keyboard.press supports combinations like "Control+KeyC"
     await page.keyboard.press(shortcut);
     console.log(`⌨️ Performed shortcut: "${shortcut}"`);
 });
 /**
- * Holds down a specific key (e.g., Shift) for subsequent actions.
- * Make sure to release it later!
- * Pattern: When I hold down key "Shift"
+ * Holds down a specific key.
+ * Useful for operations like multiple selections (holding Shift) or drag-and-drop.
+ * **Important:** You must release the key later using `I release key`.
+ *
+ * ```gherkin
+ * When I hold down key "Shift"
+ * ```
+ *
+ * @param key - The name of the key to hold down.
  */
-(0, registry_1.Step)("I hold down key {string}", async (page, key) => {
+exports.HoldDownKey = (0, registry_1.Step)("I hold down key {string}", async (page, key) => {
     await page.keyboard.down(key);
     console.log(`⬇️ Holding down key: "${key}"`);
 });
 /**
- * Releases a specific key.
- * Pattern: When I release key "Shift"
+ * Releases a specific key that was previously held down.
+ *
+ * ```gherkin
+ * When I release key "Shift"
+ * ```
+ *
+ * @param key - The name of the key to release.
  */
-(0, registry_1.Step)("I release key {string}", async (page, key) => {
+exports.ReleaseKey = (0, registry_1.Step)("I release key {string}", async (page, key) => {
     await page.keyboard.up(key);
     console.log(`⬆️ Released key: "${key}"`);
 });

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

@@ -1,2 +1,135 @@
-export {};
+/**
+ * Pauses execution for a specified number of milliseconds.
+ *
+ * ```gherkin
+ * When I wait for 1000 milliseconds
+ * ```
+ *
+ * @param ms - The duration to wait in milliseconds.
+ * @remarks
+ * **Note:** Use sparse waits to avoid flaky tests. Prefer explicit waits like `I wait for element to be visible`.
+ */
+export declare const WaitMilliseconds: void;
+/**
+ * Pauses execution for a specified number of seconds.
+ *
+ * ```gherkin
+ * When I wait for 5 seconds
+ * ```
+ *
+ * @param seconds - The duration to wait in seconds.
+ */
+export declare const WaitSeconds: void;
+/**
+ * Pauses the test execution and opens the Playwright Inspector.
+ * This is incredibly useful for manual debugging during a test run.
+ * You can inspect elements, view console logs, and step through execution.
+ *
+ * ```gherkin
+ * When I pause
+ * ```
+ */
+export declare const PauseExecution: void;
+/**
+ * Alias for `I pause`. Pauses execution for debugging.
+ *
+ * ```gherkin
+ * When I debug
+ * ```
+ */
+export declare const DebugExecution: void;
+/**
+ * Prints a custom message to the console logs.
+ * Useful for marking sections of a test output or debugging variable states.
+ *
+ * ```gherkin
+ * When I log "Starting Login Flow"
+ * ```
+ *
+ * @param message - The string to log.
+ */
+export declare const LogMessage: void;
+/**
+ * Focuses on the currently stored (active) element.
+ *
+ * ```gherkin
+ * When I focus
+ * ```
+ */
+export declare const FocusElement: void;
+/**
+ * Blurs (removes focus from) the currently stored element.
+ *
+ * ```gherkin
+ * When I blur
+ * ```
+ */
+export declare const BlurElement: void;
+/**
+ * Sets a cookie for the current context/URL.
+ *
+ * ```gherkin
+ * When I set cookie "session_id" to "12345ABC"
+ * ```
+ *
+ * @param name - The name of the cookie.
+ * @param value - The value of the cookie.
+ */
+export declare const SetCookie: void;
+/**
+ * Clears all cookies for the current browser context.
+ *
+ * ```gherkin
+ * When I clear all cookies
+ * ```
+ */
+export declare const ClearAllCookies: void;
+/**
+ * Sets an item in Local Storage.
+ *
+ * ```gherkin
+ * When I set local storage item "theme" to "dark"
+ * ```
+ *
+ * @param key - The local storage key.
+ * @param value - The value to store.
+ */
+export declare const SetLocalStorageItem: void;
+/**
+ * Retrieves a Local Storage item and logs it to the console.
+ *
+ * ```gherkin
+ * When I get local storage item "authToken"
+ * ```
+ *
+ * @param key - The key of the item to retrieve.
+ */
+export declare const GetLocalStorageItem: void;
+/**
+ * Clears all data from Local Storage.
+ *
+ * ```gherkin
+ * When I clear local storage
+ * ```
+ */
+export declare const ClearLocalStorage: void;
+/**
+ * Sets an item in Session Storage.
+ *
+ * ```gherkin
+ * When I set session storage item "user_role" to "admin"
+ * ```
+ *
+ * @param key - The session storage key.
+ * @param value - The value to store.
+ */
+export declare const SetSessionStorageItem: void;
+/**
+ * Clears all data from Session Storage.
+ *
+ * ```gherkin
+ * When I clear session storage
+ * ```
+ */
+export declare const ClearSessionStorage: void;
 //# sourceMappingURL=misc.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/misc.ts"],"names":[],"mappings":""}
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/misc.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,MAG3B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,MAGtB,CAAC;AAMH;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,MAGzB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,MAGzB,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,MAErB,CAAC;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,MAIvB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,MAOtB,CAAC;AAMH;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,MAMpB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,MAI1B,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,MAS/B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,MAG9B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,MAG5B,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,MASjC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,MAG9B,CAAC"}

package/dist/backend/actions/misc.js

@@ -1,23 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClearSessionStorage = exports.SetSessionStorageItem = exports.ClearLocalStorage = exports.GetLocalStorageItem = exports.SetLocalStorageItem = exports.ClearAllCookies = exports.SetCookie = exports.BlurElement = exports.FocusElement = exports.LogMessage = exports.DebugExecution = exports.PauseExecution = exports.WaitSeconds = exports.WaitMilliseconds = void 0;
 const registry_1 = require("../../core/registry");
 const state_1 = require("../utils/state");
 // ==================================================
 // 1. TIMING & WAITS
 // ==================================================
 /**
- * Pauses execution for a set amount of time.
- * Pattern: When I wait for 1000 milliseconds
+ * Pauses execution for a specified number of milliseconds.
+ *
+ * ```gherkin
+ * When I wait for 1000 milliseconds
+ * ```
+ *
+ * @param ms - The duration to wait in milliseconds.
+ * @remarks
+ * **Note:** Use sparse waits to avoid flaky tests. Prefer explicit waits like `I wait for element to be visible`.
  */
-(0, registry_1.Step)("I wait for {int} milliseconds", async (page, ms) => {
+exports.WaitMilliseconds = (0, registry_1.Step)("I wait for {int} milliseconds", async (page, ms) => {
     await page.waitForTimeout(ms);
     console.log(`⏳ Waited for ${ms}ms`);
 });
 /**
- * Pauses execution for a set amount of seconds.
- * Pattern: When I wait for 5 seconds
+ * Pauses execution for a specified number of seconds.
+ *
+ * ```gherkin
+ * When I wait for 5 seconds
+ * ```
+ *
+ * @param seconds - The duration to wait in seconds.
  */
-(0, registry_1.Step)("I wait for {int} seconds", async (page, seconds) => {
+exports.WaitSeconds = (0, registry_1.Step)("I wait for {int} seconds", async (page, seconds) => {
     await page.waitForTimeout(seconds * 1000);
     console.log(`⏳ Waited for ${seconds}s`);
 });
@@ -26,45 +39,64 @@ const state_1 = require("../utils/state");
 // ==================================================
 /**
  * Pauses the test execution and opens the Playwright Inspector.
- * Useful for manual debugging during a run.
- * Pattern: When I pause
+ * This is incredibly useful for manual debugging during a test run.
+ * You can inspect elements, view console logs, and step through execution.
+ *
+ * ```gherkin
+ * When I pause
+ * ```
  */
-(0, registry_1.Step)("I pause", async (page) => {
+exports.PauseExecution = (0, registry_1.Step)("I pause", async (page) => {
     console.log("⏸️ Pausing test execution...");
     await page.pause();
 });
 /**
- * Alias for pause.
- * Pattern: When I debug
+ * Alias for `I pause`. Pauses execution for debugging.
+ *
+ * ```gherkin
+ * When I debug
+ * ```
  */
-(0, registry_1.Step)("I debug", async (page) => {
+exports.DebugExecution = (0, registry_1.Step)("I debug", async (page) => {
     console.log("🐞 Debugging...");
     await page.pause();
 });
 /**
- * Prints a message to the console logs.
- * Pattern: When I log "Hello World"
+ * Prints a custom message to the console logs.
+ * Useful for marking sections of a test output or debugging variable states.
+ *
+ * ```gherkin
+ * When I log "Starting Login Flow"
+ * ```
+ *
+ * @param message - The string to log.
  */
-(0, registry_1.Step)("I log {string}", async (page, message) => {
+exports.LogMessage = (0, registry_1.Step)("I log {string}", async (page, message) => {
     console.log(`📝 LOG: ${message}`);
 });
 // ==================================================
 // 3. FOCUS & BLUR
 // ==================================================
 /**
- * Focuses on the currently stored element.
- * Pattern: When I focus
+ * Focuses on the currently stored (active) element.
+ *
+ * ```gherkin
+ * When I focus
+ * ```
  */
-(0, registry_1.Step)("I focus", async (page) => {
+exports.FocusElement = (0, registry_1.Step)("I focus", async (page) => {
     const element = (0, state_1.getActiveElement)(page);
     await element.focus();
     console.log("👀 Focused on stored element");
 });
 /**
- * Blurs (un-focuses) the currently stored element.
- * Pattern: When I blur
+ * Blurs (removes focus from) the currently stored element.
+ *
+ * ```gherkin
+ * When I blur
+ * ```
  */
-(0, registry_1.Step)("I blur", async (page) => {
+exports.BlurElement = (0, registry_1.Step)("I blur", async (page) => {
     const element = (0, state_1.getActiveElement)(page);
     // Playwright doesn't have a direct .blur(), so we use JS evaluation
     await element.evaluate((el) => {
@@ -77,10 +109,16 @@ const state_1 = require("../utils/state");
 // 4. BROWSER STORAGE (Cookies / Local Storage)
 // ==================================================
 /**
- * Sets a cookie for the current context.
- * Pattern: When I set cookie "session_id" to "12345"
+ * Sets a cookie for the current context/URL.
+ *
+ * ```gherkin
+ * When I set cookie "session_id" to "12345ABC"
+ * ```
+ *
+ * @param name - The name of the cookie.
+ * @param value - The value of the cookie.
  */
-(0, registry_1.Step)("I set cookie {string} to {string}", async (page, name, value) => {
+exports.SetCookie = (0, registry_1.Step)("I set cookie {string} to {string}", async (page, name, value) => {
     const context = page.context();
     const url = page.url();
     // We need a domain or url to set cookies. We use the current page URL.
@@ -88,19 +126,28 @@ const state_1 = require("../utils/state");
     console.log(`🍪 Set cookie "${name}"`);
 });
 /**
- * Clears all cookies.
- * Pattern: When I clear all cookies
+ * Clears all cookies for the current browser context.
+ *
+ * ```gherkin
+ * When I clear all cookies
+ * ```
  */
-(0, registry_1.Step)("I clear all cookies", async (page) => {
+exports.ClearAllCookies = (0, registry_1.Step)("I clear all cookies", async (page) => {
     const context = page.context();
     await context.clearCookies();
     console.log("🍪 Cleared all cookies");
 });
 /**
- * Sets a Local Storage item.
- * Pattern: When I set local storage item "theme" to "dark"
+ * Sets an item in Local Storage.
+ *
+ * ```gherkin
+ * When I set local storage item "theme" to "dark"
+ * ```
+ *
+ * @param key - The local storage key.
+ * @param value - The value to store.
  */
-(0, registry_1.Step)("I set local storage item {string} to {string}", async (page, key, value) => {
+exports.SetLocalStorageItem = (0, registry_1.Step)("I set local storage item {string} to {string}", async (page, key, value) => {
     await page.evaluate(({ k, v }) => localStorage.setItem(k, v), {
         k: key,
         v: value,
@@ -108,26 +155,40 @@ const state_1 = require("../utils/state");
     console.log(`📦 Set local storage "${key}" = "${value}"`);
 });
 /**
- * Gets a Local Storage item and prints it.
- * Pattern: When I get local storage item "token"
+ * Retrieves a Local Storage item and logs it to the console.
+ *
+ * ```gherkin
+ * When I get local storage item "authToken"
+ * ```
+ *
+ * @param key - The key of the item to retrieve.
  */
-(0, registry_1.Step)("I get local storage item {string}", async (page, key) => {
+exports.GetLocalStorageItem = (0, registry_1.Step)("I get local storage item {string}", async (page, key) => {
     const value = await page.evaluate((k) => localStorage.getItem(k), key);
     console.log(`📦 Local Storage "${key}": ${value}`);
 });
 /**
- * Clears all Local Storage.
- * Pattern: When I clear local storage
+ * Clears all data from Local Storage.
+ *
+ * ```gherkin
+ * When I clear local storage
+ * ```
  */
-(0, registry_1.Step)("I clear local storage", async (page) => {
+exports.ClearLocalStorage = (0, registry_1.Step)("I clear local storage", async (page) => {
     await page.evaluate(() => localStorage.clear());
     console.log("📦 Cleared local storage");
 });
 /**
- * Sets a Session Storage item.
- * Pattern: When I set session storage item "user" to "admin"
+ * Sets an item in Session Storage.
+ *
+ * ```gherkin
+ * When I set session storage item "user_role" to "admin"
+ * ```
+ *
+ * @param key - The session storage key.
+ * @param value - The value to store.
  */
-(0, registry_1.Step)("I set session storage item {string} to {string}", async (page, key, value) => {
+exports.SetSessionStorageItem = (0, registry_1.Step)("I set session storage item {string} to {string}", async (page, key, value) => {
     await page.evaluate(({ k, v }) => sessionStorage.setItem(k, v), {
         k: key,
         v: value,
@@ -135,10 +196,13 @@ const state_1 = require("../utils/state");
     console.log(`📦 Set session storage "${key}" = "${value}"`);
 });
 /**
- * Clears all Session Storage.
- * Pattern: When I clear session storage
+ * Clears all data from Session Storage.
+ *
+ * ```gherkin
+ * When I clear session storage
+ * ```
  */
-(0, registry_1.Step)("I clear session storage", async (page) => {
+exports.ClearSessionStorage = (0, registry_1.Step)("I clear session storage", async (page) => {
     await page.evaluate(() => sessionStorage.clear());
     console.log("📦 Cleared session storage");
 });