erosolar-cli 1.7.193 → 1.7.195

package/dist/core/toolPreconditions.d.ts

@@ -1,41 +0,0 @@
-/**
- * Pre-flight validation patterns for AI flow design.
- * Catches common tool usage failures before execution and provides actionable guidance.
- */
-export interface PreflightWarning {
-    readonly code: string;
-    readonly message: string;
-    readonly severity: 'critical' | 'warning' | 'info';
-    readonly suggestion: string;
-}
-export declare const AI_FLOW_VALIDATION_PATTERNS: {
-    readonly EDIT_LONG_SINGLE_LINE: RegExp;
-    readonly EDIT_PLACEHOLDER_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp];
-    readonly EDIT_FUNCTION_SIGNATURE: RegExp;
-    readonly SEARCH_OVERLY_BROAD: readonly [RegExp, RegExp, RegExp, RegExp];
-    readonly GIT_REDUNDANT_STATUS: RegExp;
-    readonly GIT_INEFFICIENT_CHAIN: RegExp;
-    readonly NPM_INCOMPLETE_PUBLISH: RegExp;
-    readonly CONTEXT_REDUNDANT_SNAPSHOT: RegExp;
-    readonly VALIDATION_EARLY_RUN: RegExp;
-};
-/**
- * Validate tool preconditions before execution to prevent common AI flow failures.
- *
- * This function implements the critical AI flow design principle: validate before execute.
- * It catches common patterns that lead to tool failures and provides actionable guidance.
- *
- * @param toolName - Name of the tool being called
- * @param args - Tool arguments
- * @returns Array of pre-flight warnings (empty if all validations pass)
- */
-export declare function validateToolPreconditions(toolName: string, args: Record<string, unknown>): PreflightWarning[];
-/**
- * Enhanced AI flow validation for TypeScript software engineering
- * Provides comprehensive validation of AI tool usage patterns
- */
-export declare function validateAIFlowPatterns(toolName: string, args: Record<string, unknown>, toolHistory: readonly {
-    toolName: string;
-    args: Record<string, unknown>;
-}[]): PreflightWarning[];
-//# sourceMappingURL=toolPreconditions.d.ts.map

package/dist/core/toolPreconditions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"toolPreconditions.d.ts","sourceRoot":"","sources":["../../src/core/toolPreconditions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAGD,eAAO,MAAM,2BAA2B;;;;;;;;;;CA+B9B,CAAC;AAEX;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,gBAAgB,EAAE,CAsKpB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAAE,GAC1E,gBAAgB,EAAE,CA2FpB"}

package/dist/core/toolPreconditions.js

