@browserflow-ai/generator 0.0.6

package/dist/config-emit.d.ts

@@ -0,0 +1,41 @@
+/**
+ * config-emit.ts
+ * Generates playwright.config.ts content.
+ */
+import type { PlaywrightConfigOptions, GeneratedConfig } from '@browserflow-ai/core';
+/**
+ * Configuration for generating playwright.config.ts.
+ */
+export interface ConfigGeneratorOptions {
+    /** Base URL for tests */
+    baseUrl?: string;
+    /** Test directory */
+    testDir?: string;
+    /** Output directory for results */
+    outputDir?: string;
+    /** Playwright config options */
+    config?: PlaywrightConfigOptions;
+    /** Custom Handlebars template */
+    template?: string;
+}
+/**
+ * Generates a playwright.config.ts file.
+ */
+export declare function generatePlaywrightConfig(options?: ConfigGeneratorOptions): GeneratedConfig;
+/**
+ * Generates a minimal playwright.config.ts for a single browser.
+ */
+export declare function generateMinimalConfig(options: {
+    baseUrl?: string;
+    testDir?: string;
+    browser?: 'chromium' | 'firefox' | 'webkit';
+}): GeneratedConfig;
+/**
+ * Generates package.json scripts for running Playwright tests.
+ */
+export declare function generatePlaywrightScripts(): Record<string, string>;
+/**
+ * Generates the commands needed to set up Playwright in a project.
+ */
+export declare function generateSetupInstructions(): string;
+//# sourceMappingURL=config-emit.d.ts.map

package/dist/config-emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-emit.d.ts","sourceRoot":"","sources":["../src/config-emit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,uBAAuB,EAEvB,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAG9B;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAwFD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,sBAA2B,GACnC,eAAe,CA8CjB;AAiBD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC7C,GAAG,eAAe,CAmClB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQlE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAUlD"}

package/dist/config-emit.js

