playwright-e2e-mcp 0.1.0

package/dist/utils/project-detector.js

@@ -0,0 +1,255 @@
+/**
+ * Project detection: locate playwright.config.*, verify Playwright is
+ * installed, identify the package manager, and discover test files.
+ *
+ * Supports monorepos by walking up to the filesystem root and picking
+ * the *nearest* directory containing a Playwright config. When several
+ * configs live side by side every candidate is returned so the caller
+ * can ask the user which one to use.
+ */
+import { readdir, readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { isTestFile, normalizePath, resolvePath } from './path-utils.js';
+const CONFIG_FILES = [
+    'playwright.config.ts',
+    'playwright.config.mts',
+    'playwright.config.js',
+    'playwright.config.mjs',
+    'playwright.config.cjs',
+];
+const IGNORED_DIRS = new Set([
+    'node_modules',
+    'dist',
+    'build',
+    '.git',
+    '.hg',
+    '.svn',
+    'test-results',
+    'playwright-report',
+    'blob-report',
+    'coverage',
+    '.next',
+    '.cache',
+    '.turbo',
+]);
+const LOCKFILES = [
+    { file: 'pnpm-lock.yaml', pm: 'pnpm' },
+    { file: 'yarn.lock', pm: 'yarn' },
+    { file: 'bun.lockb', pm: 'bun' },
+    { file: 'bun.lock', pm: 'bun' },
+    { file: 'package-lock.json', pm: 'npm' },
+    { file: 'npm-shrinkwrap.json', pm: 'npm' },
+];
+async function isDirectory(p) {
+    try {
+        return (await stat(p)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function isFile(p) {
+    try {
+        return (await stat(p)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function readJson(p) {
+    try {
+        const text = await readFile(p, 'utf8');
+        const parsed = JSON.parse(text);
+        return parsed !== null && typeof parsed === 'object' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the starting directory: accepts an existing dir, an existing
+ * file (uses its parent), a not-yet-existing path (nearest existing
+ * ancestor), and falls back to cwd.
+ */
+export async function resolveStartDir(input) {
+    const candidate = normalizePath(input && input.trim() !== '' ? input : process.cwd());
+    if (await isDirectory(candidate))
+        return candidate;
+    if (await isFile(candidate))
+        return normalizePath(path.dirname(candidate));
+    let dir = candidate;
+    for (let i = 0; i < 64; i += 1) {
+        const parent = normalizePath(path.dirname(dir));
+        if (parent === dir)
+            break;
+        dir = parent;
+        if (await isDirectory(dir))
+            return dir;
+    }
+    return normalizePath(process.cwd());
+}
+async function findPlaywrightInstall(dir) {
+    for (const pkg of ['@playwright/test', 'playwright']) {
+        const manifest = path.join(dir, 'node_modules', ...pkg.split('/'), 'package.json');
+        if (await isFile(manifest)) {
+            const json = await readJson(manifest);
+            const version = typeof json?.version === 'string' ? json.version : null;
+            return { pkg, version };
+        }
+    }
+    return null;
+}
+async function detectPackageManager(root) {
+    for (const { file, pm } of LOCKFILES) {
+        if (await isFile(path.join(root, file)))
+            return pm;
+    }
+    return 'unknown';
+}
+/**
+ * Best-effort `testDir` extraction from the config file source.
+ * Handles `testDir: 'tests'` / `testDir: "e2e"` / `testDir: "./tests"`.
+ */
+async function readTestDir(configPath, root) {
+    try {
+        const source = await readFile(configPath, 'utf8');
+        const match = /testDir\s*:\s*(['"])([^'"]+)\1/.exec(source);
+        if (!match)
+            return null;
+        const resolved = resolvePath(root, match[2]);
+        return resolved;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Detect the Playwright project around `startDir`.
+ *
+ * Walks upward looking for (in order of precedence) the nearest
+ * playwright.config.*, any package.json as a root fallback, and
+ * node_modules installs of @playwright/test or playwright.
+ */
+export async function detectProject(startDir) {
+    const start = await resolveStartDir(startDir);
+    let packageRoot = null;
+    let playwright = null;
+    let configDir = null;
+    const configCandidates = [];
+    const visited = new Set();
+    let dir = start;
+    for (let depth = 0; depth < 64; depth += 1) {
+        if (visited.has(dir))
+            break;
+        visited.add(dir);
+        if (configDir === null) {
+            for (const name of CONFIG_FILES) {
+                const candidate = path.join(dir, name);
+                if (await isFile(candidate)) {
+                    configDir = dir;
+                    configCandidates.push(normalizePath(candidate));
+                }
+            }
+        }
+        if (packageRoot === null && (await isFile(path.join(dir, 'package.json')))) {
+            packageRoot = dir;
+        }
+        if (playwright === null) {
+            playwright = await findPlaywrightInstall(dir);
+        }
+        const parent = normalizePath(path.dirname(dir));
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    const root = normalizePath(configDir ?? packageRoot ?? start);
+    const configPath = configCandidates[0] ?? null;
+    const testDir = configPath ? await readTestDir(configPath, root) : null;
+    const packageManager = await detectPackageManager(root);
+    return {
+        startDir: start,
+        root,
+        configPath,
+        configCandidates,
+        hasPlaywright: playwright !== null,
+        playwrightPackage: playwright?.pkg ?? null,
+        playwrightVersion: playwright?.version ?? null,
+        testDir,
+        packageManager,
+    };
+}
+/** Pick a config by 1-based index or exact path from the candidates list. */
+export function selectConfig(candidates, selection) {
+    if (candidates.length === 0)
+        return null;
+    if (candidates.length === 1)
+        return candidates[0];
+    if (typeof selection === 'number') {
+        const index = selection - 1;
+        return index >= 0 && index < candidates.length ? candidates[index] : null;
+    }
+    if (typeof selection === 'string' && selection.trim() !== '') {
+        const wanted = normalizePath(selection).toLowerCase();
+        const hit = candidates.find((c) => c.toLowerCase() === wanted || normalizePath(c).endsWith(`/${wanted}`));
+        return hit ?? null;
+    }
+    return null;
+}
+/** Install instructions for a project where Playwright is missing. */
+export function missingPlaywrightMessage(detection) {
+    const install = detection.packageManager === 'pnpm'
+        ? 'pnpm add -D @playwright/test'
+        : detection.packageManager === 'yarn'
+            ? 'yarn add -D @playwright/test'
+            : detection.packageManager === 'bun'
+                ? 'bun add -d @playwright/test'
+                : 'npm install -D @playwright/test';
+    const browsers = detection.packageManager === 'unknown'
+        ? 'npx playwright install'
+        : `${detection.packageManager === 'npm' ? 'npx' : detection.packageManager} playwright install`;
+    return {
+        message: 'Playwright is not installed in this project (no @playwright/test or playwright found in node_modules).',
+        hint: `Run:\n  ${install}\n  ${browsers}\nthen retry.`,
+    };
+}
+/**
+ * Recursively find Playwright spec files under `root`, skipping
+ * node_modules/build/report directories. Returns sorted, project-relative
+ * posix paths.
+ */
+export async function findTestFiles(root, options = {}) {
+    const normalizedRoot = normalizePath(root);
+    const startDir = options.testDir ? normalizePath(options.testDir) : normalizedRoot;
+    const maxDepth = options.maxDepth ?? 8;
+    const limit = options.limit ?? 1000;
+    const results = [];
+    const walk = async (dir, depth) => {
+        if (depth > maxDepth || results.length >= limit)
+            return;
+        const entries = await readdir(dir, { withFileTypes: true, encoding: 'utf8' }).catch(() => null);
+        if (entries === null)
+            return;
+        const sorted = entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of sorted) {
+            if (results.length >= limit)
+                return;
+            if (entry.name.startsWith('.') && entry.name !== '.')
+                continue;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (IGNORED_DIRS.has(entry.name))
+                    continue;
+                await walk(full, depth + 1);
+            }
+            else if (entry.isFile() && isTestFile(entry.name)) {
+                const relative = full.slice(normalizedRoot.endsWith('/') ? normalizedRoot.length : normalizedRoot.length + 1);
+                results.push(normalizePath(relative));
+            }
+        }
+    };
+    if (await isDirectory(startDir)) {
+        await walk(startDir, 0);
+    }
+    return results.sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=project-detector.js.map

package/dist/utils/project-detector.js.map

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

package/dist/utils/report-parser.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Parsing of Playwright's JSON reporter output plus text diagnostics.
+ *
+ * The JSON report is the source of truth for pass/fail stats and
+ * failures; when the run dies before a report exists (timeout, crash,
+ * syntax error, full disk…) `diagnoseOutput` turns raw stdout/stderr
+ * into an ErrorKind + actionable hint.
+ */
+import type { DiscoveredTest, ErrorKind, FailureKind, ReportStats, TestFailure, TestStatus } from '../types/index.js';
+export interface ParsedReport {
+    stats: ReportStats | null;
+    failures: TestFailure[];
+    failuresTruncated: boolean;
+    /** Every test case in the report (used by --list parsing). */
+    tests: DiscoveredTest[];
+    specCount: number;
+    projects: string[];
+    configPath: string | null;
+    parseError?: string;
+}
+export interface Diagnosis {
+    errorKind: ErrorKind;
+    errorMessage: string;
+    hint: string;
+}
+/** Remove ANSI color/control sequences from captured output. */
+export declare function stripAnsi(text: string): string;
+export declare function emptyStats(): ReportStats;
+/** Classify a failure from its message/stack plus normalized status. */
+export declare function classifyFailure(text: string, status: TestStatus): FailureKind;
+/** Parse a JSON report from a raw string. Never throws. */
+export declare function parseReportJson(raw: string, root?: string, maxFailures?: number): ParsedReport;
+/**
+ * Parse an already-deserialized Playwright JSON report into normalized
+ * stats, failures, and a flat test listing.
+ */
+export declare function parseReport(report: unknown, root?: string, maxFailures?: number): ParsedReport;
+/**
+ * Best-effort extraction of a JSON object from mixed text (stdout that
+ * interleaves logs with the JSON reporter output).
+ */
+export declare function extractJsonFromText(text: string): string | null;
+/** First line that looks like an actual error, else first content line. */
+export declare function firstMeaningfulLine(text: string): string | undefined;
+/**
+ * Turn raw process output into an ErrorKind + hint when no structured
+ * report exists. Returns null when nothing recognizable was found.
+ */
+export declare function diagnoseOutput(text: string): Diagnosis | null;
+/** Extract `name: '…'` values from a playwright.config source. */
+export declare function parseProjectNames(source: string): string[];
+/**
+ * Regex-based extraction of `test(...)` / `test.describe(...)` titles
+ * from a spec file. Used only as a fallback when Playwright itself
+ * cannot list tests (not installed, config broken, syntax error).
+ */
+export declare function extractTestTitles(source: string): Array<{
+    title: string;
+    line: number;
+}>;