@sudu-cli/fronted-preview-mcp 1.0.0-beta.0 → 1.0.0-beta.2

package/dist/handlers/autoFixLoop.d.ts

@@ -0,0 +1,21 @@
+import { Client } from 'chrome-remote-interface';
+import { ToolContext } from '../types.js';
+export interface AutoFixOptions {
+    maxIterations?: number;
+    timeoutPerIteration?: number;
+    stopOnSuccess?: boolean;
+    screenshotOnError?: boolean;
+    screenshotOnSuccess?: boolean;
+    targetErrors?: string[];
+}
+export interface AutoFixResult {
+    success: boolean;
+    iterations: number;
+    errorsFixed: number;
+    errorsRemaining: number;
+    screenshots: string[];
+    messages: string[];
+    errors: string[];
+}
+export declare function autoFixLoop(client: Client, context: ToolContext, options?: AutoFixOptions): Promise<AutoFixResult>;
+export declare function handleAutoFixLoop(context: ToolContext, options?: AutoFixOptions): Promise<AutoFixResult>;

package/dist/handlers/autoFixLoop.js

@@ -0,0 +1,135 @@
+import { handleCheckPageErrors } from './checkPageErrors.js';
+import { handleGetTypeScriptDiagnostics } from './typescriptDiagnostics.js';
+import { handleTakeScreenshot } from './takeScreenshot.js';
+export async function autoFixLoop(client, context, options = {}) {
+    const { maxIterations = 3, timeoutPerIteration = 30000, stopOnSuccess = true, screenshotOnError = true, screenshotOnSuccess = false, targetErrors = [] } = options;
+    const result = {
+        success: false,
+        iterations: 0,
+        errorsFixed: 0,
+        errorsRemaining: 0,
+        screenshots: [],
+        messages: [],
+        errors: []
+    };
+    // Check initial state
+    const initialConsoleErrors = await handleCheckPageErrors(context);
+    const initialTsDiagnostics = await handleGetTypeScriptDiagnostics(context);
+    let currentConsoleErrors = [...initialConsoleErrors.errors];
+    let currentTsDiagnostics = [...initialTsDiagnostics.diagnostics];
+    // Filter errors if targetErrors is specified
+    if (targetErrors.length > 0) {
+        currentConsoleErrors = currentConsoleErrors.filter(error => targetErrors.some(target => error.message.includes(target)));
+        currentTsDiagnostics = currentTsDiagnostics.filter(diagnostic => targetErrors.some(target => diagnostic.message.includes(target)));
+    }
+    const initialErrorCount = currentConsoleErrors.length + currentTsDiagnostics.length;
+    result.errorsRemaining = initialErrorCount;
+    // Take initial screenshot if requested
+    if (screenshotOnError && initialErrorCount > 0) {
+        const screenshot = await handleTakeScreenshot(context, { format: 'png' });
+        if (screenshot.success && screenshot.dataUrl) {
+            result.screenshots.push(`Initial state - ${initialErrorCount} errors: ${screenshot.dataUrl}`);
+        }
+    }
+    for (let iteration = 0; iteration < maxIterations; iteration++) {
+        result.iterations = iteration + 1;
+        result.messages.push(`=== Iteration ${iteration + 1} ===`);
+        try {
+            // Wait for any pending operations
+            await new Promise(resolve => setTimeout(resolve, 2000));
+            // Check current state
+            const currentErrors = await handleCheckPageErrors(context);
+            const currentDiagnostics = await handleGetTypeScriptDiagnostics(context);
+            // Update error counts
+            currentConsoleErrors = [...currentErrors.errors];
+            currentTsDiagnostics = [...currentDiagnostics.diagnostics];
+            if (targetErrors.length > 0) {
+                currentConsoleErrors = currentConsoleErrors.filter(error => targetErrors.some(target => error.message.includes(target)));
+                currentTsDiagnostics = currentTsDiagnostics.filter(diagnostic => targetErrors.some(target => diagnostic.message.includes(target)));
+            }
+            const currentErrorCount = currentConsoleErrors.length + currentTsDiagnostics.length;
+            const errorsFixed = initialErrorCount - currentErrorCount;
+            result.errorsFixed = errorsFixed;
+            result.errorsRemaining = currentErrorCount;
+            // Check if we've succeeded
+            if (currentErrorCount === 0 && stopOnSuccess) {
+                result.success = true;
+                result.messages.push(`✅ All errors fixed after ${iteration + 1} iterations`);
+                if (screenshotOnSuccess) {
+                    const screenshot = await handleTakeScreenshot(context, { format: 'png' });
+                    if (screenshot.success && screenshot.dataUrl) {
+                        result.screenshots.push(`Success state - no errors: ${screenshot.dataUrl}`);
+                    }
+                }
+                break;
+            }
+            // Log current state
+            result.messages.push(`Current errors: ${currentErrorCount} (fixed: ${errorsFixed})`);
+            if (currentConsoleErrors.length > 0) {
+                result.messages.push('Console errors:');
+                currentConsoleErrors.forEach((error) => {
+                    result.messages.push(`  - ${error.message} (${error.type})`);
+                });
+            }
+            if (currentTsDiagnostics.length > 0) {
+                result.messages.push('TypeScript diagnostics:');
+                currentTsDiagnostics.forEach((diagnostic) => {
+                    result.messages.push(`  - ${diagnostic.message} (${diagnostic.severity})`);
+                });
+            }
+            // Take screenshot if errors still exist
+            if (currentErrorCount > 0 && screenshotOnError) {
+                const screenshot = await handleTakeScreenshot(context, { format: 'png' });
+                if (screenshot.success && screenshot.dataUrl) {
+                    result.screenshots.push(`Iteration ${iteration + 1} - ${currentErrorCount} errors: ${screenshot.dataUrl}`);
+                }
+            }
+            // If no errors but we're not stopping on success, continue
+            if (currentErrorCount === 0) {
+                result.messages.push('No errors found, but continuing to next iteration');
+            }
+            // Wait before next iteration
+            await new Promise(resolve => setTimeout(resolve, timeoutPerIteration));
+        }
+        catch (error) {
+            const errorMessage = `Error in iteration ${iteration + 1}: ${error instanceof Error ? error.message : 'Unknown error'}`;
+            result.errors.push(errorMessage);
+            result.messages.push(errorMessage);
+            // Take error screenshot if requested
+            if (screenshotOnError) {
+                const screenshot = await handleTakeScreenshot(context, { format: 'png' });
+                if (screenshot.success && screenshot.dataUrl) {
+                    result.screenshots.push(`Error in iteration ${iteration + 1}: ${screenshot.dataUrl}`);
+                }
+            }
+            break;
+        }
+    }
+    // Final check
+    const finalConsoleErrors = await handleCheckPageErrors(context);
+    const finalTsDiagnostics = await handleGetTypeScriptDiagnostics(context);
+    let finalErrorCount = finalConsoleErrors.errors.length + finalTsDiagnostics.diagnostics.length;
+    if (targetErrors.length > 0) {
+        finalErrorCount = finalConsoleErrors.errors.filter((error) => targetErrors.some(target => error.message.includes(target))).length + finalTsDiagnostics.diagnostics.filter((diagnostic) => targetErrors.some(target => diagnostic.message.includes(target))).length;
+    }
+    result.errorsRemaining = finalErrorCount;
+    result.success = finalErrorCount === 0;
+    return result;
+}
+// MCP tool handler
+export async function handleAutoFixLoop(context, options) {
+    const { chromeClient } = context;
+    if (!chromeClient) {
+        return {
+            success: false,
+            iterations: 0,
+            errorsFixed: 0,
+            errorsRemaining: 0,
+            screenshots: [],
+            messages: ['Chrome client not connected. Please connect to Chrome first.'],
+            errors: ['Chrome client not connected']
+        };
+    }
+    return await autoFixLoop(chromeClient, context, options);
+}
+//# sourceMappingURL=autoFixLoop.js.map