@@ -0,0 +1,191 @@
+/**
+ * config-emit.ts
+ * Generates playwright.config.ts content.
+ */
+import Handlebars from 'handlebars';
+/**
+ * Default playwright.config.ts template.
+ */
+const DEFAULT_CONFIG_TEMPLATE = `import { defineConfig, devices } from '@playwright/test';
+
+/**
+ * Playwright configuration for BrowserFlow-generated tests.
+ * Generated: {{generatedAt}}
+ */
+export default defineConfig({
+  testDir: '{{testDir}}',
+  {{#if outputDir}}
+  outputDir: '{{outputDir}}',
+  {{/if}}
+
+  /* Run tests in files in parallel */
+  fullyParallel: true,
+
+  /* Fail the build on CI if you accidentally left test.only in the source code */
+  forbidOnly: !!process.env.CI,
+
+  /* Retry on CI only */
+  retries: process.env.CI ? {{retries}} : 0,
+
+  /* Opt out of parallel tests on CI */
+  workers: process.env.CI ? 1 : {{workers}},
+
+  /* Reporter to use */
+  reporter: '{{reporter}}',
+
+  /* Shared settings for all the projects below */
+  use: {
+    {{#if baseUrl}}
+    /* Base URL to use in actions like \`await page.goto('/')\` */
+    baseURL: '{{baseUrl}}',
+    {{/if}}
+
+    /* Collect trace when retrying the failed test */
+    trace: 'on-first-retry',
+
+    /* Take screenshot on failure */
+    screenshot: 'only-on-failure',
+  },
+
+  /* Test timeout */
+  timeout: {{timeout}},
+
+  /* Configure projects for major browsers */
+  projects: [
+{{#each projects}}
+    {
+      name: '{{name}}',
+      use: {
+        ...devices['{{deviceName}}'],
+        {{#if viewport}}
+        viewport: { width: {{viewport.width}}, height: {{viewport.height}} },
+        {{/if}}
+      },
+    },
+{{/each}}
+  ],
+{{#if webServer}}
+
+  /* Run your local dev server before starting the tests */
+  webServer: {
+    command: '{{webServer.command}}',
+    url: '{{webServer.url}}',
+    reuseExistingServer: !process.env.CI,
+  },
+{{/if}}
+});
+`;
+/**
+ * Default browser projects configuration.
+ */
+const DEFAULT_PROJECTS = [
+    { name: 'chromium', deviceName: 'Desktop Chrome' },
+    { name: 'firefox', deviceName: 'Desktop Firefox' },
+    { name: 'webkit', deviceName: 'Desktop Safari' },
+];
+/**
+ * Generates a playwright.config.ts file.
+ */
+export function generatePlaywrightConfig(options = {}) {
+    const { baseUrl, testDir = './tests', outputDir, config = {}, template = DEFAULT_CONFIG_TEMPLATE, } = options;
+    const { timeout = 30000, retries = 2, workers = 4, reporter = 'html', projects, webServer, } = config;
+    // Build projects data
+    const projectsData = projects?.map((p) => ({
+        name: p.name,
+        deviceName: getDeviceName(p),
+        viewport: p.use.viewport,
+    })) ?? DEFAULT_PROJECTS;
+    // Compile template
+    const compiledTemplate = Handlebars.compile(template);
+    const content = compiledTemplate({
+        generatedAt: new Date().toISOString(),
+        testDir,
+        outputDir,
+        baseUrl,
+        timeout,
+        retries,
+        workers,
+        reporter,
+        projects: projectsData,
+        webServer,
+    });
+    return {
+        path: 'playwright.config.ts',
+        content,
+    };
+}
+/**
+ * Maps a PlaywrightProject to a Playwright device name.
+ */
+function getDeviceName(project) {
+    const browserName = project.use.browserName ?? 'chromium';
+    const deviceMap = {
+        chromium: 'Desktop Chrome',
+        firefox: 'Desktop Firefox',
+        webkit: 'Desktop Safari',
+    };
+    return deviceMap[browserName] ?? 'Desktop Chrome';
+}
+/**
+ * Generates a minimal playwright.config.ts for a single browser.
+ */
+export function generateMinimalConfig(options) {
+    const { baseUrl, testDir = './tests', browser = 'chromium' } = options;
+    const deviceName = {
+        chromium: 'Desktop Chrome',
+        firefox: 'Desktop Firefox',
+        webkit: 'Desktop Safari',
+    }[browser];
+    const content = `import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+  testDir: '${testDir}',
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 1 : undefined,
+  reporter: 'html',
+  use: {
+    ${baseUrl ? `baseURL: '${baseUrl}',` : ''}
+    trace: 'on-first-retry',
+  },
+  projects: [
+    {
+      name: '${browser}',
+      use: { ...devices['${deviceName}'] },
+    },
+  ],
+});
+`;
+    return {
+        path: 'playwright.config.ts',
+        content,
+    };
+}
+/**
+ * Generates package.json scripts for running Playwright tests.
+ */
+export function generatePlaywrightScripts() {
+    return {
+        'test:e2e': 'playwright test',
+        'test:e2e:headed': 'playwright test --headed',
+        'test:e2e:debug': 'playwright test --debug',
+        'test:e2e:ui': 'playwright test --ui',
+        'test:e2e:update-snapshots': 'playwright test --update-snapshots',
+    };
+}
+/**
+ * Generates the commands needed to set up Playwright in a project.
+ */
+export function generateSetupInstructions() {
+    return `# Install Playwright
+bun add -D @playwright/test
+
+# Install browsers
+bunx playwright install
+
+# Run tests
+bun run test:e2e
+`;
+}
+//# sourceMappingURL=config-emit.js.map

