@tayo-dev/rtl 1.0.0

package/dist/analyzer/mocks/target-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-analyzer.d.ts","sourceRoot":"","sources":["../../../src/analyzer/mocks/target-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,WAAW,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5E,6DAA6D;IAC7D,wBAAwB,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5D,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,IAAI,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrE,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,qCAAqC;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,WAAW,EAAE,CA8Df;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,GACzC,WAAW,EAAE,CAyDf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EACpB,kBAAkB,EAAE,WAAW,EAAE,EACjC,MAAM,CAAC,EAAE,wBAAwB,GAChC,WAAW,CAAC,MAAM,CAAC,CAwCrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,MAAM,EAAE,GACtB,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAoBnC;AA0BD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,MAAoB,GAAG,MAAM,CAiB/F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpD,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC,GACA,UAAU,EAAE,CAoDd;AAiCD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,UAAU,EAAE,GACpB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAU3B"}

package/dist/analyzer/mocks/target-analyzer.js

@@ -0,0 +1,305 @@
+/**
+ * Mock Target Analyzer - Identifies appropriate mock targets from codebase
+ *
+ * Analyzes the codebase to determine which mock libraries are available
+ * (msw, jest.fn, sinon) and suggests appropriate mock targets based
+ * on the detected API calls.
+ */
+/**
+ * Detect available mock libraries from package.json dependencies
+ */
+export function detectMockLibraries(packageJson) {
+    const libraries = [];
+    const deps = {
+        ...(packageJson.dependencies || {}),
+        ...(packageJson.devDependencies || {}),
+    };
+    // Detect MSW (Mock Service Worker)
+    if (deps['msw'] || deps['@mswjs/msw']) {
+        libraries.push({
+            name: 'msw',
+            version: deps['msw'] || deps['@mswjs/msw'],
+            isConfigured: false, // Would need to check for handlers setup
+        });
+    }
+    // Jest is always available in Jest projects
+    if (deps['jest']) {
+        libraries.push({
+            name: 'jest.fn',
+            version: deps['jest'],
+            isConfigured: true,
+        });
+    }
+    // Sinon
+    if (deps['sinon']) {
+        libraries.push({
+            name: 'sinon',
+            version: deps['sinon'],
+            isConfigured: false,
+        });
+    }
+    // fetch-mock
+    if (deps['fetch-mock']) {
+        libraries.push({
+            name: 'fetch-mock',
+            version: deps['fetch-mock'],
+            isConfigured: false,
+        });
+    }
+    // undici (Node.js fetch polyfill with mocking support)
+    if (deps['undici']) {
+        libraries.push({
+            name: 'undici',
+            version: deps['undici'],
+            isConfigured: false,
+        });
+    }
+    // nock
+    if (deps['nock']) {
+        libraries.push({
+            name: 'nock',
+            version: deps['nock'],
+            isConfigured: false,
+        });
+    }
+    return libraries;
+}
+/**
+ * Analyze code files to see which mock libraries are actually used
+ */
+export function analyzeMockLibraryUsage(files) {
+    const detected = [];
+    const seen = new Set();
+    for (const file of files) {
+        const content = file.content;
+        // Check for MSW usage
+        if (content.includes('setupWorker') || content.includes('setupMSW') || content.includes('http.get') && content.includes('msw/')) {
+            if (!seen.has('msw')) {
+                detected.push({ name: 'msw', isConfigured: true, sourceFile: file.path });
+                seen.add('msw');
+            }
+        }
+        // Check for jest.fn() usage
+        if (content.includes('jest.fn()') || content.includes('jest.mock(') || content.includes('vi.fn()')) {
+            if (!seen.has('jest.fn')) {
+                detected.push({ name: 'jest.fn', isConfigured: true, sourceFile: file.path });
+                seen.add('jest.fn');
+            }
+        }
+        // Check for sinon usage
+        if (content.includes('sinon.stub') || content.includes('sinon.spy') || content.includes('sinon.mock')) {
+            if (!seen.has('sinon')) {
+                detected.push({ name: 'sinon', isConfigured: true, sourceFile: file.path });
+                seen.add('sinon');
+            }
+        }
+        // Check for fetch-mock
+        if (content.includes('fetchMock') || content.includes('fetch-mock')) {
+            if (!seen.has('fetch-mock')) {
+                detected.push({ name: 'fetch-mock', isConfigured: true, sourceFile: file.path });
+                seen.add('fetch-mock');
+            }
+        }
+        // Check for undici
+        if (content.includes('MockAgent') && content.includes('undici')) {
+            if (!seen.has('undici')) {
+                detected.push({ name: 'undici', isConfigured: true, sourceFile: file.path });
+                seen.add('undici');
+            }
+        }
+        // Check for nock
+        if (content.includes('nock(') || content.includes('nock.recorder')) {
+            if (!seen.has('nock')) {
+                detected.push({ name: 'nock', isConfigured: true, sourceFile: file.path });
+                seen.add('nock');
+            }
+        }
+    }
+    return detected;
+}
+/**
+ * Determine the best mock library for a given API call
+ */
+export function selectMockLibrary(apiCall, availableLibraries, config) {
+    // If preferred library is available, use it
+    if (config?.preferredLibrary) {
+        const preferred = availableLibraries.find(l => l.name === config.preferredLibrary);
+        if (preferred) {
+            return preferred.name;
+        }
+    }
+    // For external APIs, prefer MSW or fetch-mock for HTTP mocking
+    if (apiCall.method === 'fetch' || apiCall.method === 'axios') {
+        // Prefer MSW for REST APIs
+        if (availableLibraries.find(l => l.name === 'msw')) {
+            return 'msw';
+        }
+        // Fall back to fetch-mock
+        if (availableLibraries.find(l => l.name === 'fetch-mock')) {
+            return 'fetch-mock';
+        }
+        // Fall back to nock
+        if (availableLibraries.find(l => l.name === 'nock')) {
+            return 'nock';
+        }
+    }
+    // For XMLHttpRequest, prefer sinon or jest.fn
+    if (apiCall.method === 'XMLHttpRequest') {
+        if (availableLibraries.find(l => l.name === 'sinon')) {
+            return 'sinon';
+        }
+        return 'jest.fn';
+    }
+    // Default to jest.fn if nothing else available
+    if (availableLibraries.find(l => l.name === 'jest.fn')) {
+        return 'jest.fn';
+    }
+    // Fallback
+    return 'jest.fn';
+}
+/**
+ * Decide whether to inline or extract a mock
+ */
+export function decideMockExtraction(apiCall, existingMocks) {
+    // Check if there's already a mock for this URL
+    const hasExistingMock = existingMocks.some(mock => mock.includes(apiCall.url || ''));
+    if (hasExistingMock) {
+        return 'shared';
+    }
+    // External APIs should typically be extracted
+    if (apiCall.isExternal) {
+        return 'extracted';
+    }
+    // Complex responses should be extracted
+    const complexity = estimateMockComplexity(apiCall);
+    if (complexity > 10) {
+        return 'extracted';
+    }
+    // Default to inline for simple cases
+    return 'inline';
+}
+/**
+ * Estimate the complexity of a mock (lines of code)
+ */
+function estimateMockComplexity(apiCall) {
+    let complexity = 1;
+    // URL parameters increase complexity
+    if (apiCall.url?.includes('?')) {
+        complexity += 2;
+    }
+    // POST/PUT/PATCH methods typically have request bodies
+    if (apiCall.httpMethod === 'POST' || apiCall.httpMethod === 'PUT' || apiCall.httpMethod === 'PATCH') {
+        complexity += 3;
+    }
+    // External APIs might need more sophisticated mocking
+    if (apiCall.isExternal) {
+        complexity += 2;
+    }
+    return complexity;
+}
+/**
+ * Generate suggested file path for extracted mock
+ */
+export function suggestMockFilePath(apiCall, baseDir = '__mocks__') {
+    if (!apiCall.url) {
+        return `${baseDir}/api-mock.ts`;
+    }
+    try {
+        const url = new URL(apiCall.url);
+        const pathParts = url.pathname.split('/').filter(Boolean);
+        // Clean up path parts for file names
+        const fileName = pathParts.join('-') || 'index';
+        const cleanFileName = fileName.replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase();
+        return `${baseDir}/${url.hostname}/${cleanFileName}.ts`;
+    }
+    catch {
+        return `${baseDir}/api-mock.ts`;
+    }
+}
+/**
+ * Main function to analyze mock targets
+ */
+export function analyzeMockTargets(apiCalls, options) {
+    const targets = [];
+    // Detect available mock libraries
+    let availableLibraries = [];
+    if (options?.packageJson) {
+        availableLibraries = detectMockLibraries(options.packageJson);
+    }
+    if (options?.codebaseFiles) {
+        const usedLibraries = analyzeMockLibraryUsage(options.codebaseFiles);
+        // Merge with package.json detections, preferring configured ones
+        for (const lib of usedLibraries) {
+            const existing = availableLibraries.find(l => l.name === lib.name);
+            if (!existing) {
+                availableLibraries.push(lib);
+            }
+            else {
+                existing.isConfigured = lib.isConfigured || existing.isConfigured;
+            }
+        }
+    }
+    // If no libraries detected, default to jest.fn
+    if (availableLibraries.length === 0) {
+        availableLibraries.push({ name: 'jest.fn', isConfigured: true });
+    }
+    // Get existing mock files (simple heuristic)
+    const existingMocks = options?.codebaseFiles
+        ?.filter(f => f.path.includes('__mocks__') || f.path.includes('.mock.'))
+        .map(f => f.path) || [];
+    // Analyze each API call
+    for (const apiCall of apiCalls) {
+        const mockLibrary = selectMockLibrary(apiCall, availableLibraries, options?.config);
+        const extraction = decideMockExtraction(apiCall, existingMocks);
+        const suggestedPath = extraction !== 'inline' ? suggestMockFilePath(apiCall) : undefined;
+        targets.push({
+            id: `mock-target-${apiCall.id}`,
+            apiCallId: apiCall.id,
+            url: apiCall.url || 'unknown',
+            method: apiCall.httpMethod || 'GET',
+            mockLibrary,
+            extractionRecommendation: extraction,
+            rationale: buildRationale(apiCall, mockLibrary, extraction, availableLibraries),
+            suggestedFilePath: suggestedPath,
+        });
+    }
+    return targets;
+}
+/**
+ * Build a rationale string for the mock decision
+ */
+function buildRationale(apiCall, library, extraction, availableLibraries) {
+    const parts = [];
+    // Library choice rationale
+    const libInfo = availableLibraries.find(l => l.name === library);
+    if (libInfo?.isConfigured) {
+        parts.push(`Using ${library} (already configured in project)`);
+    }
+    else {
+        parts.push(`Using ${library} (detected in dependencies)`);
+    }
+    // Extraction rationale
+    if (extraction === 'inline') {
+        parts.push('inline for simplicity (simple mock)');
+    }
+    else if (extraction === 'extracted') {
+        parts.push('extracted to separate file (complex/external API)');
+    }
+    else {
+        parts.push('reusing existing mock (shared)');
+    }
+    return parts.join('. ');
+}
+/**
+ * Group mock targets by recommended approach
+ */
+export function groupMockTargetsByApproach(targets) {
+    const groups = new Map();
+    for (const target of targets) {
+        const key = `${target.mockLibrary}:${target.extractionRecommendation}`;
+        const existing = groups.get(key) || [];
+        groups.set(key, [...existing, target]);
+    }
+    return groups;
+}
+//# sourceMappingURL=target-analyzer.js.map

