@testivai/witness-cdp 1.0.0

package/dist/utils/framework-detect.js

@@ -0,0 +1,379 @@
+"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.FrameworkDetector = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Framework detection utility
+ */
+class FrameworkDetector {
+    /**
+     * Detect the testing framework in use
+     */
+    static detect() {
+        const cwd = process.cwd();
+        const evidence = [];
+        const configFiles = [];
+        let framework = 'unknown';
+        let confidence = 0;
+        // Check for Cypress
+        const cypressResult = this.detectCypress(cwd);
+        if (cypressResult.detected) {
+            framework = 'cypress';
+            confidence = cypressResult.confidence;
+            evidence.push(...cypressResult.evidence);
+            configFiles.push(...cypressResult.configFiles);
+        }
+        // Check for WebdriverIO
+        const wdioResult = this.detectWebdriverIO(cwd);
+        if (wdioResult.detected && wdioResult.confidence > confidence) {
+            framework = 'webdriverio';
+            confidence = wdioResult.confidence;
+            evidence.length = 0;
+            configFiles.length = 0;
+            evidence.push(...wdioResult.evidence);
+            configFiles.push(...wdioResult.configFiles);
+        }
+        // Check for Selenium JS
+        const seleniumJsResult = this.detectSeleniumJS(cwd);
+        if (seleniumJsResult.detected && seleniumJsResult.confidence > confidence) {
+            framework = 'selenium-js';
+            confidence = seleniumJsResult.confidence;
+            evidence.length = 0;
+            configFiles.length = 0;
+            evidence.push(...seleniumJsResult.evidence);
+            configFiles.push(...seleniumJsResult.configFiles);
+        }
+        // Check for Selenium Python
+        const seleniumPyResult = this.detectSeleniumPython(cwd);
+        if (seleniumPyResult.detected && seleniumPyResult.confidence > confidence) {
+            framework = 'selenium-python';
+            confidence = seleniumPyResult.confidence;
+            evidence.length = 0;
+            configFiles.length = 0;
+            evidence.push(...seleniumPyResult.evidence);
+            configFiles.push(...seleniumPyResult.configFiles);
+        }
+        const instructions = this.generateInstructions(framework);
+        return {
+            framework,
+            confidence,
+            evidence,
+            configFiles,
+            instructions,
+        };
+    }
+    /**
+     * Detect Cypress
+     */
+    static detectCypress(cwd) {
+        const detected = false;
+        const evidence = [];
+        const configFiles = [];
+        let confidence = 0;
+        // Check for cypress.config.js/ts
+        const cypressConfigFiles = ['cypress.config.js', 'cypress.config.ts'];
+        for (const file of cypressConfigFiles) {
+            if (fs.existsSync(path.join(cwd, file))) {
+                configFiles.push(file);
+                evidence.push(`Found ${file}`);
+                confidence += 0.4;
+            }
+        }
+        // Check for cypress folder
+        if (fs.existsSync(path.join(cwd, 'cypress'))) {
+            evidence.push('Found cypress/ directory');
+            confidence += 0.3;
+        }
+        // Check package.json for cypress dependency
+        const packageJsonPath = path.join(cwd, 'package.json');
+        if (fs.existsSync(packageJsonPath)) {
+            try {
+                const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+                if (packageJson.dependencies?.cypress || packageJson.devDependencies?.cypress) {
+                    evidence.push('Found cypress in package.json');
+                    confidence += 0.3;
+                }
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        return { detected: confidence > 0, confidence, evidence, configFiles };
+    }
+    /**
+     * Detect WebdriverIO
+     */
+    static detectWebdriverIO(cwd) {
+        const detected = false;
+        const evidence = [];
+        const configFiles = [];
+        let confidence = 0;
+        // Check for wdio.conf.js/ts
+        const wdioConfigFiles = ['wdio.conf.js', 'wdio.conf.ts'];
+        for (const file of wdioConfigFiles) {
+            if (fs.existsSync(path.join(cwd, file))) {
+                configFiles.push(file);
+                evidence.push(`Found ${file}`);
+                confidence += 0.5;
+            }
+        }
+        // Check package.json for webdriverio dependency
+        const packageJsonPath = path.join(cwd, 'package.json');
+        if (fs.existsSync(packageJsonPath)) {
+            try {
+                const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+                if (packageJson.dependencies?.webdriverio || packageJson.devDependencies?.webdriverio) {
+                    evidence.push('Found webdriverio in package.json');
+                    confidence += 0.5;
+                }
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        return { detected: confidence > 0, confidence, evidence, configFiles };
+    }
+    /**
+     * Detect Selenium JS
+     */
+    static detectSeleniumJS(cwd) {
+        const detected = false;
+        const evidence = [];
+        const configFiles = [];
+        let confidence = 0;
+        // Check package.json for selenium-webdriver dependency
+        const packageJsonPath = path.join(cwd, 'package.json');
+        if (fs.existsSync(packageJsonPath)) {
+            try {
+                const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+                if (packageJson.dependencies?.['selenium-webdriver'] ||
+                    packageJson.devDependencies?.['selenium-webdriver']) {
+                    evidence.push('Found selenium-webdriver in package.json');
+                    confidence = 0.8;
+                }
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        // Look for selenium usage in test files
+        const testDirs = ['test', 'tests', 'spec', '__tests__'];
+        for (const testDir of testDirs) {
+            const dirPath = path.join(cwd, testDir);
+            if (fs.existsSync(dirPath)) {
+                const files = fs.readdirSync(dirPath);
+                for (const file of files) {
+                    if (file.endsWith('.js') || file.endsWith('.ts')) {
+                        const filePath = path.join(dirPath, file);
+                        const content = fs.readFileSync(filePath, 'utf-8');
+                        if (content.includes('selenium-webdriver') ||
+                            content.includes('import { Builder }') ||
+                            content.includes('webdriver')) {
+                            evidence.push(`Found selenium usage in ${path.join(testDir, file)}`);
+                            confidence = Math.max(confidence, 0.6);
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        return { detected: confidence > 0, confidence, evidence, configFiles };
+    }
+    /**
+     * Detect Selenium Python
+     */
+    static detectSeleniumPython(cwd) {
+        const detected = false;
+        const evidence = [];
+        const configFiles = [];
+        let confidence = 0;
+        // Check for requirements.txt or pyproject.toml
+        const reqFiles = ['requirements.txt', 'pyproject.toml', 'Pipfile'];
+        for (const file of reqFiles) {
+            if (fs.existsSync(path.join(cwd, file))) {
+                const content = fs.readFileSync(path.join(cwd, file), 'utf-8');
+                if (content.includes('selenium')) {
+                    evidence.push(`Found selenium in ${file}`);
+                    confidence += 0.5;
+                    configFiles.push(file);
+                }
+            }
+        }
+        // Look for selenium usage in Python files
+        const testDirs = ['test', 'tests', 'spec'];
+        for (const testDir of testDirs) {
+            const dirPath = path.join(cwd, testDir);
+            if (fs.existsSync(dirPath)) {
+                const files = fs.readdirSync(dirPath);
+                for (const file of files) {
+                    if (file.endsWith('.py')) {
+                        const filePath = path.join(dirPath, file);
+                        const content = fs.readFileSync(filePath, 'utf-8');
+                        if (content.includes('from selenium import') ||
+                            content.includes('import selenium') ||
+                            content.includes('webdriver')) {
+                            evidence.push(`Found selenium usage in ${path.join(testDir, file)}`);
+                            confidence = Math.max(confidence, 0.7);
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        return { detected: confidence > 0, confidence, evidence, configFiles };
+    }
+    /**
+     * Generate setup instructions for the detected framework
+     */
+    static generateInstructions(framework) {
+        switch (framework) {
+            case 'cypress':
+                return [
+                    '',
+                    'To use TestivAI with Cypress:',
+                    '',
+                    '1. Add this custom command to cypress/support/commands.js:',
+                    '',
+                    '  // testivai-witness-cdp.js',
+                    '  Cypress.Commands.add(\'witness\', (name) => {',
+                    '    return cy.window().invoke(\'testivaiWitness\', name);',
+                    '  });',
+                    '',
+                    '2. Use in your tests:',
+                    '',
+                    '  it(\'should capture visual snapshot\', () => {',
+                    '    cy.visit(\'/my-page\');',
+                    '    cy.witness(\'my-snapshot\');',
+                    '  });',
+                    '',
+                    '3. Run tests with:',
+                    '  testivai run "cypress run"',
+                    '',
+                ];
+            case 'webdriverio':
+                return [
+                    '',
+                    'To use TestivAI with WebdriverIO:',
+                    '',
+                    '1. Add this custom command to your test setup:',
+                    '',
+                    '  // In wdio.conf.js or test setup',
+                    '  browser.addCommand(\'witness\', function(name) {',
+                    '    return this.executeScript(\'return window.testivaiWitness(arguments[0])\', name);',
+                    '  });',
+                    '',
+                    '2. Use in your tests:',
+                    '',
+                    '  it(\'should capture visual snapshot\', async () => {',
+                    '    await browser.url(\'/my-page\');',
+                    '    await browser.witness(\'my-snapshot\');',
+                    '  });',
+                    '',
+                    '3. Run tests with:',
+                    '  testivai run "npx wdio"',
+                    '',
+                ];
+            case 'selenium-js':
+                return [
+                    '',
+                    'To use TestivAI with Selenium (JavaScript):',
+                    '',
+                    '1. In your tests, use execute_script:',
+                    '',
+                    '  const { Builder, By } = require(\'selenium-webdriver\');',
+                    '',
+                    '  async function captureSnapshot(driver, name) {',
+                    '    await driver.executeScript(`return window.testivaiWitness(\'${name}\')`);',
+                    '  }',
+                    '',
+                    '2. Use in your tests:',
+                    '',
+                    '  it(\'should capture visual snapshot\', async () => {',
+                    '    const driver = await new Builder().forBrowser(\'chrome\').build();',
+                    '    await driver.get(\'http://localhost:3000\');',
+                    '    await captureSnapshot(driver, \'my-snapshot\');',
+                    '  });',
+                    '',
+                    '3. Run tests with:',
+                    '  testivai run "npm test"',
+                    '',
+                ];
+            case 'selenium-python':
+                return [
+                    '',
+                    'To use TestivAI with Selenium (Python):',
+                    '',
+                    '1. In your tests, use execute_script:',
+                    '',
+                    '  from selenium import webdriver',
+                    '',
+                    '  def capture_snapshot(driver, name):',
+                    '      driver.execute_script(f"return window.testivaiWitness(\'{name}\')")',
+                    '',
+                    '2. Use in your tests:',
+                    '',
+                    '  def test_visual_snapshot():',
+                    '      driver = webdriver.Chrome()',
+                    '      driver.get("http://localhost:3000")',
+                    '      capture_snapshot(driver, "my-snapshot")',
+                    '',
+                    '3. Run tests with:',
+                    '  testivai run "pytest tests/"',
+                    '',
+                ];
+            default:
+                return [
+                    '',
+                    'No supported testing framework detected.',
+                    '',
+                    'To use TestivAI, you need to:',
+                    '',
+                    '1. Launch Chrome with remote debugging:',
+                    '   chrome --remote-debugging-port=9222',
+                    '',
+                    '2. In your test code, call:',
+                    '   window.testivaiWitness(\'snapshot-name\')',
+                    '',
+                    '3. Run your tests with:',
+                    '   testivai run "your-test-command"',
+                    '',
+                ];
+        }
+    }
+}
+exports.FrameworkDetector = FrameworkDetector;
+//# sourceMappingURL=framework-detect.js.map

package/dist/utils/framework-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-detect.js","sourceRoot":"","sources":["../../src/utils/framework-detect.ts"],"names":[],"mappings":"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"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,29 @@
+export interface LoggerOptions {
+    verbose?: boolean;
+    quiet?: boolean;
+    debug?: boolean;
+}
+export declare class Logger {
+    private options;
+    constructor(options?: LoggerOptions);
+    private shouldLog;
+    error(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+    success(message: string, ...args: any[]): void;
+    verbose(message: string, ...args: any[]): void;
+    plain(message: string, ...args: any[]): void;
+    capture(snapshotName: string): void;
+    upload(batchId: string): void;
+    connected(port: number): void;
+    disconnected(): void;
+    bindingRegistered(bindingName: string): void;
+    bindingCalled(bindingName: string, payload?: string): void;
+    startProgress(message: string): void;
+    updateProgress(message: string): void;
+    endProgress(message: string): void;
+}
+export declare const logger: Logger;
+export declare function createLogger(options: LoggerOptions): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAgB;gBAEnB,OAAO,GAAE,aAAkB;IAIvC,OAAO,CAAC,SAAS;IAMjB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAK5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAK3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAK3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAK5C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAK9C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAK9C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM5C,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAKnC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK7B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7B,YAAY,IAAI,IAAI;IAKpB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAK5C,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAM1D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKpC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOrC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAMnC;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC;AAGnC,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE3D"}

package/dist/utils/logger.js

@@ -0,0 +1,114 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.Logger = void 0;
+exports.createLogger = createLogger;
+const chalk_1 = __importDefault(require("chalk"));
+class Logger {
+    constructor(options = {}) {
+        this.options = options;
+    }
+    shouldLog(level) {
+        if (this.options.quiet && level !== 'error')
+            return false;
+        if (level === 'debug' && !this.options.debug)
+            return false;
+        return true;
+    }
+    error(message, ...args) {
+        if (!this.shouldLog('error'))
+            return;
+        console.error(chalk_1.default.red(`❌ ${message}`), ...args);
+    }
+    warn(message, ...args) {
+        if (!this.shouldLog('warn'))
+            return;
+        console.warn(chalk_1.default.yellow(`⚠️  ${message}`), ...args);
+    }
+    info(message, ...args) {
+        if (!this.shouldLog('info'))
+            return;
+        console.log(chalk_1.default.blue(`ℹ️  ${message}`), ...args);
+    }
+    debug(message, ...args) {
+        if (!this.shouldLog('debug'))
+            return;
+        console.log(chalk_1.default.gray(`🐛 ${message}`), ...args);
+    }
+    success(message, ...args) {
+        if (!this.shouldLog('success'))
+            return;
+        console.log(chalk_1.default.green(`✅ ${message}`), ...args);
+    }
+    verbose(message, ...args) {
+        if (!this.options.verbose || this.options.quiet)
+            return;
+        console.log(chalk_1.default.gray(`   ${message}`), ...args);
+    }
+    plain(message, ...args) {
+        if (this.options.quiet)
+            return;
+        console.log(message, ...args);
+    }
+    // Specialized loggers for common operations
+    capture(snapshotName) {
+        if (!this.shouldLog('info'))
+            return;
+        console.log(chalk_1.default.cyan(`📸 Capturing: ${snapshotName}`));
+    }
+    upload(batchId) {
+        if (!this.shouldLog('info'))
+            return;
+        console.log(chalk_1.default.cyan(`📤 Uploading batch: ${batchId}`));
+    }
+    connected(port) {
+        if (!this.shouldLog('success'))
+            return;
+        console.log(chalk_1.default.green(`🔗 Connected to Chrome on port ${port}`));
+    }
+    disconnected() {
+        if (!this.shouldLog('info'))
+            return;
+        console.log(chalk_1.default.blue(`🔌 Disconnected from Chrome`));
+    }
+    bindingRegistered(bindingName) {
+        if (!this.shouldLog('debug'))
+            return;
+        console.log(chalk_1.default.gray(`📝 Registered binding: ${bindingName}`));
+    }
+    bindingCalled(bindingName, payload) {
+        if (!this.shouldLog('debug'))
+            return;
+        console.log(chalk_1.default.gray(`📞 Binding called: ${bindingName}${payload ? ` (${payload})` : ''}`));
+    }
+    // Progress indicators
+    startProgress(message) {
+        if (!this.shouldLog('info'))
+            return;
+        process.stdout.write(`${chalk_1.default.blue('⏳')} ${message}...`);
+    }
+    updateProgress(message) {
+        if (!this.shouldLog('info'))
+            return;
+        process.stdout.clearLine(0);
+        process.stdout.cursorTo(0);
+        process.stdout.write(`${chalk_1.default.blue('⏳')} ${message}...`);
+    }
+    endProgress(message) {
+        if (!this.shouldLog('info'))
+            return;
+        process.stdout.clearLine(0);
+        process.stdout.cursorTo(0);
+        console.log(`${chalk_1.default.green('✓')} ${message}`);
+    }
+}
+exports.Logger = Logger;
+// Create default logger instance
+exports.logger = new Logger();
+// Create logger with options
+function createLogger(options) {
+    return new Logger(options);
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/process.d.ts

@@ -0,0 +1,61 @@
+import { ChildProcess } from 'child_process';
+export interface ProcessOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    silent?: boolean;
+    inheritStdio?: boolean;
+}
+export interface ProcessResult {
+    exitCode: number | null;
+    signal: string | null;
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Spawn a child process and capture its output
+ */
+export declare function spawnProcess(command: string, args?: string[], options?: ProcessOptions): Promise<ProcessResult>;
+/**
+ * Spawn a process with real-time output and signal handling
+ */
+export declare class ProcessManager {
+    private command;
+    private args;
+    private options;
+    private child;
+    private isKilled;
+    constructor(command: string, args?: string[], options?: ProcessOptions);
+    /**
+     * Start the process
+     */
+    start(): Promise<void>;
+    /**
+     * Wait for the process to complete
+     */
+    wait(): Promise<ProcessResult>;
+    /**
+     * Kill the process
+     */
+    kill(signal?: NodeJS.Signals): void;
+    /**
+     * Check if process is running
+     */
+    isRunning(): boolean;
+    /**
+     * Get the child process instance
+     */
+    getProcess(): ChildProcess | null;
+    /**
+     * Run a command and return the result
+     */
+    static run(command: string, args?: string[], options?: ProcessOptions): Promise<ProcessResult>;
+}
+/**
+ * Handle SIGINT and SIGTERM gracefully
+ */
+export declare function setupSignalHandlers(cleanup: () => void | Promise<void>): void;
+/**
+ * Check if a command exists in PATH
+ */
+export declare function commandExists(command: string): Promise<boolean>;
+//# sourceMappingURL=process.d.ts.map

package/dist/utils/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,YAAY,EAAE,MAAM,eAAe,CAAC;AAGpD,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAgDxB;AAED;;GAEG;AACH,qBAAa,cAAc;IAKvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,OAAO;IANjB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAS;gBAGf,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,cAAmB;IAGtC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC;IAsCpC;;OAEG;IACH,IAAI,CAAC,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,IAAI;IAQ9C;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,UAAU,IAAI,YAAY,GAAG,IAAI;IAIjC;;OAEG;WACU,GAAG,CACd,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC;CAK1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAClC,IAAI,CAcN;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUrE"}