playwright-mimic 0.1.0 → 0.1.2

package/dist/mimic/navigation.js

@@ -0,0 +1,136 @@
+import { generateText, Output } from 'ai';
+import { zNavigationAction, } from './schema/action.js';
+import { countTokens } from '../utils/token-counter.js';
+import { addAnnotation } from './annotations.js';
+import { generateNavigationCode } from './playwrightCodeGenerator.js';
+export const getNavigationAction = async (_page, brain, action, testContext) => {
+    // Build context description for the prompt
+    const contextDescription = testContext ? `
+**Test Context:**
+- Current URL: ${testContext.currentState.url}
+- Current Page Title: ${testContext.currentState.pageTitle}
+- Step ${testContext.currentStepIndex + 1} of ${testContext.totalSteps}
+${testContext.previousSteps.length > 0 ? `
+**Previous Steps Executed:**
+${testContext.previousSteps.map((prevStep, idx) => `${idx + 1}. Step ${prevStep.stepIndex + 1}: "${prevStep.stepText}" (${prevStep.actionKind}${prevStep.url ? ` → ${prevStep.url}` : ''})`).join('\n')}
+` : ''}
+` : '';
+    const res = await generateText({
+        model: brain,
+        maxRetries: 3,
+        prompt: `You are an expert in converting Gherkin test steps into structured browser automation action objects using Playwright.
+
+Your task is to process a single Gherkin step and determine whether it represents a **navigation** action. this can be any of the following:
+- navigate to a page (this requires a url, if no url is provided, go for an option below)
+- closePage: close the current page
+- goBack: go back to the previous page, or navigate back in the browser history
+- goForward: go forward to the next page, or navigate forward in the browser history
+- refresh: refresh the current page, or reload the page
+
+${contextDescription}
+**Input Gherkin step:** ${action}
+
+**Instructions:**
+1. Determine the navigation type and extract the URL if applicable
+2. For navigate/openPage actions, determine if the step indicates opening in a new window/tab:
+   - If the step mentions "new window", "new tab", "open in new", "in a new page", or similar phrases, set newWindow: true
+   - Otherwise, set newWindow: false or omit it (defaults to false)
+3. Provide a clear, human-readable description of what navigation is happening
+   - For navigate/openPage: "Navigate to [page name or URL]" (e.g., "Navigate to login page", "Navigate to https://example.com")
+   - For navigate/openPage with newWindow: "Navigate to [page name or URL] in new window/tab" (e.g., "Navigate to login page in new window")
+   - Do not hallucinate the domain, if none are mentioned, just pass the uri (e.g., "/login")
+   - For goBack: "Go back to previous page in browser history" (the system will add the specific URL information)
+   - For goForward: "Go forward to next page in browser history" (the system will add the specific URL information)
+   - For refresh: "Refresh the current page" (the system will add the specific URL information)
+   - For closePage: "Close the current browser page/tab" (the system will add the specific URL information)
+    
+    `,
+        output: Output.object({ schema: zNavigationAction, name: 'navigation' }),
+    });
+    await countTokens(res);
+    return res.output;
+};
+/**
+ * Execute a navigation action on the page with plain English annotation
+ *
+ * This function performs browser navigation actions (navigate, go back, refresh, etc.)
+ * and adds test annotations for better traceability and validation.
+ *
+ * @param page - Playwright Page object to perform navigation on
+ * @param navigationAction - Navigation action containing type, parameters, and description
+ * @param testInfo - Playwright TestInfo for adding annotations (optional)
+ * @param gherkinStep - The original Gherkin step for annotation type (optional)
+ * @returns Promise that resolves to the navigation action (for snapshot storage)
+ */
+export const executeNavigationAction = async (page, navigationAction, testInfo, gherkinStep) => {
+    // Use LLM-generated description or build a default one
+    const actionDescription = navigationAction.description || 'navigation action';
+    // Generate Playwright code equivalent
+    const playwrightCode = generateNavigationCode(navigationAction.type, navigationAction.params.url ?? undefined, navigationAction.params.newWindow);
+    switch (navigationAction.type) {
+        case 'openPage':
+        case 'navigate':
+            // Check if we need to open in a new window/tab
+            if (navigationAction.params.newWindow) {
+                // Create a new page in the same browser context
+                const context = page.context();
+                const newPage = await context.newPage();
+                addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} in new window/tab and waiting for page to load completely`, playwrightCode);
+                await newPage.goto(navigationAction.params.url, { waitUntil: 'networkidle' });
+                // Note: The new page is created and navigated, but the original page reference remains unchanged
+                // The new page is available in the browser context and can be accessed via context.pages()
+            }
+            else {
+                addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} and waiting for page to load completely`, playwrightCode);
+                await page.goto(navigationAction.params.url, { waitUntil: 'networkidle' });
+            }
+            break;
+        case 'closePage':
+            // Only close page if explicitly requested - be very careful with this action
+            // Check if page is still open before closing
+            if (page.isClosed()) {
+                addAnnotation(testInfo, gherkinStep, `→ Page is already closed, cannot close again`, playwrightCode);
+                return navigationAction;
+            }
+            // Capture current URL for better traceability
+            const currentUrlBeforeClose = page.url();
+            addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} (closing page at ${currentUrlBeforeClose})`, playwrightCode);
+            await page.close();
+            break;
+        case 'goBack':
+            // Capture current URL before going back for better traceability
+            const currentUrlBeforeBack = page.url();
+            await page.goBack();
+            try {
+                const urlAfterBack = page.url();
+                addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} (from ${currentUrlBeforeBack} to ${urlAfterBack})`, playwrightCode);
+            }
+            catch {
+                addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} (from ${currentUrlBeforeBack})`, playwrightCode);
+            }
+            break;
+        case 'goForward':
+            // Capture current URL before going forward for better traceability
+            const currentUrlBeforeForward = page.url();
+            await page.goForward();
+            try {
+                const urlAfterForward = page.url();
+                addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} (from ${currentUrlBeforeForward} to ${urlAfterForward})`, playwrightCode);
+            }
+            catch {
+                addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} (from ${currentUrlBeforeForward})`, playwrightCode);
+            }
+            break;
+        case 'refresh':
+            // Capture current URL for better traceability
+            const currentUrlBeforeRefresh = page.url();
+            addAnnotation(testInfo, gherkinStep, `→ ${actionDescription} to reload all content (refreshing ${currentUrlBeforeRefresh})`, playwrightCode);
+            await page.reload();
+            break;
+        default:
+            throw new Error(`Unknown navigation action type: ${navigationAction.type}`);
+    }
+    // Return the action for snapshot storage
+    return navigationAction;
+};
+//# sourceMappingURL=navigation.js.map

package/dist/mimic/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../src/mimic/navigation.ts"],"names":[],"mappings":"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"}

package/dist/mimic/playwrightCodeGenerator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Playwright Code Generator
+ *
+ * Converts SelectorDescriptor and action information into equivalent Playwright code strings
+ * for test annotations and documentation purposes.
+ */
+import type { SelectorDescriptor } from './selectorTypes.js';
+/**
+ * Convert a SelectorDescriptor to a Playwright code string
+ *
+ * Generates the equivalent Playwright locator code that would be used to select
+ * the element described by the SelectorDescriptor.
+ *
+ * @param descriptor - SelectorDescriptor to convert
+ * @param baseVar - Base variable name to use (default: 'page')
+ * @returns Playwright code string representing the locator
+ *
+ * @example
+ * ```typescript
+ * const code = selectorToPlaywrightCode({
+ *   type: 'role',
+ *   role: 'button',
+ *   name: 'Submit'
+ * });
+ * // Returns: "page.getByRole('button', { name: 'Submit' })"
+ * ```
+ */
+export declare function selectorToPlaywrightCode(descriptor: SelectorDescriptor, baseVar?: string): string;
+/**
+ * Generate Playwright code for a click action
+ *
+ * @param selectorCode - Playwright locator code string
+ * @param clickType - Type of click action ('left', 'right', 'double', 'middle', 'hover')
+ * @returns Playwright code string for the click action
+ */
+export declare function generateClickCode(selectorCode: string, clickType: 'primary' | 'secondary' | 'tertiary' | 'double' | 'hover'): string;
+/**
+ * Generate Playwright code for a form action
+ *
+ * @param selectorCode - Playwright locator code string
+ * @param actionType - Type of form action
+ * @param value - Value to use for the action (if applicable)
+ * @returns Playwright code string for the form action
+ */
+export declare function generateFormCode(selectorCode: string, actionType: 'keypress' | 'type' | 'fill' | 'select' | 'uncheck' | 'check' | 'click' | 'setInputFiles' | 'clear', value?: string): string;
+/**
+ * Generate Playwright code for a navigation action
+ *
+ * @param actionType - Type of navigation action
+ * @param url - URL for navigate/openPage actions (optional)
+ * @param newWindow - If true, opens URL in a new browser window/tab (optional)
+ * @returns Playwright code string for the navigation action
+ */
+export declare function generateNavigationCode(actionType: 'openPage' | 'navigate' | 'closePage' | 'goBack' | 'goForward' | 'refresh', url?: string, newWindow?: boolean): string;
+//# sourceMappingURL=playwrightCodeGenerator.d.ts.map

package/dist/mimic/playwrightCodeGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwrightCodeGenerator.d.ts","sourceRoot":"","sources":["../../src/mimic/playwrightCodeGenerator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,kBAAkB,EAC9B,OAAO,GAAE,MAAe,GACvB,MAAM,CA6JR;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GACnE,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,eAAe,GAAG,OAAO,EAC/G,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAwBR;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,EACtF,GAAG,CAAC,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,OAAO,GAClB,MAAM,CA4BR"}

package/dist/mimic/playwrightCodeGenerator.js

@@ -0,0 +1,270 @@
+/**
+ * Playwright Code Generator
+ *
+ * Converts SelectorDescriptor and action information into equivalent Playwright code strings
+ * for test annotations and documentation purposes.
+ */
+import { jsonToStringOrRegex } from './selectorSerialization.js';
+/**
+ * Convert a SelectorDescriptor to a Playwright code string
+ *
+ * Generates the equivalent Playwright locator code that would be used to select
+ * the element described by the SelectorDescriptor.
+ *
+ * @param descriptor - SelectorDescriptor to convert
+ * @param baseVar - Base variable name to use (default: 'page')
+ * @returns Playwright code string representing the locator
+ *
+ * @example
+ * ```typescript
+ * const code = selectorToPlaywrightCode({
+ *   type: 'role',
+ *   role: 'button',
+ *   name: 'Submit'
+ * });
+ * // Returns: "page.getByRole('button', { name: 'Submit' })"
+ * ```
+ */
+export function selectorToPlaywrightCode(descriptor, baseVar = 'page') {
+    let code = baseVar;
+    // Build base locator code based on selector type
+    switch (descriptor.type) {
+        case 'testid':
+            code += `.getByTestId(${JSON.stringify(descriptor.value)})`;
+            break;
+        case 'role':
+            if (descriptor.name !== undefined) {
+                const nameValue = jsonToStringOrRegex(descriptor.name);
+                const isRegex = nameValue instanceof RegExp;
+                if (isRegex) {
+                    // For regex, show the pattern
+                    const pattern = nameValue.source;
+                    const flags = nameValue.flags;
+                    code += `.getByRole(${JSON.stringify(descriptor.role)}, { name: /${pattern}/${flags} })`;
+                }
+                else {
+                    // For string, include exact option if specified
+                    const options = [`name: ${JSON.stringify(nameValue)}`];
+                    if (descriptor.exact) {
+                        options.push('exact: true');
+                    }
+                    code += `.getByRole(${JSON.stringify(descriptor.role)}, { ${options.join(', ')} })`;
+                }
+            }
+            else {
+                code += `.getByRole(${JSON.stringify(descriptor.role)})`;
+            }
+            // Add .nth() if specified (for radio groups, checkbox groups, etc.)
+            if (descriptor.nth !== undefined) {
+                code += `.nth(${descriptor.nth})`;
+            }
+            break;
+        case 'label':
+            {
+                const labelValue = jsonToStringOrRegex(descriptor.value);
+                const isRegex = labelValue instanceof RegExp;
+                if (isRegex) {
+                    const pattern = labelValue.source;
+                    const flags = labelValue.flags;
+                    code += `.getByLabel(/${pattern}/${flags})`;
+                }
+                else {
+                    const options = [];
+                    if (descriptor.exact) {
+                        options.push('exact: true');
+                    }
+                    const optionsStr = options.length > 0 ? `, { ${options.join(', ')} }` : '';
+                    code += `.getByLabel(${JSON.stringify(labelValue)}${optionsStr})`;
+                }
+                // Add .nth() if specified
+                if (descriptor.nth !== undefined) {
+                    code += `.nth(${descriptor.nth})`;
+                }
+            }
+            break;
+        case 'placeholder':
+            {
+                const placeholderValue = jsonToStringOrRegex(descriptor.value);
+                const isRegex = placeholderValue instanceof RegExp;
+                if (isRegex) {
+                    const pattern = placeholderValue.source;
+                    const flags = placeholderValue.flags;
+                    code += `.getByPlaceholder(/${pattern}/${flags})`;
+                }
+                else {
+                    const options = [];
+                    if (descriptor.exact) {
+                        options.push('exact: true');
+                    }
+                    const optionsStr = options.length > 0 ? `, { ${options.join(', ')} }` : '';
+                    code += `.getByPlaceholder(${JSON.stringify(placeholderValue)}${optionsStr})`;
+                }
+            }
+            break;
+        case 'alt':
+            {
+                const altValue = jsonToStringOrRegex(descriptor.value);
+                const isRegex = altValue instanceof RegExp;
+                if (isRegex) {
+                    const pattern = altValue.source;
+                    const flags = altValue.flags;
+                    code += `.getByAltText(/${pattern}/${flags})`;
+                }
+                else {
+                    const options = [];
+                    if (descriptor.exact) {
+                        options.push('exact: true');
+                    }
+                    const optionsStr = options.length > 0 ? `, { ${options.join(', ')} }` : '';
+                    code += `.getByAltText(${JSON.stringify(altValue)}${optionsStr})`;
+                }
+            }
+            break;
+        case 'title':
+            {
+                const titleValue = jsonToStringOrRegex(descriptor.value);
+                const isRegex = titleValue instanceof RegExp;
+                if (isRegex) {
+                    const pattern = titleValue.source;
+                    const flags = titleValue.flags;
+                    code += `.getByTitle(/${pattern}/${flags})`;
+                }
+                else {
+                    const options = [];
+                    if (descriptor.exact) {
+                        options.push('exact: true');
+                    }
+                    const optionsStr = options.length > 0 ? `, { ${options.join(', ')} }` : '';
+                    code += `.getByTitle(${JSON.stringify(titleValue)}${optionsStr})`;
+                }
+            }
+            break;
+        case 'text':
+            {
+                const textValue = jsonToStringOrRegex(descriptor.value);
+                const isRegex = textValue instanceof RegExp;
+                if (isRegex) {
+                    const pattern = textValue.source;
+                    const flags = textValue.flags;
+                    code += `.getByText(/${pattern}/${flags})`;
+                }
+                else {
+                    const options = [];
+                    if (descriptor.exact) {
+                        options.push('exact: true');
+                    }
+                    const optionsStr = options.length > 0 ? `, { ${options.join(', ')} }` : '';
+                    code += `.getByText(${JSON.stringify(textValue)}${optionsStr})`;
+                }
+            }
+            break;
+        case 'css':
+            code += `.locator(${JSON.stringify(descriptor.selector)})`;
+            break;
+        default:
+            const _exhaustive = descriptor;
+            void _exhaustive;
+            throw new Error(`Unknown selector type: ${descriptor.type}`);
+    }
+    // Handle nested child selectors recursively
+    if (descriptor.child) {
+        // For nested selectors, chain the child selector
+        code = selectorToPlaywrightCode(descriptor.child, code);
+    }
+    return code;
+}
+/**
+ * Generate Playwright code for a click action
+ *
+ * @param selectorCode - Playwright locator code string
+ * @param clickType - Type of click action ('left', 'right', 'double', 'middle', 'hover')
+ * @returns Playwright code string for the click action
+ */
+export function generateClickCode(selectorCode, clickType) {
+    switch (clickType) {
+        case 'primary':
+            return `await ${selectorCode}.click();`;
+        case 'secondary':
+            return `await ${selectorCode}.click({ button: 'right' });`;
+        case 'double':
+            return `await ${selectorCode}.dblclick();`;
+        case 'tertiary':
+            return `await ${selectorCode}.click({ button: 'middle' });`;
+        case 'hover':
+            return `await ${selectorCode}.hover();`;
+        default:
+            throw new Error(`Unknown click type: ${clickType}`);
+    }
+}
+/**
+ * Generate Playwright code for a form action
+ *
+ * @param selectorCode - Playwright locator code string
+ * @param actionType - Type of form action
+ * @param value - Value to use for the action (if applicable)
+ * @returns Playwright code string for the form action
+ */
+export function generateFormCode(selectorCode, actionType, value) {
+    switch (actionType) {
+        case 'fill':
+            return `await ${selectorCode}.fill(${JSON.stringify(value || '')});`;
+        case 'type':
+            // Type action uses page.keyboard, not the element selector
+            return `await page.keyboard.type(${JSON.stringify(value || '')});`;
+        case 'select':
+            return `await ${selectorCode}.selectOption(${JSON.stringify(value || '')});`;
+        case 'check':
+            return `await ${selectorCode}.check();`;
+        case 'uncheck':
+            return `await ${selectorCode}.uncheck();`;
+        case 'click':
+            return `await ${selectorCode}.click();`;
+        case 'clear':
+            return `await ${selectorCode}.clear();`;
+        case 'setInputFiles':
+            return `await ${selectorCode}.setInputFiles(${JSON.stringify(value || '')});`;
+        case 'keypress':
+            return `await page.keyboard.press(${JSON.stringify(value || '')});`;
+        default:
+            throw new Error(`Unknown form action type: ${actionType}`);
+    }
+}
+/**
+ * Generate Playwright code for a navigation action
+ *
+ * @param actionType - Type of navigation action
+ * @param url - URL for navigate/openPage actions (optional)
+ * @param newWindow - If true, opens URL in a new browser window/tab (optional)
+ * @returns Playwright code string for the navigation action
+ */
+export function generateNavigationCode(actionType, url, newWindow) {
+    switch (actionType) {
+        case 'openPage':
+        case 'navigate':
+            if (newWindow) {
+                // Generate code for opening in a new window/tab
+                if (url) {
+                    return `const newPage = await page.context().newPage();\nawait newPage.goto(${JSON.stringify(url)}, { waitUntil: 'networkidle' });`;
+                }
+                return `const newPage = await page.context().newPage();\nawait newPage.goto(url, { waitUntil: 'networkidle' });`;
+            }
+            else {
+                // Generate code for normal navigation
+                if (url) {
+                    return `await page.goto(${JSON.stringify(url)}, { waitUntil: 'networkidle' });`;
+                }
+                return `await page.goto(url, { waitUntil: 'networkidle' });`;
+            }
+        case 'closePage':
+            return `await page.close();`;
+        case 'goBack':
+            return `await page.goBack();`;
+        case 'goForward':
+            return `await page.goForward();`;
+        case 'refresh':
+            return `await page.reload();`;
+        default:
+            throw new Error(`Unknown navigation action type: ${actionType}`);
+    }
+}
+//# sourceMappingURL=playwrightCodeGenerator.js.map

package/dist/mimic/playwrightCodeGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwrightCodeGenerator.js","sourceRoot":"","sources":["../../src/mimic/playwrightCodeGenerator.ts"],"names":[],"mappings":"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"}

package/dist/mimic/replay.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Snapshot Replay Module
+ *
+ * Replays test steps from a snapshot without using LLM calls.
+ * This provides fast, deterministic test execution for previously successful tests.
+ */
+import { Page, TestInfo } from '@playwright/test';
+import type { Snapshot } from './types.js';
+/**
+ * Replay a complete test from a snapshot
+ *
+ * Executes all steps in the snapshot without making LLM calls.
+ * This is much faster than normal execution since it skips AI analysis.
+ *
+ * @param page - Playwright Page object
+ * @param snapshot - Snapshot containing steps to replay
+ * @param testInfo - Playwright TestInfo for annotations (optional)
+ * @returns Promise that resolves when all steps are replayed
+ */
+export declare function replayFromSnapshot(page: Page, snapshot: Snapshot, testInfo?: TestInfo): Promise<void>;
+//# sourceMappingURL=replay.d.ts.map

package/dist/mimic/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/mimic/replay.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAQ,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAUzD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,EAClB,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/mimic/replay.js

@@ -0,0 +1,142 @@
+/**
+ * Snapshot Replay Module
+ *
+ * Replays test steps from a snapshot without using LLM calls.
+ * This provides fast, deterministic test execution for previously successful tests.
+ */
+import { test } from '@playwright/test';
+import { executeNavigationAction } from './navigation.js';
+import { executeClickAction } from './click.js';
+import { executeFormAction } from './forms.js';
+import { getMimic } from './markers.js';
+import { getFromSelector } from './selectorUtils.js';
+/**
+ * Replay a complete test from a snapshot
+ *
+ * Executes all steps in the snapshot without making LLM calls.
+ * This is much faster than normal execution since it skips AI analysis.
+ *
+ * @param page - Playwright Page object
+ * @param snapshot - Snapshot containing steps to replay
+ * @param testInfo - Playwright TestInfo for annotations (optional)
+ * @returns Promise that resolves when all steps are replayed
+ */
+export async function replayFromSnapshot(page, snapshot, testInfo) {
+    // Get steps array for replay (support both new and old format)
+    // New format: use steps array (which is built from stepsByHash for backward compatibility)
+    // Old format: use steps array directly
+    const stepsToReplay = snapshot.steps || [];
+    if (stepsToReplay.length === 0) {
+        console.warn('⚠️  Snapshot has no steps to replay');
+        return;
+    }
+    // Replay each step in order
+    for (const step of stepsToReplay) {
+        await test.step(step.stepText, async () => {
+            switch (step.actionKind) {
+                case 'navigation':
+                    await replayNavigationStep(page, step, testInfo);
+                    break;
+                case 'click':
+                    await replayClickStep(page, step, testInfo);
+                    break;
+                case 'form update':
+                    await replayFormStep(page, step, testInfo);
+                    break;
+                default:
+                    throw new Error(`Unknown action kind in snapshot: ${step.actionKind}`);
+            }
+        });
+    }
+}
+/**
+ * Replay a navigation step from snapshot
+ *
+ * @param page - Playwright Page object
+ * @param step - Snapshot step containing navigation action
+ * @param testInfo - Playwright TestInfo for annotations (optional)
+ * @returns Promise that resolves when navigation is complete
+ */
+async function replayNavigationStep(page, step, testInfo) {
+    const actionDetails = step.actionDetails;
+    await executeNavigationAction(page, actionDetails, testInfo, step.stepText);
+}
+/**
+ * Replay a click step from snapshot
+ *
+ * Reconstructs the locator from stored target element information.
+ *
+ * @param page - Playwright Page object
+ * @param step - Snapshot step containing click action
+ * @param testInfo - Playwright TestInfo for annotations (optional)
+ * @returns Promise that resolves when click is complete
+ */
+async function replayClickStep(page, step, testInfo) {
+    const actionDetails = step.actionDetails;
+    // Reconstruct the target element from snapshot using best selector
+    if (!step.targetElement || !step.targetElement.selector) {
+        throw new Error(`Snapshot step ${step.stepIndex} (click) is missing targetElement with selector`);
+    }
+    // Use the stored selector descriptor (primary) to reconstruct the locator
+    // Fall back to mimicId if selector fails
+    let element;
+    try {
+        element = getFromSelector(page, step.targetElement.selector);
+        // Verify the element exists
+        await element.waitFor({ timeout: 5000 });
+    }
+    catch (error) {
+        // Selector might be stale, fall back to marker ID
+        if (step.targetElement.mimicId !== undefined) {
+            console.warn(`Stored selector failed for step ${step.stepIndex}, using marker ID ${step.targetElement.mimicId}`);
+            element = getMimic(page, step.targetElement.mimicId);
+        }
+        else {
+            throw new Error(`Snapshot step ${step.stepIndex} (click) selector failed and no mimicId fallback available`);
+        }
+    }
+    // Find the selected candidate from the click action result
+    // The first candidate should be the one we used originally
+    const selectedCandidate = actionDetails.candidates[0];
+    if (!selectedCandidate) {
+        throw new Error(`Snapshot step ${step.stepIndex} (click) has no candidates in actionDetails`);
+    }
+    await executeClickAction(element, actionDetails, selectedCandidate, testInfo, step.stepText);
+}
+/**
+ * Replay a form step from snapshot
+ *
+ * Reconstructs the form element locator from stored target element information.
+ *
+ * @param page - Playwright Page object
+ * @param step - Snapshot step containing form action
+ * @param testInfo - Playwright TestInfo for annotations (optional)
+ * @returns Promise that resolves when form action is complete
+ */
+async function replayFormStep(page, step, testInfo) {
+    const actionDetails = step.actionDetails;
+    // Reconstruct the target element from snapshot using best selector
+    if (!step.targetElement || !step.targetElement.selector) {
+        throw new Error(`Snapshot step ${step.stepIndex} (form) is missing targetElement with selector`);
+    }
+    // Use the stored selector descriptor (primary) to reconstruct the locator
+    // Fall back to mimicId if selector fails
+    let element;
+    try {
+        element = getFromSelector(page, step.targetElement.selector);
+        // Verify the element exists
+        await element.waitFor({ timeout: 5000 });
+    }
+    catch (error) {
+        // Selector might be stale, fall back to marker ID
+        if (step.targetElement.mimicId !== undefined) {
+            console.warn(`Stored selector failed for step ${step.stepIndex}, using marker ID ${step.targetElement.mimicId}`);
+            element = getMimic(page, step.targetElement.mimicId);
+        }
+        else {
+            throw new Error(`Snapshot step ${step.stepIndex} (form) selector failed and no mimicId fallback available`);
+        }
+    }
+    await executeFormAction(page, actionDetails, element, testInfo, step.stepText);
+}
+//# sourceMappingURL=replay.js.map