@testivai/witness-playwright 2.0.3 → 2.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testivai/witness-playwright",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "Playwright adapter for TestivAI Witness — local-first visual regression with pixel + DOM comparison",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -46,7 +46,7 @@
   "dependencies": {
     "fs-extra": "^11.4.0",
     "sharp": "^0.35.4",
-    "@testivai/witness": "2.1.0"
+    "@testivai/witness": "2.2.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.63.0",

package/dist/ci.d.ts

@@ -1,30 +0,0 @@
-/**
- * Utilities for detecting CI/CD environments and extracting a unique run identifier.
- */
-/**
- * CI environment information for integration feedback (e.g., GitHub commit statuses, PR comments).
- */
-export interface CiInfo {
-    /** CI provider name */
-    provider: string;
-    /** Pull/Merge request number (if available) */
-    prNumber?: number;
-    /** URL to the CI run (if available) */
-    runUrl?: string;
-    /** CI build/run identifier */
-    buildId?: string;
-}
-/**
- * Gets a unique identifier for the current CI run.
- * This ID is used to group snapshots from parallel shards into a single batch.
- *
- * @returns A unique string identifier for the CI run, or null if not in a known CI environment.
- */
-export declare function getCiRunId(): string | null;
-/**
- * Gets detailed CI environment information including PR number and run URL.
- * Used for integration feedback (GitHub commit statuses, PR comments, etc.).
- *
- * @returns CiInfo object if in a known CI environment, or null otherwise.
- */
-export declare function getCiInfo(): CiInfo | null;

package/dist/ci.js

@@ -1,117 +0,0 @@
-"use strict";
-/**
- * Utilities for detecting CI/CD environments and extracting a unique run identifier.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCiRunId = getCiRunId;
-exports.getCiInfo = getCiInfo;
-/**
- * Gets a unique identifier for the current CI run.
- * This ID is used to group snapshots from parallel shards into a single batch.
- *
- * @returns A unique string identifier for the CI run, or null if not in a known CI environment.
- */
-function getCiRunId() {
-    // GitHub Actions
-    if (process.env.GITHUB_RUN_ID) {
-        return `github-${process.env.GITHUB_RUN_ID}`;
-    }
-    // GitLab CI
-    if (process.env.GITLAB_CI) {
-        return `gitlab-${process.env.CI_PIPELINE_ID}`;
-    }
-    // Jenkins
-    if (process.env.JENKINS_URL) {
-        return `jenkins-${process.env.BUILD_ID}`;
-    }
-    // CircleCI
-    if (process.env.CIRCLECI) {
-        return `circleci-${process.env.CIRCLE_WORKFLOW_ID}`;
-    }
-    // Travis CI
-    if (process.env.TRAVIS) {
-        return `travis-${process.env.TRAVIS_BUILD_ID}`;
-    }
-    return null;
-}
-/**
- * Gets detailed CI environment information including PR number and run URL.
- * Used for integration feedback (GitHub commit statuses, PR comments, etc.).
- *
- * @returns CiInfo object if in a known CI environment, or null otherwise.
- */
-function getCiInfo() {
-    // GitHub Actions
-    if (process.env.GITHUB_ACTIONS) {
-        const serverUrl = process.env.GITHUB_SERVER_URL || 'https://github.com';
-        const repo = process.env.GITHUB_REPOSITORY;
-        const runId = process.env.GITHUB_RUN_ID;
-        // PR number: available via GITHUB_EVENT_NUMBER in pull_request events,
-        // or from GITHUB_REF (refs/pull/<number>/merge)
-        let prNumber;
-        if (process.env.GITHUB_EVENT_NUMBER) {
-            prNumber = parseInt(process.env.GITHUB_EVENT_NUMBER, 10) || undefined;
-        }
-        else if (process.env.GITHUB_REF?.startsWith('refs/pull/')) {
-            const match = process.env.GITHUB_REF.match(/^refs\/pull\/(\d+)\//);
-            if (match) {
-                prNumber = parseInt(match[1], 10);
-            }
-        }
-        return {
-            provider: 'github_actions',
-            prNumber,
-            runUrl: repo && runId ? `${serverUrl}/${repo}/actions/runs/${runId}` : undefined,
-            buildId: runId,
-        };
-    }
-    // GitLab CI
-    if (process.env.GITLAB_CI) {
-        const prNumber = process.env.CI_MERGE_REQUEST_IID
-            ? parseInt(process.env.CI_MERGE_REQUEST_IID, 10) || undefined
-            : undefined;
-        return {
-            provider: 'gitlab_ci',
-            prNumber,
-            runUrl: process.env.CI_PIPELINE_URL || undefined,
-            buildId: process.env.CI_PIPELINE_ID,
-        };
-    }
-    // CircleCI
-    if (process.env.CIRCLECI) {
-        const prNumber = process.env.CIRCLE_PULL_REQUEST
-            ? parseInt(process.env.CIRCLE_PULL_REQUEST.split('/').pop() || '', 10) || undefined
-            : undefined;
-        return {
-            provider: 'circleci',
-            prNumber,
-            runUrl: process.env.CIRCLE_BUILD_URL || undefined,
-            buildId: process.env.CIRCLE_WORKFLOW_ID,
-        };
-    }
-    // Jenkins
-    if (process.env.JENKINS_URL) {
-        const prNumber = process.env.CHANGE_ID
-            ? parseInt(process.env.CHANGE_ID, 10) || undefined
-            : undefined;
-        return {
-            provider: 'jenkins',
-            prNumber,
-            runUrl: process.env.BUILD_URL || undefined,
-            buildId: process.env.BUILD_ID,
-        };
-    }
-    // Travis CI
-    if (process.env.TRAVIS) {
-        const prNumber = process.env.TRAVIS_PULL_REQUEST && process.env.TRAVIS_PULL_REQUEST !== 'false'
-            ? parseInt(process.env.TRAVIS_PULL_REQUEST, 10) || undefined
-            : undefined;
-        return {
-            provider: 'travis_ci',
-            prNumber,
-            runUrl: process.env.TRAVIS_BUILD_WEB_URL || undefined,
-            buildId: process.env.TRAVIS_BUILD_ID,
-        };
-    }
-    return null;
-}

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);
-    });
-}