package/dist/config-emit.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @browserflow-ai/generator
+ *
+ * Playwright test generator for BrowserFlow.
+ * Converts exploration lockfiles into deterministic Playwright Test code.
+ */
+export { PlaywrightGenerator, generateTest } from './playwright-ts.js';
+export type { TestGeneratorOptions } from './playwright-ts.js';
+export { generateLocatorCode, resolveLocatorCode, escapeString, selectorToLocator, roleLocator, textLocator, testIdLocator, } from './locator-emit.js';
+export type { LocatorEmitOptions } from './locator-emit.js';
+export { generateScreenshotAssertion, generateElementScreenshotAssertion, generateScreenshotCapture, generateScreenshotCompare, generateVisualImports, generateWaitForAnimations, } from './visual-checks.js';
+export type { ScreenshotOptions, VisualCheckEmitOptions } from './visual-checks.js';
+export { generatePlaywrightConfig, generateMinimalConfig, generatePlaywrightScripts, generateSetupInstructions, } from './config-emit.js';
+export type { ConfigGeneratorOptions } from './config-emit.js';
+export type { ExplorationLockfile, ExplorationStep, GeneratorConfig, GeneratedTest, GeneratedConfig, LocatorObject, LocatorMethod, LocatorArgs, ReviewData, PlaywrightConfigOptions, PlaywrightProject, } from '@browserflow-ai/core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG/D,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EACL,2BAA2B,EAC3B,kCAAkC,EAClC,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGpF,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG/D,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,EACb,aAAa,EACb,WAAW,EACX,UAAU,EACV,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @browserflow-ai/generator
+ *
+ * Playwright test generator for BrowserFlow.
+ * Converts exploration lockfiles into deterministic Playwright Test code.
+ */
+// Main generator class
+export { PlaywrightGenerator, generateTest } from './playwright-ts.js';
+// Locator code generation
+export { generateLocatorCode, resolveLocatorCode, escapeString, selectorToLocator, roleLocator, textLocator, testIdLocator, } from './locator-emit.js';
+// Visual check code generation
+export { generateScreenshotAssertion, generateElementScreenshotAssertion, generateScreenshotCapture, generateScreenshotCompare, generateVisualImports, generateWaitForAnimations, } from './visual-checks.js';
+// Config generation
+export { generatePlaywrightConfig, generateMinimalConfig, generatePlaywrightScripts, generateSetupInstructions, } from './config-emit.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uBAAuB;AACvB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvE,0BAA0B;AAC1B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,+BAA+B;AAC/B,OAAO,EACL,2BAA2B,EAC3B,kCAAkC,EAClC,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAG5B,oBAAoB;AACpB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC"}

package/dist/locator-emit.d.ts

@@ -0,0 +1,76 @@
+/**
+ * locator-emit.ts
+ * Converts LocatorObject instances to Playwright locator code strings.
+ */
+import type { LegacyLocatorObject } from '@browserflow-ai/core';
+type LocatorObject = LegacyLocatorObject;
+/**
+ * Options for code generation.
+ */
+export interface LocatorEmitOptions {
+    /** Variable name for the page object (default: "page") */
+    pageVar?: string;
+    /** Whether to chain .first() for potentially multiple matches */
+    chainFirst?: boolean;
+    /**
+     * Index-based selection for multiple matches:
+     * - 0: .first()
+     * - -1: .last()
+     * - other: .nth(n)
+     * Takes precedence over chainFirst when specified.
+     */
+    nth?: number;
+    /**
+     * Parent locator for scoping. The generated code will be
+     * chained from this parent locator.
+     * Example: within: { method: 'getByTestId', args: { testId: 'form' } }
+     * Results in: page.getByTestId('form').getByRole('button')
+     */
+    within?: LocatorObject;
+}
+/**
+ * Escapes a string for use in generated TypeScript code.
+ */
+export declare function escapeString(str: string): string;
+/**
+ * Generates Playwright locator code from a LocatorObject.
+ *
+ * @example
+ * // getByRole example
+ * generateLocatorCode({ method: 'getByRole', args: { role: 'button', name: 'Submit' } })
+ * // Returns: "page.getByRole('button', { name: 'Submit' })"
+ *
+ * @example
+ * // CSS selector example
+ * generateLocatorCode({ selector: 'button.primary' })
+ * // Returns: "page.locator('button.primary')"
+ */
+export declare function generateLocatorCode(locator: LocatorObject, options?: LocatorEmitOptions): string;
+/**
+ * Creates a LocatorObject from a CSS selector string.
+ */
+export declare function selectorToLocator(selector: string): LocatorObject;
+/**
+ * Creates a LocatorObject for getByRole.
+ */
+export declare function roleLocator(role: string, options?: {
+    name?: string;
+    exact?: boolean;
+}): LocatorObject;
+/**
+ * Creates a LocatorObject for getByText.
+ */
+export declare function textLocator(text: string, options?: {
+    exact?: boolean;
+}): LocatorObject;
+/**
+ * Creates a LocatorObject for getByTestId.
+ */
+export declare function testIdLocator(testId: string): LocatorObject;
+/**
+ * Resolves the best locator code from an exploration step.
+ * Prefers method-based locators over CSS selectors.
+ */
+export declare function resolveLocatorCode(locator: LocatorObject | undefined, fallbackSelector: string | undefined, options?: LocatorEmitOptions): string;
+export {};
+//# sourceMappingURL=locator-emit.d.ts.map

