playwright-cucumber-ts-steps 1.1.7 → 1.1.9

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

@@ -1,2 +1,62 @@
-export {};
+/**
+ * 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.
+ */
+export declare const ClickElement: void;
+/**
+ * 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.
+ */
+export declare const ForceClickElement: void;
+/**
+ * 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.
+ */
+export declare const FillElement: void;
+/**
+ * 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").
+ */
+export declare const PressKeyGlobal: void;
+/**
+ * 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.
+ */
+export declare const HardWait: 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":""}
+{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../../../src/backend/actions/interactions.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,MAEvB,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,MAE5B,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,MAEtB,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,MAEzB,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,QAAQ,MAEnB,CAAC"}

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

@@ -0,0 +1,71 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +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.
+ * 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").
+ */
+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 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.
+ */
+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 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.
+ */
+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 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").
+ */
+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.
+ * 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.
+ */
+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 that was previously held down.
+ *
+ * ```gherkin
+ * When I release key "Shift"
+ * ```
+ *
+ * @param key - The name of the key to release.
+ */
+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

@@ -0,0 +1,135 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,208 @@
+"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 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`.
+ */
+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 specified number of seconds.
+ *
+ * ```gherkin
+ * When I wait for 5 seconds
+ * ```
+ *
+ * @param seconds - The duration to wait in 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`);
+});
+// ==================================================
+// 2. DEBUGGING
+// ==================================================
+/**
+ * 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
+ * ```
+ */
+exports.PauseExecution = (0, registry_1.Step)("I pause", async (page) => {
+    console.log("⏸️ Pausing test execution...");
+    await page.pause();
+});
+/**
+ * Alias for `I pause`. Pauses execution for debugging.
+ *
+ * ```gherkin
+ * When I debug
+ * ```
+ */
+exports.DebugExecution = (0, registry_1.Step)("I debug", async (page) => {
+    console.log("🐞 Debugging...");
+    await page.pause();
+});
+/**
+ * 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.
+ */
+exports.LogMessage = (0, registry_1.Step)("I log {string}", async (page, message) => {
+    console.log(`📝 LOG: ${message}`);
+});
+// ==================================================
+// 3. FOCUS & BLUR
+// ==================================================
+/**
+ * Focuses on the currently stored (active) element.
+ *
+ * ```gherkin
+ * When I focus
+ * ```
+ */
+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 (removes focus from) the currently stored element.
+ *
+ * ```gherkin
+ * When I blur
+ * ```
+ */
+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) => {
+        if (el instanceof HTMLElement)
+            el.blur();
+    });
+    console.log("🌫️ Blurred stored element");
+});
+// ==================================================
+// 4. BROWSER STORAGE (Cookies / Local Storage)
+// ==================================================
+/**
+ * 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.
+ */
+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.
+    await context.addCookies([{ name, value, url }]);
+    console.log(`🍪 Set cookie "${name}"`);
+});
+/**
+ * Clears all cookies for the current browser context.
+ *
+ * ```gherkin
+ * When I clear all cookies
+ * ```
+ */
+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 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.
+ */
+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,
+    });
+    console.log(`📦 Set local storage "${key}" = "${value}"`);
+});
+/**
+ * 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.
+ */
+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 data from Local Storage.
+ *
+ * ```gherkin
+ * When I clear local storage
+ * ```
+ */
+exports.ClearLocalStorage = (0, registry_1.Step)("I clear local storage", async (page) => {
+    await page.evaluate(() => localStorage.clear());
+    console.log("📦 Cleared local storage");
+});
+/**
+ * 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.
+ */
+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,
+    });
+    console.log(`📦 Set session storage "${key}" = "${value}"`);
+});
+/**
+ * Clears all data from Session Storage.
+ *
+ * ```gherkin
+ * When I clear session storage
+ * ```
+ */
+exports.ClearSessionStorage = (0, registry_1.Step)("I clear session storage", async (page) => {
+    await page.evaluate(() => sessionStorage.clear());
+    console.log("📦 Cleared session storage");
+});