@testivai/witness-playwright 1.2.0 → 1.3.0

package/README.md

@@ -89,11 +89,14 @@ import { snapshot } from '@testivai/witness-playwright';
 // Basic usage
 await snapshot(page, testInfo, 'my-snapshot');
 
-// With custom config
+// With per-snapshot overrides
 await snapshot(page, testInfo, 'checkout-page', {
-  threshold: 0.05,  // 5% difference tolerance
-  fullPage: true,   // Capture full page
+  ignoreSelectors: ['.live-chat', '[data-testid=clock]'], // hidden for this capture
+  stabilize: false, // opt out of animation-freeze + font-wait for this snapshot
 });
+
+// Diff tolerances (maxDiffPercent, noiseAutoPass, ...) are project-level:
+// set them in .testivai/config.json — see the repository README.
 ```
 
 ## CI/CD Integration

package/dist/config/ignore-selectors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Helpers for the ignoreSelectors feature.
+ *
+ * Three sources, merged with deduplication (last-write-wins dedup via Set):
+ *   1. .testivai/config.json     — global OSS config (`ignoreSelectors` array)
+ *   2. testivai.config.ts/js     — power-user project config (`ignoreSelectors`)
+ *   3. testivai.witness() call   — per-snapshot override (`ignoreSelectors`)
+ *
+ * These functions are pure (no Playwright dependency) so they can be
+ * exercised in plain Jest unit tests without a browser.
+ */
+import { TestivAIConfig, TestivAIProjectConfig } from '../types';
+/**
+ * Read ignoreSelectors from `.testivai/config.json`.
+ * Returns `[]` when the file doesn't exist or is malformed.
+ *
+ * @param projectRoot  Directory that contains the `.testivai/` folder
+ */
+export declare function readWitnessConfigSelectors(projectRoot: string): string[];
+/**
+ * Collect and deduplicate ignoreSelectors from all three sources.
+ *
+ * Order of precedence for deduplication: earlier sources win (Set preserves
+ * insertion order, so the first occurrence of any selector survives).
+ *
+ * @param projectRoot    Path to the project root (where `.testivai/` lives)
+ * @param projectConfig  Loaded `testivai.config.ts` project config
+ * @param effectiveConfig  Merged per-snapshot TestivAIConfig
+ */
+export declare function collectIgnoreSelectors(projectRoot: string, projectConfig: TestivAIProjectConfig, effectiveConfig: TestivAIConfig): string[];
+/**
+ * Build a `<style>` tag content that hides every given selector via
+ * `visibility: hidden !important`.
+ *
+ * Returns an empty string when the selectors list is empty so callers can
+ * guard with `if (css)` before calling `page.addStyleTag`.
+ */
+export declare function buildIgnoreSelectorsCSS(selectors: string[]): string;

package/dist/config/ignore-selectors.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * Helpers for the ignoreSelectors feature.
+ *
+ * Three sources, merged with deduplication (last-write-wins dedup via Set):
+ *   1. .testivai/config.json     — global OSS config (`ignoreSelectors` array)
+ *   2. testivai.config.ts/js     — power-user project config (`ignoreSelectors`)
+ *   3. testivai.witness() call   — per-snapshot override (`ignoreSelectors`)
+ *
+ * These functions are pure (no Playwright dependency) so they can be
+ * exercised in plain Jest unit tests without a browser.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readWitnessConfigSelectors = readWitnessConfigSelectors;
+exports.collectIgnoreSelectors = collectIgnoreSelectors;
+exports.buildIgnoreSelectorsCSS = buildIgnoreSelectorsCSS;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Read ignoreSelectors from `.testivai/config.json`.
+ * Returns `[]` when the file doesn't exist or is malformed.
+ *
+ * @param projectRoot  Directory that contains the `.testivai/` folder
+ */
+function readWitnessConfigSelectors(projectRoot) {
+    try {
+        const configPath = path.join(projectRoot, '.testivai', 'config.json');
+        if (!fs.existsSync(configPath))
+            return [];
+        const raw = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        return Array.isArray(raw.ignoreSelectors) ? raw.ignoreSelectors : [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Collect and deduplicate ignoreSelectors from all three sources.
+ *
+ * Order of precedence for deduplication: earlier sources win (Set preserves
+ * insertion order, so the first occurrence of any selector survives).
+ *
+ * @param projectRoot    Path to the project root (where `.testivai/` lives)
+ * @param projectConfig  Loaded `testivai.config.ts` project config
+ * @param effectiveConfig  Merged per-snapshot TestivAIConfig
+ */
+function collectIgnoreSelectors(projectRoot, projectConfig, effectiveConfig) {
+    const fromWitnessConfig = readWitnessConfigSelectors(projectRoot);
+    const fromProjectConfig = projectConfig.ignoreSelectors ?? [];
+    const fromSnapshot = effectiveConfig.ignoreSelectors ?? [];
+    return [...new Set([...fromWitnessConfig, ...fromProjectConfig, ...fromSnapshot])];
+}
+/**
+ * Build a `<style>` tag content that hides every given selector via
+ * `visibility: hidden !important`.
+ *
+ * Returns an empty string when the selectors list is empty so callers can
+ * guard with `if (css)` before calling `page.addStyleTag`.
+ */
+function buildIgnoreSelectorsCSS(selectors) {
+    if (selectors.length === 0)
+        return '';
+    return selectors.map(s => `${s} { visibility: hidden !important; }`).join('\n');
+}

package/dist/config/stabilize.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Capture stabilization — neutralize the top causes of flaky visual diffs
+ * before a screenshot is taken:
+ *
+ *   1. CSS animations & transitions (elements caught mid-motion)
+ *   2. The blinking text caret
+ *   3. Web fonts still loading (fallback font rendered in the capture)
+ *   4. Smooth scrolling still settling
+ *
+ * Resolution order for the on/off switch (first defined wins):
+ *   1. per-snapshot  testivai.witness(..., { stabilize })
+ *   2. project       testivai.config.ts → stabilize
+ *   3. global        .testivai/config.json → stabilize
+ *   4. default       true
+ */
+import type { Page } from '@playwright/test';
+import { TestivAIConfig, TestivAIProjectConfig } from '../types';
+/**
+ * CSS injected for the duration of the capture. Near-zero durations (not
+ * `none`) let every animation/transition COMPLETE instantly at its final
+ * state — pages whose content starts hidden and reveals via entry
+ * animations or class transitions render fully. (`animation: none` would
+ * freeze them at the hidden initial state.)
+ */
+export declare const STABILIZE_CSS = "*, *::before, *::after {\n  animation-duration: 0.001s !important;\n  animation-delay: 0s !important;\n  animation-iteration-count: 1 !important;\n  transition-duration: 0.001s !important;\n  transition-delay: 0s !important;\n  caret-color: transparent !important;\n  scroll-behavior: auto !important;\n}";
+/** Read the global `stabilize` flag from `.testivai/config.json`, if set. */
+export declare function readWitnessConfigStabilize(projectRoot: string): boolean | undefined;
+/** Resolve the effective stabilize flag across all three config sources. */
+export declare function resolveStabilize(projectRoot: string, projectConfig: TestivAIProjectConfig, testConfig?: TestivAIConfig): boolean;
+/**
+ * Wait for web fonts to finish loading, bounded at 3s so a hanging font
+ * request can never stall the capture. Best-effort: errors are swallowed —
+ * a missing FontFaceSet API just means no wait.
+ */
+export declare function waitForFonts(page: Page): Promise<void>;

package/dist/config/stabilize.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Capture stabilization — neutralize the top causes of flaky visual diffs
+ * before a screenshot is taken:
+ *
+ *   1. CSS animations & transitions (elements caught mid-motion)
+ *   2. The blinking text caret
+ *   3. Web fonts still loading (fallback font rendered in the capture)
+ *   4. Smooth scrolling still settling
+ *
+ * Resolution order for the on/off switch (first defined wins):
+ *   1. per-snapshot  testivai.witness(..., { stabilize })
+ *   2. project       testivai.config.ts → stabilize
+ *   3. global        .testivai/config.json → stabilize
+ *   4. default       true
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STABILIZE_CSS = void 0;
+exports.readWitnessConfigStabilize = readWitnessConfigStabilize;
+exports.resolveStabilize = resolveStabilize;
+exports.waitForFonts = waitForFonts;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * CSS injected for the duration of the capture. Near-zero durations (not
+ * `none`) let every animation/transition COMPLETE instantly at its final
+ * state — pages whose content starts hidden and reveals via entry
+ * animations or class transitions render fully. (`animation: none` would
+ * freeze them at the hidden initial state.)
+ */
+exports.STABILIZE_CSS = `*, *::before, *::after {
+  animation-duration: 0.001s !important;
+  animation-delay: 0s !important;
+  animation-iteration-count: 1 !important;
+  transition-duration: 0.001s !important;
+  transition-delay: 0s !important;
+  caret-color: transparent !important;
+  scroll-behavior: auto !important;
+}`;
+/** Read the global `stabilize` flag from `.testivai/config.json`, if set. */
+function readWitnessConfigStabilize(projectRoot) {
+    try {
+        const configPath = path.join(projectRoot, '.testivai', 'config.json');
+        if (!fs.existsSync(configPath))
+            return undefined;
+        const raw = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        return typeof raw.stabilize === 'boolean' ? raw.stabilize : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Resolve the effective stabilize flag across all three config sources. */
+function resolveStabilize(projectRoot, projectConfig, testConfig) {
+    if (typeof testConfig?.stabilize === 'boolean')
+        return testConfig.stabilize;
+    if (typeof projectConfig.stabilize === 'boolean')
+        return projectConfig.stabilize;
+    const fromWitnessConfig = readWitnessConfigStabilize(projectRoot);
+    if (typeof fromWitnessConfig === 'boolean')
+        return fromWitnessConfig;
+    return true;
+}
+/**
+ * Wait for web fonts to finish loading, bounded at 3s so a hanging font
+ * request can never stall the capture. Best-effort: errors are swallowed —
+ * a missing FontFaceSet API just means no wait.
+ */
+async function waitForFonts(page) {
+    try {
+        await page.evaluate(() => Promise.race([
+            document.fonts?.ready,
+            new Promise((resolve) => setTimeout(resolve, 3000)),
+        ]));
+    }
+    catch {
+        // Page navigated or evaluate failed — capture proceeds unstabilized fonts
+    }
+}

package/dist/snapshot.d.ts

@@ -1,5 +1,17 @@
 import { Page, TestInfo } from '@playwright/test';
 import { TestivAIConfig } from './types';
+/**
+ * Compute the effective snapshot name, folding in a project variant when the
+ * Playwright config runs multiple projects. Without this, two projects (e.g.
+ * chromium-desktop and mobile-safari) capturing the same snapshot name would
+ * overwrite each other's baselines under .testivai/baselines/<name>/.
+ *
+ * Single-project configs are untouched: 'homepage' stays 'homepage'.
+ * Multi-project configs get 'homepage__chromium', 'homepage__mobile-safari'.
+ * The variant lives in the NAME, so the on-disk layout, results.json schema,
+ * report, approve CLI, and PR-comment approvals all work unchanged.
+ */
+export declare function effectiveSnapshotName(baseName: string, testInfo: TestInfo): string;
 /**
  * Captures a snapshot of the page, including a screenshot, DOM, and layout data.
  * The evidence is stored in a temporary directory for the reporter to process later.

package/dist/snapshot.js

@@ -36,12 +36,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.effectiveSnapshotName = effectiveSnapshotName;
 exports.snapshot = snapshot;
 const fs = __importStar(require("fs-extra"));
 const path = __importStar(require("path"));
 const url_1 = require("url");
 const sharp_1 = __importDefault(require("sharp"));
 const loader_1 = require("./config/loader");
+const ignore_selectors_1 = require("./config/ignore-selectors");
+const stabilize_1 = require("./config/stabilize");
 /**
  * Generates a safe filename from a URL.
  * @param pageUrl The URL of the page.
@@ -62,6 +65,27 @@ function getSnapshotNameFromUrl(pageUrl) {
         return 'snapshot';
     }
 }
+/**
+ * Compute the effective snapshot name, folding in a project variant when the
+ * Playwright config runs multiple projects. Without this, two projects (e.g.
+ * chromium-desktop and mobile-safari) capturing the same snapshot name would
+ * overwrite each other's baselines under .testivai/baselines/<name>/.
+ *
+ * Single-project configs are untouched: 'homepage' stays 'homepage'.
+ * Multi-project configs get 'homepage__chromium', 'homepage__mobile-safari'.
+ * The variant lives in the NAME, so the on-disk layout, results.json schema,
+ * report, approve CLI, and PR-comment approvals all work unchanged.
+ */
+function effectiveSnapshotName(baseName, testInfo) {
+    const projects = testInfo?.config?.projects;
+    const projectName = testInfo?.project?.name;
+    if (!Array.isArray(projects) || projects.length <= 1)
+        return baseName;
+    if (typeof projectName !== 'string' || projectName.length === 0)
+        return baseName;
+    const safeVariant = projectName.replace(/[^a-z0-9_-]+/gi, '_').toLowerCase();
+    return `${baseName}__${safeVariant}`;
+}
 /**
  * Captures a snapshot of the page, including a screenshot, DOM, and layout data.
  * The evidence is stored in a temporary directory for the reporter to process later.
@@ -88,7 +112,7 @@ async function snapshot(page, testInfo, name, config) {
     }
     const outputDir = path.join(process.cwd(), '.testivai', 'temp');
     await fs.ensureDir(outputDir);
-    const snapshotName = name || getSnapshotNameFromUrl(page.url());
+    const snapshotName = effectiveSnapshotName(name || getSnapshotNameFromUrl(page.url()), testInfo);
     const timestamp = Date.now();
     const safeName = snapshotName.replace(/[^a-z0-9]/gi, '_').toLowerCase();
     const baseFilename = `${timestamp}_${safeName}`;
@@ -96,29 +120,31 @@ async function snapshot(page, testInfo, name, config) {
     const screenshotPath = path.join(outputDir, `${baseFilename}.png`);
     // In local mode: hide elements matching ignoreSelectors before the screenshot
     // so dynamic content (version badges, timestamps, ads) doesn't cause false diffs.
-    // Sources (merged, deduped):
+    // Sources (merged, deduped) — see config/ignore-selectors.ts:
     //   1. .testivai/config.json  → ignoreSelectors  (global, OSS config)
     //   2. testivai.config.ts     → ignoreSelectors  (global, power users)
     //   3. testivai.witness(...)  → { ignoreSelectors } (per-snapshot override)
     let ignoreStyleEl = null;
     if (isLocalMode) {
-        // Read global ignores from .testivai/config.json
-        let witnessConfigIgnore = [];
+        const allSelectors = (0, ignore_selectors_1.collectIgnoreSelectors)(process.cwd(), projectConfig, effectiveConfig);
+        const css = (0, ignore_selectors_1.buildIgnoreSelectorsCSS)(allSelectors);
+        if (css) {
+            ignoreStyleEl = await page.addStyleTag({ content: css });
+        }
+    }
+    // Stabilize the page before capture (all modes): freeze CSS animations and
+    // transitions, hide the caret, and wait for web fonts — the top sources of
+    // flaky pixel diffs. Injected as CSS so every capture path (native
+    // screenshot, CDP captureScreenshot, scroll-and-stitch) is covered.
+    let stabilizeStyleEl = null;
+    if ((0, stabilize_1.resolveStabilize)(process.cwd(), projectConfig, config)) {
         try {
-            const witnessConfigPath = path.join(process.cwd(), '.testivai', 'config.json');
-            if (fs.existsSync(witnessConfigPath)) {
-                const raw = JSON.parse(fs.readFileSync(witnessConfigPath, 'utf-8'));
-                witnessConfigIgnore = raw.ignoreSelectors ?? [];
-            }
+            stabilizeStyleEl = await page.addStyleTag({ content: stabilize_1.STABILIZE_CSS });
         }
-        catch { /* ignore malformed config */ }
-        const playwrightConfigIgnore = projectConfig.ignoreSelectors ?? [];
-        const perSnapshotIgnore = effectiveConfig.ignoreSelectors ?? [];
-        const allSelectors = [...new Set([...witnessConfigIgnore, ...playwrightConfigIgnore, ...perSnapshotIgnore])];
-        if (allSelectors.length > 0) {
-            const css = allSelectors.map(s => `${s} { visibility: hidden !important; }`).join('\n');
-            ignoreStyleEl = await page.addStyleTag({ content: css });
+        catch {
+            // Style injection can fail on locked-down pages; capture proceeds
         }
+        await (0, stabilize_1.waitForFonts)(page);
     }
     // Check if scroll-and-stitch is explicitly requested (backup method)
     if (effectiveConfig.useBrowserCapture === false) {
@@ -341,6 +367,11 @@ async function snapshot(page, testInfo, name, config) {
         await ignoreStyleEl.evaluate((el) => el.remove()).catch(() => { });
         ignoreStyleEl = null;
     }
+    // Re-enable animations/transitions after capture
+    if (stabilizeStyleEl) {
+        await stabilizeStyleEl.evaluate((el) => el.remove()).catch(() => { });
+        stabilizeStyleEl = null;
+    }
     // 1.5. Local mode: also place the screenshot in the layout expected by
     //      @testivai/witness/report (subdirectory keyed by snapshot name).
     //      This is what `BaselineStore.listTemp()` and `compareAll()` enumerate.
@@ -355,7 +386,19 @@ async function snapshot(page, testInfo, name, config) {
         await fs.ensureDir(localSnapshotDir);
         await fs.copyFile(screenshotPath, path.join(localSnapshotDir, 'screenshot.png'));
         try {
-            const domHtml = await page.evaluate(() => document.documentElement.outerHTML);
+            const domIgnoreSelectors = (0, ignore_selectors_1.collectIgnoreSelectors)(process.cwd(), projectConfig, effectiveConfig);
+            const domHtml = await page.evaluate((selectors) => {
+                // ignoreSelectors excludes elements from the pixel diff, so they
+                // are excluded from the DOM/text signal too (consistent semantic)
+                const clone = document.documentElement.cloneNode(true);
+                for (const sel of selectors) {
+                    try {
+                        clone.querySelectorAll(sel).forEach((el) => el.remove());
+                    }
+                    catch { }
+                }
+                return clone.outerHTML;
+            }, domIgnoreSelectors);
             if (typeof domHtml === 'string' && domHtml.length > 0) {
                 await fs.writeFile(path.join(localSnapshotDir, 'dom.html'), domHtml, 'utf-8');
             }

package/dist/types.d.ts

@@ -196,6 +196,8 @@ export interface TestivAIProjectConfig {
     structure?: StructureAnalysisConfig;
     /** Environment-specific overrides (optional) */
     environments?: EnvironmentConfig;
+    /** Stabilize captures (disable animations, hide caret, wait for fonts). Default: true. */
+    stabilize?: boolean;
 }
 /**
  * Per-test configuration overrides
@@ -228,6 +230,15 @@ export interface TestivAIConfig {
      * Example: ["[data-testivai-ignore]", ".version-badge", "#live-chat-widget"]
      */
     ignoreSelectors?: string[];
+    /**
+     * Stabilize the page before capture: disable CSS animations/transitions,
+     * hide the text caret, and wait for web fonts to finish loading — the top
+     * causes of flaky visual diffs. Default: true.
+     *
+     * Can also be set globally in `.testivai/config.json` under `stabilize`
+     * or in `testivai.config.ts`. Per-snapshot values win.
+     */
+    stabilize?: boolean;
 }
 /**
  * Layout/Bounding box data for an element

package/package.json

@@ -1,16 +1,12 @@
 {
   "name": "@testivai/witness-playwright",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Playwright sensor for Testivai Visual Regression Test system",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "bin": {
-    "testivai": "dist/cli/index.js"
-  },
   "exports": {
     ".": "./dist/index.js",
-    "./reporter": "./dist/reporter-entry.js",
-    "./cli": "./dist/cli/index.js"
+    "./reporter": "./dist/reporter-entry.js"
   },
   "keywords": [
     "playwright",
@@ -46,23 +42,23 @@
   "dependencies": {
     "axios": "^1.16.1",
     "chalk": "^4.1.2",
-    "commander": "^11.0.0",
+    "commander": "^14.0.3",
     "cross-fetch": "^4.0.0",
     "fs-extra": "^11.3.5",
     "sharp": "^0.34.5",
     "simple-git": "^3.21.0",
     "@testivai/common": "0.2.2",
-    "@testivai/witness": "1.1.0"
+    "@testivai/witness": "1.2.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",
     "@types/fs-extra": "^11.0.4",
     "@types/jest": "^30.0.0",
     "@types/node": "^20.10.0",
-    "jest": "^30.2.0",
-    "ts-jest": "^29.4.5",
+    "jest": "^30.4.2",
+    "ts-jest": "^29.4.11",
     "ts-node": "^10.9.0",
-    "typescript": "^5.3.0"
+    "typescript": "^6.0.3"
   },
   "scripts": {
     "build": "tsc",

package/dist/cli/index.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/cli/index.js

@@ -1,47 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
-const chalk_1 = __importDefault(require("chalk"));
-const init_1 = require("./init");
-const program = new commander_1.Command();
-// Display banner
-const showBanner = () => {
-    console.log();
-    console.log(chalk_1.default.cyan.bold('  TestivAI'));
-    console.log(chalk_1.default.gray('  Catch Visual Bugs Automatically'));
-    console.log(chalk_1.default.gray('  AI that catches real bugs, ignores the noise.'));
-    console.log();
-};
-program
-    .name('testivai')
-    .description('TestivAI Playwright SDK CLI')
-    .version(require('../../package.json').version)
-    .hook('preAction', () => {
-    if (!process.argv.includes('--quiet') && !process.argv.includes('-q')) {
-        showBanner();
-    }
-});
-// Global options
-program
-    .option('-q, --quiet', 'Suppress banner output (ideal for CI)');
-program
-    .command('init')
-    .description('Initialize TestivAI configuration file')
-    .action(async () => {
-    try {
-        await (0, init_1.createConfigFile)();
-    }
-    catch (error) {
-        console.error('❌ Failed to initialize:', error);
-        process.exit(1);
-    }
-});
-program.parse(process.argv);
-// Show help if no command provided
-if (!process.argv.slice(2).length) {
-    program.outputHelp();
-}

package/dist/cli/init.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-declare function createConfigFile(): Promise<void>;
-export { createConfigFile };

package/dist/cli/init.js

@@ -1,158 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createConfigFile = createConfigFile;
-const fs = __importStar(require("fs-extra"));
-const path = __importStar(require("path"));
-/**
- * Basic CLI init script for TestivAI Playwright SDK
- * Creates a testivai.config.ts file with sensible defaults
- */
-const DEFAULT_CONFIG = `/**
- * TestivAI Configuration File
- * 
- * This file configures how TestivAI analyzes visual differences in your tests.
- * 
- * Layout Settings:
- * - sensitivity: 0-4 scale (0=strict/precise, 4=very lenient)
- * - tolerance: Base pixel tolerance for layout differences
- * 
- * AI Settings:
- * - sensitivity: 0-4 scale (0=conservative, 4=aggressive)
- * - confidence: 0.0-1.0 scale (minimum confidence required for AI_BUG verdict)
- * 
- * Custom Configuration Examples:
- * 
- * // For strict testing (critical components):
- * export default {
- *   layout: { sensitivity: 0, tolerance: 0.5 },
- *   ai: { sensitivity: 0, confidence: 0.9 }
- * };
- * 
- * // For lenient testing (dynamic content):
- * export default {
- *   layout: { sensitivity: 4, tolerance: 3.0 },
- *   ai: { sensitivity: 3, confidence: 0.6 }
- * };
- * 
- * // Per-selector tolerances (advanced):
- * export default {
- *   layout: { 
- *     sensitivity: 2, 
- *     tolerance: 1.0,
- *     selectorTolerances: {
- *       '.carousel': 4.0,      // Carousel components shift
- *       '.dropdown': 2.0,      // Dropdowns can vary
- *       '.tooltip': 5.0,       // Tooltips are highly variable
- *       '.submit-button': 0.5  // Critical buttons need precision
- *     }
- *   },
- *   ai: { sensitivity: 2, confidence: 0.7 }
- * };
- * 
- * // Environment-specific overrides:
- * export default {
- *   layout: { sensitivity: 2, tolerance: 1.0 },
- *   ai: { sensitivity: 2, confidence: 0.7 },
- *   environments: {
- *     ci: {
- *       layout: { sensitivity: 1, tolerance: 0.5 },  // Stricter in CI
- *       ai: { sensitivity: 1, confidence: 0.8 }
- *     },
- *     development: {
- *       layout: { sensitivity: 3, tolerance: 2.0 },  // More lenient locally
- *       ai: { sensitivity: 3, confidence: 0.6 }
- *     }
- *   }
- * };
- */
-
-export default {
-  // Your TestivAI API key - get this from the dashboard after creating a project
-  apiKey: process.env.TESTIVAI_API_KEY || '',
-  
-  // API endpoint - automatically points to production
-  apiUrl: process.env.TESTIVAI_API_URL || 'https://core-api.testiv.ai',
-  
-  layout: {
-    sensitivity: 2,        // Balanced sensitivity (0-4 scale)
-    tolerance: 1.0,        // 1 pixel base tolerance
-  },
-  ai: {
-    sensitivity: 2,        // Balanced AI analysis (0-4 scale)
-    confidence: 0.7,       // 70% confidence required for AI_BUG
-  }
-};
-`;
-async function createConfigFile() {
-    const configPath = path.join(process.cwd(), 'testivai.config.ts');
-    // Check if config already exists
-    if (await fs.pathExists(configPath)) {
-        console.log('❌ TestivAI config already exists at:', configPath);
-        console.log('   Delete it first if you want to regenerate it.');
-        process.exit(1);
-    }
-    try {
-        // Create the config file
-        await fs.writeFile(configPath, DEFAULT_CONFIG, 'utf8');
-        console.log('✅ TestivAI configuration created successfully!');
-        console.log('📁 Config file:', configPath);
-        console.log('');
-        console.log('📖 Next steps:');
-        console.log('   1. Set up your API key:');
-        console.log('      TESTIVAI_API_KEY=tstvai-your-key-here');
-        console.log('');
-        console.log('   2. Update your playwright.config.ts to use TestivAI reporter:');
-        console.log('      reporter: [[\'@testivai/witness-playwright/reporter\']]');
-        console.log('');
-        console.log('   3. Review and customize testivai.config.ts');
-        console.log('   4. Run your tests: npx playwright test');
-        console.log('');
-        console.log('💡 Get your API key from: https://dashboard.testiv.ai');
-        console.log('💡 The SDK automatically connects to the production API - no URL configuration needed!');
-    }
-    catch (error) {
-        console.error('❌ Failed to create configuration file:', error);
-        process.exit(1);
-    }
-}
-// Main execution
-if (require.main === module) {
-    createConfigFile().catch(error => {
-        console.error('❌ CLI init failed:', error);
-        process.exit(1);
-    });
-}