codemeld 2.1.0

package/dist/ai/refinement-loop.js

@@ -0,0 +1,180 @@
+/**
+ * AI Refinement Loop — Orchestrates the build→fix→verify cycle.
+ * This is the main entry point for AI-enhanced conversion.
+ */
+import { readdir } from 'fs/promises';
+import { join } from 'path';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import chalk from 'chalk';
+import ora from 'ora';
+import { agentLoop } from './agent.js';
+import { toolDefinitions, createToolExecutor } from './tools.js';
+import { FULL_REFINEMENT_PROMPT, BUILD_FIXER_PROMPT, buildUserMessage } from './prompts.js';
+const execFileAsync = promisify(execFile);
+const SHELL_OPTS = { shell: true };
+/**
+ * Run the AI refinement loop on a converted project.
+ */
+export async function runRefinement(options) {
+    const { inputDir, outputDir, maxSteps = 50, mode = 'full', verbose = false, } = options;
+    const spinner = ora({ text: 'AI agent starting...', color: 'cyan' }).start();
+    const fixesApplied = [];
+    const remainingIssues = [];
+    // Gather project context
+    spinner.text = 'Gathering project context...';
+    const originalFiles = await listFilesRecursive(inputDir, ['.html', '.js', '.css', '.json']);
+    const componentFiles = await listFilesRecursive(join(outputDir, 'src'), ['.tsx', '.ts', '.css']);
+    // Get initial build/type errors
+    const typeErrors = await runTypeCheck(outputDir);
+    const buildErrors = await runBuild(outputDir);
+    // Select system prompt based on mode
+    const systemPrompt = mode === 'build-fix' ? BUILD_FIXER_PROMPT : FULL_REFINEMENT_PROMPT;
+    // Build user message with context
+    const userMessage = buildUserMessage({
+        inputDir,
+        outputDir,
+        originalFiles: originalFiles.map(f => f.replace(inputDir + '/', '')),
+        componentFiles: componentFiles.map(f => f.replace(outputDir + '/', '')),
+        buildErrors: buildErrors.success ? undefined : buildErrors.output,
+        typeErrors: typeErrors.success ? undefined : typeErrors.output,
+    });
+    // Create tool executor
+    const toolCtx = {
+        outputDir,
+        inputDir,
+        onStatus: (msg) => {
+            if (verbose) {
+                spinner.stop();
+                console.log(chalk.dim(msg));
+                spinner.start();
+            }
+            // Track fixes from status reports
+            if (msg.includes('Fixes applied:')) {
+                const lines = msg.split('\n').filter(l => l.trim().startsWith('- '));
+                fixesApplied.push(...lines.map(l => l.trim().replace(/^- /, '')));
+            }
+            if (msg.includes('Remaining issues:')) {
+                const lines = msg.split('\n').filter(l => l.trim().startsWith('- '));
+                remainingIssues.push(...lines.map(l => l.trim().replace(/^- /, '')));
+            }
+        },
+    };
+    const toolExecutor = createToolExecutor(toolCtx);
+    // Run the agent loop
+    spinner.text = 'AI agent analyzing and fixing issues...';
+    let aiResponse;
+    try {
+        aiResponse = await agentLoop(systemPrompt, userMessage, toolDefinitions, toolExecutor, {
+            maxSteps,
+            temperature: 0.3,
+            onStep: (step, max, action) => {
+                spinner.text = `AI agent [${step}/${max}]: ${action}`;
+            },
+            onEvent: (event) => {
+                if (verbose && event.type === 'token' && event.content) {
+                    process.stdout.write(chalk.dim(event.content));
+                }
+                if (event.type === 'tool_start' && event.toolName) {
+                    spinner.text = `AI using built-in tool: ${event.toolName}...`;
+                }
+            },
+        });
+    }
+    catch (err) {
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        spinner.fail(`AI agent encountered an error: ${errorMsg}`);
+        if (verbose) {
+            console.error(chalk.red(err instanceof Error ? err.stack || errorMsg : errorMsg));
+        }
+        return {
+            success: false,
+            buildPassed: false,
+            fixesApplied,
+            remainingIssues: [errorMsg],
+            aiResponse: `Error: ${errorMsg}`,
+        };
+    }
+    // Final build verification
+    spinner.text = 'Final build verification...';
+    const finalBuild = await runBuild(outputDir);
+    if (finalBuild.success) {
+        spinner.succeed(chalk.green('AI refinement complete — build passes!'));
+    }
+    else {
+        spinner.warn(chalk.yellow('AI refinement complete — some issues may remain'));
+    }
+    // Print summary
+    if (fixesApplied.length > 0) {
+        console.log(chalk.cyan('\n  Fixes applied:'));
+        for (const fix of fixesApplied) {
+            console.log(chalk.green(`    ✓ ${fix}`));
+        }
+    }
+    if (remainingIssues.length > 0) {
+        console.log(chalk.yellow('\n  Remaining issues:'));
+        for (const issue of remainingIssues) {
+            console.log(chalk.yellow(`    ⚠ ${issue}`));
+        }
+    }
+    return {
+        success: finalBuild.success,
+        buildPassed: finalBuild.success,
+        fixesApplied,
+        remainingIssues,
+        screenshots: {
+            original: options.screenshotOriginal,
+            converted: options.screenshotConverted,
+        },
+        aiResponse,
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────
+async function listFilesRecursive(dir, extensions) {
+    const results = [];
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules' && entry.name !== 'dist') {
+                results.push(...await listFilesRecursive(fullPath, extensions));
+            }
+            else if (entry.isFile() && extensions.some(ext => entry.name.endsWith(ext))) {
+                results.push(fullPath);
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or isn't readable
+    }
+    return results;
+}
+async function runTypeCheck(outputDir) {
+    try {
+        const { stdout, stderr } = await execFileAsync('npx', ['tsc', '--noEmit'], {
+            cwd: outputDir,
+            timeout: 60_000,
+            ...SHELL_OPTS,
+        });
+        return { success: true, output: `${stdout}\n${stderr}`.trim() };
+    }
+    catch (err) {
+        const errObj = err;
+        return { success: false, output: `${errObj.stdout || ''}\n${errObj.stderr || ''}`.trim() };
+    }
+}
+async function runBuild(outputDir) {
+    try {
+        const { stdout, stderr } = await execFileAsync('npx', ['vite', 'build'], {
+            cwd: outputDir,
+            timeout: 60_000,
+            ...SHELL_OPTS,
+        });
+        return { success: true, output: `${stdout}\n${stderr}`.trim() };
+    }
+    catch (err) {
+        const errObj = err;
+        return { success: false, output: `${errObj.stdout || ''}\n${errObj.stderr || ''}`.trim() };
+    }
+}
+//# sourceMappingURL=refinement-loop.js.map

package/dist/ai/refinement-loop.js.map

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

package/dist/ai/tools.d.ts

@@ -0,0 +1,17 @@
+/**
+ * AI Agent Tools — file I/O, build commands, and screenshot capabilities
+ * These tools are provided to the AI agent so it can read/modify files,
+ * run builds, and take screenshots autonomously.
+ */
+import type { ToolDefinition } from './agent.js';
+export declare const toolDefinitions: ToolDefinition[];
+export interface ToolContext {
+    outputDir: string;
+    inputDir: string;
+    onStatus?: (message: string) => void;
+}
+/**
+ * Create a tool executor function bound to a specific project context.
+ */
+export declare function createToolExecutor(ctx: ToolContext): (name: string, args: Record<string, unknown>) => Promise<string>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/ai/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/ai/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AASjD,eAAO,MAAM,eAAe,EAAE,cAAc,EAiL3C,CAAC;AAIF,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,IAGf,MAAM,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAAC,CA+GhG"}

package/dist/ai/tools.js

@@ -0,0 +1,353 @@
+/**
+ * AI Agent Tools — file I/O, build commands, and screenshot capabilities
+ * These tools are provided to the AI agent so it can read/modify files,
+ * run builds, and take screenshots autonomously.
+ */
+import { readFile, writeFile, readdir } from 'fs/promises';
+import { join } from 'path';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+const execFileAsync = promisify(execFile);
+// On Windows, npm/npx are .cmd scripts and require shell: true
+const SHELL_OPTS = { shell: true };
+// ─── Tool Definitions (sent to AI API) ───────────────────────────────
+export const toolDefinitions = [
+    {
+        type: 'function',
+        function: {
+            name: 'read_file',
+            description: 'Read the contents of a file in the converted React project. Use this to examine component code, config files, or build output.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'Relative path from the project root (e.g., "src/components/index.tsx", "tsconfig.json")',
+                    },
+                },
+                required: ['path'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'write_file',
+            description: 'Write or overwrite a file in the converted React project. Use this to fix TypeScript errors, add missing imports, or refactor components.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'Relative path from the project root (e.g., "src/components/index.tsx")',
+                    },
+                    content: {
+                        type: 'string',
+                        description: 'The full file content to write',
+                    },
+                },
+                required: ['path', 'content'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'list_files',
+            description: 'List files in a directory of the converted React project. Use this to understand the project structure.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'Relative directory path from the project root (e.g., "src/components", "src")',
+                    },
+                },
+                required: ['path'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'run_build',
+            description: 'Run "npx vite build" to check if the project compiles. Returns build output including any errors. This is the primary way to verify the project is working.',
+            parameters: {
+                type: 'object',
+                properties: {},
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'run_typecheck',
+            description: 'Run "npx tsc --noEmit" to check for TypeScript type errors. Returns any type errors found. Use this to identify specific issues before fixing them.',
+            parameters: {
+                type: 'object',
+                properties: {},
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'read_original_file',
+            description: 'Read a file from the ORIGINAL HTML project (before conversion). Use this to understand the original code when fixing conversion issues.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'Relative path from the original project root (e.g., "index.html", "script.js", "style.css")',
+                    },
+                },
+                required: ['path'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'take_screenshot',
+            description: 'Take a screenshot of a locally served web page using Playwright. Returns the screenshot file path. Use this to visually verify the converted app.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    url: {
+                        type: 'string',
+                        description: 'The URL to screenshot (e.g., "http://localhost:3001")',
+                    },
+                    output_path: {
+                        type: 'string',
+                        description: 'Where to save the screenshot (e.g., "/tmp/screenshot.png")',
+                    },
+                    full_page: {
+                        type: 'boolean',
+                        description: 'Whether to capture full page or just viewport (default: true)',
+                    },
+                },
+                required: ['url', 'output_path'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'serve_and_screenshot',
+            description: 'Serve a directory as a static site and take a screenshot. Handles server lifecycle automatically. Use this to screenshot the original HTML site or the built React app.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    directory: {
+                        type: 'string',
+                        description: 'Absolute path to the directory to serve (e.g., "/tmp/output/dist" for built React app, "/home/user/project/sample" for original)',
+                    },
+                    output_path: {
+                        type: 'string',
+                        description: 'Where to save the screenshot (e.g., "/tmp/original-screenshot.png")',
+                    },
+                    full_page: {
+                        type: 'boolean',
+                        description: 'Whether to capture full page (default: true)',
+                    },
+                },
+                required: ['directory', 'output_path'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'report_status',
+            description: 'Report the current status of the refinement process. Use this to communicate progress, describe what was fixed, or flag issues that need human attention.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    status: {
+                        type: 'string',
+                        enum: ['in_progress', 'success', 'needs_attention', 'failed'],
+                        description: 'Current status of the refinement',
+                    },
+                    message: {
+                        type: 'string',
+                        description: 'Human-readable status message describing what was done or what needs attention',
+                    },
+                    fixes_applied: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'List of fixes applied so far',
+                    },
+                    remaining_issues: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'List of remaining issues that could not be auto-fixed',
+                    },
+                },
+                required: ['status', 'message'],
+            },
+        },
+    },
+];
+/**
+ * Create a tool executor function bound to a specific project context.
+ */
+export function createToolExecutor(ctx) {
+    const { outputDir, inputDir, onStatus } = ctx;
+    return async function executeTool(name, args) {
+        switch (name) {
+            case 'read_file': {
+                const filePath = join(outputDir, args.path);
+                try {
+                    const content = await readFile(filePath, 'utf-8');
+                    return content;
+                }
+                catch (err) {
+                    return `Error: File not found: ${args.path}`;
+                }
+            }
+            case 'write_file': {
+                const filePath = join(outputDir, args.path);
+                try {
+                    await writeFile(filePath, args.content, 'utf-8');
+                    onStatus?.(`  Wrote: ${args.path}`);
+                    return `Successfully wrote ${args.path}`;
+                }
+                catch (err) {
+                    return `Error writing file: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            }
+            case 'list_files': {
+                const dirPath = join(outputDir, args.path || '');
+                try {
+                    const entries = await readdir(dirPath, { withFileTypes: true });
+                    const listing = entries.map(e => `${e.isDirectory() ? '[dir] ' : ''}${e.name}`).join('\n');
+                    return listing || '(empty directory)';
+                }
+                catch (err) {
+                    return `Error listing directory: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            }
+            case 'run_build': {
+                onStatus?.('  Running vite build...');
+                try {
+                    const { stdout, stderr } = await execFileAsync('npx', ['vite', 'build'], {
+                        cwd: outputDir,
+                        timeout: 60_000,
+                        ...SHELL_OPTS,
+                    });
+                    return `BUILD SUCCESS\n\nstdout:\n${stdout}\n\nstderr:\n${stderr}`;
+                }
+                catch (err) {
+                    const errObj = err;
+                    return `BUILD FAILED\n\nstdout:\n${errObj.stdout || ''}\n\nstderr:\n${errObj.stderr || ''}\n\nmessage:\n${errObj.message || ''}`;
+                }
+            }
+            case 'run_typecheck': {
+                onStatus?.('  Running tsc --noEmit...');
+                try {
+                    const { stdout, stderr } = await execFileAsync('npx', ['tsc', '--noEmit'], {
+                        cwd: outputDir,
+                        timeout: 60_000,
+                        ...SHELL_OPTS,
+                    });
+                    return `TYPECHECK PASSED\n\n${stdout}\n${stderr}`;
+                }
+                catch (err) {
+                    const errObj = err;
+                    return `TYPECHECK ERRORS\n\n${errObj.stdout || ''}\n${errObj.stderr || ''}`;
+                }
+            }
+            case 'read_original_file': {
+                const filePath = join(inputDir, args.path);
+                try {
+                    const content = await readFile(filePath, 'utf-8');
+                    return content;
+                }
+                catch (err) {
+                    return `Error: Original file not found: ${args.path}`;
+                }
+            }
+            case 'take_screenshot': {
+                return await takeScreenshot(args.url, args.output_path, args.full_page ?? true);
+            }
+            case 'serve_and_screenshot': {
+                return await serveAndScreenshot(args.directory, args.output_path, args.full_page ?? true);
+            }
+            case 'report_status': {
+                const status = args.status;
+                const message = args.message;
+                const fixes = args.fixes_applied || [];
+                const remaining = args.remaining_issues || [];
+                let report = `[${status.toUpperCase()}] ${message}`;
+                if (fixes.length > 0) {
+                    report += `\n\nFixes applied:\n${fixes.map(f => `  - ${f}`).join('\n')}`;
+                }
+                if (remaining.length > 0) {
+                    report += `\n\nRemaining issues:\n${remaining.map(r => `  - ${r}`).join('\n')}`;
+                }
+                onStatus?.(report);
+                return 'Status reported.';
+            }
+            default:
+                return `Error: Unknown tool "${name}"`;
+        }
+    };
+}
+// ─── Screenshot Helpers ──────────────────────────────────────────────
+async function takeScreenshot(url, outputPath, fullPage = true) {
+    try {
+        // Dynamic import to avoid requiring playwright when not using screenshots
+        const { chromium } = await import('playwright');
+        const browser = await chromium.launch({ headless: true });
+        const context = await browser.newContext({ viewport: { width: 1440, height: 900 } });
+        const page = await context.newPage();
+        await page.goto(url, { waitUntil: 'networkidle', timeout: 15000 }).catch(() => { });
+        await page.waitForTimeout(2000);
+        await page.screenshot({ path: outputPath, fullPage });
+        await browser.close();
+        return `Screenshot saved to ${outputPath}`;
+    }
+    catch (err) {
+        return `Screenshot failed: ${err instanceof Error ? err.message : String(err)}`;
+    }
+}
+async function serveAndScreenshot(directory, outputPath, fullPage = true) {
+    const http = await import('http');
+    const fs = await import('fs');
+    const pathMod = await import('path');
+    const MIME_TYPES = {
+        '.html': 'text/html', '.css': 'text/css', '.js': 'application/javascript',
+        '.json': 'application/json', '.png': 'image/png', '.jpg': 'image/jpeg',
+        '.svg': 'image/svg+xml', '.ico': 'image/x-icon', '.woff2': 'font/woff2',
+    };
+    // Find a free port
+    const port = 3050 + Math.floor(Math.random() * 1000);
+    return new Promise((resolve) => {
+        const server = http.createServer((req, res) => {
+            let filePath = pathMod.join(directory, req.url === '/' ? 'index.html' : req.url);
+            if (!fs.existsSync(filePath)) {
+                filePath = pathMod.join(directory, 'index.html'); // SPA fallback
+            }
+            try {
+                const content = fs.readFileSync(filePath);
+                const ext = pathMod.extname(filePath);
+                res.writeHead(200, { 'Content-Type': MIME_TYPES[ext] || 'application/octet-stream' });
+                res.end(content);
+            }
+            catch {
+                res.writeHead(404);
+                res.end('Not found');
+            }
+        });
+        server.listen(port, async () => {
+            const result = await takeScreenshot(`http://localhost:${port}`, outputPath, fullPage);
+            server.close();
+            resolve(result);
+        });
+        server.on('error', () => {
+            resolve(`Error: Could not start server on port ${port}`);
+        });
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/ai/tools.js.map

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

package/dist/ai/visual-compare.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Visual Comparison Module — Uses Playwright to screenshot original and
+ * converted sites, then provides the comparison to the AI agent.
+ */
+import { type Server } from 'http';
+/**
+ * Serve a directory as a static HTTP server.
+ * Returns the server and the port it's listening on.
+ */
+export declare function serveDirectory(dir: string, port?: number): Promise<{
+    server: Server;
+    port: number;
+    url: string;
+}>;
+/**
+ * Take a screenshot of a URL using Playwright.
+ */
+export declare function screenshotUrl(url: string, outputPath: string, options?: {
+    fullPage?: boolean;
+    width?: number;
+    height?: number;
+    waitMs?: number;
+}): Promise<void>;
+/**
+ * Take screenshots of both the original and converted sites.
+ * Returns paths to the screenshot files.
+ */
+export declare function compareScreenshots(originalDir: string, convertedDistDir: string, outputDir?: string): Promise<{
+    originalPath: string;
+    convertedPath: string;
+}>;
+/**
+ * Build a textual description of the HTML structure for AI comparison.
+ * Since we can't send images to this API, we extract the DOM structure
+ * for text-based comparison.
+ */
+export declare function extractPageStructure(dir: string): Promise<string>;
+/**
+ * Compare the DOM structures of original and converted sites.
+ * Returns a text summary suitable for sending to the AI agent.
+ */
+export declare function buildVisualComparisonContext(originalDir: string, convertedDistDir: string): Promise<string>;
+//# sourceMappingURL=visual-compare.d.ts.map

package/dist/ai/visual-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-compare.d.ts","sourceRoot":"","sources":["../../src/ai/visual-compare.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAoBjD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAoCpH;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACrF,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,SAAS,GAAE,MAAe,GACzB,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAuB1D;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAkDjB;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAiBjB"}