@supernal/interface 1.0.9 → 1.0.12

package/dist/cjs/src/testing/graph-tester/modes/PerformanceMode.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * Performance testing mode (stub - to be implemented in Phase 2).
+ *
+ * Will collect Core Web Vitals and Lighthouse metrics.
+ *
+ * @packageDocumentation
+ */
+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.PerformanceMode = void 0;
+const TestFunction_1 = require("../core/TestFunction");
+/**
+ * Performance testing mode (stub).
+ */
+class PerformanceMode extends TestFunction_1.TestFunction {
+    constructor(config) {
+        super();
+        this.mode = 'performance';
+        this.name = 'Performance';
+        this.description = 'Collects Core Web Vitals and performance metrics';
+        this.config = config;
+    }
+    async execute(page, context) {
+        const startTime = Date.now();
+        const errors = [];
+        try {
+            // Collect Core Web Vitals and performance metrics
+            const metrics = await page.evaluate(() => {
+                return new Promise((resolve) => {
+                    const observer = new PerformanceObserver((list) => {
+                        const entries = list.getEntries();
+                        // Process entries as they come
+                    });
+                    // Use performance API to get navigation timing
+                    const perfData = performance.getEntriesByType('navigation')[0];
+                    const paintEntries = performance.getEntriesByType('paint');
+                    const fcp = paintEntries.find((entry) => entry.name === 'first-contentful-paint')?.startTime;
+                    // Get layout shift metrics
+                    const layoutShifts = performance.getEntriesByType('layout-shift');
+                    const cls = layoutShifts.reduce((sum, entry) => sum + (entry.value || 0), 0);
+                    // Calculate TTI approximation (when main thread is idle)
+                    const tti = perfData ? perfData.domInteractive : 0;
+                    // Get resource timing
+                    const resources = performance.getEntriesByType('resource');
+                    const totalSize = resources.reduce((sum, r) => sum + (r.transferSize || 0), 0);
+                    resolve({
+                        // Core Web Vitals
+                        fcp: fcp || 0,
+                        lcp: 0, // Will be collected via observer
+                        cls: cls || 0,
+                        tti: tti || 0,
+                        tbt: 0, // Total Blocking Time - approximation
+                        // Additional metrics
+                        domContentLoaded: perfData?.domContentLoadedEventEnd || 0,
+                        loadComplete: perfData?.loadEventEnd || 0,
+                        totalResourceSize: totalSize,
+                        resourceCount: resources.length,
+                        // Timing breakdown
+                        dns: perfData ? perfData.domainLookupEnd - perfData.domainLookupStart : 0,
+                        tcp: perfData ? perfData.connectEnd - perfData.connectStart : 0,
+                        ttfb: perfData ? perfData.responseStart - perfData.requestStart : 0,
+                    });
+                });
+            });
+            // Check thresholds
+            const thresholdViolations = [];
+            if (this.config.thresholds) {
+                if (this.config.thresholds.fcp && metrics.fcp > this.config.thresholds.fcp) {
+                    thresholdViolations.push({
+                        severity: 'warning',
+                        message: `FCP ${metrics.fcp.toFixed(2)}ms exceeds threshold ${this.config.thresholds.fcp}ms`,
+                    });
+                }
+                if (this.config.thresholds.lcp && metrics.lcp > this.config.thresholds.lcp) {
+                    thresholdViolations.push({
+                        severity: 'warning',
+                        message: `LCP ${metrics.lcp.toFixed(2)}ms exceeds threshold ${this.config.thresholds.lcp}ms`,
+                    });
+                }
+                if (this.config.thresholds.cls && metrics.cls > this.config.thresholds.cls) {
+                    thresholdViolations.push({
+                        severity: 'warning',
+                        message: `CLS ${metrics.cls.toFixed(3)} exceeds threshold ${this.config.thresholds.cls}`,
+                    });
+                }
+                if (this.config.thresholds.tti && metrics.tti > this.config.thresholds.tti) {
+                    thresholdViolations.push({
+                        severity: 'warning',
+                        message: `TTI ${metrics.tti.toFixed(2)}ms exceeds threshold ${this.config.thresholds.tti}ms`,
+                    });
+                }
+            }
+            // Save results
+            const outputPath = `${this.config.outputDir}/${this.sanitizeRoute(context.route)}-performance.json`;
+            await this.ensureDirectory(this.config.outputDir);
+            await this.writeFile(outputPath, JSON.stringify({ route: context.route, metrics, thresholdViolations }, null, 2));
+            const duration = Date.now() - startTime;
+            return {
+                passed: thresholdViolations.length === 0,
+                duration,
+                errors: thresholdViolations,
+                metadata: {
+                    performance: metrics,
+                    outputPath,
+                },
+            };
+        }
+        catch (error) {
+            errors.push({
+                severity: 'critical',
+                message: `Performance collection failed: ${error instanceof Error ? error.message : String(error)}`,
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+            return {
+                passed: false,
+                duration: Date.now() - startTime,
+                errors,
+                metadata: {},
+            };
+        }
+    }
+    sanitizeRoute(route) {
+        return route.replace(/^\//, '').replace(/\//g, '-') || 'home';
+    }
+    async ensureDirectory(dir) {
+        const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+        await fs.mkdir(dir, { recursive: true });
+    }
+    async writeFile(path, content) {
+        const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+        await fs.writeFile(path, content, 'utf-8');
+    }
+}
+exports.PerformanceMode = PerformanceMode;
+//# sourceMappingURL=PerformanceMode.js.map

package/dist/cjs/src/testing/graph-tester/modes/PerformanceMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceMode.js","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/modes/PerformanceMode.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGH,uDAAoD;AAuBpD;;GAEG;AACH,MAAa,eAAgB,SAAQ,2BAAY;IAO/C,YAAY,MAAyB;QACnC,KAAK,EAAE,CAAC;QAPD,SAAI,GAAG,aAAa,CAAC;QACrB,SAAI,GAAG,aAAa,CAAC;QACrB,gBAAW,GAAG,kDAAkD,CAAC;QAMxE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAU,EAAE,OAAoB;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAwC,EAAE,CAAC;QAEvD,IAAI,CAAC;YACH,kDAAkD;YAClD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAiB,EAAE;gBACrD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;oBAC7B,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAC,CAAC,IAAI,EAAE,EAAE;wBAChD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;wBAClC,+BAA+B;oBACjC,CAAC,CAAC,CAAC;oBAEH,+CAA+C;oBAC/C,MAAM,QAAQ,GAAG,WAAW,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC,CAA4C,CAAC;oBAC1G,MAAM,YAAY,GAAG,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;oBAE3D,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,wBAAwB,CAAC,EAAE,SAAS,CAAC;oBAE7F,2BAA2B;oBAC3B,MAAM,YAAY,GAAG,WAAW,CAAC,gBAAgB,CAAC,cAAc,CAAU,CAAC;oBAC3E,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBAE7E,yDAAyD;oBACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;oBAEnD,sBAAsB;oBACtB,MAAM,SAAS,GAAG,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;oBAC3D,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAW,EAAE,CAAM,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBAE5F,OAAO,CAAC;wBACN,kBAAkB;wBAClB,GAAG,EAAE,GAAG,IAAI,CAAC;wBACb,GAAG,EAAE,CAAC,EAAE,iCAAiC;wBACzC,GAAG,EAAE,GAAG,IAAI,CAAC;wBACb,GAAG,EAAE,GAAG,IAAI,CAAC;wBACb,GAAG,EAAE,CAAC,EAAE,sCAAsC;wBAE9C,qBAAqB;wBACrB,gBAAgB,EAAE,QAAQ,EAAE,wBAAwB,IAAI,CAAC;wBACzD,YAAY,EAAE,QAAQ,EAAE,YAAY,IAAI,CAAC;wBACzC,iBAAiB,EAAE,SAAS;wBAC5B,aAAa,EAAE,SAAS,CAAC,MAAM;wBAE/B,mBAAmB;wBACnB,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;wBACzE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;wBAC/D,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;qBACpE,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,mBAAmB;YACnB,MAAM,mBAAmB,GAAwC,EAAE,CAAC;YACpE,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;oBAC3E,mBAAmB,CAAC,IAAI,CAAC;wBACvB,QAAQ,EAAE,SAAS;wBACnB,OAAO,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI;qBAC7F,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;oBAC3E,mBAAmB,CAAC,IAAI,CAAC;wBACvB,QAAQ,EAAE,SAAS;wBACnB,OAAO,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI;qBAC7F,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;oBAC3E,mBAAmB,CAAC,IAAI,CAAC;wBACvB,QAAQ,EAAE,SAAS;wBACnB,OAAO,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;qBACzF,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;oBAC3E,mBAAmB,CAAC,IAAI,CAAC;wBACvB,QAAQ,EAAE,SAAS;wBACnB,OAAO,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI;qBAC7F,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,eAAe;YACf,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC;YACpG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAElH,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAExC,OAAO;gBACL,MAAM,EAAE,mBAAmB,CAAC,MAAM,KAAK,CAAC;gBACxC,QAAQ;gBACR,MAAM,EAAE,mBAAmB;gBAC3B,QAAQ,EAAE;oBACR,WAAW,EAAE,OAAO;oBACpB,UAAU;iBACX;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,UAAU;gBACpB,OAAO,EAAE,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;gBACnG,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACxD,CAAC,CAAC;YACH,OAAO;gBACL,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAChC,MAAM;gBACN,QAAQ,EAAE,EAAE;aACb,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,KAAa;QACjC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC;IAChE,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,GAAW;QACvC,MAAM,EAAE,GAAG,wDAAa,aAAa,GAAC,CAAC;QACvC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,OAAe;QACnD,MAAM,EAAE,GAAG,wDAAa,aAAa,GAAC,CAAC;QACvC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF;AAzID,0CAyIC"}

package/dist/cjs/src/testing/graph-tester/modes/SEOMode.js

@@ -0,0 +1,264 @@
+"use strict";
+/**
+ * SEO testing mode (stub - to be implemented in Phase 2).
+ *
+ * Will validate meta tags, OpenGraph, and structured data.
+ *
+ * @packageDocumentation
+ */
+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.SEOMode = void 0;
+const TestFunction_1 = require("../core/TestFunction");
+/**
+ * SEO testing mode (stub).
+ */
+class SEOMode extends TestFunction_1.TestFunction {
+    constructor(config) {
+        super();
+        this.mode = 'seo';
+        this.name = 'SEO';
+        this.description = 'Validates meta tags and SEO elements';
+        this.config = config;
+    }
+    async execute(page, context) {
+        const startTime = Date.now();
+        const errors = [];
+        try {
+            // Extract SEO metadata
+            const seoData = await page.evaluate(() => {
+                // Helper to get meta content
+                const getMeta = (name) => {
+                    const meta = document.querySelector(`meta[name="${name}"], meta[property="${name}"]`);
+                    return meta?.getAttribute('content') || null;
+                };
+                // Get all meta tags
+                const allMeta = {};
+                Array.from(document.querySelectorAll('meta')).forEach((meta) => {
+                    const name = meta.getAttribute('name') || meta.getAttribute('property');
+                    const content = meta.getAttribute('content');
+                    if (name && content) {
+                        allMeta[name] = content;
+                    }
+                });
+                // Title and description
+                const title = document.querySelector('title')?.textContent || '';
+                const description = getMeta('description');
+                // OpenGraph
+                const og = {
+                    title: getMeta('og:title'),
+                    description: getMeta('og:description'),
+                    image: getMeta('og:image'),
+                    url: getMeta('og:url'),
+                    type: getMeta('og:type'),
+                    siteName: getMeta('og:site_name'),
+                };
+                // Twitter Cards
+                const twitter = {
+                    card: getMeta('twitter:card'),
+                    title: getMeta('twitter:title'),
+                    description: getMeta('twitter:description'),
+                    image: getMeta('twitter:image'),
+                    site: getMeta('twitter:site'),
+                    creator: getMeta('twitter:creator'),
+                };
+                // Canonical URL
+                const canonical = document.querySelector('link[rel="canonical"]')?.getAttribute('href');
+                // Heading structure
+                const headings = {
+                    h1: Array.from(document.querySelectorAll('h1')).map((h) => h.textContent?.trim() || ''),
+                    h2: Array.from(document.querySelectorAll('h2')).map((h) => h.textContent?.trim() || ''),
+                    h3Count: document.querySelectorAll('h3').length,
+                    h4Count: document.querySelectorAll('h4').length,
+                };
+                // Structured data (JSON-LD)
+                const structuredData = [];
+                Array.from(document.querySelectorAll('script[type="application/ld+json"]')).forEach((script) => {
+                    try {
+                        const data = JSON.parse(script.textContent || '{}');
+                        structuredData.push(data);
+                    }
+                    catch {
+                        // Ignore invalid JSON
+                    }
+                });
+                // Images
+                const images = Array.from(document.querySelectorAll('img'));
+                const imagesWithoutAlt = images.filter((img) => !img.getAttribute('alt')).length;
+                // Links
+                const links = Array.from(document.querySelectorAll('a'));
+                const externalLinks = links.filter((a) => {
+                    const href = a.getAttribute('href');
+                    return href && (href.startsWith('http://') || href.startsWith('https://'));
+                }).length;
+                return {
+                    title,
+                    description,
+                    canonical,
+                    allMeta,
+                    og,
+                    twitter,
+                    headings,
+                    structuredData,
+                    images: {
+                        total: images.length,
+                        withoutAlt: imagesWithoutAlt,
+                    },
+                    links: {
+                        total: links.length,
+                        external: externalLinks,
+                    },
+                };
+            });
+            // Validate required meta tags
+            const missingTags = [];
+            if (this.config.requiredMetaTags) {
+                for (const tag of this.config.requiredMetaTags) {
+                    if (!seoData.allMeta[tag]) {
+                        missingTags.push(tag);
+                    }
+                }
+            }
+            // Basic SEO validations
+            const issues = [];
+            if (!seoData.title) {
+                issues.push({ severity: 'critical', message: 'Missing page title' });
+            }
+            else if (seoData.title.length < 30 || seoData.title.length > 60) {
+                issues.push({
+                    severity: 'warning',
+                    message: `Title length ${seoData.title.length} characters (recommended: 30-60)`,
+                });
+            }
+            if (!seoData.description) {
+                issues.push({ severity: 'critical', message: 'Missing meta description' });
+            }
+            else if (seoData.description.length < 120 || seoData.description.length > 160) {
+                issues.push({
+                    severity: 'warning',
+                    message: `Description length ${seoData.description.length} characters (recommended: 120-160)`,
+                });
+            }
+            if (seoData.headings.h1.length === 0) {
+                issues.push({ severity: 'warning', message: 'Missing H1 heading' });
+            }
+            else if (seoData.headings.h1.length > 1) {
+                issues.push({
+                    severity: 'warning',
+                    message: `Multiple H1 headings found (${seoData.headings.h1.length})`,
+                });
+            }
+            if (seoData.images.withoutAlt > 0) {
+                issues.push({
+                    severity: 'warning',
+                    message: `${seoData.images.withoutAlt} images without alt text`,
+                });
+            }
+            // OpenGraph validation
+            if (this.config.validateOpenGraph !== false) {
+                if (!seoData.og.title)
+                    issues.push({ severity: 'warning', message: 'Missing og:title' });
+                if (!seoData.og.description)
+                    issues.push({ severity: 'warning', message: 'Missing og:description' });
+                if (!seoData.og.image)
+                    issues.push({ severity: 'warning', message: 'Missing og:image' });
+            }
+            // Twitter Cards validation
+            if (this.config.validateTwitterCards !== false) {
+                if (!seoData.twitter.card)
+                    issues.push({ severity: 'info', message: 'Missing twitter:card' });
+            }
+            if (missingTags.length > 0) {
+                issues.push({
+                    severity: 'critical',
+                    message: `Missing required meta tags: ${missingTags.join(', ')}`,
+                });
+            }
+            // Save results
+            const outputPath = `${this.config.outputDir}/${this.sanitizeRoute(context.route)}-seo.json`;
+            await this.ensureDirectory(this.config.outputDir);
+            await this.writeFile(outputPath, JSON.stringify({
+                route: context.route,
+                seo: seoData,
+                issues,
+                score: this.calculateScore(issues),
+            }, null, 2));
+            const duration = Date.now() - startTime;
+            return {
+                passed: issues.length === 0,
+                duration,
+                errors: issues,
+                metadata: {
+                    seo: {
+                        issueCount: issues.length,
+                        score: this.calculateScore(issues),
+                        hasStructuredData: seoData.structuredData.length > 0,
+                    },
+                    outputPath,
+                },
+            };
+        }
+        catch (error) {
+            errors.push({
+                severity: 'critical',
+                message: `SEO validation failed: ${error instanceof Error ? error.message : String(error)}`,
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+            return {
+                passed: false,
+                duration: Date.now() - startTime,
+                errors,
+                metadata: {},
+            };
+        }
+    }
+    calculateScore(issues) {
+        // Simple scoring: 100 - (10 points per issue)
+        return Math.max(0, 100 - issues.length * 10);
+    }
+    sanitizeRoute(route) {
+        return route.replace(/^\//, '').replace(/\//g, '-') || 'home';
+    }
+    async ensureDirectory(dir) {
+        const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+        await fs.mkdir(dir, { recursive: true });
+    }
+    async writeFile(path, content) {
+        const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+        await fs.writeFile(path, content, 'utf-8');
+    }
+}
+exports.SEOMode = SEOMode;
+//# sourceMappingURL=SEOMode.js.map

package/dist/cjs/src/testing/graph-tester/modes/SEOMode.js.map

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

package/dist/cjs/src/testing/graph-tester/modes/VisualRegressionMode.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * Visual regression testing mode.
+ *
+ * Captures screenshots with element annotations for visual regression testing and AI analysis.
+ *
+ * @packageDocumentation
+ */
+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.VisualRegressionMode = void 0;
+const TestFunction_1 = require("../core/TestFunction");
+const screenshot_1 = require("../screenshot");
+const path = __importStar(require("path"));
+/**
+ * Visual regression testing mode.
+ *
+ * Captures full-page screenshots with element annotations, bounding boxes,
+ * and generates interactive HTML overlays for review.
+ *
+ * @example
+ * ```typescript
+ * const mode = new VisualRegressionMode({
+ *   outputDir: './screenshots',
+ *   annotate: true,
+ *   generateHTML: true
+ * });
+ *
+ * const tester = new GraphTester({
+ *   baseUrl: 'http://localhost:3000',
+ *   routes: [{ route: '/' }],
+ *   modes: []
+ * });
+ *
+ * tester.registerTestFunction(mode);
+ * const results = await tester.runTests();
+ * ```
+ */
+class VisualRegressionMode extends TestFunction_1.TestFunction {
+    constructor(config) {
+        super();
+        this.mode = 'visual';
+        this.name = 'Visual Regression';
+        this.description = 'Captures screenshots with element annotations for visual regression testing';
+        this.annotator = null;
+        this.config = {
+            fullPage: true,
+            annotate: true,
+            generateHTML: true,
+            includeInvisible: false,
+            minElementSize: 5,
+            aiAnalyze: false,
+            ...config,
+        };
+    }
+    /**
+     * Setup: Initialize screenshot annotator.
+     */
+    async setup(page) {
+        if (this.config.annotate) {
+            this.annotator = new screenshot_1.ScreenshotAnnotator({
+                outputDir: this.config.outputDir,
+                fullPage: this.config.fullPage,
+                includeInvisible: this.config.includeInvisible,
+                minElementSize: this.config.minElementSize,
+                ...this.config.annotatorConfig,
+            });
+        }
+    }
+    /**
+     * Execute: Capture screenshot and annotations.
+     */
+    async execute(page, context) {
+        const startTime = Date.now();
+        const errors = [];
+        const metadata = {};
+        try {
+            // Capture annotated screenshot
+            if (this.annotator) {
+                const viewportLabel = context.viewport ? ` [${context.viewport.name}]` : '';
+                console.log(`Capturing annotated screenshot for ${context.route}${viewportLabel}...`);
+                const annotatedScreenshot = await this.annotator.capture(page, context.route, context.viewport?.name);
+                metadata.screenshot = {
+                    path: annotatedScreenshot.screenshotPath,
+                    annotationCount: annotatedScreenshot.annotations.length,
+                    interactiveElementCount: annotatedScreenshot.annotations.filter((a) => a.isInteractive)
+                        .length,
+                    pageSize: annotatedScreenshot.pageMetadata.pageSize,
+                    viewport: annotatedScreenshot.pageMetadata.viewport,
+                };
+                // Generate HTML overlay
+                if (this.config.generateHTML) {
+                    const htmlPath = annotatedScreenshot.screenshotPath.replace('.png', '.html');
+                    const renderer = new screenshot_1.HTMLAnnotationRenderer({
+                        outputPath: htmlPath,
+                        includeSidebar: true,
+                        enableHover: true,
+                        enableClickToHighlight: true,
+                        ...this.config.htmlRendererConfig,
+                    });
+                    const renderResult = await renderer.render(annotatedScreenshot);
+                    metadata.htmlOverlay = {
+                        path: renderResult.outputPath,
+                        fileSize: renderResult.fileSize,
+                        duration: renderResult.duration,
+                    };
+                    console.log(`Generated HTML overlay: ${renderResult.outputPath}`);
+                }
+                // AI analysis (enterprise only)
+                if (this.config.aiAnalyze) {
+                    errors.push({
+                        severity: 'info',
+                        message: 'AI analysis requires @supernalintelligence/interface-enterprise',
+                    });
+                }
+            }
+            else {
+                // Simple screenshot without annotations
+                const screenshotPath = path.join(this.config.outputDir, `${this.sanitizeRoute(context.route)}.png`);
+                await page.screenshot({
+                    path: screenshotPath,
+                    fullPage: this.config.fullPage,
+                });
+                metadata.screenshot = {
+                    path: screenshotPath,
+                };
+            }
+            return {
+                passed: true,
+                duration: Date.now() - startTime,
+                errors,
+                metadata,
+            };
+        }
+        catch (error) {
+            errors.push({
+                severity: 'critical',
+                message: `Visual regression failed: ${error instanceof Error ? error.message : String(error)}`,
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+            return {
+                passed: false,
+                duration: Date.now() - startTime,
+                errors,
+                metadata,
+            };
+        }
+    }
+    /**
+     * Sanitize route for filename.
+     */
+    sanitizeRoute(route) {
+        return route.replace(/^\//, '').replace(/\//g, '-') || 'home';
+    }
+    /**
+     * Validate configuration.
+     */
+    validate() {
+        const errors = super.validate();
+        if (!this.config.outputDir) {
+            errors.push('outputDir is required');
+        }
+        return errors;
+    }
+}
+exports.VisualRegressionMode = VisualRegressionMode;
+//# sourceMappingURL=VisualRegressionMode.js.map

package/dist/cjs/src/testing/graph-tester/modes/VisualRegressionMode.js.map

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