@supernal/interface 1.0.9 → 1.0.11

package/dist/cjs/src/testing/graph-tester/core/TestFunction.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Abstract base class for all test functions.
+ *
+ * Test functions implement specific testing modes (visual regression, performance, accessibility, etc.).
+ * Each test function:
+ * 1. Receives a Playwright page and test context
+ * 2. Performs its testing logic
+ * 3. Returns a TestResult with pass/fail status and metadata
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestFunction = void 0;
+exports.isTestFunction = isTestFunction;
+/**
+ * Abstract base class for test functions.
+ *
+ * @example
+ * ```typescript
+ * class VisualRegressionMode extends TestFunction {
+ *   mode = 'visual';
+ *
+ *   async execute(page: Page, context: TestContext): Promise<TestResult> {
+ *     const startTime = Date.now();
+ *     const screenshot = await page.screenshot({ fullPage: true });
+ *
+ *     return {
+ *       passed: true,
+ *       duration: Date.now() - startTime,
+ *       errors: [],
+ *       metadata: {
+ *         screenshot,
+ *         screenshotPath: './screenshots/example.png'
+ *       }
+ *     };
+ *   }
+ * }
+ * ```
+ */
+class TestFunction {
+    /**
+     * Execute the full test lifecycle: setup, execute, teardown.
+     * This method handles the orchestration and error handling.
+     *
+     * @param page - Playwright page instance
+     * @param context - Test context
+     * @returns Test result
+     */
+    async run(page, context) {
+        const startTime = Date.now();
+        const errors = [];
+        try {
+            // Check if we should test this route
+            if (this.shouldTest && !this.shouldTest(context)) {
+                return {
+                    passed: true,
+                    duration: Date.now() - startTime,
+                    errors: [],
+                    metadata: {
+                        skipped: true,
+                        reason: 'Skipped by shouldTest() predicate',
+                    },
+                    mode: this.mode,
+                    route: context.route,
+                };
+            }
+            // Setup
+            if (this.setup) {
+                try {
+                    await this.setup(page);
+                }
+                catch (error) {
+                    errors.push({
+                        severity: 'critical',
+                        message: `Setup failed: ${error instanceof Error ? error.message : String(error)}`,
+                        stack: error instanceof Error ? error.stack : undefined,
+                    });
+                    return {
+                        passed: false,
+                        duration: Date.now() - startTime,
+                        errors,
+                        metadata: {},
+                        mode: this.mode,
+                        route: context.route,
+                    };
+                }
+            }
+            // Execute
+            let result;
+            try {
+                result = await this.execute(page, context);
+            }
+            catch (error) {
+                errors.push({
+                    severity: 'critical',
+                    message: `Execution failed: ${error instanceof Error ? error.message : String(error)}`,
+                    stack: error instanceof Error ? error.stack : undefined,
+                });
+                result = {
+                    passed: false,
+                    duration: Date.now() - startTime,
+                    errors,
+                    metadata: {},
+                };
+            }
+            // Teardown
+            if (this.teardown) {
+                try {
+                    await this.teardown(page);
+                }
+                catch (error) {
+                    errors.push({
+                        severity: 'warning',
+                        message: `Teardown failed: ${error instanceof Error ? error.message : String(error)}`,
+                        stack: error instanceof Error ? error.stack : undefined,
+                    });
+                }
+            }
+            // Merge errors and add metadata
+            return {
+                ...result,
+                errors: [...errors, ...result.errors],
+                mode: this.mode,
+                route: context.route,
+            };
+        }
+        catch (error) {
+            // Catch-all for unexpected errors
+            return {
+                passed: false,
+                duration: Date.now() - startTime,
+                errors: [
+                    ...errors,
+                    {
+                        severity: 'critical',
+                        message: `Unexpected error: ${error instanceof Error ? error.message : String(error)}`,
+                        stack: error instanceof Error ? error.stack : undefined,
+                    },
+                ],
+                metadata: {},
+                mode: this.mode,
+                route: context.route,
+            };
+        }
+    }
+    /**
+     * Validate test function configuration.
+     * Override to add custom validation logic.
+     *
+     * @returns Array of validation errors (empty if valid)
+     */
+    validate() {
+        const errors = [];
+        if (!this.mode) {
+            errors.push('mode is required');
+        }
+        if (!this.name) {
+            errors.push('name is required');
+        }
+        if (!this.description) {
+            errors.push('description is required');
+        }
+        return errors;
+    }
+    /**
+     * Get test function info for reporting.
+     */
+    getInfo() {
+        return {
+            mode: this.mode,
+            name: this.name,
+            description: this.description,
+        };
+    }
+}
+exports.TestFunction = TestFunction;
+/**
+ * Type guard to check if an object is a TestFunction.
+ */
+function isTestFunction(obj) {
+    return (obj &&
+        typeof obj === 'object' &&
+        typeof obj.mode === 'string' &&
+        typeof obj.name === 'string' &&
+        typeof obj.description === 'string' &&
+        typeof obj.execute === 'function');
+}
+//# sourceMappingURL=TestFunction.js.map

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

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

package/dist/cjs/src/testing/graph-tester/core/types.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Core types for the graph-based testing framework.
+ *
+ * This file is the contract between all packages - changes require consensus.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewportPresets = void 0;
+/**
+ * Predefined viewport presets.
+ */
+exports.ViewportPresets = {
+    Desktop: { name: 'desktop', width: 1920, height: 1080 },
+    DesktopSmall: { name: 'desktop-small', width: 1366, height: 768 },
+    Laptop: { name: 'laptop', width: 1280, height: 720 },
+    TabletLandscape: { name: 'tablet-landscape', width: 1024, height: 768, isMobile: true, hasTouch: true },
+    TabletPortrait: { name: 'tablet-portrait', width: 768, height: 1024, isMobile: true, hasTouch: true },
+    MobileLarge: { name: 'mobile-large', width: 414, height: 896, isMobile: true, hasTouch: true },
+    Mobile: { name: 'mobile', width: 375, height: 812, isMobile: true, hasTouch: true },
+    MobileSmall: { name: 'mobile-small', width: 320, height: 568, isMobile: true, hasTouch: true },
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/core/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAyPH;;GAEG;AACU,QAAA,eAAe,GAAG;IAC7B,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACvD,YAAY,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACjE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACpD,eAAe,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IACvG,cAAc,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IACrG,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC9F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IACnF,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;CACtF,CAAC"}

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

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Fixtures exports.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanupPortPool = exports.expect = exports.test = void 0;
+var portPool_1 = require("./portPool");
+Object.defineProperty(exports, "test", { 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/fixtures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/testing/graph-tester/fixtures/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,uCAA2D;AAAlD,gGAAA,IAAI,OAAA;AAAE,kGAAA,MAAM,OAAA;AAAE,2GAAA,eAAe,OAAA"}

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"}