@iqual/playwright-vrt 0.1.1 → 0.1.2

package/dist/src/runner.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env bun
+import type { VRTConfig } from './config.js';
+export interface TestResults {
+    passed: number;
+    failed: number;
+    total: number;
+    exitCode: number;
+}
+export interface RunnerOptions {
+    config: VRTConfig;
+    outputDir: string;
+    verbose?: boolean;
+    project?: string;
+    updateBaseline?: boolean;
+    hasExplicitReference?: boolean;
+    headed?: boolean;
+}
+/**
+ * Check if baseline snapshots already exist and are valid
+ */
+export declare function hasExistingSnapshots(snapshotDir: string): boolean;
+/**
+ * Run Playwright tests using the shipped config and test files
+ * Much simpler than the old approach - just exec playwright
+ */
+export declare function runVisualTests(options: RunnerOptions): Promise<TestResults>;
+export declare function printResults(results: TestResults, config: VRTConfig): void;
+//# sourceMappingURL=runner.d.ts.map

package/dist/src/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner.ts"],"names":[],"mappings":";AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAyBjE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA0DjF;AA4GD,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAW1E"}

package/dist/src/runner.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env bun
+import { spawn } from 'child_process';
+import * as path from 'path';
+import * as fs from 'fs';
+/**
+ * Check if baseline snapshots already exist and are valid
+ */
+export function hasExistingSnapshots(snapshotDir) {
+    if (!fs.existsSync(snapshotDir)) {
+        return false;
+    }
+    // Recursively check for any .png files
+    function hasSnapshotFiles(dir) {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (hasSnapshotFiles(fullPath)) {
+                    return true;
+                }
+            }
+            else if (entry.name.endsWith('.png')) {
+                return true;
+            }
+        }
+        return false;
+    }
+    return hasSnapshotFiles(snapshotDir);
+}
+/**
+ * Run Playwright tests using the shipped config and test files
+ * Much simpler than the old approach - just exec playwright
+ */
+export async function runVisualTests(options) {
+    const { config, outputDir, verbose, project, updateBaseline, hasExplicitReference, headed } = options;
+    // Find the playwright-vrt package directory
+    const packageDir = path.join(__dirname, '..');
+    const playwrightConfigPath = path.join(packageDir, 'playwright.config.js');
+    const snapshotDir = path.join(process.cwd(), 'playwright-snapshots');
+    // Check if baseline snapshots already exist (look for any .png files in snapshots)
+    const hasBaseline = !updateBaseline && hasExistingSnapshots(snapshotDir);
+    if (hasBaseline) {
+        console.log('\n📸 Using existing baseline snapshots');
+        if (verbose) {
+            console.log('   (Use --update-baseline to regenerate from reference URL)');
+        }
+    }
+    else {
+        if (updateBaseline) {
+            console.log('\n🔄 Updating baseline snapshots...');
+        }
+        else {
+            console.log('\n📸 Creating baseline snapshots (first run)...');
+        }
+        console.log(`   Source: ${config.referenceUrl}`);
+        // Step 1: Create baseline screenshots
+        await runPlaywright({
+            configPath: playwrightConfigPath,
+            baseURL: config.referenceUrl,
+            vrtConfig: config,
+            outputDir,
+            updateSnapshots: true,
+            verbose: true,
+            project,
+            headed,
+        });
+        console.log('✓ Baseline created');
+    }
+    console.log(`\n🧪 Testing ${config.testUrl}`);
+    // Step 2: Run tests against test URL
+    const exitCode = await runPlaywright({
+        configPath: playwrightConfigPath,
+        baseURL: config.testUrl,
+        vrtConfig: config,
+        outputDir,
+        updateSnapshots: false,
+        verbose: true,
+        project,
+        headed,
+    });
+    // Parse results
+    const results = await parseResults(outputDir);
+    results.exitCode = exitCode;
+    return results;
+}
+async function runPlaywright(options) {
+    return new Promise((resolve, reject) => {
+        const args = [
+            'playwright',
+            'test',
+            '--config', options.configPath
+        ];
+        if (options.updateSnapshots) {
+            args.push('--update-snapshots');
+        }
+        if (options.project) {
+            args.push('--project', options.project);
+        }
+        if (options.headed) {
+            args.push('--headed');
+        }
+        const env = {
+            ...process.env,
+            BASE_URL: options.baseURL,
+            VRT_CONFIG: JSON.stringify(options.vrtConfig),
+            OUTPUT_DIR: options.outputDir,
+        };
+        const proc = spawn('bunx', args, {
+            env,
+            stdio: options.verbose ? 'inherit' : 'pipe',
+            shell: true,
+            cwd: process.cwd(),
+        });
+        let stdout = '';
+        let stderr = '';
+        if (!options.verbose) {
+            proc.stdout?.on('data', (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+        }
+        proc.on('close', (code) => {
+            const exitCode = code || 0;
+            // For baseline creation (update-snapshots), always succeed
+            if (options.updateSnapshots) {
+                resolve(0);
+            }
+            else {
+                // For actual tests, return the exit code
+                resolve(exitCode);
+            }
+        });
+        proc.on('error', (error) => {
+            reject(new Error(`Failed to run Playwright: ${error.message}`));
+        });
+    });
+}
+async function parseResults(outputDir) {
+    const resultsPath = path.join(outputDir, 'results.json');
+    try {
+        const file = Bun.file(resultsPath);
+        const results = await file.json();
+        let passed = 0;
+        let failed = 0;
+        let total = 0;
+        // Parse Playwright JSON results
+        if (results.suites) {
+            for (const suite of results.suites) {
+                if (suite.specs) {
+                    for (const spec of suite.specs) {
+                        total++;
+                        if (spec.ok) {
+                            passed++;
+                        }
+                        else {
+                            failed++;
+                        }
+                    }
+                }
+            }
+        }
+        return { passed, failed, total, exitCode: 0 };
+    }
+    catch {
+        return { passed: 0, failed: 0, total: 0, exitCode: 1 };
+    }
+}
+export function printResults(results, config) {
+    console.log('\n📊 Test Results:');
+    console.log(`   Total: ${results.total}`);
+    console.log(`   Passed: ${results.passed}`);
+    console.log(`   Failed: ${results.failed}`);
+    if (results.failed > 0) {
+        console.log(`\n❌ ${results.failed} visual difference(s) detected`);
+    }
+    else if (results.total > 0) {
+        console.log('\n✅ All visual tests passed');
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/src/runner.js.map

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

package/dist/src/workspace.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env bun
+/**
+ * Workspace manages the .playwright-vrt/ directory
+ * This is persistent between runs for debugging and caching
+ */
+export declare class Workspace {
+    private readonly dir;
+    constructor(baseDir?: string);
+    getPath(file?: string): string;
+    writeFile(filename: string, content: string): void;
+    readFile(filename: string): string;
+    exists(filename: string): boolean;
+    writeJSON(filename: string, data: any): void;
+    readJSON(filename: string): any;
+    clean(): void;
+    info(): void;
+}
+//# sourceMappingURL=workspace.d.ts.map

package/dist/src/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/workspace.ts"],"names":[],"mappings":";AAKA;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,OAAO,CAAC,EAAE,MAAM;IAQ5B,OAAO,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAIlC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAWlD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAKlC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAI5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG;IAK/B,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,IAAI;CAGb"}

package/dist/src/workspace.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env bun
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Workspace manages the .playwright-vrt/ directory
+ * This is persistent between runs for debugging and caching
+ */
+export class Workspace {
+    dir;
+    constructor(baseDir) {
+        // Use .playwright-vrt in current directory (or specified base)
+        this.dir = path.join(baseDir || process.cwd(), '.playwright-vrt');
+        // Create workspace directory
+        fs.mkdirSync(this.dir, { recursive: true });
+    }
+    getPath(file = '') {
+        return file ? path.join(this.dir, file) : this.dir;
+    }
+    writeFile(filename, content) {
+        const filePath = this.getPath(filename);
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(filePath, content, 'utf-8');
+    }
+    readFile(filename) {
+        const filePath = this.getPath(filename);
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    exists(filename) {
+        return fs.existsSync(this.getPath(filename));
+    }
+    writeJSON(filename, data) {
+        this.writeFile(filename, JSON.stringify(data, null, 2));
+    }
+    readJSON(filename) {
+        return JSON.parse(this.readFile(filename));
+    }
+    // Manual cleanup - workspace is persistent by default
+    clean() {
+        if (fs.existsSync(this.dir)) {
+            fs.rmSync(this.dir, { recursive: true, force: true });
+            console.log(`🗑️  Cleaned workspace: ${this.dir}`);
+        }
+    }
+    info() {
+        console.log(`📁 Workspace: ${this.dir}`);
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/src/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/workspace.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;GAGG;AACH,MAAM,OAAO,SAAS;IACH,GAAG,CAAS;IAE7B,YAAY,OAAgB;QAC1B,+DAA+D;QAC/D,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,iBAAiB,CAAC,CAAC;QAElE,6BAA6B;QAC7B,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,CAAC,OAAe,EAAE;QACvB,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;IACrD,CAAC;IAED,SAAS,CAAC,QAAgB,EAAE,OAAe;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAEnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,QAAQ,CAAC,QAAgB;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,QAAgB;QACrB,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,SAAS,CAAC,QAAgB,EAAE,IAAS;QACnC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,QAAQ,CAAC,QAAgB;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,sDAAsD;IACtD,KAAK;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@iqual/playwright-vrt",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Standalone Visual Regression Testing CLI tool using Playwright",
   "type": "module",
   "bin": {
-    "playwright-vrt": "./src/cli.ts"
+    "playwright-vrt": "./dist/src/cli.js"
   },
   "files": [
-    "src/",
-    "tests/",
-    "playwright.config.ts",
-    "tsconfig.json",
+    "dist/",
     "README.md"
   ],
   "scripts": {
     "dev": "bun run src/cli.ts",
+    "build": "tsc && cp -r tests dist/ && cp playwright.config.js dist/",
+    "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "bun run typecheck",
-    "test": "bun run src/cli.ts --help"
+    "prepublishOnly": "bun run clean && bun run build",
+    "test": "bun run src/cli.ts --help",
+    "test:dist": "node dist/src/cli.js --help"
   },
   "keywords": [
     "visual-regression",

package/src/cli.ts

@@ -1,339 +0,0 @@
-#!/usr/bin/env bun
-
-import * as path from 'path';
-import * as fs from 'fs';
-import { loadConfig, validateConfig, type CLIOptions } from './config';
-import { collectURLs } from './collect';
-import { runVisualTests, printResults, hasExistingSnapshots } from './runner';
-import { createHash } from 'crypto';
-
-/**
- * Compute SHA-256 hash of a file
- */
-function computeFileHash(filePath: string): string {
-  const content = fs.readFileSync(filePath, 'utf-8');
-  return createHash('sha256').update(content).digest('hex');
-}
-
-/**
- * Compute SHA-256 hash of a config object
- */
-function computeConfigHash(config: any): string {
-  // Create a stable JSON representation (sorted keys)
-  const configStr = JSON.stringify(config, Object.keys(config).sort());
-  return createHash('sha256').update(configStr).digest('hex');
-}
-
-/**
- * Check if cache is valid by comparing stored hashes
- */
-function isCacheValid(snapshotDir: string, config: any): boolean {
-  const hashFile = path.join(snapshotDir, '.cache-hash.json');
-
-  if (!fs.existsSync(hashFile)) {
-    return false;
-  }
-
-  try {
-    const stored = JSON.parse(fs.readFileSync(hashFile, 'utf-8'));
-    const packageDir = path.join(__dirname, '..');
-    const testFilePath = path.join(packageDir, 'tests', 'vrt.spec.ts');
-
-    const currentHashes = {
-      config: computeConfigHash(config),
-      testFile: fs.existsSync(testFilePath) ? computeFileHash(testFilePath) : '',
-    };
-
-    // Log cache timestamp
-    console.log(`   Cache timestamp: ${stored.timestamp}`);
-
-    return stored.config === currentHashes.config &&
-           stored.testFile === currentHashes.testFile;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Save current config and test file hashes to cache
- */
-function saveCacheHashes(snapshotDir: string, config: any): void {
-  const packageDir = path.join(__dirname, '..');
-  const testFilePath = path.join(packageDir, 'tests', 'vrt.spec.ts');
-
-  const hashes = {
-    config: computeConfigHash(config),
-    testFile: fs.existsSync(testFilePath) ? computeFileHash(testFilePath) : '',
-    timestamp: new Date().toISOString(),
-  };
-
-  const hashFile = path.join(snapshotDir, '.cache-hash.json');
-  fs.writeFileSync(hashFile, JSON.stringify(hashes, null, 2), 'utf-8');
-}
-
-async function main() {
-  const args = parseArgs();
-
-  // Either --config or --test is required
-  if (!args.config && !args.test) {
-    console.error('Error: Either --config or --test is required');
-    printUsage();
-    process.exit(2);
-  }
-
-  try {
-    // Load and validate configuration
-    let config;
-    let configPath: string | undefined;
-
-    if (args.config) {
-      // Load from config file
-      configPath = path.resolve(args.config);
-      config = await loadConfig(configPath);
-    } else {
-      // Use defaults
-      const { DEFAULT_CONFIG } = await import('./config');
-      config = { ...DEFAULT_CONFIG } as any;
-    }
-
-    // Override with CLI args
-    if (args.test) config.testUrl = args.test;
-    if (args.reference) config.referenceUrl = args.reference;
-
-    let hasExplicitReference = true;
-
-    // If no reference URL set, default to test URL
-    if (!config.referenceUrl && config.testUrl) {
-      config.referenceUrl = config.testUrl;
-      hasExplicitReference = false;
-    }
-
-    if (args.maxUrls) config.maxUrls = args.maxUrls;
-
-    validateConfig(config);
-
-    console.log('🚀 Starting Visual Regression Testing');
-    console.log(`   Reference: ${config.referenceUrl}`);
-    console.log(`   Test: ${config.testUrl}`);
-
-    // Create snapshot directory for URLs and snapshots
-    const snapshotDir = path.resolve('playwright-snapshots');
-    const outputDir = path.resolve(args.output || 'playwright-report');
-
-    if (!fs.existsSync(snapshotDir)) {
-      fs.mkdirSync(snapshotDir, { recursive: true });
-    }
-
-    if (args.verbose) {
-      console.log(`📁 Snapshots: ${snapshotDir}`);
-      console.log(`📁 Output: ${outputDir}`);
-    }
-
-    // Check if URLs already exist (unless --update-baseline)
-    const urlsPath = path.join(snapshotDir, 'urls.json');
-    let urls: string[] = [];
-
-    // Check cache validity based on config object and test file hashes
-    const cacheValid = isCacheValid(snapshotDir, config);
-    const shouldRegenerate = args.updateBaseline || !cacheValid;
-
-    if (!hasExplicitReference && !cacheValid && !args.updateBaseline) {
-      console.error('\n❌ Error: No baseline snapshots found and no reference URL provided.');
-      console.error('   Either:');
-      console.error('   1. Provide --reference <url> to create baseline from a reference system');
-      console.error('   2. Use --update-baseline to create baseline from test URL');
-      console.error('   3. Add referenceUrl to your config file\n');
-      process.exit(2);
-    }
-
-    if (fs.existsSync(urlsPath) && !shouldRegenerate) {
-      // Load existing URLs
-      console.log('\n📋 Using cached URLs from previous run');
-      urls = JSON.parse(fs.readFileSync(urlsPath, 'utf-8'));
-      console.log(`✓ Loaded ${urls.length} URLs from cache`);
-
-      if (args.verbose) {
-        console.log('   (Use --update-baseline to regenerate URLs)');
-      }
-    } else {
-      // Collect URLs from sitemap/crawler
-      if (args.updateBaseline) {
-        console.log('\n🔄 Updating baseline (regenerating URLs)...');
-      } else if (!cacheValid && fs.existsSync(urlsPath)) {
-        console.log('\n🔄 Config or test file changed, regenerating URLs...');
-      } else {
-        console.log('\n🔍 Collecting URLs (first run)...');
-      }
-
-      console.log(`   Source: ${config.referenceUrl}${config.sitemapPath || '/sitemap.xml'}`);
-      const urlResult = await collectURLs(config);
-
-      console.log(`✓ Found ${urlResult.total} URLs, filtered to ${urlResult.filtered}, using top ${urlResult.urls.length}`);
-      console.log(`  Source: ${urlResult.source}`);
-
-      urls = urlResult.urls;
-
-      // Save URLs to snapshot directory (co-located with snapshots for easy caching)
-      fs.writeFileSync(urlsPath, JSON.stringify(urls, null, 2), 'utf-8');
-
-      // Save cache hashes based on final config object
-      saveCacheHashes(snapshotDir, config);
-    }
-
-    if (urls.length === 0) {
-      throw new Error('No URLs found to test');
-    }
-
-    if (args.verbose) {
-      console.log('\n📝 URLs to test:');
-      urls.forEach((url, i) => console.log(`  ${i + 1}. ${url}`));
-    }
-
-    // Run visual regression tests using shipped Playwright config and tests
-    const results = await runVisualTests({
-      config,
-      outputDir,
-      verbose: args.verbose,
-      project: args.project,
-      updateBaseline: shouldRegenerate,
-      hasExplicitReference,
-      headed: args.headed,
-    });
-
-    // Print results
-    printResults(results, config);
-
-    // Report location
-    const reportPath = path.join(outputDir, 'index.html');
-    console.log(`\n📊 Report: ${reportPath}`);
-
-    if (args.verbose) {
-      console.log(`📁 Snapshots: ${snapshotDir}`);
-    }
-
-    // Exit with appropriate code
-    process.exit(results.failed > 0 ? 1 : 0);
-  } catch (error) {
-    console.error('\n❌ Error:', error instanceof Error ? error.message : error);
-    if (args.verbose && error instanceof Error) {
-      console.error(error.stack);
-    }
-    process.exit(2);
-  }
-}
-
-function parseArgs(): CLIOptions {
-  const args: CLIOptions = {
-    config: '',
-  };
-
-  for (let i = 2; i < process.argv.length; i++) {
-    const arg = process.argv[i];
-    const next = process.argv[i + 1];
-
-    switch (arg) {
-      case '--reference':
-        args.reference = next;
-        i++;
-        break;
-      case '--test':
-        args.test = next;
-        i++;
-        break;
-      case '--config':
-        args.config = next;
-        i++;
-        break;
-      case '--output':
-        args.output = next;
-        i++;
-        break;
-      case '--max-urls':
-        args.maxUrls = parseInt(next, 10);
-        i++;
-        break;
-      case '--project':
-        args.project = next;
-        i++;
-        break;
-      case '--verbose':
-        args.verbose = true;
-        break;
-      case '--headed':
-        args.headed = true;
-        break;
-      case '--update-baseline':
-        args.updateBaseline = true;
-        break;
-      case '--clean':
-        // Clean snapshots and reports
-        console.log('🗑️  Cleaning...');
-        ['playwright-snapshots', 'playwright-report', 'playwright-tmp'].forEach(dir => {
-          const fullPath = path.resolve(dir);
-          if (fs.existsSync(fullPath)) {
-            fs.rmSync(fullPath, { recursive: true, force: true });
-            console.log(`   Removed: ${dir}/`);
-          }
-        });
-        console.log('✓ Clean complete');
-        process.exit(0);
-        break;
-      case '--help':
-      case '-h':
-        printUsage();
-        process.exit(0);
-        break;
-    }
-  }
-
-  return args;
-}
-
-function printUsage(): void {
-  console.log(`
-Usage: playwright-vrt run [options]
-
-Required (one of):
-  --test <url>           Test URL
-  --config <path>        Path to config file with testUrl/referenceUrl
-
-Optional:
-  --reference <url>      Reference URL (defaults to --test URL or config)
-  --output <dir>         Output directory (default: ./playwright-report)
-  --max-urls <number>    Override config maxUrls
-  --project <name>       Playwright project to run (default: all)
-  --verbose              Detailed logging
-  --headed               Run browser in headed mode (visible)
-  --update-baseline      Force regenerate URLs and baseline snapshots
-  --clean                Clean playwright-snapshots/ and playwright-report/
-  --help, -h             Show this help message
-
-Examples:
-  # Minimal - compare staging against itself (first run creates baseline)
-  bunx playwright-vrt run --test https://staging.example.com
-
-  # Compare staging against production
-  bunx playwright-vrt run \\
-    --reference https://production.com \\
-    --test https://staging.com
-
-  # With config file only (contains testUrl and referenceUrl)
-  bunx playwright-vrt run --config ./playwright-vrt.config.json
-
-  # With config file + URL override
-  bunx playwright-vrt run \\
-    --test https://preview-123.staging.com \\
-    --config ./playwright-vrt.config.json
-
-Directories:
-  playwright-snapshots/  Baseline snapshots and URLs (cache this!)
-  playwright-report/     HTML test report
-  playwright-tmp/        Temporary test artifacts (cleared on each run)
-
-  Clean with: playwright-vrt run --clean
-  Or manually: rm -rf playwright-snapshots playwright-report playwright-tmp
-`);
-}
-
-// Run the CLI
-main();