package/dist/analyzer/mocks/target-analyzer.js.map

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

package/dist/analyzer/visual/element-analyzer.d.ts

@@ -0,0 +1,44 @@
+import { Page } from 'playwright';
+/**
+ * Query strategy for Testing Library
+ */
+export interface QueryStrategy {
+    method: string;
+    args: (string | RegExp | {
+        name?: string;
+        exact?: boolean;
+    })[];
+    priority: number;
+}
+/**
+ * Accessibility properties extracted from an element
+ */
+export interface AccessibilityProperties {
+    preferredQuery: QueryStrategy;
+    alternatives: QueryStrategy[];
+    hasAccessibleName: boolean;
+    isInteractive: boolean;
+}
+/**
+ * Analyzes an element's accessibility properties and suggests optimal Testing Library queries
+ * @param page - The Playwright page object
+ * @param selector - CSS selector for the element
+ * @returns Promise<AccessibilityProperties> - Analysis results with ranked query strategies
+ */
+export declare function analyzeElementProperties(page: Page, selector: string): Promise<AccessibilityProperties | null>;
+/**
+ * Gets all interactive elements on the page with their query strategies
+ * @param page - The Playwright page object
+ * @returns Promise<Array<{ selector: string; properties: AccessibilityProperties }>>
+ */
+export declare function analyzePageElements(page: Page): Promise<Array<{
+    selector: string;
+    properties: AccessibilityProperties;
+}>>;
+/**
+ * Recommends the best query method for a given element
+ * @param properties - The accessibility properties
+ * @returns string - Recommended query method
+ */
+export declare function recommendQueryMethod(properties: AccessibilityProperties): string;
+//# sourceMappingURL=element-analyzer.d.ts.map

