@supernal/interface 1.0.8 → 1.0.11

package/dist/cjs/src/testing/graph-tester/fixtures/portPool.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * Port pool fixture for parallel testing.
+ *
+ * Automatically assigns unique ports to each test worker to avoid conflicts.
+ *
+ * @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.expect = exports.test = void 0;
+exports.cleanupPortPool = cleanupPortPool;
+const test_1 = require("@playwright/test");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+/**
+ * Port pool manager (singleton across workers).
+ */
+class PortPoolManager {
+    constructor(startPort = 3020, poolSize = 10) {
+        this.availablePorts = [];
+        this.usedPorts = new Set();
+        this.lockFile = path.join(os.tmpdir(), 'supernal-port-pool.lock');
+        this.lockFd = null;
+        // Initialize pool: 3020-3029 by default
+        for (let i = 0; i < poolSize; i++) {
+            this.availablePorts.push(startPort + i);
+        }
+    }
+    /**
+     * Acquire a port from the pool (with cross-worker coordination).
+     */
+    async acquirePort() {
+        await this.acquireLock();
+        try {
+            if (this.availablePorts.length === 0) {
+                throw new Error('No available ports in pool. Increase pool size or reduce parallel workers.');
+            }
+            const port = this.availablePorts.shift();
+            this.usedPorts.add(port);
+            return port;
+        }
+        finally {
+            await this.releaseLock();
+        }
+    }
+    /**
+     * Release a port back to the pool.
+     */
+    async releasePort(port) {
+        await this.acquireLock();
+        try {
+            if (this.usedPorts.has(port)) {
+                this.usedPorts.delete(port);
+                this.availablePorts.push(port);
+            }
+        }
+        finally {
+            await this.releaseLock();
+        }
+    }
+    /**
+     * Acquire file-based lock for cross-worker coordination.
+     */
+    async acquireLock() {
+        const maxRetries = 100;
+        const retryDelay = 50; // ms
+        for (let i = 0; i < maxRetries; i++) {
+            try {
+                // Try to create lock file with exclusive flag
+                this.lockFd = fs.openSync(this.lockFile, fs.constants.O_CREAT | fs.constants.O_EXCL | fs.constants.O_RDWR);
+                return; // Lock acquired
+            }
+            catch (error) {
+                if (error.code === 'EEXIST') {
+                    // Lock file exists, wait and retry
+                    await new Promise((resolve) => setTimeout(resolve, retryDelay));
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        throw new Error('Failed to acquire port pool lock after retries');
+    }
+    /**
+     * Release file-based lock.
+     */
+    async releaseLock() {
+        if (this.lockFd !== null) {
+            try {
+                fs.closeSync(this.lockFd);
+                fs.unlinkSync(this.lockFile);
+            }
+            catch (error) {
+                // Ignore errors (file might already be deleted)
+            }
+            this.lockFd = null;
+        }
+    }
+    /**
+     * Cleanup all resources.
+     */
+    async cleanup() {
+        try {
+            if (fs.existsSync(this.lockFile)) {
+                fs.unlinkSync(this.lockFile);
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+}
+// Global port pool instance
+const portPool = new PortPoolManager();
+/**
+ * Playwright test fixture with automatic port assignment.
+ *
+ * @example
+ * ```typescript
+ * import { test, expect } from '@supernal/interface/testing/graph-tester/fixtures';
+ *
+ * test('visual regression', async ({ page, port, baseURL }) => {
+ *   console.log(`Test running on port ${port}`);
+ *   await page.goto(baseURL);
+ *   // Test automatically gets unique port!
+ * });
+ * ```
+ */
+exports.test = test_1.test.extend({
+    port: async ({}, use) => {
+        const port = await portPool.acquirePort();
+        await use(port);
+        await portPool.releasePort(port);
+    },
+    baseURL: async ({ port }, use) => {
+        await use(`http://localhost:${port}`);
+    },
+});
+/**
+ * Re-export expect from Playwright.
+ */
+exports.expect = test_1.expect;
+/**
+ * Cleanup port pool (call at end of test suite).
+ */
+async function cleanupPortPool() {
+    await portPool.cleanup();
+}
+//# sourceMappingURL=portPool.js.map

package/dist/cjs/src/testing/graph-tester/fixtures/portPool.js.map

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

package/dist/cjs/src/testing/graph-tester/index.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Graph-Based Testing Framework
+ *
+ * A comprehensive testing framework that systematically applies different testing functions
+ * (visual regression, performance, accessibility, SEO) to all routes in your application.
+ *
+ * ## Features
+ *
+ * - **Screenshot Annotation**: Capture screenshots with element bounding boxes, testids, and interaction capabilities
+ * - **Multiple Test Modes**: Visual regression, performance, accessibility, SEO
+ * - **AI-Ready Output**: JSON + PNG format optimized for multimodal AI analysis
+ * - **Multi-Format Reporting**: HTML (interactive), JSON (CI/CD), Markdown (docs)
+ * - **Parallel Testing**: Port pool fixture for running tests in parallel
+ * - **Pluggable Architecture**: Create custom test modes by extending TestFunction
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { GraphTester, VisualRegressionMode, JSONReporter } from '@supernal/interface/testing/graph-tester';
+ *
+ * const tester = new GraphTester({
+ *   baseUrl: 'http://localhost:3000',
+ *   routes: [
+ *     { route: '/', metadata: { name: 'Home' } },
+ *     { route: '/dashboard', metadata: { name: 'Dashboard' } }
+ *   ],
+ *   modes: ['visual'],
+ *   output: {
+ *     dir: './test-results',
+ *     formats: ['json', 'html']
+ *   }
+ * });
+ *
+ * // Register test modes
+ * tester.registerTestFunction(new VisualRegressionMode({
+ *   outputDir: './screenshots',
+ *   annotate: true,
+ *   generateHTML: true
+ * }));
+ *
+ * // Run tests
+ * const results = await tester.runTests();
+ * console.log(`Pass rate: ${results.passRate}%`);
+ *
+ * // Generate reports
+ * const reporter = new JSONReporter({ outputDir: './test-results' });
+ * await reporter.generate(results);
+ * ```
+ *
+ * ## Enterprise Features
+ *
+ * For automatic route discovery via NavigationGraph, CLI commands, and AI analysis,
+ * see `@supernalintelligence/interface-enterprise/testing/graph-tester`.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanupPortPool = exports.expect = exports.testWithPortPool = exports.MarkdownReporter = exports.HTMLReporter = exports.JSONReporter = exports.UnifiedReporter = exports.SEOMode = exports.AccessibilityMode = exports.PerformanceMode = exports.VisualRegressionMode = exports.CanvasAnnotationRenderer = exports.HTMLAnnotationRenderer = exports.ScreenshotAnnotator = exports.ViewportPresets = exports.GraphTester = exports.isTestFunction = exports.TestFunction = void 0;
+// ==================== Core ====================
+var TestFunction_1 = require("./core/TestFunction");
+Object.defineProperty(exports, "TestFunction", { enumerable: true, get: function () { return TestFunction_1.TestFunction; } });
+Object.defineProperty(exports, "isTestFunction", { enumerable: true, get: function () { return TestFunction_1.isTestFunction; } });
+var GraphTester_1 = require("./core/GraphTester");
+Object.defineProperty(exports, "GraphTester", { enumerable: true, get: function () { return GraphTester_1.GraphTester; } });
+var types_1 = require("./core/types");
+Object.defineProperty(exports, "ViewportPresets", { enumerable: true, get: function () { return types_1.ViewportPresets; } });
+// ==================== Screenshot Annotation ====================
+var ScreenshotAnnotator_1 = require("./screenshot/ScreenshotAnnotator");
+Object.defineProperty(exports, "ScreenshotAnnotator", { enumerable: true, get: function () { return ScreenshotAnnotator_1.ScreenshotAnnotator; } });
+var HTMLAnnotationRenderer_1 = require("./screenshot/HTMLAnnotationRenderer");
+Object.defineProperty(exports, "HTMLAnnotationRenderer", { enumerable: true, get: function () { return HTMLAnnotationRenderer_1.HTMLAnnotationRenderer; } });
+var CanvasAnnotationRenderer_1 = require("./screenshot/CanvasAnnotationRenderer");
+Object.defineProperty(exports, "CanvasAnnotationRenderer", { enumerable: true, get: function () { return CanvasAnnotationRenderer_1.CanvasAnnotationRenderer; } });
+// ==================== Test Modes ====================
+var VisualRegressionMode_1 = require("./modes/VisualRegressionMode");
+Object.defineProperty(exports, "VisualRegressionMode", { enumerable: true, get: function () { return VisualRegressionMode_1.VisualRegressionMode; } });
+var PerformanceMode_1 = require("./modes/PerformanceMode");
+Object.defineProperty(exports, "PerformanceMode", { enumerable: true, get: function () { return PerformanceMode_1.PerformanceMode; } });
+var AccessibilityMode_1 = require("./modes/AccessibilityMode");
+Object.defineProperty(exports, "AccessibilityMode", { enumerable: true, get: function () { return AccessibilityMode_1.AccessibilityMode; } });
+var SEOMode_1 = require("./modes/SEOMode");
+Object.defineProperty(exports, "SEOMode", { enumerable: true, get: function () { return SEOMode_1.SEOMode; } });
+// ==================== Reporters ====================
+var UnifiedReporter_1 = require("./reporters/UnifiedReporter");
+Object.defineProperty(exports, "UnifiedReporter", { enumerable: true, get: function () { return UnifiedReporter_1.UnifiedReporter; } });
+var JSONReporter_1 = require("./reporters/JSONReporter");
+Object.defineProperty(exports, "JSONReporter", { enumerable: true, get: function () { return JSONReporter_1.JSONReporter; } });
+var HTMLReporter_1 = require("./reporters/HTMLReporter");
+Object.defineProperty(exports, "HTMLReporter", { enumerable: true, get: function () { return HTMLReporter_1.HTMLReporter; } });
+var MarkdownReporter_1 = require("./reporters/MarkdownReporter");
+Object.defineProperty(exports, "MarkdownReporter", { enumerable: true, get: function () { return MarkdownReporter_1.MarkdownReporter; } });
+// ==================== Fixtures ====================
+var portPool_1 = require("./fixtures/portPool");
+Object.defineProperty(exports, "testWithPortPool", { enumerable: true, get: function () { return portPool_1.test; } });
+Object.defineProperty(exports, "expect", { enumerable: true, get: function () { return portPool_1.expect; } });
+Object.defineProperty(exports, "cleanupPortPool", { enumerable: true, get: function () { return portPool_1.cleanupPortPool; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/testing/graph-tester/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;;;AAEH,iDAAiD;AAEjD,oDAAmE;AAA1D,4GAAA,YAAY,OAAA;AAAE,8GAAA,cAAc,OAAA;AACrC,kDAAiD;AAAxC,0GAAA,WAAW,OAAA;AAEpB,sCAA+C;AAAtC,wGAAA,eAAe,OAAA;AAExB,kEAAkE;AAElE,wEAAuE;AAA9D,0HAAA,mBAAmB,OAAA;AAG5B,8EAA6E;AAApE,gIAAA,sBAAsB,OAAA;AAC/B,kFAAiF;AAAxE,oIAAA,wBAAwB,OAAA;AAIjC,uDAAuD;AAEvD,qEAAoE;AAA3D,4HAAA,oBAAoB,OAAA;AAG7B,2DAA0D;AAAjD,kHAAA,eAAe,OAAA;AAGxB,+DAA8D;AAArD,sHAAA,iBAAiB,OAAA;AAG1B,2CAA0C;AAAjC,kGAAA,OAAO,OAAA;AAGhB,sDAAsD;AAEtD,+DAA8D;AAArD,kHAAA,eAAe,OAAA;AAGxB,yDAAwD;AAA/C,4GAAA,YAAY,OAAA;AAGrB,yDAAwD;AAA/C,4GAAA,YAAY,OAAA;AAGrB,iEAAgE;AAAvD,oHAAA,gBAAgB,OAAA;AAGzB,qDAAqD;AAErD,gDAAwF;AAA/E,4GAAA,IAAI,OAAoB;AAAE,kGAAA,MAAM,OAAA;AAAE,2GAAA,eAAe,OAAA"}

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

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Accessibility testing mode (stub - to be implemented in Phase 2).
+ *
+ * Will integrate axe-core for WCAG compliance testing.
+ *
+ * @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.AccessibilityMode = void 0;
+const TestFunction_1 = require("../core/TestFunction");
+/**
+ * Accessibility testing mode (stub).
+ */
+class AccessibilityMode extends TestFunction_1.TestFunction {
+    constructor(config) {
+        super();
+        this.mode = 'accessibility';
+        this.name = 'Accessibility';
+        this.description = 'Tests WCAG compliance using axe-core';
+        this.config = config;
+    }
+    async execute(page, context) {
+        const startTime = Date.now();
+        const errors = [];
+        try {
+            // Inject axe-core
+            await this.injectAxe(page);
+            // Run axe analysis with WCAG tags
+            const wcagTags = this.getWCAGTags();
+            const results = await page.evaluate((tags) => {
+                return new Promise((resolve) => {
+                    // @ts-ignore - axe is injected globally
+                    if (typeof window.axe === 'undefined') {
+                        resolve({ violations: [], passes: [], incomplete: [], inapplicable: [] });
+                        return;
+                    }
+                    // @ts-ignore
+                    window.axe
+                        .run({
+                        runOnly: {
+                            type: 'tag',
+                            values: tags,
+                        },
+                    })
+                        .then((results) => {
+                        resolve(results);
+                    })
+                        .catch((error) => {
+                        resolve({ violations: [], passes: [], incomplete: [], inapplicable: [], error: error.message });
+                    });
+                });
+            }, wcagTags);
+            // Process violations
+            const violations = results.violations || [];
+            const warnings = results.incomplete || [];
+            // Build detailed violation reports
+            const violationReports = violations.map((v) => ({
+                id: v.id,
+                impact: v.impact,
+                description: v.description,
+                help: v.help,
+                helpUrl: v.helpUrl,
+                nodes: v.nodes.map((node) => ({
+                    html: node.html,
+                    target: node.target,
+                    failureSummary: node.failureSummary,
+                })),
+            }));
+            const warningReports = warnings.map((w) => ({
+                id: w.id,
+                impact: w.impact,
+                description: w.description,
+                help: w.help,
+                helpUrl: w.helpUrl,
+                nodes: w.nodes.length,
+            }));
+            // Determine if test passed
+            const hasViolations = violations.length > 0;
+            const hasWarnings = warnings.length > 0;
+            const passed = this.config.strict ? !hasViolations && !hasWarnings : !hasViolations;
+            // Collect error messages
+            if (hasViolations) {
+                violations.forEach((v) => {
+                    errors.push({
+                        severity: v.impact === 'critical' ? 'critical' : 'warning',
+                        message: `[${v.impact}] ${v.help} (${v.nodes.length} instances)`,
+                        location: v.helpUrl,
+                    });
+                });
+            }
+            if (this.config.strict && hasWarnings) {
+                warnings.forEach((w) => {
+                    errors.push({
+                        severity: 'info',
+                        message: `[warning] ${w.help} (${w.nodes.length} instances)`,
+                        location: w.helpUrl,
+                    });
+                });
+            }
+            // Save results
+            const outputPath = `${this.config.outputDir}/${this.sanitizeRoute(context.route)}-accessibility.json`;
+            await this.ensureDirectory(this.config.outputDir);
+            await this.writeFile(outputPath, JSON.stringify({
+                route: context.route,
+                wcagVersion: this.config.wcagVersion || '2.1',
+                wcagLevel: this.config.wcagLevel || 'AA',
+                summary: {
+                    violations: violations.length,
+                    warnings: warnings.length,
+                    passes: results.passes?.length || 0,
+                    incomplete: results.incomplete?.length || 0,
+                },
+                violations: violationReports,
+                warnings: warningReports,
+            }, null, 2));
+            const duration = Date.now() - startTime;
+            return {
+                passed,
+                duration,
+                errors,
+                metadata: {
+                    accessibility: {
+                        violationCount: violations.length,
+                        warningCount: warnings.length,
+                        passCount: results.passes?.length || 0,
+                    },
+                    outputPath,
+                },
+            };
+        }
+        catch (error) {
+            errors.push({
+                severity: 'critical',
+                message: `Accessibility testing failed: ${error instanceof Error ? error.message : String(error)}`,
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+            return {
+                passed: false,
+                duration: Date.now() - startTime,
+                errors,
+                metadata: {},
+            };
+        }
+    }
+    async injectAxe(page) {
+        try {
+            // Try to load axe-core from CDN
+            await page.addScriptTag({
+                url: 'https://cdnjs.cloudflare.com/ajax/libs/axe-core/4.8.3/axe.min.js',
+            });
+        }
+        catch (error) {
+            throw new Error('Failed to inject axe-core from CDN. Please check your network connection or use a local axe-core installation.');
+        }
+    }
+    getWCAGTags() {
+        const version = this.config.wcagVersion || '2.1';
+        const level = this.config.wcagLevel || 'AA';
+        const tags = ['wcag2a'];
+        if (level === 'AA' || level === 'AAA') {
+            tags.push('wcag2aa');
+        }
+        if (level === 'AAA') {
+            tags.push('wcag2aaa');
+        }
+        // Add version-specific tags
+        if (version === '2.1') {
+            tags.push('wcag21a');
+            if (level === 'AA' || level === 'AAA')
+                tags.push('wcag21aa');
+            if (level === 'AAA')
+                tags.push('wcag21aaa');
+        }
+        if (version === '2.2') {
+            tags.push('wcag21a', 'wcag22a');
+            if (level === 'AA' || level === 'AAA')
+                tags.push('wcag21aa', 'wcag22aa');
+            if (level === 'AAA')
+                tags.push('wcag21aaa', 'wcag22aaa');
+        }
+        return tags;
+    }
+    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.AccessibilityMode = AccessibilityMode;
+//# sourceMappingURL=AccessibilityMode.js.map

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

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