@@ -1,267 +0,0 @@
-// Enhanced AI flow validation patterns for TypeScript software engineering
-export const AI_FLOW_VALIDATION_PATTERNS = {
-    // Edit tool patterns
-    EDIT_LONG_SINGLE_LINE: /^[^\n]{50,}$/, // Long single line without newlines
-    EDIT_PLACEHOLDER_PATTERNS: [
-        /\.\.\./, // ... placeholder
-        /\[.*\]/, // [content] placeholder
-        /\/\/\s*\.\.\./, // // ... comment placeholder
-        /\/\*\s*\.\.\.\s*\*\//, // /* ... */ comment placeholder
-    ],
-    EDIT_FUNCTION_SIGNATURE: /^(function|class|const|let|var|export)\s+\w+\s*\([^)]*$/, // Unbalanced function signature
-    // Search patterns
-    SEARCH_OVERLY_BROAD: [
-        /^\*$/, // Single asterisk
-        /^\.$/, // Single dot
-        /^\*\*\/\*\*$/, // **/** pattern
-        /^\*\*\/\*$/, // **/* pattern
-    ],
-    // Git patterns
-    GIT_REDUNDANT_STATUS: /git\s+status/i,
-    GIT_INEFFICIENT_CHAIN: /git\s+(status|add|commit|push)/i,
-    // NPM patterns
-    NPM_INCOMPLETE_PUBLISH: /npm\s+publish/i,
-    // Context patterns
-    CONTEXT_REDUNDANT_SNAPSHOT: /context_snapshot/i,
-    // Validation patterns
-    VALIDATION_EARLY_RUN: /(run_repo_checks|run_tests|run_build)/i,
-};
-/**
- * Validate tool preconditions before execution to prevent common AI flow failures.
- *
- * This function implements the critical AI flow design principle: validate before execute.
- * It catches common patterns that lead to tool failures and provides actionable guidance.
- *
- * @param toolName - Name of the tool being called
- * @param args - Tool arguments
- * @returns Array of pre-flight warnings (empty if all validations pass)
- */
-export function validateToolPreconditions(toolName, args) {
-    const warnings = [];
-    const toolLower = toolName.toLowerCase();
-    // -------------------------------------------------------------------------
-    // Edit Tool Validation - Critical for AI software engineering flow
-    // -------------------------------------------------------------------------
-    if (toolLower === 'edit') {
-        const oldString = args['old_string'];
-        const newString = args['new_string'];
-        const filePath = args['file_path'];
-        if (!oldString) {
-            // Empty old_string = new file creation - validate path structure
-            if (filePath && !filePath.startsWith('/')) {
-                warnings.push({
-                    code: 'EDIT_RELATIVE_PATH',
-                    message: 'Edit file_path should be absolute path for new file creation',
-                    severity: 'warning',
-                    suggestion: 'Use absolute path starting with / for file creation',
-                });
-            }
-        }
-        else {
-            // PATTERN 1: Long single line without newlines - likely didn't read file
-            if (!oldString.includes('\n') && oldString.length > 50) {
-                warnings.push({
-                    code: 'EDIT_NO_CONTEXT',
-                    message: 'Long single line without newlines detected in old_string',
-                    severity: 'critical',
-                    suggestion: 'AI should use Read tool first to get exact text including whitespace. Copy multiple lines for uniqueness.',
-                });
-            }
-            // PATTERN 2: Placeholder patterns - AI is guessing content
-            const placeholderPatterns = ['...', '[content]', '// ...', '# ...', '/* ... */', '[code]', 'TODO'];
-            if (placeholderPatterns.some((p) => oldString.includes(p))) {
-                warnings.push({
-                    code: 'EDIT_PLACEHOLDER',
-                    message: 'Placeholder patterns detected in old_string',
-                    severity: 'critical',
-                    suggestion: 'AI is guessing instead of reading actual file. Use Read tool to get exact file content.',
-                });
-            }
-            // PATTERN 3: Indentation mismatch detection
-            if (oldString && newString) {
-                const oldLines = oldString.split('\n');
-                const newLines = newString.split('\n');
-                if (oldLines.length > 1 && newLines.length > 1) {
-                    const firstOldLine = oldLines[0] || '';
-                    const firstNewLine = newLines[0] || '';
-                    const oldIndent = firstOldLine.length - firstOldLine.trimStart().length;
-                    const newIndent = firstNewLine.length - firstNewLine.trimStart().length;
-                    if (oldIndent !== newIndent && oldIndent > 0) {
-                        warnings.push({
-                            code: 'EDIT_INDENT_MISMATCH',
-                            message: `old_string starts with ${oldIndent} spaces, new_string starts with ${newIndent}`,
-                            severity: 'warning',
-                            suggestion: 'Mismatched indentation often causes Edit to fail matching.',
-                        });
-                    }
-                }
-            }
-            // PATTERN 4: Tab vs space mismatch
-            if (oldString && newString) {
-                const oldHasTabs = oldString.includes('\t');
-                const newHasTabs = newString.includes('\t');
-                if (oldHasTabs && !newHasTabs) {
-                    warnings.push({
-                        code: 'EDIT_WHITESPACE_MISMATCH',
-                        message: 'old_string uses tabs, new_string uses spaces',
-                        severity: 'warning',
-                        suggestion: 'Whitespace type mismatch may cause Edit to fail.',
-                    });
-                }
-            }
-            // PATTERN 5: Function signature truncation
-            if (oldString.includes('function ') || oldString.includes('def ') || oldString.includes('fn ')) {
-                const openParens = (oldString.match(/\(/g) || []).length;
-                const closeParens = (oldString.match(/\)/g) || []).length;
-                if (openParens !== closeParens) {
-                    warnings.push({
-                        code: 'EDIT_TRUNCATED_SIGNATURE',
-                        message: 'Unbalanced parentheses in old_string - function signature may be truncated',
-                        severity: 'warning',
-                        suggestion: 'Use Read to get complete function signature.',
-                    });
-                }
-            }
-            // PATTERN 6: Very short old_string for complex replacement
-            if (oldString.length < 20 && newString && newString.length > 100) {
-                warnings.push({
-                    code: 'EDIT_SHORT_MATCH',
-                    message: 'old_string is very short but new_string is large',
-                    severity: 'warning',
-                    suggestion: 'Short matches may hit multiple locations. Use more context in old_string.',
-                });
-            }
-        }
-    }
-    // -------------------------------------------------------------------------
-    // Search Operations Validation
-    // -------------------------------------------------------------------------
-    if (toolLower === 'grep' || toolLower === 'glob' || toolLower.includes('search')) {
-        const pattern = args['pattern'];
-        const headLimit = args['head_limit'];
-        if (pattern) {
-            // Overly broad patterns
-            if (pattern === '.' || pattern === '*' || pattern === '**/*') {
-                warnings.push({
-                    code: 'SEARCH_BROAD_PATTERN',
-                    message: `Pattern '${pattern}' is too broad and may return thousands of files`,
-                    severity: 'critical',
-                    suggestion: "Use targeted patterns like '**/*.ts' or 'src/**/*.js' with head_limit parameter.",
-                });
-            }
-            // Missing head_limit on glob patterns
-            if (!headLimit && /[*?\[]/.test(pattern)) {
-                warnings.push({
-                    code: 'SEARCH_NO_LIMIT',
-                    message: `Pattern '${pattern}' may match many files without head_limit`,
-                    severity: 'info',
-                    suggestion: 'Consider adding head_limit parameter to prevent context overflow.',
-                });
-            }
-        }
-    }
-    // -------------------------------------------------------------------------
-    // Bash Command Efficiency
-    // -------------------------------------------------------------------------
-    if (toolLower === 'bash' || toolLower === 'execute_bash') {
-        const command = String(args['command'] || '').toLowerCase();
-        // Multiple git status calls in one command
-        if ((command.match(/git status/g) || []).length > 1) {
-            warnings.push({
-                code: 'GIT_REDUNDANT_STATUS',
-                message: "Multiple 'git status' calls detected",
-                severity: 'info',
-                suggestion: "Use single combined commands like 'git add -A && git commit -m msg && git push'.",
-            });
-        }
-        // NPM publish without full workflow
-        if (command.includes('npm publish')) {
-            if (!command.includes('npm version') && !command.includes('npm run build')) {
-                warnings.push({
-                    code: 'NPM_INCOMPLETE_WORKFLOW',
-                    message: 'npm publish without standard workflow steps',
-                    severity: 'warning',
-                    suggestion: "Use: 'npm version patch && npm run build && npm publish && git push'.",
-                });
-            }
-        }
-    }
-    return warnings;
-}
-/**
- * Enhanced AI flow validation for TypeScript software engineering
- * Provides comprehensive validation of AI tool usage patterns
- */
-export function validateAIFlowPatterns(toolName, args, toolHistory) {
-    const warnings = [];
-    const toolLower = toolName.toLowerCase();
-    // Pattern: Sequential file reads without parallel execution
-    if (toolLower === 'read' || toolLower === 'read_file') {
-        const currentFile = (args['file_path'] || args['path']);
-        // Get recent read operations (last 5 in history)
-        const recentReads = toolHistory
-            .slice(-5)
-            .filter((call) => {
-            const callLower = call.toolName.toLowerCase();
-            return callLower === 'read' || callLower === 'read_file';
-        });
-        // Trigger on 2nd sequential read (one prior read exists)
-        if (recentReads.length >= 1) {
-            const previousFiles = recentReads
-                .map((call) => (call.args['file_path'] || call.args['path']))
-                .filter(Boolean);
-            const allFiles = currentFile ? [...previousFiles, currentFile] : previousFiles;
-            const uniqueFiles = Array.from(new Set(allFiles));
-            if (uniqueFiles.length >= 2) {
-                const fileList = uniqueFiles.map(f => `  - ${f}`).join('\n');
-                warnings.push({
-                    code: 'SEQUENTIAL_READ_OPTIMIZATION',
-                    message: `Multiple sequential file reads detected - consider parallel execution`,
-                    severity: 'info',
-                    suggestion: `Use parallel tool calls for independent file reads to improve performance.\nFiles read sequentially:\n${fileList}`,
-                });
-            }
-        }
-    }
-    // Pattern: Edit without prior Read
-    if (toolLower === 'edit') {
-        const hasRecentRead = toolHistory.some((call) => (call.toolName.toLowerCase().includes('read') || call.toolName.toLowerCase().includes('read_file')) &&
-            call.args['path'] === args['file_path']);
-        if (!hasRecentRead) {
-            warnings.push({
-                code: 'EDIT_WITHOUT_READ',
-                message: 'Edit attempted without prior file read',
-                severity: 'critical',
-                suggestion: 'Always use Read tool first to get exact text including whitespace and indentation.',
-            });
-        }
-    }
-    // Pattern: Multiple validation runs
-    if (toolLower === 'run_repo_checks' || toolLower === 'run_tests' || toolLower === 'run_build') {
-        const recentValidations = toolHistory.filter((call) => call.toolName.toLowerCase().includes('run_') ||
-            call.toolName.toLowerCase().includes('test') ||
-            call.toolName.toLowerCase().includes('build'));
-        if (recentValidations.length > 0) {
-            warnings.push({
-                code: 'DEFERRED_VALIDATION_REMINDER',
-                message: 'Multiple validation runs detected - remember to run only once at the end',
-                severity: 'info',
-                suggestion: 'Complete ALL implementation work first, then run a SINGLE validation pass at the very end.',
-            });
-        }
-    }
-    // Pattern: Inefficient git operations
-    if (toolLower.includes('git')) {
-        const recentGitOps = toolHistory.filter((call) => call.toolName.toLowerCase().includes('git'));
-        if (recentGitOps.length >= 2) {
-            warnings.push({
-                code: 'GIT_EFFICIENCY_OPTIMIZATION',
-                message: 'Multiple git operations detected - consider combined commands',
-                severity: 'info',
-                suggestion: 'Use single combined commands like "git add -A && git commit -m msg && git push" instead of separate calls.',
-            });
-        }
-    }
-    return warnings;
-}
-//# sourceMappingURL=toolPreconditions.js.map

package/dist/core/toolPreconditions.js.map

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

package/dist/core/toolRuntime.d.ts

@@ -1,137 +0,0 @@
-import { type JSONSchemaObject, type ProviderId, type ProviderToolDefinition, type ToolCallRequest } from './types.js';
-import { ContextManager } from './contextManager.js';
-import { type PreflightWarning } from './toolPreconditions.js';
-/**
- * Execution context for tool operations with strict TypeScript typing
- */
-export interface ToolExecutionContext {
-    readonly profileName: string;
-    readonly provider: ProviderId;
-    readonly model: string;
-    readonly workspaceContext?: string | null;
-}
-/**
- * Type-safe tool observer with generic parameter inference for AI flow monitoring
- */
-export interface ToolRuntimeObserver<T extends Record<string, unknown> = Record<string, unknown>> {
-    /** Called when tool execution begins */
-    onToolStart?(call: ToolCallRequest & {
-        args: T;
-    }): void;
-    /** Called when tool execution completes successfully */
-    onToolResult?(call: ToolCallRequest & {
-        args: T;
-    }, output: string): void;
-    /** Called when tool execution fails */
-    onToolError?(call: ToolCallRequest & {
-        args: T;
-    }, error: string): void;
-    /** Called when cached result is used instead of execution */
-    onCacheHit?(call: ToolCallRequest & {
-        args: T;
-    }): void;
-    /** Called for progress updates during long-running operations */
-    onToolProgress?(call: ToolCallRequest & {
-        args: T;
-    }, progress: ToolProgressUpdate): void;
-    /** Called for pre-flight warnings before tool execution */
-    onToolWarning?(call: ToolCallRequest & {
-        args: T;
-    }, warning: PreflightWarning | string): void;
-}
-interface ToolRuntimeOptions {
-    readonly observer?: ToolRuntimeObserver;
-    readonly contextManager?: ContextManager;
-    readonly enableCache?: boolean;
-    readonly cacheTTLMs?: number;
-}
-/**
- * Generic tool handler with parameter type inference for AI flow execution
- */
-type ToolHandler<T extends Record<string, unknown> = Record<string, unknown>> = (args: T) => Promise<string> | string;
-/**
- * Enhanced tool definition with parameter type safety for AI software engineering
- */
-export interface ToolDefinition<T extends Record<string, unknown> = Record<string, unknown>> {
-    /** Unique identifier for the tool */
-    readonly name: string;
-    /** Human-readable description for AI understanding */
-    readonly description: string;
-    /** JSON Schema defining the tool's parameter structure */
-    readonly parameters?: JSONSchemaObject;
-    /** Function that implements the tool's behavior */
-    readonly handler: ToolHandler<T>;
-    /** Whether results can be cached for performance optimization */
-    readonly cacheable?: boolean;
-}
-/**
- * Collection of related tools grouped by functionality
- */
-export interface ToolSuite {
-    /** Unique identifier for the tool suite */
-    readonly id: string;
-    /** Human-readable description of the suite's purpose */
-    readonly description?: string;
-    /** Array of tool definitions in this suite */
-    readonly tools: readonly ToolDefinition[];
-}
-export interface ToolHistoryEntry {
-    toolName: string;
-    args: Record<string, unknown>;
-    timestamp: number;
-}
-export interface ToolProgressUpdate {
-    current: number;
-    total?: number;
-    message?: string;
-}
-/**
- * Type-safe utility functions for tool runtime operations
- */
-export declare namespace ToolRuntimeUtils {
-    /**
-     * Creates a type-safe tool definition with inferred parameter types
-     */
-    function createToolDefinition<T extends Record<string, unknown>>(definition: ToolDefinition<T>): ToolDefinition<T>;
-    /**
-     * Creates a type-safe tool suite with inferred tool types
-     */
-    function createToolSuite(suite: ToolSuite): ToolSuite;
-    /**
-     * Type guard to check if a tool definition matches expected parameter schema
-     */
-    function isToolDefinition(__tool: ToolDefinition, expectedSchema?: JSONSchemaObject): boolean;
-}
-export declare class ToolRuntime {
-    private readonly registry;
-    private readonly registrationOrder;
-    private readonly observer;
-    private readonly contextManager;
-    private readonly cache;
-    private readonly enableCache;
-    private readonly cacheTTLMs;
-    private readonly toolHistory;
-    private readonly maxHistorySize;
-    constructor(baseTools?: ToolDefinition[], options?: ToolRuntimeOptions);
-    registerSuite(suite: ToolSuite): void;
-    unregisterSuite(id: string): void;
-    listProviderTools(): ProviderToolDefinition[];
-    execute(call: ToolCallRequest, context?: {
-        profileName?: string;
-        provider?: string;
-        model?: string;
-    }): Promise<string>;
-    private getCacheKey;
-    clearCache(): void;
-    getCacheStats(): {
-        size: number;
-        entries: number;
-    };
-    clearToolHistory(): void;
-    getToolHistory(): readonly ToolHistoryEntry[];
-    private addTool;
-    private removeFromOrder;
-}
-export declare function createDefaultToolRuntime(context: ToolExecutionContext, toolSuites?: ToolSuite[], options?: ToolRuntimeOptions): ToolRuntime;
-export {};
-//# sourceMappingURL=toolRuntime.d.ts.map

package/dist/core/toolRuntime.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"toolRuntime.d.ts","sourceRoot":"","sources":["../../src/core/toolRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAqD,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAElH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9F,wCAAwC;IACxC,WAAW,CAAC,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAExD,wDAAwD;IACxD,YAAY,CAAC,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzE,uCAAuC;IACvC,WAAW,CAAC,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvE,6DAA6D;IAC7D,UAAU,CAAC,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAEvD,iEAAiE;IACjE,cAAc,CAAC,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEzF,2DAA2D;IAC3D,aAAa,CAAC,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAAC;CAC/F;AAED,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAC9E,IAAI,EAAE,CAAC,KACJ,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzF,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAEvC,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAEjC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,wDAAwD;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;CAC3C;AAYD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAeD;;GAEG;AACH,yBAAiB,gBAAgB,CAAC;IAChC;;OAEG;IACH,SAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,GAC5B,cAAc,CAAC,CAAC,CAAC,CAEnB;IAED;;OAEG;IACH,SAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,GACf,SAAS,CAEX;IAED;;OAEG;IACH,SAAgB,gBAAgB,CAC9B,MAAM,EAAE,cAAc,EACtB,cAAc,CAAC,EAAE,gBAAgB,GAChC,OAAO,CAIT;CACF;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAM;gBAEzB,SAAS,GAAE,cAAc,EAAO,EAAE,OAAO,GAAE,kBAAuB;IAc9E,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAUrC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAYjC,iBAAiB,IAAI,sBAAsB,EAAE;IAgBvC,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgI5H,OAAO,CAAC,WAAW;IAInB,UAAU,IAAI,IAAI;IAIlB,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAWlD,gBAAgB,IAAI,IAAI;IAIxB,cAAc,IAAI,SAAS,gBAAgB,EAAE;IAI7C,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,eAAe;CAMxB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,UAAU,GAAE,SAAS,EAAO,EAC5B,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAeb"}