mindheal 1.0.0

package/dist/esm/git/pr-creator.js

@@ -0,0 +1,188 @@
+import { logger } from '../utils/logger.js';
+import { getRepoInfo } from '../utils/environment.js';
+
+class PRCreator {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Create a pull/merge request on the configured provider.
+     */
+    async createPR(details) {
+        const repo = this.resolveRepo();
+        logger.info(`Creating PR on ${this.config.provider}: "${details.title}"`);
+        switch (this.config.provider) {
+            case 'github':
+                return this.createGitHubPR(repo, details);
+            case 'gitlab':
+                return this.createGitLabMR(repo, details);
+            case 'bitbucket':
+                return this.createBitbucketPR(repo, details);
+            default: {
+                const provider = this.config.provider;
+                throw new Error(`[MindHeal] Unsupported git provider: ${provider}`);
+            }
+        }
+    }
+    // ── Private helpers ──────────────────────────────────────────────────────────
+    /**
+     * Resolve the repository owner/name from config or by auto-detecting from
+     * the git remote URL.
+     */
+    resolveRepo() {
+        if (this.config.repoOwner && this.config.repoName) {
+            return { owner: this.config.repoOwner, name: this.config.repoName };
+        }
+        const detected = getRepoInfo();
+        if (detected) {
+            logger.debug('Auto-detected repo info from git remote', detected);
+            return detected;
+        }
+        throw new Error('[MindHeal] Unable to determine repository owner/name. ' +
+            'Set repoOwner and repoName in the git config, or ensure a valid git remote exists.');
+    }
+    /**
+     * Format the PR body with a healing summary markdown table.
+     */
+    formatBody(rawBody) {
+        return [
+            '## MindHeal - Automated Locator Fix',
+            '',
+            rawBody,
+            '',
+            '---',
+            '*This PR was automatically generated by [MindHeal](https://github.com/nicholasgriffintn/mindheal).*',
+        ].join('\n');
+    }
+    // ── GitHub ────────────────────────────────────────────────────────────────────
+    async createGitHubPR(repo, details) {
+        const url = `https://api.github.com/repos/${repo.owner}/${repo.name}/pulls`;
+        const body = {
+            title: details.title,
+            body: this.formatBody(details.body),
+            head: details.sourceBranch,
+            base: details.targetBranch,
+        };
+        const response = await this.request(url, body, {
+            Authorization: `Bearer ${this.config.token}`,
+            Accept: 'application/vnd.github.v3+json',
+        });
+        const data = (await response.json());
+        if (!response.ok) {
+            const errorBody = JSON.stringify(data);
+            throw new Error(`[MindHeal] GitHub PR creation failed (${response.status}): ${errorBody}`);
+        }
+        const prResult = {
+            url: data.html_url,
+            number: data.number,
+            provider: 'github',
+        };
+        // Best-effort: add labels and reviewers
+        await this.addGitHubExtras(repo, prResult.number, details);
+        logger.info(`GitHub PR created: ${prResult.url}`);
+        return prResult;
+    }
+    /**
+     * Add labels and request reviewers on a GitHub PR (non-critical).
+     */
+    async addGitHubExtras(repo, prNumber, details) {
+        const base = `https://api.github.com/repos/${repo.owner}/${repo.name}`;
+        const headers = {
+            Authorization: `Bearer ${this.config.token}`,
+            Accept: 'application/vnd.github.v3+json',
+        };
+        // Labels
+        if (details.labels.length > 0) {
+            try {
+                await this.request(`${base}/issues/${prNumber}/labels`, { labels: details.labels }, headers);
+            }
+            catch (error) {
+                logger.warn('[MindHeal] Failed to add labels to PR', error);
+            }
+        }
+        // Reviewers
+        if (details.reviewers.length > 0) {
+            try {
+                await this.request(`${base}/pulls/${prNumber}/requested_reviewers`, { reviewers: details.reviewers }, headers);
+            }
+            catch (error) {
+                logger.warn('[MindHeal] Failed to request reviewers on PR', error);
+            }
+        }
+    }
+    // ── GitLab ────────────────────────────────────────────────────────────────────
+    async createGitLabMR(repo, details) {
+        const encodedPath = encodeURIComponent(`${repo.owner}/${repo.name}`);
+        const url = `https://gitlab.com/api/v4/projects/${encodedPath}/merge_requests`;
+        const body = {
+            title: details.title,
+            description: this.formatBody(details.body),
+            source_branch: details.sourceBranch,
+            target_branch: details.targetBranch,
+            labels: details.labels.join(','),
+            reviewer_ids: [], // GitLab uses numeric IDs; usernames not directly supported
+        };
+        const response = await this.request(url, body, {
+            'PRIVATE-TOKEN': this.config.token,
+        });
+        const data = (await response.json());
+        if (!response.ok) {
+            const errorBody = JSON.stringify(data);
+            throw new Error(`[MindHeal] GitLab MR creation failed (${response.status}): ${errorBody}`);
+        }
+        const prResult = {
+            url: data.web_url,
+            number: data.iid,
+            provider: 'gitlab',
+        };
+        logger.info(`GitLab MR created: ${prResult.url}`);
+        return prResult;
+    }
+    // ── Bitbucket ─────────────────────────────────────────────────────────────────
+    async createBitbucketPR(repo, details) {
+        const url = `https://api.bitbucket.org/2.0/repositories/${repo.owner}/${repo.name}/pullrequests`;
+        const body = {
+            title: details.title,
+            description: this.formatBody(details.body),
+            source: { branch: { name: details.sourceBranch } },
+            destination: { branch: { name: details.targetBranch } },
+            reviewers: details.reviewers.map((username) => ({ username })),
+            close_source_branch: true,
+        };
+        const response = await this.request(url, body, {
+            Authorization: `Bearer ${this.config.token}`,
+        });
+        const data = (await response.json());
+        if (!response.ok) {
+            const errorBody = JSON.stringify(data);
+            throw new Error(`[MindHeal] Bitbucket PR creation failed (${response.status}): ${errorBody}`);
+        }
+        const prResult = {
+            url: data.links.html.href,
+            number: data.id,
+            provider: 'bitbucket',
+        };
+        logger.info(`Bitbucket PR created: ${prResult.url}`);
+        return prResult;
+    }
+    // ── HTTP helper ───────────────────────────────────────────────────────────────
+    async request(url, body, headers) {
+        try {
+            return await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...headers,
+                },
+                body: JSON.stringify(body),
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`[MindHeal] HTTP request to ${url} failed: ${message}`);
+        }
+    }
+}
+
+export { PRCreator };
+//# sourceMappingURL=pr-creator.js.map

