@iqual/playwright-vrt 0.1.0 → 0.1.2

package/{playwright.config.ts → dist/playwright.config.js}

@@ -1,5 +1,3 @@
-import { defineConfig } from '@playwright/test';
-
 // This config is shipped with playwright-vrt package
 // User's config is loaded via environment variables
 
@@ -7,7 +5,7 @@ const vrtConfig = process.env.VRT_CONFIG
   ? JSON.parse(process.env.VRT_CONFIG)
   : { viewports: [{ name: 'desktop', width: 1920, height: 1080 }] };
 
-export default defineConfig({
+export default {
   testDir: './tests',
   fullyParallel: true,
   retries: process.env.CI ? 2 : 1,
@@ -44,11 +42,11 @@ export default defineConfig({
   },
 
   // Create a project for each viewport
-  projects: vrtConfig.viewports.map((vp: any) => ({
+  projects: vrtConfig.viewports.map((vp) => ({
     name: vp.name,
     use: {
       viewport: { width: vp.width, height: vp.height },
       deviceScaleFactor: 1,
     },
   })),
-});
+};

package/dist/src/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":""}

package/dist/src/cli.js

@@ -0,0 +1,301 @@
+#!/usr/bin/env bun
+import * as path from 'path';
+import * as fs from 'fs';
+import { loadConfig, validateConfig } from './config.js';
+import { collectURLs } from './collect.js';
+import { runVisualTests, printResults } from './runner.js';
+import { createHash } from 'crypto';
+/**
+ * Compute SHA-256 hash of a file
+ */
+function computeFileHash(filePath) {
+    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) {
+    // 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, config) {
+    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, config) {
+    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;
+        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 };
+        }
+        // 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 = [];
+        // 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() {
+    const args = {
+        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() {
+    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();
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/collect.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env bun
+import type { VRTConfig } from './config.js';
+export interface URLCollectionResult {
+    urls: string[];
+    source: 'sitemap' | 'crawl';
+    total: number;
+    filtered: number;
+}
+export declare function collectURLs(config: VRTConfig): Promise<URLCollectionResult>;
+export declare function saveURLs(urls: string[], filepath: string): void;
+//# sourceMappingURL=collect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/collect.ts"],"names":[],"mappings":";AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiCjF;AAwHD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAG/D"}

package/dist/src/collect.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env bun
+import Sitemapper from 'sitemapper';
+import micromatch from 'micromatch';
+import { chromium } from 'playwright';
+export async function collectURLs(config) {
+    let urls = [];
+    let source = 'sitemap';
+    // Try sitemap first
+    try {
+        urls = await collectFromSitemap(config.referenceUrl, config.sitemapPath || '/sitemap.xml');
+    }
+    catch (error) {
+        console.warn('⚠️ Sitemap fetch failed, falling back to crawler');
+        // Fallback to crawling
+        urls = await crawlWebsite(config.referenceUrl, config.crawlOptions);
+        source = 'crawl';
+    }
+    const totalUrls = urls.length;
+    // Filter URLs
+    urls = filterURLs(urls, config.referenceUrl, config.include || ['*'], config.exclude || []);
+    // Remove duplicate URLs but keep order
+    urls = Array.from(new Set(urls));
+    // Limit to maxUrls
+    const maxUrls = config.maxUrls || 25;
+    const filteredCount = urls.length;
+    urls = urls.slice(0, maxUrls);
+    return {
+        urls,
+        source,
+        total: totalUrls,
+        filtered: filteredCount,
+    };
+}
+async function collectFromSitemap(baseUrl, sitemapPath) {
+    const sitemapUrl = new URL(sitemapPath, baseUrl).toString();
+    const sitemap = new Sitemapper({
+        url: sitemapUrl,
+        timeout: 15000,
+    });
+    const { sites } = await sitemap.fetch();
+    if (!sites || sites.length === 0) {
+        throw new Error('No URLs found in sitemap');
+    }
+    return sites;
+}
+async function crawlWebsite(baseUrl, options) {
+    const urls = new Set();
+    console.log('   Using crawler (homepage links only)...');
+    const browser = await chromium.launch({ headless: true });
+    const page = await browser.newPage();
+    const baseUrlObj = new URL(baseUrl);
+    try {
+        // Visit the homepage
+        await page.goto(baseUrl, {
+            waitUntil: 'networkidle',
+            timeout: 30000
+        });
+        // Add the homepage itself, by adding the current page URL
+        urls.add(page.url());
+        // Extract all links from the page
+        const links = await page.evaluate(() => {
+            // @ts-ignore - runs in browser context
+            const anchors = Array.from(document.querySelectorAll('a[href]'));
+            // @ts-ignore - runs in browser context
+            return anchors.map(a => a.href);
+        });
+        // Filter links to same domain and add to set
+        for (const link of links) {
+            try {
+                const linkUrl = new URL(link);
+                // Only include links from the same domain
+                if (linkUrl.hostname === baseUrlObj.hostname) {
+                    // Normalize URL (remove hash)
+                    linkUrl.hash = '';
+                    const normalizedUrl = linkUrl.toString();
+                    if (options?.removeTrailingSlash) {
+                        // Remove trailing slash for consistency (except for root)
+                        const cleanUrl = normalizedUrl.endsWith('/') && normalizedUrl !== baseUrl + '/'
+                            ? normalizedUrl.slice(0, -1)
+                            : normalizedUrl;
+                        urls.add(cleanUrl);
+                    }
+                    else {
+                        urls.add(normalizedUrl);
+                    }
+                }
+            }
+            catch {
+                // Skip invalid URLs
+            }
+        }
+        console.log(`   Found ${urls.size} URLs from homepage`);
+    }
+    catch (error) {
+        console.error('   Crawler error:', error instanceof Error ? error.message : error);
+        // At minimum, return the base URL
+        urls.add(baseUrl);
+    }
+    finally {
+        await browser.close();
+    }
+    return Array.from(urls);
+}
+function filterURLs(urls, baseUrl, include, exclude) {
+    return urls.filter((url) => {
+        // Convert URL to path for pattern matching
+        const urlObj = new URL(url);
+        const path = urlObj.pathname + urlObj.search;
+        // Filter URLs that don't match the reference URL domain
+        const baseObj = new URL(baseUrl);
+        if (urlObj.hostname !== baseObj.hostname) {
+            return false;
+        }
+        // Also match against full URL for more flexibility
+        const fullUrl = url;
+        // Check if excluded
+        if (exclude.length > 0) {
+            if (micromatch.isMatch(path, exclude, { bash: true })) {
+                return false;
+            }
+        }
+        // Check if included
+        if (include.length > 0) {
+            return micromatch.isMatch(path, include, { bash: true });
+        }
+        return true;
+    });
+}
+export function saveURLs(urls, filepath) {
+    const content = JSON.stringify(urls, null, 2);
+    Bun.write(filepath, content);
+}
+//# sourceMappingURL=collect.js.map

package/dist/src/collect.js.map

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

package/dist/src/config.d.ts

@@ -0,0 +1,38 @@
+#!/usr/bin/env bun
+export interface VRTConfig {
+    referenceUrl: string;
+    testUrl: string;
+    sitemapPath?: string;
+    maxUrls?: number;
+    exclude?: string[];
+    include?: string[];
+    crawlOptions?: {
+        maxDepth?: number;
+        removeTrailingSlash?: boolean;
+    };
+    viewports?: Array<{
+        name: string;
+        width: number;
+        height: number;
+    }>;
+    threshold?: {
+        maxDiffPixels?: number;
+        maxDiffPixelRatio?: number;
+    };
+}
+export interface CLIOptions {
+    reference?: string;
+    test?: string;
+    config: string;
+    output?: string;
+    maxUrls?: number;
+    project?: string;
+    verbose?: boolean;
+    identifier?: string;
+    updateBaseline?: boolean;
+    headed?: boolean;
+}
+export declare const DEFAULT_CONFIG: Partial<VRTConfig>;
+export declare function loadConfig(configPath: string): Promise<VRTConfig>;
+export declare function validateConfig(config: VRTConfig): void;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":";AAEA,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;IACF,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,SAAS,CAAC,EAAE;QACV,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,SAAS,CAiB7C,CAAC;AAEF,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAyBvE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmCtD"}

package/dist/src/config.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env bun
+export const DEFAULT_CONFIG = {
+    sitemapPath: '/sitemap.xml',
+    maxUrls: 25,
+    exclude: [],
+    include: ['*'],
+    crawlOptions: {
+        maxDepth: 1,
+        removeTrailingSlash: true,
+    },
+    viewports: [
+        { name: 'desktop', width: 1920, height: 1080 },
+        { name: 'mobile', width: 375, height: 667 },
+    ],
+    threshold: {
+        maxDiffPixels: 100,
+        maxDiffPixelRatio: 0.01,
+    },
+};
+export async function loadConfig(configPath) {
+    try {
+        const file = Bun.file(configPath);
+        const config = await file.json();
+        // Merge with defaults
+        return {
+            ...DEFAULT_CONFIG,
+            ...config,
+            crawlOptions: {
+                ...DEFAULT_CONFIG.crawlOptions,
+                ...config.crawlOptions,
+            },
+            viewports: config.viewports || DEFAULT_CONFIG.viewports,
+            threshold: {
+                ...DEFAULT_CONFIG.threshold,
+                ...config.threshold,
+            },
+        };
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            throw new Error(`Config file not found: ${configPath}`);
+        }
+        throw error;
+    }
+}
+export function validateConfig(config) {
+    // Validate required URLs
+    if (!config.testUrl) {
+        throw new Error('testUrl is required');
+    }
+    if (!config.referenceUrl) {
+        throw new Error('referenceUrl is required');
+    }
+    // Validate URL format
+    try {
+        new URL(config.referenceUrl);
+        new URL(config.testUrl);
+    }
+    catch {
+        throw new Error('Invalid URL format in referenceUrl or testUrl');
+    }
+    // Validate viewports
+    if (!config.viewports || config.viewports.length === 0) {
+        throw new Error('At least one viewport must be defined');
+    }
+    for (const vp of config.viewports) {
+        if (!vp.name || vp.width <= 0 || vp.height <= 0) {
+            throw new Error(`Invalid viewport configuration: ${JSON.stringify(vp)}`);
+        }
+    }
+    // Validate threshold
+    if (config.threshold) {
+        if (config.threshold.maxDiffPixelRatio &&
+            (config.threshold.maxDiffPixelRatio < 0 || config.threshold.maxDiffPixelRatio > 1)) {
+            throw new Error('maxDiffPixelRatio must be between 0 and 1');
+        }
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import './cli.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,UAAU,CAAC"}

package/{src/index.ts → dist/src/index.js}

@@ -1,2 +1,3 @@
 #!/usr/bin/env bun
 import './cli.ts';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,UAAU,CAAC"}