package/dist/locator-emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator-emit.d.ts","sourceRoot":"","sources":["../src/locator-emit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,sBAAsB,CAAC;AAG/E,KAAK,aAAa,GAAG,mBAAmB,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhD;AAqBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAsCR;AA4HD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAEjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3C,aAAa,CAKf;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,aAAa,CAKf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAK3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAcR"}

package/dist/locator-emit.js

@@ -0,0 +1,239 @@
+/**
+ * locator-emit.ts
+ * Converts LocatorObject instances to Playwright locator code strings.
+ */
+/**
+ * Escapes a string for use in generated TypeScript code.
+ */
+export function escapeString(str) {
+    return str
+        .replace(/\\/g, '\\\\')
+        .replace(/'/g, "\\'")
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t');
+}
+/**
+ * Formats a value as a TypeScript literal.
+ */
+function formatValue(value) {
+    if (typeof value === 'string') {
+        return `'${escapeString(value)}'`;
+    }
+    if (value instanceof RegExp) {
+        return value.toString();
+    }
+    if (typeof value === 'boolean' || typeof value === 'number') {
+        return String(value);
+    }
+    if (value === null || value === undefined) {
+        return 'undefined';
+    }
+    return JSON.stringify(value);
+}
+/**
+ * Generates Playwright locator code from a LocatorObject.
+ *
+ * @example
+ * // getByRole example
+ * generateLocatorCode({ method: 'getByRole', args: { role: 'button', name: 'Submit' } })
+ * // Returns: "page.getByRole('button', { name: 'Submit' })"
+ *
+ * @example
+ * // CSS selector example
+ * generateLocatorCode({ selector: 'button.primary' })
+ * // Returns: "page.locator('button.primary')"
+ */
+export function generateLocatorCode(locator, options = {}) {
+    const { pageVar = 'page', chainFirst = false, nth, within } = options;
+    // Start with the base variable or parent locator chain
+    let baseVar = pageVar;
+    if (within) {
+        // Generate code for the parent locator (without page var suffix methods)
+        baseVar = generateLocatorCode(within, { pageVar });
+    }
+    let code;
+    if (locator.method && locator.args) {
+        code = generateMethodLocator(locator.method, locator.args, baseVar);
+    }
+    else if (locator.selector) {
+        code = `${baseVar}.locator('${escapeString(locator.selector)}')`;
+    }
+    else if (locator.ref) {
+        // Element refs need to be resolved - use a placeholder selector
+        // In practice, the exploration should have resolved this to a selector
+        code = `${baseVar}.locator('[data-ref="${escapeString(locator.ref)}"]')`;
+    }
+    else {
+        throw new Error('LocatorObject must have either method+args, selector, or ref');
+    }
+    // Apply nth handling - takes precedence over chainFirst
+    if (nth !== undefined) {
+        if (nth === 0) {
+            code += '.first()';
+        }
+        else if (nth === -1) {
+            code += '.last()';
+        }
+        else {
+            code += `.nth(${nth})`;
+        }
+    }
+    else if (chainFirst) {
+        code += '.first()';
+    }
+    return code;
+}
+/**
+ * Generates code for Playwright locator methods (getByRole, getByText, etc.)
+ */
+function generateMethodLocator(method, args, pageVar) {
+    switch (method) {
+        case 'getByRole': {
+            const { role, ...options } = args;
+            if (!role) {
+                throw new Error('getByRole requires a role argument');
+            }
+            const escapedRole = escapeString(String(role));
+            const optionsStr = formatOptions(options);
+            if (optionsStr) {
+                return `${pageVar}.getByRole('${escapedRole}', ${optionsStr})`;
+            }
+            return `${pageVar}.getByRole('${escapedRole}')`;
+        }
+        case 'getByText': {
+            const { text, exact } = args;
+            if (text === undefined) {
+                throw new Error('getByText requires a text argument');
+            }
+            const textValue = formatValue(text);
+            if (exact !== undefined) {
+                return `${pageVar}.getByText(${textValue}, { exact: ${exact} })`;
+            }
+            return `${pageVar}.getByText(${textValue})`;
+        }
+        case 'getByLabel': {
+            const { text, exact } = args;
+            if (text === undefined) {
+                throw new Error('getByLabel requires a text argument');
+            }
+            const textValue = formatValue(text);
+            if (exact !== undefined) {
+                return `${pageVar}.getByLabel(${textValue}, { exact: ${exact} })`;
+            }
+            return `${pageVar}.getByLabel(${textValue})`;
+        }
+        case 'getByPlaceholder': {
+            const { text, exact } = args;
+            if (text === undefined) {
+                throw new Error('getByPlaceholder requires a text argument');
+            }
+            const textValue = formatValue(text);
+            if (exact !== undefined) {
+                return `${pageVar}.getByPlaceholder(${textValue}, { exact: ${exact} })`;
+            }
+            return `${pageVar}.getByPlaceholder(${textValue})`;
+        }
+        case 'getByTestId': {
+            const { testId } = args;
+            if (testId === undefined) {
+                throw new Error('getByTestId requires a testId argument');
+            }
+            return `${pageVar}.getByTestId('${escapeString(String(testId))}')`;
+        }
+        case 'getByAltText': {
+            const { text, exact } = args;
+            if (text === undefined) {
+                throw new Error('getByAltText requires a text argument');
+            }
+            const textValue = formatValue(text);
+            if (exact !== undefined) {
+                return `${pageVar}.getByAltText(${textValue}, { exact: ${exact} })`;
+            }
+            return `${pageVar}.getByAltText(${textValue})`;
+        }
+        case 'getByTitle': {
+            const { text, exact } = args;
+            if (text === undefined) {
+                throw new Error('getByTitle requires a text argument');
+            }
+            const textValue = formatValue(text);
+            if (exact !== undefined) {
+                return `${pageVar}.getByTitle(${textValue}, { exact: ${exact} })`;
+            }
+            return `${pageVar}.getByTitle(${textValue})`;
+        }
+        case 'locator': {
+            const { selector } = args;
+            if (selector === undefined) {
+                throw new Error('locator requires a selector argument');
+            }
+            return `${pageVar}.locator('${escapeString(String(selector))}')`;
+        }
+        default:
+            throw new Error(`Unknown locator method: ${method}`);
+    }
+}
+/**
+ * Formats an options object for code generation.
+ */
+function formatOptions(options) {
+    const entries = Object.entries(options).filter(([_, v]) => v !== undefined && v !== null);
+    if (entries.length === 0) {
+        return '';
+    }
+    const parts = entries.map(([key, value]) => {
+        return `${key}: ${formatValue(value)}`;
+    });
+    return `{ ${parts.join(', ')} }`;
+}
+/**
+ * Creates a LocatorObject from a CSS selector string.
+ */
+export function selectorToLocator(selector) {
+    return { selector };
+}
+/**
+ * Creates a LocatorObject for getByRole.
+ */
+export function roleLocator(role, options) {
+    return {
+        method: 'getByRole',
+        args: { role, ...options },
+    };
+}
+/**
+ * Creates a LocatorObject for getByText.
+ */
+export function textLocator(text, options) {
+    return {
+        method: 'getByText',
+        args: { text, ...options },
+    };
+}
+/**
+ * Creates a LocatorObject for getByTestId.
+ */
+export function testIdLocator(testId) {
+    return {
+        method: 'getByTestId',
+        args: { testId },
+    };
+}
+/**
+ * Resolves the best locator code from an exploration step.
+ * Prefers method-based locators over CSS selectors.
+ */
+export function resolveLocatorCode(locator, fallbackSelector, options = {}) {
+    if (locator?.method && locator.args) {
+        return generateLocatorCode(locator, options);
+    }
+    if (locator?.selector) {
+        return generateLocatorCode(locator, options);
+    }
+    if (fallbackSelector) {
+        return generateLocatorCode({ selector: fallbackSelector }, options);
+    }
+    throw new Error('No locator or selector available');
+}
+//# sourceMappingURL=locator-emit.js.map

package/dist/locator-emit.js.map

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

package/dist/locator-emit.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * locator-emit.test.ts
+ * Tests for the locator-to-code conversion module.
+ */
+export {};
+//# sourceMappingURL=locator-emit.test.d.ts.map

package/dist/locator-emit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator-emit.test.d.ts","sourceRoot":"","sources":["../src/locator-emit.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}