package/dist/esm/git/pr-creator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-creator.js","sources":["../../../../src/git/pr-creator.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -0,0 +1,37 @@
+export { createMindHealFixture, getAllHealingSessions, mindHealConfig, autoTest as test } from './core/interceptor.js';
+export { expect } from '@playwright/test';
+export { Healer } from './core/healer.js';
+export { createConfig, loadConfig } from './config/config-loader.js';
+export { DEFAULT_CONFIG } from './config/defaults.js';
+export { createAIProvider } from './ai/ai-provider.js';
+export { AnthropicProvider } from './ai/anthropic-provider.js';
+export { OpenAIProvider } from './ai/openai-provider.js';
+export { AzureOpenAIProvider } from './ai/azure-openai-provider.js';
+export { GeminiProvider } from './ai/gemini-provider.js';
+export { OllamaProvider } from './ai/ollama-provider.js';
+export { BedrockProvider } from './ai/bedrock-provider.js';
+export { DeepSeekProvider } from './ai/deepseek-provider.js';
+export { GroqProvider } from './ai/groq-provider.js';
+export { QwenProvider } from './ai/qwen-provider.js';
+export { MetaProvider } from './ai/meta-provider.js';
+export { PerplexityProvider } from './ai/perplexity-provider.js';
+export { GitOperations } from './git/git-operations.js';
+export { PRCreator } from './git/pr-creator.js';
+export { CodeModifier } from './git/code-modifier.js';
+export { ReviewServer } from './server/review-server.js';
+export { HealReportGenerator } from './reporters/heal-report.js';
+export { SelfHealCache } from './core/self-heal-cache.js';
+export { KnowledgeStore } from './rag/knowledge-store.js';
+export { ContextRetriever } from './rag/context-retriever.js';
+export { buildTermVector, cosineSimilarity, textSimilarity, tokenize } from './rag/embeddings.js';
+export { HealingAnalytics } from './analytics/healing-analytics.js';
+export { SmartRetry } from './core/smart-retry.js';
+export { VisualVerifier } from './core/visual-verification.js';
+export { FileLock } from './utils/file-lock.js';
+export { configureLogger, logger } from './utils/logger.js';
+export { detectGitProvider, getRepoInfo, isCI } from './utils/environment.js';
+export { detectPlatform, enterpriseStrategy, extractStableIdPart, isDynamicId, scrollVirtualContainer, waitForEnterpriseLoad } from './core/enterprise-strategy.js';
+export { captureDOMSnapshot } from './core/dom-snapshot.js';
+export { analyzeLocator, getLocatorHash } from './core/locator-analyzer.js';
+export { runStrategy } from './core/locator-strategies.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/rag/context-retriever.js