package/dist/mode.d.ts

@@ -1,21 +0,0 @@
-/**
- * Resolve whether the adapter should run in local mode.
- *
- * Local-first is the zero-config default: with no API key, the adapter
- * captures to `.testivai/temp/<name>/` and writes an HTML report — no cloud,
- * no account, nothing scary. Cloud mode activates only when a key is present.
- *
- * Precedence (first match wins):
- *   1. TESTIVAI_MODE env — explicit override ('local' | 'cloud')
- *   2. .testivai/config.json `mode` — project default
- *   3. TESTIVAI_API_KEY presence — key ⇒ cloud, no key ⇒ local
- *
- * This is deliberately derivable from the shell environment and the config
- * file alone, so it resolves identically in the Playwright main process (the
- * reporter) and in worker processes (the `snapshot()` capture) — env vars set
- * at runtime by the reporter never propagate to already-spawned workers.
- */
-export declare function resolveLocalMode(opts?: {
-    apiKey?: string;
-    projectRoot?: string;
-}): boolean;

package/dist/mode.js

@@ -1,84 +0,0 @@
-"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.resolveLocalMode = resolveLocalMode;
-const fs = __importStar(require("fs-extra"));
-const path = __importStar(require("path"));
-/**
- * Read `mode` from .testivai/config.json. Returns null when the file is
- * absent, malformed, or has no recognized mode field.
- */
-function configMode(projectRoot) {
-    try {
-        const cfg = fs.readJsonSync(path.join(projectRoot, '.testivai', 'config.json'));
-        if (cfg?.mode === 'local')
-            return 'local';
-        if (cfg?.mode === 'cloud')
-            return 'cloud';
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Resolve whether the adapter should run in local mode.
- *
- * Local-first is the zero-config default: with no API key, the adapter
- * captures to `.testivai/temp/<name>/` and writes an HTML report — no cloud,
- * no account, nothing scary. Cloud mode activates only when a key is present.
- *
- * Precedence (first match wins):
- *   1. TESTIVAI_MODE env — explicit override ('local' | 'cloud')
- *   2. .testivai/config.json `mode` — project default
- *   3. TESTIVAI_API_KEY presence — key ⇒ cloud, no key ⇒ local
- *
- * This is deliberately derivable from the shell environment and the config
- * file alone, so it resolves identically in the Playwright main process (the
- * reporter) and in worker processes (the `snapshot()` capture) — env vars set
- * at runtime by the reporter never propagate to already-spawned workers.
- */
-function resolveLocalMode(opts = {}) {
-    const envMode = process.env.TESTIVAI_MODE;
-    if (envMode === 'local')
-        return true;
-    if (envMode === 'cloud')
-        return false;
-    const cfg = configMode(opts.projectRoot ?? process.cwd());
-    if (cfg)
-        return cfg === 'local';
-    const apiKey = opts.apiKey ?? process.env.TESTIVAI_API_KEY;
-    return !apiKey;
-}

package/dist/structureAnalyzer.d.ts

@@ -1,12 +0,0 @@
-import { Page } from '@playwright/test';
-import { StructureAnalysisConfig, StructureAnalysis, StructureChange } from './types';
-/**
- * Analyzes page structure and generates fingerprint
- * @renamed Was `analyzeDOM` — renamed to conceal internal layer terminology (IP protection)
- */
-export declare function analyzeStructure(page: Page, config?: StructureAnalysisConfig): Promise<StructureAnalysis>;
-/**
- * Compare two structure analyses and identify changes
- * @renamed Was `compareDOMAnalysis` — renamed to conceal internal layer terminology (IP protection)
- */
-export declare function compareStructureAnalysis(baseline: StructureAnalysis, current: StructureAnalysis): StructureChange[];

package/dist/structureAnalyzer.js

@@ -1,288 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.analyzeStructure = analyzeStructure;
-exports.compareStructureAnalysis = compareStructureAnalysis;
-/**
- * Default configuration for structure analysis
- * @renamed Was DEFAULT_CONFIG in domAnalyzer.ts — renamed to conceal internal layer terminology (IP protection)
- */
-const DEFAULT_CONFIG = {
-    enableFingerprint: true,
-    enableStructure: true,
-    enableSemantic: true,
-    ignoreAttributes: [
-        'data-testid',
-        'data-reactid',
-        'data-reactroot',
-        'ng-version',
-        'ng-version',
-        'ng-reflect-router-outlet',
-        'data-ng-version',
-        'style', // Inline styles change often
-        'class', // CSS classes can be dynamic
-    ],
-    ignoreElements: [
-        'script',
-        'style',
-        'noscript',
-        'meta',
-        'link',
-        'title',
-    ],
-    ignoreContentPatterns: [
-        /\d{4}-\d{2}-\d{2}/, // Dates
-        /\d{1,2}:\d{2}(:\d{2})?/, // Times
-        /\b\d{4}\b/, // Years
-        /\b\d+\b/, // Pure numbers
-        /uuid-/i, // UUIDs
-        /_\d+/, // Number suffixes
-        /\$\d+\.?\d*/, // Currency
-    ],
-};
-/**
- * Analyzes page structure and generates fingerprint
- * @renamed Was `analyzeDOM` — renamed to conceal internal layer terminology (IP protection)
- */
-async function analyzeStructure(page, config = {}) {
-    const finalConfig = { ...DEFAULT_CONFIG, ...config };
-    return await page.evaluate((cfg) => {
-        // Helper functions
-        const normalizeSelector = (el) => {
-            let selector = el.nodeName.toLowerCase();
-            // Add ID if present and not a dynamic ID
-            if (el.id && !cfg.ignoreAttributes.includes('id')) {
-                // Skip if ID looks dynamic
-                if (!/^(ember|react|ng|vue|_)/.test(el.id)) {
-                    selector += `#${el.id}`;
-                }
-            }
-            // Add meaningful classes only
-            if (el.className && !cfg.ignoreAttributes.includes('class')) {
-                const classes = el.className.toString()
-                    .split(' ')
-                    .filter((c) => c &&
-                    !/^(ember|react|ng|vue|css|active|hover|focus)/.test(c) &&
-                    !c.includes('_') &&
-                    !/\d/.test(c))
-                    .slice(0, 3); // Limit to 3 most meaningful classes
-                if (classes.length > 0) {
-                    selector += `.${classes.join('.')}`;
-                }
-            }
-            return selector;
-        };
-        const getElementPath = (el, maxDepth = 10) => {
-            const path = [];
-            let current = el;
-            let depth = 0;
-            while (current && current.nodeType === Node.ELEMENT_NODE && depth < maxDepth) {
-                path.unshift(normalizeSelector(current));
-                current = current.parentElement;
-                depth++;
-            }
-            return path.join(' > ');
-        };
-        const shouldIgnoreElement = (el) => {
-            return cfg.ignoreElements.includes(el.nodeName.toLowerCase());
-        };
-        const shouldIgnoreAttribute = (attr) => {
-            return cfg.ignoreAttributes.includes(attr.toLowerCase());
-        };
-        const shouldIgnoreContent = (content) => {
-            return cfg.ignoreContentPatterns.some((pattern) => pattern.test(content));
-        };
-        const normalizeText = (text) => {
-            if (!text)
-                return '';
-            // Replace ignored patterns with placeholders
-            let normalized = text.trim();
-            cfg.ignoreContentPatterns.forEach((pattern) => {
-                normalized = normalized.replace(pattern, '[DYNAMIC]');
-            });
-            // Normalize whitespace
-            normalized = normalized.replace(/\s+/g, ' ');
-            return normalized;
-        };
-        // Get all meaningful elements
-        const allElements = Array.from(document.querySelectorAll('*'))
-            .filter(el => !shouldIgnoreElement(el));
-        const analysis = {};
-        // 1. Generate fingerprint
-        if (cfg.enableFingerprint) {
-            const paths = allElements.map((el) => {
-                const path = getElementPath(el);
-                const text = normalizeText(el.textContent || '');
-                const attrs = [];
-                // Add important attributes
-                for (const attr of el.attributes) {
-                    if (!shouldIgnoreAttribute(attr.name) && attr.value) {
-                        attrs.push(`${attr.name}="${attr.value}"`);
-                    }
-                }
-                return `${path}${text ? `|${text}` : ''}${attrs.length ? `|${attrs.join(',')}` : ''}`;
-            });
-            // Create hash from sorted paths
-            const sortedPaths = paths.sort().join('|||');
-            analysis.fingerprint = btoa(sortedPaths).substring(0, 32);
-        }
-        // 2. Structural analysis
-        if (cfg.enableStructure) {
-            const elementTypes = {};
-            let maxDepth = 0;
-            allElements.forEach((el) => {
-                const tag = el.nodeName.toLowerCase();
-                elementTypes[tag] = (elementTypes[tag] || 0) + 1;
-                // Calculate depth
-                let depth = 0;
-                let current = el;
-                while (current.parentElement) {
-                    depth++;
-                    current = current.parentElement;
-                }
-                maxDepth = Math.max(maxDepth, depth);
-            });
-            analysis.structure = {
-                totalElements: allElements.length,
-                elementTypes,
-                maxDepth,
-                interactiveElements: {
-                    buttons: document.querySelectorAll('button').length,
-                    inputs: document.querySelectorAll('input').length,
-                    links: document.querySelectorAll('a[href]').length,
-                    forms: document.querySelectorAll('form').length,
-                },
-            };
-        }
-        // 3. Semantic analysis
-        if (cfg.enableSemantic) {
-            const headings = {};
-            for (let i = 1; i <= 6; i++) {
-                headings[`h${i}`] = document.querySelectorAll(`h${i}`).length;
-            }
-            analysis.semantic = {
-                headings,
-                landmarks: {
-                    hasHeader: !!document.querySelector('header'),
-                    hasNav: !!document.querySelector('nav'),
-                    hasMain: !!document.querySelector('main'),
-                    hasFooter: !!document.querySelector('footer'),
-                    hasAside: !!document.querySelector('aside'),
-                },
-                lists: {
-                    ordered: document.querySelectorAll('ol').length,
-                    unordered: document.querySelectorAll('ul').length,
-                },
-                tables: document.querySelectorAll('table').length,
-                images: document.querySelectorAll('img').length,
-            };
-        }
-        // 4. Component analysis (framework-agnostic)
-        const components = {};
-        allElements.forEach((el) => {
-            // Try various component detection strategies
-            const componentName = el.getAttribute('data-testid')?.replace(/-/g, '') ||
-                el.getAttribute('data-component') ||
-                el.getAttribute('data-testid') ||
-                el.className?.toString().match(/(\w+Container|\w+Component|\w+Page|\w+Card|\w+Modal)/i)?.[1];
-            if (componentName && componentName.length > 2) {
-                if (!components[componentName]) {
-                    components[componentName] = [];
-                }
-                const attrs = {};
-                for (const attr of el.attributes) {
-                    if (!shouldIgnoreAttribute(attr.name) && attr.value) {
-                        attrs[attr.name] = attr.value;
-                    }
-                }
-                components[componentName].push({
-                    selector: getElementPath(el),
-                    text: normalizeText(el.textContent || '').substring(0, 100),
-                    attributes: attrs,
-                });
-            }
-        });
-        if (Object.keys(components).length > 0) {
-            analysis.components = components;
-        }
-        return analysis;
-    }, finalConfig);
-}
-/**
- * Compare two structure analyses and identify changes
- * @renamed Was `compareDOMAnalysis` — renamed to conceal internal layer terminology (IP protection)
- */
-function compareStructureAnalysis(baseline, current) {
-    const changes = [];
-    // Compare fingerprints
-    if (baseline.fingerprint && current.fingerprint) {
-        if (baseline.fingerprint !== current.fingerprint) {
-            changes.push({
-                type: 'fingerprint',
-                severity: 'high',
-                description: 'Page structure has changed',
-                details: {
-                    baseline: baseline.fingerprint,
-                    current: current.fingerprint,
-                },
-            });
-        }
-    }
-    // Compare structure
-    if (baseline.structure && current.structure) {
-        if (baseline.structure.totalElements !== current.structure.totalElements) {
-            changes.push({
-                type: 'structure',
-                severity: 'medium',
-                description: `Element count changed from ${baseline.structure.totalElements} to ${current.structure.totalElements}`,
-            });
-        }
-        // Check for new/removed element types
-        const baselineTypes = Object.keys(baseline.structure.elementTypes);
-        const currentTypes = Object.keys(current.structure.elementTypes);
-        const removed = baselineTypes.filter(t => !currentTypes.includes(t));
-        const added = currentTypes.filter(t => !baselineTypes.includes(t));
-        if (removed.length > 0) {
-            changes.push({
-                type: 'structure',
-                severity: 'medium',
-                description: `Removed element types: ${removed.join(', ')}`,
-            });
-        }
-        if (added.length > 0) {
-            changes.push({
-                type: 'structure',
-                severity: 'medium',
-                description: `Added element types: ${added.join(', ')}`,
-            });
-        }
-    }
-    // Compare semantic structure
-    if (baseline.semantic && current.semantic) {
-        // Check heading changes
-        const baselineHeadings = baseline.semantic.headings;
-        const currentHeadings = current.semantic.headings;
-        for (const level in baselineHeadings) {
-            if (baselineHeadings[level] !== currentHeadings[level]) {
-                changes.push({
-                    type: 'semantic',
-                    severity: 'low',
-                    description: `${level} count changed from ${baselineHeadings[level]} to ${currentHeadings[level]}`,
-                });
-            }
-        }
-        // Check landmark changes
-        const baselineLandmarks = baseline.semantic.landmarks;
-        const currentLandmarks = current.semantic.landmarks;
-        for (const landmark in baselineLandmarks) {
-            if (baselineLandmarks[landmark] !==
-                currentLandmarks[landmark]) {
-                changes.push({
-                    type: 'semantic',
-                    severity: 'medium',
-                    description: `Landmark ${landmark} ${baselineLandmarks[landmark] ? 'removed' : 'added'}`,
-                });
-            }
-        }
-    }
-    return changes;
-}