attocode 0.2.3 → 0.2.5

package/dist/src/integrations/utilities/file-change-tracker.js

@@ -0,0 +1,538 @@
+/**
+ * File Change Tracker
+ *
+ * Tracks file changes for undo capability in agent sessions.
+ * Provides before/after content capture, diff generation, and undo functionality.
+ *
+ * @example
+ * ```typescript
+ * import Database from 'better-sqlite3';
+ * import { FileChangeTracker } from './file-change-tracker.js';
+ *
+ * const db = new Database('sessions.db');
+ * const tracker = new FileChangeTracker(db, 'session-123');
+ *
+ * // Record a file change
+ * const changeId = await tracker.recordChange({
+ *   filePath: '/path/to/file.ts',
+ *   operation: 'edit',
+ *   contentBefore: 'old content',
+ *   contentAfter: 'new content',
+ *   turnNumber: 1,
+ * });
+ *
+ * // Undo the change
+ * const result = await tracker.undoChange(changeId);
+ * ```
+ */
+import { writeFile, unlink } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+// =============================================================================
+// DIFF UTILITIES
+// =============================================================================
+/**
+ * Generate a simple unified diff between two strings.
+ * This is a basic implementation - for production, consider using a proper diff library.
+ */
+function generateUnifiedDiff(before, after, filePath) {
+    const beforeLines = before.split('\n');
+    const afterLines = after.split('\n');
+    const header = [
+        `--- a/${filePath}`,
+        `+++ b/${filePath}`,
+    ];
+    // Simple line-by-line diff (not optimal but functional)
+    const hunks = [];
+    let i = 0;
+    let j = 0;
+    while (i < beforeLines.length || j < afterLines.length) {
+        // Find next difference
+        const startI = i;
+        const startJ = j;
+        // Skip matching lines
+        while (i < beforeLines.length && j < afterLines.length && beforeLines[i] === afterLines[j]) {
+            i++;
+            j++;
+        }
+        // If we've found a difference or reached the end
+        if (i < beforeLines.length || j < afterLines.length) {
+            // Determine the hunk boundaries
+            const contextBefore = Math.max(0, i - 3);
+            const hunkStart = contextBefore + 1;
+            // Find the extent of the difference
+            const diffStartI = i;
+            const diffStartJ = j;
+            // Advance through differing lines
+            while (i < beforeLines.length || j < afterLines.length) {
+                if (i < beforeLines.length && j < afterLines.length && beforeLines[i] === afterLines[j]) {
+                    // Found a match - check if it's the end of the diff section
+                    let matchCount = 0;
+                    let tempI = i;
+                    let tempJ = j;
+                    while (tempI < beforeLines.length && tempJ < afterLines.length &&
+                        beforeLines[tempI] === afterLines[tempJ] && matchCount < 3) {
+                        matchCount++;
+                        tempI++;
+                        tempJ++;
+                    }
+                    if (matchCount >= 3) {
+                        break;
+                    }
+                }
+                if (i < beforeLines.length)
+                    i++;
+                if (j < afterLines.length)
+                    j++;
+            }
+            // Build the hunk
+            const hunkLines = [];
+            const beforeCount = i - contextBefore;
+            const afterCount = j - (startJ + (contextBefore - startI));
+            hunkLines.push(`@@ -${hunkStart},${beforeCount} +${hunkStart},${afterCount} @@`);
+            // Add context before
+            for (let k = contextBefore; k < diffStartI; k++) {
+                hunkLines.push(` ${beforeLines[k]}`);
+            }
+            // Add removed lines
+            for (let k = diffStartI; k < i; k++) {
+                if (k < beforeLines.length) {
+                    hunkLines.push(`-${beforeLines[k]}`);
+                }
+            }
+            // Add added lines
+            for (let k = diffStartJ; k < j; k++) {
+                if (k < afterLines.length) {
+                    hunkLines.push(`+${afterLines[k]}`);
+                }
+            }
+            hunks.push(hunkLines.join('\n'));
+        }
+    }
+    return [...header, ...hunks].join('\n');
+}
+/**
+ * Apply a unified diff to restore original content.
+ * Returns the original content before the diff was applied.
+ */
+function applyReverseDiff(currentContent, diff) {
+    // Parse diff hunks
+    const lines = diff.split('\n');
+    const resultLines = currentContent.split('\n');
+    let lineIndex = 0;
+    let i = 0;
+    // Skip header lines
+    while (i < lines.length && !lines[i].startsWith('@@')) {
+        i++;
+    }
+    while (i < lines.length) {
+        const line = lines[i];
+        if (line.startsWith('@@')) {
+            // Parse hunk header: @@ -start,count +start,count @@
+            const match = line.match(/@@ -(\d+),?\d* \+(\d+),?\d* @@/);
+            if (match) {
+                lineIndex = parseInt(match[2], 10) - 1;
+            }
+            i++;
+            continue;
+        }
+        if (line.startsWith('+')) {
+            // This was an addition - remove it to reverse
+            if (lineIndex < resultLines.length && resultLines[lineIndex] === line.slice(1)) {
+                resultLines.splice(lineIndex, 1);
+            }
+            i++;
+            continue;
+        }
+        if (line.startsWith('-')) {
+            // This was a removal - add it back to reverse
+            resultLines.splice(lineIndex, 0, line.slice(1));
+            lineIndex++;
+            i++;
+            continue;
+        }
+        if (line.startsWith(' ')) {
+            // Context line
+            lineIndex++;
+            i++;
+            continue;
+        }
+        i++;
+    }
+    return resultLines.join('\n');
+}
+// =============================================================================
+// FILE CHANGE TRACKER
+// =============================================================================
+/**
+ * Tracks file changes for undo capability.
+ */
+export class FileChangeTracker {
+    db;
+    sessionId;
+    config;
+    stmts;
+    constructor(db, sessionId, config) {
+        this.db = db;
+        this.sessionId = sessionId;
+        this.config = {
+            enabled: config?.enabled ?? true,
+            maxFullContentBytes: config?.maxFullContentBytes ?? 50 * 1024, // 50KB
+        };
+        this.prepareStatements();
+    }
+    /**
+     * Prepare SQL statements for reuse.
+     */
+    prepareStatements() {
+        this.stmts = {
+            insertChange: this.db.prepare(`
+        INSERT INTO file_changes (
+          session_id, entry_id, tool_call_id, turn_number, file_path,
+          operation, content_before, content_after, diff_unified,
+          storage_mode, bytes_before, bytes_after, is_undone,
+          undo_change_id, created_at
+        )
+        VALUES (
+          @sessionId, @entryId, @toolCallId, @turnNumber, @filePath,
+          @operation, @contentBefore, @contentAfter, @diffUnified,
+          @storageMode, @bytesBefore, @bytesAfter, @isUndone,
+          @undoChangeId, @createdAt
+        )
+      `),
+            getChange: this.db.prepare(`
+        SELECT
+          id, session_id as sessionId, turn_number as turnNumber,
+          file_path as filePath, operation, content_before as contentBefore,
+          content_after as contentAfter, diff_unified as diffUnified,
+          storage_mode as storageMode, bytes_before as bytesBefore,
+          bytes_after as bytesAfter, is_undone as isUndone,
+          undo_change_id as undoChangeId, tool_call_id as toolCallId,
+          created_at as createdAt
+        FROM file_changes
+        WHERE id = ? AND session_id = ?
+      `),
+            getChanges: this.db.prepare(`
+        SELECT
+          id, session_id as sessionId, turn_number as turnNumber,
+          file_path as filePath, operation, content_before as contentBefore,
+          content_after as contentAfter, diff_unified as diffUnified,
+          storage_mode as storageMode, bytes_before as bytesBefore,
+          bytes_after as bytesAfter, is_undone as isUndone,
+          undo_change_id as undoChangeId, tool_call_id as toolCallId,
+          created_at as createdAt
+        FROM file_changes
+        WHERE session_id = ?
+        ORDER BY id ASC
+      `),
+            getFileChanges: this.db.prepare(`
+        SELECT
+          id, session_id as sessionId, turn_number as turnNumber,
+          file_path as filePath, operation, content_before as contentBefore,
+          content_after as contentAfter, diff_unified as diffUnified,
+          storage_mode as storageMode, bytes_before as bytesBefore,
+          bytes_after as bytesAfter, is_undone as isUndone,
+          undo_change_id as undoChangeId, tool_call_id as toolCallId,
+          created_at as createdAt
+        FROM file_changes
+        WHERE session_id = ? AND file_path = ?
+        ORDER BY id ASC
+      `),
+            getLastFileChange: this.db.prepare(`
+        SELECT
+          id, session_id as sessionId, turn_number as turnNumber,
+          file_path as filePath, operation, content_before as contentBefore,
+          content_after as contentAfter, diff_unified as diffUnified,
+          storage_mode as storageMode, bytes_before as bytesBefore,
+          bytes_after as bytesAfter, is_undone as isUndone,
+          undo_change_id as undoChangeId, tool_call_id as toolCallId,
+          created_at as createdAt
+        FROM file_changes
+        WHERE session_id = ? AND file_path = ? AND is_undone = 0
+        ORDER BY id DESC
+        LIMIT 1
+      `),
+            getTurnChanges: this.db.prepare(`
+        SELECT
+          id, session_id as sessionId, turn_number as turnNumber,
+          file_path as filePath, operation, content_before as contentBefore,
+          content_after as contentAfter, diff_unified as diffUnified,
+          storage_mode as storageMode, bytes_before as bytesBefore,
+          bytes_after as bytesAfter, is_undone as isUndone,
+          undo_change_id as undoChangeId, tool_call_id as toolCallId,
+          created_at as createdAt
+        FROM file_changes
+        WHERE session_id = ? AND turn_number = ? AND is_undone = 0
+        ORDER BY id DESC
+      `),
+            markUndone: this.db.prepare(`
+        UPDATE file_changes
+        SET is_undone = 1, undo_change_id = ?
+        WHERE id = ? AND session_id = ? AND is_undone = 0
+      `),
+            clearUndone: this.db.prepare(`
+        UPDATE file_changes
+        SET is_undone = 0, undo_change_id = NULL
+        WHERE id = ? AND session_id = ?
+      `),
+            getSessionSummary: this.db.prepare(`
+        SELECT
+          COUNT(*) as totalChanges,
+          SUM(CASE WHEN is_undone = 0 THEN 1 ELSE 0 END) as activeChanges,
+          SUM(CASE WHEN is_undone = 1 THEN 1 ELSE 0 END) as undoneChanges,
+          SUM(CASE WHEN operation = 'create' AND is_undone = 0 THEN 1 ELSE 0 END) as createCount,
+          SUM(CASE WHEN operation = 'write' AND is_undone = 0 THEN 1 ELSE 0 END) as writeCount,
+          SUM(CASE WHEN operation = 'edit' AND is_undone = 0 THEN 1 ELSE 0 END) as editCount,
+          SUM(CASE WHEN operation = 'delete' AND is_undone = 0 THEN 1 ELSE 0 END) as deleteCount
+        FROM file_changes
+        WHERE session_id = ?
+      `),
+        };
+    }
+    /**
+     * Record a file change.
+     */
+    async recordChange(params) {
+        if (!this.config.enabled) {
+            return -1;
+        }
+        const now = new Date().toISOString();
+        const contentBefore = params.contentBefore ?? null;
+        const contentAfter = params.contentAfter ?? null;
+        const bytesBefore = contentBefore ? Buffer.byteLength(contentBefore, 'utf-8') : 0;
+        const bytesAfter = contentAfter ? Buffer.byteLength(contentAfter, 'utf-8') : 0;
+        // Determine storage mode
+        let storageMode = 'full';
+        let diffUnified = null;
+        let storedBefore = contentBefore;
+        let storedAfter = contentAfter;
+        // Use diff mode for large files
+        const totalBytes = bytesBefore + bytesAfter;
+        if (totalBytes > this.config.maxFullContentBytes && contentBefore && contentAfter) {
+            storageMode = 'diff';
+            diffUnified = generateUnifiedDiff(contentBefore, contentAfter, params.filePath);
+            // In diff mode, we only store the after content (current state) and the diff
+            // to reconstruct the before content
+            storedBefore = null;
+            storedAfter = contentAfter;
+        }
+        const result = this.stmts.insertChange.run({
+            sessionId: this.sessionId,
+            entryId: null,
+            toolCallId: params.toolCallId ?? null,
+            turnNumber: params.turnNumber,
+            filePath: params.filePath,
+            operation: params.operation,
+            contentBefore: storedBefore,
+            contentAfter: storedAfter,
+            diffUnified,
+            storageMode,
+            bytesBefore,
+            bytesAfter,
+            isUndone: 0,
+            undoChangeId: null,
+            createdAt: now,
+        });
+        return result.lastInsertRowid;
+    }
+    /**
+     * Undo a specific change by ID.
+     * Uses a transaction with optimistic locking to prevent TOCTOU race conditions.
+     */
+    async undoChange(changeId) {
+        // Use database transaction with optimistic locking to prevent race condition
+        // The key insight: we mark as undone BEFORE file operations, inside a transaction
+        // If two calls race, only one will succeed in updating is_undone from 0 to 1
+        const txResult = this.db.transaction(() => {
+            const row = this.stmts.getChange.get(changeId, this.sessionId);
+            if (!row) {
+                return { success: false, error: 'Change not found' };
+            }
+            if (row.isUndone) {
+                return { success: false, error: 'Change already undone' };
+            }
+            // Optimistic lock: mark as undone BEFORE file operations
+            // The WHERE clause includes is_undone = 0, so only one concurrent call succeeds
+            const result = this.stmts.markUndone.run(null, changeId, this.sessionId);
+            if (result.changes === 0) {
+                return { success: false, error: 'Concurrent modification detected' };
+            }
+            return { success: true, row };
+        })();
+        if (!txResult.success || !txResult.row) {
+            return {
+                success: false,
+                filePath: '',
+                message: txResult.error || 'Transaction failed',
+            };
+        }
+        const row = txResult.row;
+        const filePath = row.filePath;
+        try {
+            // Determine what content to restore
+            let contentToRestore = null;
+            if (row.storageMode === 'full') {
+                contentToRestore = row.contentBefore;
+            }
+            else if (row.storageMode === 'diff' && row.diffUnified && row.contentAfter) {
+                // Reconstruct the before content from the diff
+                contentToRestore = applyReverseDiff(row.contentAfter, row.diffUnified);
+            }
+            // Perform the undo based on operation type
+            switch (row.operation) {
+                case 'create':
+                    // Undo create = delete the file
+                    if (existsSync(filePath)) {
+                        await unlink(filePath);
+                    }
+                    break;
+                case 'write':
+                case 'edit':
+                    // Undo write/edit = restore previous content
+                    if (contentToRestore !== null) {
+                        await writeFile(filePath, contentToRestore, 'utf-8');
+                    }
+                    else if (row.operation === 'write') {
+                        // If no previous content for a write, delete the file
+                        if (existsSync(filePath)) {
+                            await unlink(filePath);
+                        }
+                    }
+                    break;
+                case 'delete':
+                    // Undo delete = recreate the file with original content
+                    if (contentToRestore !== null) {
+                        await writeFile(filePath, contentToRestore, 'utf-8');
+                    }
+                    break;
+            }
+            return {
+                success: true,
+                filePath,
+                message: `Successfully undid ${row.operation} on ${filePath}`,
+                changeId,
+            };
+        }
+        catch (error) {
+            // File operations failed - rollback the database change
+            this.stmts.clearUndone.run(changeId, this.sessionId);
+            return {
+                success: false,
+                filePath,
+                message: `Failed to undo change: ${error instanceof Error ? error.message : String(error)}`,
+                changeId,
+            };
+        }
+    }
+    /**
+     * Undo the last change to a specific file.
+     */
+    async undoLastChange(filePath) {
+        const row = this.stmts.getLastFileChange.get(this.sessionId, filePath);
+        if (!row) {
+            return {
+                success: false,
+                filePath,
+                message: `No undoable changes found for ${filePath}`,
+            };
+        }
+        return this.undoChange(row.id);
+    }
+    /**
+     * Undo all changes in a turn.
+     */
+    async undoTurn(turnNumber) {
+        const rows = this.stmts.getTurnChanges.all(this.sessionId, turnNumber);
+        const results = [];
+        // Undo in reverse order (last change first)
+        for (const row of rows) {
+            const result = await this.undoChange(row.id);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Get all changes for a file.
+     */
+    getFileHistory(filePath) {
+        const rows = this.stmts.getFileChanges.all(this.sessionId, filePath);
+        return rows.map(row => ({
+            id: row.id,
+            sessionId: row.sessionId,
+            turnNumber: row.turnNumber,
+            filePath: row.filePath,
+            operation: row.operation,
+            contentBefore: row.contentBefore,
+            contentAfter: row.contentAfter,
+            diffUnified: row.diffUnified,
+            storageMode: row.storageMode,
+            bytesBefore: row.bytesBefore,
+            bytesAfter: row.bytesAfter,
+            isUndone: row.isUndone === 1,
+            undoChangeId: row.undoChangeId,
+            toolCallId: row.toolCallId,
+            createdAt: row.createdAt,
+        }));
+    }
+    /**
+     * Get all changes in session.
+     */
+    getChanges(options) {
+        if (options?.filePath) {
+            return this.getFileHistory(options.filePath);
+        }
+        const rows = this.stmts.getChanges.all(this.sessionId);
+        return rows.map(row => ({
+            id: row.id,
+            sessionId: row.sessionId,
+            turnNumber: row.turnNumber,
+            filePath: row.filePath,
+            operation: row.operation,
+            contentBefore: row.contentBefore,
+            contentAfter: row.contentAfter,
+            diffUnified: row.diffUnified,
+            storageMode: row.storageMode,
+            bytesBefore: row.bytesBefore,
+            bytesAfter: row.bytesAfter,
+            isUndone: row.isUndone === 1,
+            undoChangeId: row.undoChangeId,
+            toolCallId: row.toolCallId,
+            createdAt: row.createdAt,
+        }));
+    }
+    /**
+     * Get session change summary.
+     */
+    getSessionChangeSummary() {
+        const row = this.stmts.getSessionSummary.get(this.sessionId);
+        // Get unique file paths from active changes
+        const changes = this.getChanges();
+        const activeFiles = new Set();
+        for (const change of changes) {
+            if (!change.isUndone) {
+                activeFiles.add(change.filePath);
+            }
+        }
+        return {
+            totalChanges: row.totalChanges || 0,
+            activeChanges: row.activeChanges || 0,
+            undoneChanges: row.undoneChanges || 0,
+            filesModified: Array.from(activeFiles),
+            byOperation: {
+                create: row.createCount || 0,
+                write: row.writeCount || 0,
+                edit: row.editCount || 0,
+                delete: row.deleteCount || 0,
+            },
+        };
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+/**
+ * Create a FileChangeTracker instance.
+ */
+export function createFileChangeTracker(db, sessionId, config) {
+    return new FileChangeTracker(db, sessionId, config);
+}
+//# sourceMappingURL=file-change-tracker.js.map

package/dist/src/integrations/utilities/file-change-tracker.js.map

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

package/dist/src/integrations/utilities/graph-visualization.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Dependency Graph Visualization
+ *
+ * Generates visual representations of codebase dependency graphs.
+ * Supports multiple output formats:
+ * - Mermaid: Markdown-compatible diagrams (renders in GitHub, VS Code, etc.)
+ * - DOT: GraphViz format for advanced visualization
+ * - ASCII: Terminal-friendly text diagrams
+ *
+ * @example
+ * ```typescript
+ * const repoMap = await codebaseContext.analyze();
+ * const diagram = generateDependencyDiagram(repoMap.dependencyGraph, {
+ *   format: 'mermaid',
+ *   maxNodes: 20,
+ *   direction: 'LR',
+ * });
+ * console.log(diagram);
+ * ```
+ */
+export type FileDependencyGraph = Map<string, Set<string>>;
+export type DiagramFormat = 'mermaid' | 'dot' | 'ascii';
+export type DiagramDirection = 'TD' | 'LR' | 'BT' | 'RL';
+export interface GraphVisualizationOptions {
+    /** Output format */
+    format: DiagramFormat;
+    /** Maximum number of nodes to include (prevents huge diagrams) */
+    maxNodes?: number;
+    /** Graph direction: TD (top-down), LR (left-right), BT (bottom-top), RL (right-left) */
+    direction?: DiagramDirection;
+    /** Include external dependencies (node_modules, etc.) */
+    includeExternal?: boolean;
+    /** Group files by directory */
+    groupByDirectory?: boolean;
+    /** Only show files matching these patterns */
+    filterPatterns?: string[];
+    /** Highlight these files (shown with different style) */
+    highlightFiles?: string[];
+    /** Title for the diagram */
+    title?: string;
+}
+export interface DiagramResult {
+    /** The generated diagram content */
+    content: string;
+    /** Number of nodes in the diagram */
+    nodeCount: number;
+    /** Number of edges in the diagram */
+    edgeCount: number;
+    /** Files that were excluded due to limits */
+    excludedFiles: string[];
+}
+/**
+ * Generate a visual diagram of a dependency graph.
+ */
+export declare function generateDependencyDiagram(graph: FileDependencyGraph, options?: Partial<GraphVisualizationOptions>): DiagramResult;
+/**
+ * Generate a focused diagram showing a file and its immediate dependencies.
+ */
+export declare function generateFocusedDiagram(graph: FileDependencyGraph, centerFile: string, options?: Partial<GraphVisualizationOptions>): DiagramResult;
+/**
+ * Generate a diagram showing the reverse dependencies (what depends on this file).
+ */
+export declare function generateReverseDiagram(reverseFileDependencyGraph: FileDependencyGraph, targetFile: string, options?: Partial<GraphVisualizationOptions>): DiagramResult;
+/**
+ * Create a configured diagram generator.
+ */
+export declare function createGraphVisualizer(defaultOptions?: Partial<GraphVisualizationOptions>): {
+    generate: (graph: FileDependencyGraph, options?: Partial<GraphVisualizationOptions>) => DiagramResult;
+    focused: (graph: FileDependencyGraph, centerFile: string, options?: Partial<GraphVisualizationOptions>) => DiagramResult;
+    reverse: (graph: FileDependencyGraph, targetFile: string, options?: Partial<GraphVisualizationOptions>) => DiagramResult;
+};
+//# sourceMappingURL=graph-visualization.d.ts.map

package/dist/src/integrations/utilities/graph-visualization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-visualization.d.ts","sourceRoot":"","sources":["../../../../src/integrations/utilities/graph-visualization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,MAAM,MAAM,mBAAmB,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;AACxD,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,oBAAoB;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,yDAAyD;IACzD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+BAA+B;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAMD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE,OAAO,CAAC,yBAAyB,CAAM,GAC/C,aAAa,CAsBf;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,EAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAO,CAAC,yBAAyB,CAAM,GAC/C,aAAa,CASf;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,0BAA0B,EAAE,mBAAmB,EAC/C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAO,CAAC,yBAAyB,CAAM,GAC/C,aAAa,CAQf;AAkXD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,GAAE,OAAO,CAAC,yBAAyB,CAAM;sBAGnC,mBAAmB,YAAY,OAAO,CAAC,yBAAyB,CAAC;qBAGlE,mBAAmB,cAAc,MAAM,YAAY,OAAO,CAAC,yBAAyB,CAAC;qBAGrF,mBAAmB,cAAc,MAAM,YAAY,OAAO,CAAC,yBAAyB,CAAC;EAGzG"}