package/dist/handlers/autoFixLoop.js.map

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

package/dist/handlers/checkPageErrors.d.ts

@@ -0,0 +1,9 @@
+import type { MCPToolResponse } from '../types.js';
+interface CheckPageErrorsArgs {
+    projectDir?: string;
+    customPort?: number;
+    cdpPort?: number;
+    waitForLoadMs?: number;
+}
+declare function handleCheckPageErrors(args: CheckPageErrorsArgs): Promise<MCPToolResponse>;
+export { handleCheckPageErrors };

package/dist/handlers/checkPageErrors.js

@@ -0,0 +1,168 @@
+import { detectFramework } from '../detectors/frameworkDetector.js';
+import { startServer } from '../serverManager.js';
+import CDP from 'chrome-remote-interface';
+async function handleCheckPageErrors(args) {
+    const projectDir = args.projectDir || process.cwd();
+    const cdpPort = args.cdpPort || 9222;
+    const waitForLoadMs = args.waitForLoadMs || 3000;
+    let client = null;
+    try {
+        // Step 1: Detect framework and start/get dev server
+        const info = await detectFramework(projectDir);
+        if (!info.devScript) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'No dev script found',
+                            availableScripts: Object.keys(info.npmScripts),
+                            projectDir,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Step 2: Start dev server (or reuse existing)
+        const port = args.customPort || info.port;
+        const command = `npm run ${info.devScript}`;
+        const status = await startServer(projectDir, command, port);
+        const pageUrl = status.url;
+        // Step 3: Connect to Chrome via CDP
+        const cdpOptions = { port: cdpPort };
+        try {
+            client = await CDP(cdpOptions);
+        }
+        catch (cdpErr) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Failed to connect to Chrome DevTools Protocol on port ${cdpPort}. Ensure Chrome is running with --remote-debugging-port=${cdpPort}`,
+                            details: cdpErr instanceof Error ? cdpErr.message : String(cdpErr),
+                            pageUrl,
+                            suggestion: 'Start Chrome with: chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug',
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (!client) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to create CDP client',
+                            pageUrl,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Enable domains
+        const { Page, Runtime, Network, Log } = client;
+        await Promise.all([
+            Page.enable(),
+            Runtime.enable(),
+            Network.enable(),
+            Log.enable(),
+        ]);
+        // Collect console messages
+        const consoleMessages = [];
+        const networkErrors = [];
+        // Listen for console messages (Log.entryAdded)
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        client.on('Log.entryAdded', (params) => {
+            const entry = params.entry;
+            consoleMessages.push({
+                type: entry.level,
+                text: entry.text,
+                url: entry.url,
+                lineNumber: entry.lineNumber,
+                stackTrace: entry.stackTrace,
+            });
+        });
+        // Listen for network errors (Network.responseReceived)
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        client.on('Network.responseReceived', (params) => {
+            const response = params.response;
+            if (response.status >= 400) {
+                networkErrors.push({
+                    url: response.url,
+                    method: response.requestMethod || 'GET',
+                    statusCode: response.status,
+                    errorText: `HTTP ${response.status}`,
+                });
+            }
+        });
+        // Listen for network loading failed
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        client.on('Network.loadingFailed', (params) => {
+            networkErrors.push({
+                url: `request:${params.requestId}`,
+                method: 'UNKNOWN',
+                errorText: params.errorText,
+            });
+        });
+        // Step 4: Navigate to the page
+        await Page.navigate({ url: pageUrl });
+        // Wait for page load
+        await new Promise((resolve) => {
+            const timeout = setTimeout(resolve, waitForLoadMs);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const handler = (params) => {
+                clearTimeout(timeout);
+                resolve();
+            };
+            client.on('Page.loadEventFired', handler);
+        });
+        // Give a bit more time for async console messages
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        // Step 5: Compile report
+        const errors = consoleMessages.filter((m) => m.type === 'error');
+        const warnings = consoleMessages.filter((m) => m.type === 'warning');
+        const report = {
+            pageUrl,
+            framework: info.framework,
+            port: status.port,
+            consoleMessages,
+            networkErrors,
+            hasErrors: errors.length > 0 || networkErrors.length > 0,
+            errorCount: errors.length + networkErrors.length,
+            warningCount: warnings.length,
+            timestamp: new Date().toISOString(),
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(report, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: errorMessage }, null, 2) }],
+            isError: true,
+        };
+    }
+    finally {
+        if (client) {
+            try {
+                await client.close();
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+    }
+}
+export { handleCheckPageErrors };
+//# sourceMappingURL=checkPageErrors.js.map

package/dist/handlers/checkPageErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkPageErrors.js","sourceRoot":"","sources":["../../src/handlers/checkPageErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,GAAkC,MAAM,yBAAyB,CAAC;AAqCzE,KAAK,UAAU,qBAAqB,CAAC,IAAyB;IAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IACrC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC;IAEjD,IAAI,MAAM,GAAkB,IAAI,CAAC;IAEjC,IAAI,CAAC;QACH,oDAAoD;QACpD,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;QAE/C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,KAAK,EAAE,qBAAqB;4BAC5B,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;4BAC9C,UAAU;yBACX,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC;QAC1C,MAAM,OAAO,GAAG,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAE5D,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC;QAE3B,oCAAoC;QACpC,MAAM,UAAU,GAAY,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,KAAK,EAAE,yDAAyD,OAAO,2DAA2D,OAAO,EAAE;4BAC3I,OAAO,EAAE,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;4BAClE,OAAO;4BACP,UAAU,EAAE,0FAA0F;yBACvG,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,KAAK,EAAE,6BAA6B;4BACpC,OAAO;yBACR,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;QAE/C,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,IAAI,CAAC,MAAM,EAAE;YACb,OAAO,CAAC,MAAM,EAAE;YAChB,OAAO,CAAC,MAAM,EAAE;YAChB,GAAG,CAAC,MAAM,EAAE;SACb,CAAC,CAAC;QAEH,2BAA2B;QAC3B,MAAM,eAAe,GAAqB,EAAE,CAAC;QAC7C,MAAM,aAAa,GAAmB,EAAE,CAAC;QAEzC,+CAA+C;QAC/C,8DAA8D;QAC9D,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,MAAW,EAAE,EAAE;YAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3B,eAAe,CAAC,IAAI,CAAC;gBACnB,IAAI,EAAE,KAAK,CAAC,KAA+B;gBAC3C,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,uDAAuD;QACvD,8DAA8D;QAC9D,MAAM,CAAC,EAAE,CAAC,0BAA0B,EAAE,CAAC,MAAW,EAAE,EAAE;YACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YACjC,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;gBAC3B,aAAa,CAAC,IAAI,CAAC;oBACjB,GAAG,EAAE,QAAQ,CAAC,GAAG;oBACjB,MAAM,EAAE,QAAQ,CAAC,aAAa,IAAI,KAAK;oBACvC,UAAU,EAAE,QAAQ,CAAC,MAAM;oBAC3B,SAAS,EAAE,QAAQ,QAAQ,CAAC,MAAM,EAAE;iBACrC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,oCAAoC;QACpC,8DAA8D;QAC9D,MAAM,CAAC,EAAE,CAAC,uBAAuB,EAAE,CAAC,MAAW,EAAE,EAAE;YACjD,aAAa,CAAC,IAAI,CAAC;gBACjB,GAAG,EAAE,WAAW,MAAM,CAAC,SAAS,EAAE;gBAClC,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,+BAA+B;QAC/B,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAEtC,qBAAqB;QACrB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YACnD,8DAA8D;YAC9D,MAAM,OAAO,GAAG,CAAC,MAAW,EAAE,EAAE;gBAC9B,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,MAAO,CAAC,EAAE,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,kDAAkD;QAClD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAE1D,yBAAyB;QACzB,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QAErE,MAAM,MAAM,GAAoB;YAC9B,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,eAAe;YACf,aAAa;YACb,SAAS,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC;YACxD,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM;YAChD,YAAY,EAAE,QAAQ,CAAC,MAAM;YAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACnF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/handlers/pickElement.d.ts

@@ -0,0 +1,10 @@
+import type { MCPToolResponse } from '../types.js';
+interface PickElementArgs {
+    projectDir?: string;
+    customPort?: number;
+    cdpPort?: number;
+    selector?: string;
+    waitForLoadMs?: number;
+}
+declare function handlePickElement(args: PickElementArgs): Promise<MCPToolResponse>;
+export { handlePickElement };