playwright-e2e-mcp 0.1.0

package/dist/utils/change-analyzer.js

@@ -0,0 +1,290 @@
+/**
+ * Change + selector analysis for the generate-e2e-test tool.
+ *
+ * "Look at the agent's recent file changes, identify the components,
+ * and scaffold a test using the correct selectors" (blueprint). This
+ * module answers the first two parts: which files changed (git working
+ * tree, last commit, or mtime fallback) and which locators those files
+ * actually declare (data-testid, roles, labels, ids…).
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { readdir, readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { normalizePath, relativeToRoot } from './path-utils.js';
+const execFileAsync = promisify(execFile);
+const SOURCE_EXT = /\.(?:[cm]?[jt]sx?|vue|svelte|css|scss|less|html)$/;
+const IGNORED_DIRS = new Set([
+    'node_modules',
+    'dist',
+    'build',
+    '.git',
+    'test-results',
+    'playwright-report',
+    'blob-report',
+    'coverage',
+    '.next',
+    '.nuxt',
+    '.cache',
+    '.turbo',
+]);
+const MAX_FILE_BYTES = 512 * 1024;
+const MAX_SELECTORS = 40;
+const DEFAULT_WINDOW_MS = 7 * 24 * 60 * 60 * 1000;
+/* ------------------------------------------------------------------ */
+/* Recent changes                                                      */
+/* ------------------------------------------------------------------ */
+function cleanPorcelainPath(raw) {
+    let p = raw.trim();
+    if (p.includes(' -> '))
+        p = p.split(' -> ').pop() ?? p;
+    if (p.startsWith('"') && p.endsWith('"'))
+        p = p.slice(1, -1);
+    return normalizePath(p);
+}
+/** Drop build/vendor paths git may report (e.g. no .gitignore yet). */
+function isIgnoredPath(file) {
+    const segments = file.split('/');
+    if (segments.length > 1 && segments.some((segment) => IGNORED_DIRS.has(segment)))
+        return true;
+    return segments.slice(0, -1).some((segment) => segment === '.git');
+}
+async function gitStatusFiles(root) {
+    try {
+        const { stdout } = await execFileAsync('git', ['status', '--porcelain=v1', '-uall', '--untracked-files=all'], { cwd: root, timeout: 4_000, maxBuffer: 1024 * 1024 });
+        return stdout
+            .split(/\r?\n/)
+            .filter((line) => line.length > 3)
+            .map((line) => cleanPorcelainPath(line.slice(3)));
+    }
+    catch {
+        return null;
+    }
+}
+async function gitLastCommitFiles(root) {
+    try {
+        const { stdout } = await execFileAsync('git', ['diff', '--name-only', 'HEAD~1'], {
+            cwd: root,
+            timeout: 4_000,
+            maxBuffer: 1024 * 1024,
+        });
+        const files = stdout
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map((line) => normalizePath(line));
+        return files.length > 0 ? files : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function recentMtimeFiles(root, windowMs, limit) {
+    const cutoff = Date.now() - windowMs;
+    const found = [];
+    const walk = async (dir, depth) => {
+        if (depth > 8 || found.length > 500)
+            return;
+        const entries = await readdir(dir, { withFileTypes: true, encoding: 'utf8' }).catch(() => null);
+        if (!entries)
+            return;
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || IGNORED_DIRS.has(entry.name))
+                continue;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(full, depth + 1);
+            }
+            else if (entry.isFile() && SOURCE_EXT.test(entry.name)) {
+                try {
+                    const info = await stat(full);
+                    if (info.mtimeMs >= cutoff && info.size <= MAX_FILE_BYTES) {
+                        found.push({ file: normalizePath(full), mtime: info.mtimeMs });
+                    }
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        }
+    };
+    await walk(root, 0);
+    found.sort((a, b) => b.mtime - a.mtime);
+    return found.slice(0, limit).map((entry) => entry.file);
+}
+/* ------------------------------------------------------------------ */
+/* Selector extraction                                                 */
+/* ------------------------------------------------------------------ */
+function lineOf(source, index) {
+    let line = 1;
+    for (let i = 0; i < index && i < source.length; i += 1) {
+        if (source.charCodeAt(i) === 10)
+            line += 1;
+    }
+    return line;
+}
+function quote(value) {
+    return value.includes("'") ? `"${value}"` : `'${value}'`;
+}
+const PATTERNS = [
+    {
+        kind: 'test-id',
+        re: /\bdata-testid\s*=\s*["']([^"']{1,80})["']/g,
+        toLocator: (m) => `getByTestId(${quote(m[1])})`,
+    },
+    {
+        kind: 'test-id',
+        re: /\bdata-(test-id|test|cy)\s*=\s*["']([^"']{1,80})["']/g,
+        toLocator: (m) => `locator(${quote(`[data-${m[1]}="${m[2]}"]`)})`,
+    },
+    {
+        kind: 'test-id',
+        re: /\bgetByTestId\(\s*["'`]([^"'`]{1,80})["'`]/g,
+        toLocator: (m) => `getByTestId(${quote(m[1])})`,
+    },
+    {
+        kind: 'role',
+        re: /\bgetByRole\(\s*["'`]([a-zA-Z]+)["'`]\s*,\s*\{\s*name:\s*["'`]([^"'`]{1,80})["'`]/g,
+        toLocator: (m) => `getByRole(${quote(m[1])}, { name: ${quote(m[2])} })`,
+    },
+    {
+        kind: 'aria',
+        re: /\baria-label\s*=\s*["']([^"']{1,80})["']/g,
+        toLocator: (m) => `getByLabel(${quote(m[1])})`,
+    },
+    {
+        kind: 'placeholder',
+        re: /\bplaceholder\s*=\s*["']([^"']{1,80})["']/g,
+        toLocator: (m) => `getByPlaceholder(${quote(m[1])})`,
+    },
+    {
+        kind: 'id',
+        re: /(?<![\w.])id\s*=\s*["']([\w-]{1,60})["']/g,
+        toLocator: (m) => `locator(${quote(`#${m[1]}`)})`,
+    },
+    {
+        kind: 'name',
+        re: /(?<![\w.])name\s*=\s*["']([\w:-]{1,60})["']/g,
+        toLocator: (m) => `locator(${quote(`[name="${m[1]}"]`)})`,
+    },
+    {
+        kind: 'text',
+        re: /<(button|a)\b[^>]*>\s*([^<>{}\n]{2,60}?)\s*<\/\1>/g,
+        toLocator: (m) => `getByRole(${quote(m[1] === 'a' ? 'link' : 'button')}, { name: ${quote(m[2].trim())} })`,
+    },
+    {
+        kind: 'text',
+        re: /\bgetByText\(\s*["'`]([^"'`]{1,80})["'`]/g,
+        toLocator: (m) => `getByText(${quote(m[1])})`,
+    },
+];
+/** Extract locators declared in one source file. */
+export function extractSelectors(source, file) {
+    const out = [];
+    const seen = new Set();
+    const bounded = source.length > MAX_FILE_BYTES ? source.slice(0, MAX_FILE_BYTES) : source;
+    for (const pattern of PATTERNS) {
+        pattern.re.lastIndex = 0;
+        let match;
+        while ((match = pattern.re.exec(bounded)) !== null) {
+            const locator = pattern.toLocator(match);
+            if (!locator)
+                continue;
+            // The meaningful value is always the pattern's last capture group.
+            const value = match[match.length - 1] ?? '';
+            if (value === '')
+                continue;
+            const key = `${pattern.kind}:${value}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push({
+                kind: pattern.kind,
+                value,
+                locator,
+                file,
+                line: lineOf(bounded, match.index),
+            });
+            if (out.length >= MAX_SELECTORS)
+                return out;
+        }
+    }
+    return out;
+}
+export async function analyzeRecentChanges(projectRoot, options = {}) {
+    const root = normalizePath(projectRoot);
+    const limit = options.limit ?? 12;
+    let changeSource = 'mtime';
+    let files = (await gitStatusFiles(root))?.filter((file) => !isIgnoredPath(file)) ?? null;
+    if (files !== null && files.length === 0) {
+        files = (await gitLastCommitFiles(root))?.filter((file) => !isIgnoredPath(file)) ?? null;
+        if (files !== null)
+            changeSource = 'git-last-commit';
+    }
+    else if (files !== null) {
+        changeSource = 'git-status';
+    }
+    if (files === null) {
+        files = (await recentMtimeFiles(root, options.windowMs ?? DEFAULT_WINDOW_MS, limit)).filter((file) => !isIgnoredPath(file));
+        changeSource = 'mtime';
+    }
+    const selectors = [];
+    const seen = new Set();
+    const scanned = [];
+    let truncated = false;
+    for (const file of files) {
+        if (scanned.length >= limit) {
+            truncated = true;
+            break;
+        }
+        const absolute = path.isAbsolute(file) ? file : path.join(root, file);
+        let source;
+        try {
+            const info = await stat(absolute);
+            if (!info.isFile() || info.size > MAX_FILE_BYTES)
+                continue;
+            source = await readFile(absolute, 'utf8');
+        }
+        catch {
+            continue;
+        }
+        if (!SOURCE_EXT.test(absolute))
+            continue;
+        scanned.push(relativeToRoot(root, absolute));
+        for (const candidate of extractSelectors(source, relativeToRoot(root, absolute))) {
+            const key = `${candidate.kind}:${candidate.value}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            selectors.push(candidate);
+            if (selectors.length >= MAX_SELECTORS) {
+                truncated = true;
+                break;
+            }
+        }
+        if (selectors.length >= MAX_SELECTORS)
+            break;
+    }
+    return {
+        changeSource,
+        files: files.map((file) => ({
+            path: path.isAbsolute(file) ? relativeToRoot(root, file) : normalizePath(file),
+            source: changeSource === 'mtime' ? 'mtime' : 'git',
+        })),
+        selectors,
+        scanned: scanned.length,
+        truncated,
+    };
+}
+/** Pull `baseURL` / `webServer.url` out of a playwright.config source. */
+export function detectEntryUrl(configSource) {
+    const out = {};
+    const base = /baseURL\s*:\s*["']([^"']{3,200})["']/.exec(configSource);
+    if (base)
+        out.baseURL = base[1];
+    const server = /\burl\s*:\s*["'](https?:\/\/[^"']{3,200})["']/.exec(configSource);
+    if (server)
+        out.webServerUrl = server[1];
+    return out;
+}
+//# sourceMappingURL=change-analyzer.js.map

package/dist/utils/change-analyzer.js.map

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

package/dist/utils/image-diff.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Visual regression core: PNG decode/encode and a pixel diff.
+ *
+ * Playwright screenshots are 8-bit non-interlaced PNGs, so a small
+ * built-in codec covers them without adding dependencies. The diff
+ * reports how much changed, *where* it changed (merged grid regions),
+ * and the average color shift — powering the "you changed the button
+ * from blue to red" message from the blueprint.
+ */
+export interface RgbaImage {
+    width: number;
+    height: number;
+    /** RGBA8, row-major, length = width * height * 4. */
+    data: Uint8Array;
+}
+export interface Rgb {
+    r: number;
+    g: number;
+    b: number;
+}
+/** Decode an 8-bit, non-interlaced PNG (gray/RGB/palette/alpha variants). */
+export declare function decodePng(buf: Buffer): RgbaImage;
+/** Encode an RGBA image as a PNG (filter 0, default compression). */
+export declare function encodePng(image: RgbaImage): Buffer;
+export interface DiffOptions {
+    /** Per-pixel combined channel delta (0–765) above which a pixel differs. Default 60. */
+    pixelThreshold?: number;
+    /** Grid cell size used to cluster changed pixels into regions. Default 24. */
+    cellSize?: number;
+    /** Fraction of a cell that must differ before the cell counts. Default 0.05. */
+    cellRatio?: number;
+}
+export interface DiffRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    pixels: number;
+}
+export interface DiffResult {
+    width: number;
+    height: number;
+    totalPixels: number;
+    diffPixels: number;
+    /** Percentage of changed pixels (0–100). */
+    percent: number;
+    /** True when the two screenshots have different dimensions. */
+    dimensionsChanged: boolean;
+    /** Changed areas, largest first (top 5). */
+    regions: DiffRegion[];
+    /** Average color of changed pixels, before → after. */
+    beforeAvg?: Rgb;
+    afterAvg?: Rgb;
+    /** Annotated image: grayscale baseline, changed pixels in red. */
+    diffImage: RgbaImage;
+}
+/**
+ * Compare two screenshots. When dimensions differ, the overlapping
+ * region is compared and the remainder counts as changed.
+ */
+export declare function diffImages(before: RgbaImage, after: RgbaImage, options?: DiffOptions): DiffResult;