package/dist/analyzer/visual/element-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-analyzer.d.ts","sourceRoot":"","sources":["../../../src/analyzer/visual/element-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGlC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,EAAE,CAAC;IAC/D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,aAAa,CAAC;IAC9B,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAgIzC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,uBAAuB,CAAA;CAAE,CAAC,CAAC,CAkC3E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,uBAAuB,GAAG,MAAM,CAkBhF"}

package/dist/analyzer/visual/element-analyzer.js

@@ -0,0 +1,176 @@
+import { inspectElement } from './inspector.js';
+/**
+ * Analyzes an element's accessibility properties and suggests optimal Testing Library queries
+ * @param page - The Playwright page object
+ * @param selector - CSS selector for the element
+ * @returns Promise<AccessibilityProperties> - Analysis results with ranked query strategies
+ */
+export async function analyzeElementProperties(page, selector) {
+    const elementInfo = await inspectElement(page, selector);
+    if (!elementInfo) {
+        return null;
+    }
+    const strategies = [];
+    const tagName = elementInfo.tagName.toLowerCase();
+    // Determine if element is interactive
+    const interactiveRoles = [
+        'button', 'link', 'menuitem', 'checkbox', 'radio', 'switch',
+        'textbox', 'searchbox', 'combobox', 'slider', 'spinbutton'
+    ];
+    const isInteractive = interactiveRoles.includes(elementInfo.ariaRole || '') ||
+        ['button', 'a', 'input', 'select', 'textarea'].includes(tagName);
+    // 1. getByRole + name (most robust)
+    if (elementInfo.ariaRole && elementInfo.textContent) {
+        strategies.push({
+            method: 'getByRole',
+            args: [elementInfo.ariaRole, { name: elementInfo.textContent }],
+            priority: 1,
+        });
+    }
+    // 2. getByLabelText (form fields)
+    const labelFor = await page.$eval(selector, (el) => {
+        const htmlEl = el;
+        if (htmlEl.id) {
+            const label = document.querySelector(`label[for="${htmlEl.id}"]`);
+            return label?.textContent?.trim() || null;
+        }
+        // Check parent label
+        const parentLabel = htmlEl.closest('label');
+        return parentLabel?.textContent?.trim() || null;
+    }).catch(() => null);
+    if (labelFor) {
+        strategies.push({
+            method: 'getByLabelText',
+            args: [labelFor],
+            priority: 2,
+        });
+    }
+    // Also check for aria-label
+    if (elementInfo.ariaLabel) {
+        strategies.push({
+            method: 'getByLabelText',
+            args: [elementInfo.ariaLabel],
+            priority: 2,
+        });
+    }
+    // 3. getByPlaceholderText
+    const placeholder = await page.$eval(selector, (el) => {
+        return el.placeholder || '';
+    }).catch(() => '');
+    if (placeholder) {
+        strategies.push({
+            method: 'getByPlaceholderText',
+            args: [placeholder, { exact: true }],
+            priority: 3,
+        });
+    }
+    // 4. getByAltText (images)
+    if (tagName === 'img') {
+        const altText = await page.$eval(selector, (el) => {
+            return el.alt || '';
+        }).catch(() => '');
+        if (altText) {
+            strategies.push({
+                method: 'getByAltText',
+                args: [altText],
+                priority: 4,
+            });
+        }
+    }
+    // 5. getByTestId (if data-testid present)
+    const testId = await page.$eval(selector, (el) => {
+        return el.getAttribute('data-testid') || el.getAttribute('data-test-id') || '';
+    }).catch(() => '');
+    if (testId) {
+        strategies.push({
+            method: 'getByTestId',
+            args: [testId],
+            priority: 5,
+        });
+    }
+    // 6. getByText (last resort)
+    if (elementInfo.textContent) {
+        strategies.push({
+            method: 'getByText',
+            args: [elementInfo.textContent, { exact: true }],
+            priority: 6,
+        });
+    }
+    // Sort by priority
+    strategies.sort((a, b) => a.priority - b.priority);
+    // Check if element has accessible name
+    const hasAccessibleName = !!(elementInfo.ariaLabel ||
+        elementInfo.textContent ||
+        labelFor ||
+        placeholder ||
+        testId);
+    return {
+        preferredQuery: strategies[0] || {
+            method: 'getByRole',
+            args: ['generic'],
+            priority: 99,
+        },
+        alternatives: strategies.slice(1),
+        hasAccessibleName,
+        isInteractive,
+    };
+}
+/**
+ * Gets all interactive elements on the page with their query strategies
+ * @param page - The Playwright page object
+ * @returns Promise<Array<{ selector: string; properties: AccessibilityProperties }>>
+ */
+export async function analyzePageElements(page) {
+    const results = [];
+    // Find common interactive element selectors
+    const selectors = [
+        'button', 'a', 'input', 'select', 'textarea',
+        '[role="button"]', '[role="link"]', '[role="checkbox"]',
+        '[role="radio"]', '[role="textbox"]'
+    ];
+    for (const sel of selectors) {
+        const elements = await page.$$(sel);
+        for (const element of elements) {
+            const selector = await element.evaluate((el) => {
+                // Generate a unique selector
+                if (el.id)
+                    return `#${el.id}`;
+                if (el.getAttribute('data-testid'))
+                    return `[data-testid="${el.getAttribute('data-testid')}"]`;
+                if (el.className && typeof el.className === 'object' && 'baseVal' in el.className) {
+                    return el.tagName.toLowerCase();
+                }
+                const classList = el.classList ? Array.from(el.classList) : [];
+                const classes = classList.filter((c) => !c.includes('Mui')).join('.');
+                return classes ? `${el.tagName.toLowerCase()}.${classes}` : el.tagName.toLowerCase();
+            });
+            const properties = await analyzeElementProperties(page, sel);
+            if (properties) {
+                results.push({ selector, properties });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Recommends the best query method for a given element
+ * @param properties - The accessibility properties
+ * @returns string - Recommended query method
+ */
+export function recommendQueryMethod(properties) {
+    const { preferredQuery } = properties;
+    if (preferredQuery.priority === 99) {
+        return `// Warning: No good query strategy found. Consider adding data-testid or aria-label.`;
+    }
+    let queryString = preferredQuery.method;
+    if (preferredQuery.args.length > 0) {
+        const args = preferredQuery.args.map(arg => {
+            if (arg instanceof RegExp)
+                return `/${arg.source}/${arg.flags}`;
+            return typeof arg === 'string' ? `"${arg}"` : JSON.stringify(arg);
+        }).join(', ');
+        queryString += `(${args})`;
+    }
+    return queryString;
+}
+//# sourceMappingURL=element-analyzer.js.map

package/dist/analyzer/visual/element-analyzer.js.map

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

package/dist/analyzer/visual/inspector.d.ts

@@ -0,0 +1,49 @@
+import { Browser, Page } from 'playwright';
+/**
+ * Element information extracted from the DOM
+ */
+export interface ElementInfo {
+    tagName: string;
+    textContent: string;
+    ariaRole?: string;
+    ariaLabel?: string;
+    nameAttr?: string;
+    id: string;
+    classes: string[];
+    isVisible: boolean;
+    isDisabled: boolean;
+}
+/**
+ * Launches a headless Chromium browser
+ * @returns Promise<Browser> - The launched browser instance
+ * @throws Error if Playwright is not installed
+ */
+export declare function launchBrowser(): Promise<Browser>;
+/**
+ * Captures a screenshot of the current page
+ * @param page - The Playwright page object
+ * @param path - The file path to save the screenshot
+ */
+export declare function captureScreenshot(page: Page, path: string): Promise<void>;
+/**
+ * Inspects an element by selector and extracts accessibility properties
+ * @param page - The Playwright page object
+ * @param selector - CSS selector for the element
+ * @returns Promise<ElementInfo | null> - Element info or null if not found
+ */
+export declare function inspectElement(page: Page, selector: string): Promise<ElementInfo | null>;
+/**
+ * Navigates to a URL with timeout handling
+ * @param page - The Playwright page object
+ * @param url - The URL to navigate to
+ * @param timeout - Timeout in milliseconds (default 30000)
+ * @returns Promise<boolean> - True if navigation succeeded
+ */
+export declare function navigateToUrl(page: Page, url: string, timeout?: number): Promise<boolean>;
+/**
+ * Gets accessibility tree for the page
+ * @param page - The Playwright page object
+ * @returns Promise<string> - Accessibility tree snapshot
+ */
+export declare function getAccessibilityTree(page: Page): Promise<string>;
+//# sourceMappingURL=inspector.d.ts.map

package/dist/analyzer/visual/inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../../src/analyzer/visual/inspector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAY,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAWtD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/E;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAiD7B;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAKtE"}