@@ -0,0 +1,287 @@
+import { logger } from '../utils/logger.js';
+
+/**
+ * RAG Context Retriever — collects relevant context from all knowledge sources.
+ *
+ * Before the AI healing strategy runs, the retriever searches the knowledge store
+ * for entries that are relevant to the current broken locator. The returned
+ * context chunks are injected into the AI prompt so the model can make better
+ * decisions based on project-specific knowledge.
+ *
+ * Six knowledge sources are supported:
+ *   1. healing-history  — previously healed locators for the same page/selector
+ *   2. page-objects     — POM class metadata (selectors, method names, file paths)
+ *   3. git-changes      — recent git diffs that may explain why a locator broke
+ *   4. dom-snapshots    — historical DOM snapshots of the same page
+ *   5. component-docs   — component library / design system documentation
+ *   6. test-specs       — test file context (describe blocks, step descriptions)
+ */
+class ContextRetriever {
+    constructor(config, store) {
+        this.config = config;
+        this.store = store;
+    }
+    /**
+     * Retrieve relevant context for a broken locator.
+     *
+     * Builds a search query from the locator info + page URL, queries the
+     * knowledge store, and returns ranked context chunks that meet the
+     * similarity threshold.
+     */
+    retrieve(originalLocator, pageUrl, action, errorMessage) {
+        if (!this.config.enabled) {
+            return [];
+        }
+        try {
+            // Build a rich query from the healing context
+            const query = this.buildQuery(originalLocator, pageUrl, action, errorMessage);
+            logger.debug(`[RAG] Searching knowledge store with query: "${query.slice(0, 120)}..."`);
+            const chunks = this.store.search(query, {
+                sources: this.config.sources.length > 0 ? this.config.sources : undefined,
+                maxResults: this.config.maxContextChunks,
+                similarityThreshold: this.config.similarityThreshold,
+            });
+            if (chunks.length > 0) {
+                logger.info(`[RAG] Retrieved ${chunks.length} context chunk(s) for healing`);
+                for (const chunk of chunks) {
+                    logger.debug(`[RAG]   - ${chunk.source} (score: ${chunk.relevanceScore.toFixed(3)})`);
+                }
+            }
+            else {
+                logger.debug('[RAG] No relevant context found in knowledge store');
+            }
+            return chunks;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`[RAG] Context retrieval failed: ${msg}. Continuing without RAG context.`);
+            return [];
+        }
+    }
+    // ─── Knowledge Ingestion ──────────────────────────────────────────────────
+    /**
+     * Ingest a completed healing event into the knowledge store so future
+     * healings can learn from it.
+     */
+    ingestHealingEvent(event) {
+        if (!this.config.enabled)
+            return;
+        if (!this.config.sources.includes('healing-history'))
+            return;
+        try {
+            const content = [
+                `Page: ${event.pageUrl}`,
+                `Action: ${event.action}`,
+                `Original: ${event.originalLocator.playwrightExpression}`,
+                event.healedLocator
+                    ? `Healed: ${event.healedLocator.playwrightExpression}`
+                    : 'Healing failed',
+                `Strategy: ${event.strategy ?? 'none'}`,
+                `Confidence: ${event.confidence}`,
+                `Status: ${event.status}`,
+            ].join('\n');
+            this.store.upsert({
+                source: 'healing-history',
+                content,
+                tags: [
+                    event.originalLocator.selector,
+                    event.originalLocator.type,
+                    event.pageUrl,
+                    event.action,
+                ],
+                metadata: {
+                    testFile: event.testFile,
+                    testTitle: event.testTitle,
+                    strategy: event.strategy ?? 'none',
+                    status: event.status,
+                },
+            });
+            logger.debug(`[RAG] Ingested healing event: ${event.id}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`[RAG] Failed to ingest healing event: ${msg}`);
+        }
+    }
+    /**
+     * Ingest page object metadata into the knowledge store.
+     * Call this when scanning page object files during initialization.
+     */
+    ingestPageObject(filePath, selectors, className) {
+        if (!this.config.enabled)
+            return;
+        if (!this.config.sources.includes('page-objects'))
+            return;
+        try {
+            const content = [
+                `Page Object: ${className}`,
+                `File: ${filePath}`,
+                `Selectors:`,
+                ...selectors.map((s) => `  - ${s}`),
+            ].join('\n');
+            this.store.upsert({
+                source: 'page-objects',
+                content,
+                tags: [className, filePath, ...selectors.slice(0, 10)],
+                metadata: {
+                    className,
+                    filePath,
+                    selectorCount: String(selectors.length),
+                },
+            });
+            logger.debug(`[RAG] Ingested page object: ${className} (${selectors.length} selectors)`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`[RAG] Failed to ingest page object: ${msg}`);
+        }
+    }
+    /**
+     * Ingest git diff context into the knowledge store.
+     * Call this when a git change is detected that might affect locators.
+     */
+    ingestGitChange(filePath, diff, commitMessage) {
+        if (!this.config.enabled)
+            return;
+        if (!this.config.sources.includes('git-changes'))
+            return;
+        try {
+            const content = [
+                `File: ${filePath}`,
+                `Commit: ${commitMessage}`,
+                `Diff:`,
+                diff.slice(0, 2000), // Truncate large diffs
+            ].join('\n');
+            this.store.upsert({
+                source: 'git-changes',
+                content,
+                tags: [filePath, commitMessage.slice(0, 50)],
+                metadata: {
+                    filePath,
+                    commitMessage: commitMessage.slice(0, 200),
+                },
+            });
+            logger.debug(`[RAG] Ingested git change: ${filePath}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`[RAG] Failed to ingest git change: ${msg}`);
+        }
+    }
+    /**
+     * Ingest a DOM snapshot into the knowledge store.
+     * Stores a condensed version for future reference.
+     */
+    ingestDOMSnapshot(pageUrl, html, title) {
+        if (!this.config.enabled)
+            return;
+        if (!this.config.sources.includes('dom-snapshots'))
+            return;
+        try {
+            const content = [
+                `Page: ${pageUrl}`,
+                `Title: ${title}`,
+                `DOM (condensed):`,
+                html.slice(0, 3000), // Store condensed version
+            ].join('\n');
+            this.store.upsert({
+                source: 'dom-snapshots',
+                content,
+                tags: [pageUrl, title],
+                metadata: {
+                    pageUrl,
+                    title,
+                    snapshotSize: String(html.length),
+                },
+            });
+            logger.debug(`[RAG] Ingested DOM snapshot: ${pageUrl}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`[RAG] Failed to ingest DOM snapshot: ${msg}`);
+        }
+    }
+    /**
+     * Ingest component/design-system documentation.
+     */
+    ingestComponentDoc(componentName, doc, filePath) {
+        if (!this.config.enabled)
+            return;
+        if (!this.config.sources.includes('component-docs'))
+            return;
+        try {
+            this.store.upsert({
+                source: 'component-docs',
+                content: doc.slice(0, 3000),
+                tags: [componentName, filePath],
+                metadata: {
+                    componentName,
+                    filePath,
+                },
+            });
+            logger.debug(`[RAG] Ingested component doc: ${componentName}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`[RAG] Failed to ingest component doc: ${msg}`);
+        }
+    }
+    /**
+     * Ingest test spec context (describe blocks, test titles, step descriptions).
+     */
+    ingestTestSpec(testFile, testTitle, steps) {
+        if (!this.config.enabled)
+            return;
+        if (!this.config.sources.includes('test-specs'))
+            return;
+        try {
+            const content = [
+                `Test File: ${testFile}`,
+                `Test: ${testTitle}`,
+                `Steps:`,
+                ...steps.map((s, i) => `  ${i + 1}. ${s}`),
+            ].join('\n');
+            this.store.upsert({
+                source: 'test-specs',
+                content,
+                tags: [testFile, testTitle, ...steps.slice(0, 5)],
+                metadata: {
+                    testFile,
+                    testTitle,
+                    stepCount: String(steps.length),
+                },
+            });
+            logger.debug(`[RAG] Ingested test spec: ${testTitle}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`[RAG] Failed to ingest test spec: ${msg}`);
+        }
+    }
+    // ─── Helpers ──────────────────────────────────────────────────────────────
+    /**
+     * Build a rich search query from the healing context.
+     * Combines locator info, URL, action, and error for best TF-IDF matching.
+     */
+    buildQuery(locator, pageUrl, action, errorMessage) {
+        const parts = [
+            locator.selector,
+            locator.type,
+            locator.playwrightExpression,
+            pageUrl,
+            action,
+            // Include first line of error for context
+            errorMessage.split('\n')[0],
+        ];
+        return parts.filter(Boolean).join(' ');
+    }
+    /**
+     * Get the knowledge store instance (for direct access / testing).
+     */
+    getStore() {
+        return this.store;
+    }
+}
+
+export { ContextRetriever };
+//# sourceMappingURL=context-retriever.js.map

package/dist/esm/rag/context-retriever.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-retriever.js","sources":["../../../../src/rag/context-retriever.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rag/embeddings.js

@@ -0,0 +1,77 @@
+/**
+ * Lightweight text similarity engine for RAG retrieval.
+ *
+ * Uses TF-IDF-style term weighting with cosine similarity — no external
+ * embedding model or vector DB required. This is intentionally simple so
+ * MindHeal works offline (e.g. with Ollama) without any extra infrastructure.
+ *
+ * For large knowledge bases, consumers can swap in a real vector DB via the
+ * `ContextRetriever` interface.
+ */
+// ─── Tokenization ────────────────────────────────────────────────────────────
+/**
+ * Tokenizes text into lowercase alphanumeric terms, splitting on non-word
+ * characters. Also generates bigrams for better matching on locator patterns
+ * like "submit-btn" or "getByTestId".
+ */
+function tokenize(text) {
+    const raw = text.toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim().split(/\s+/).filter(Boolean);
+    // Add bigrams for compound terms
+    const bigrams = [];
+    for (let i = 0; i < raw.length - 1; i++) {
+        bigrams.push(`${raw[i]}_${raw[i + 1]}`);
+    }
+    return [...raw, ...bigrams];
+}
+/**
+ * Builds a term-frequency vector from a list of tokens.
+ */
+function buildTermVector(tokens) {
+    const freq = new Map();
+    for (const token of tokens) {
+        freq.set(token, (freq.get(token) ?? 0) + 1);
+    }
+    // Normalize by document length
+    const len = tokens.length || 1;
+    for (const [term, count] of freq) {
+        freq.set(term, count / len);
+    }
+    return freq;
+}
+/**
+ * Computes cosine similarity between two term vectors.
+ * Returns a value between 0 (completely different) and 1 (identical).
+ */
+function cosineSimilarity(a, b) {
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (const [term, weightA] of a) {
+        normA += weightA * weightA;
+        const weightB = b.get(term) ?? 0;
+        dotProduct += weightA * weightB;
+    }
+    for (const [, weightB] of b) {
+        normB += weightB * weightB;
+    }
+    const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denominator === 0)
+        return 0;
+    return dotProduct / denominator;
+}
+/**
+ * Computes similarity between two text strings.
+ * Convenience wrapper over tokenize → buildTermVector → cosineSimilarity.
+ */
+function textSimilarity(textA, textB) {
+    const tokensA = tokenize(textA);
+    const tokensB = tokenize(textB);
+    if (tokensA.length === 0 || tokensB.length === 0)
+        return 0;
+    const vecA = buildTermVector(tokensA);
+    const vecB = buildTermVector(tokensB);
+    return cosineSimilarity(vecA, vecB);
+}
+
+export { buildTermVector, cosineSimilarity, textSimilarity, tokenize };
+//# sourceMappingURL=embeddings.js.map

package/dist/esm/rag/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sources":["../../../../src/rag/embeddings.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;AASG;AAEH;AAEA;;;;AAIG;AACG,SAAU,QAAQ,CAAC,IAAY,EAAA;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;;IAG9F,MAAM,OAAO,GAAa,EAAE;AAC5B,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;AACvC,QAAA,OAAO,CAAC,IAAI,CAAC,CAAA,EAAG,GAAG,CAAC,CAAC,CAAC,CAAA,CAAA,EAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA,CAAE,CAAC;IACzC;AAEA,IAAA,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC;AAC7B;AAMA;;AAEG;AACG,SAAU,eAAe,CAAC,MAAgB,EAAA;AAC9C,IAAA,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB;AACtC,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;AAC1B,QAAA,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C;;AAGA,IAAA,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;QAChC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,GAAG,CAAC;IAC7B;AAEA,IAAA,OAAO,IAAI;AACb;AAEA;;;AAGG;AACG,SAAU,gBAAgB,CAAC,CAAa,EAAE,CAAa,EAAA;IAC3D,IAAI,UAAU,GAAG,CAAC;IAClB,IAAI,KAAK,GAAG,CAAC;IACb,IAAI,KAAK,GAAG,CAAC;IAEb,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE;AAC/B,QAAA,KAAK,IAAI,OAAO,GAAG,OAAO;QAC1B,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;AAChC,QAAA,UAAU,IAAI,OAAO,GAAG,OAAO;IACjC;IAEA,KAAK,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE;AAC3B,QAAA,KAAK,IAAI,OAAO,GAAG,OAAO;IAC5B;AAEA,IAAA,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IACvD,IAAI,WAAW,KAAK,CAAC;AAAE,QAAA,OAAO,CAAC;IAE/B,OAAO,UAAU,GAAG,WAAW;AACjC;AAEA;;;AAGG;AACG,SAAU,cAAc,CAAC,KAAa,EAAE,KAAa,EAAA;AACzD,IAAA,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC;AAC/B,IAAA,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC;IAE/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,CAAC;AAE1D,IAAA,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC;AACrC,IAAA,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC;AAErC,IAAA,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC;AACrC;;;;"}