erosolar-cli 1.7.392 → 1.7.394

package/dist/core/types.d.ts

@@ -0,0 +1,306 @@
+/**
+ * AI Provider identifier for multi-provider support
+ */
+export type ProviderId = string;
+/**
+ * Reasoning effort levels for AI model optimization
+ */
+export type ReasoningEffortLevel = 'low' | 'medium' | 'high';
+/**
+ * Text verbosity levels for output control
+ */
+export type TextVerbosityLevel = 'low' | 'medium' | 'high';
+/**
+ * Conversation roles in AI message flow
+ */
+export type ConversationRole = 'system' | 'user' | 'assistant' | 'tool';
+export interface SystemMessage {
+    role: 'system';
+    content: string;
+}
+export interface UserMessage {
+    role: 'user';
+    content: string;
+}
+export interface ToolCallArguments {
+    [key: string]: unknown;
+}
+export interface ToolCallRequest {
+    id: string;
+    name: string;
+    arguments: ToolCallArguments;
+}
+export interface AssistantMessage {
+    role: 'assistant';
+    content: string;
+    toolCalls?: ToolCallRequest[];
+}
+export interface ToolMessage {
+    role: 'tool';
+    name: string;
+    content: string;
+    toolCallId: string;
+}
+/**
+ * Enhanced discriminated union for type-safe tool responses
+ * Provides comprehensive error handling and metadata tracking
+ */
+export interface ToolSuccessResponse {
+    readonly type: 'success';
+    readonly content: string;
+    readonly metadata?: {
+        readonly linesRead?: number;
+        readonly fileSize?: number;
+        readonly executionTime?: number;
+        readonly cacheHit?: boolean;
+        readonly toolName?: string;
+        readonly timestamp?: number;
+    };
+}
+/**
+ * Structured error response with recovery guidance
+ */
+export interface ToolErrorResponse {
+    readonly type: 'error';
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+        readonly details?: Readonly<Record<string, unknown>>;
+        readonly suggestion?: string;
+        readonly recoverable: boolean;
+        readonly toolName?: string;
+    };
+}
+/**
+ * Warning response with actionable suggestions
+ */
+export interface ToolWarningResponse {
+    readonly type: 'warning';
+    readonly content: string;
+    readonly warnings: ReadonlyArray<{
+        readonly code: string;
+        readonly message: string;
+        readonly severity: 'critical' | 'warning' | 'info';
+        readonly suggestion: string;
+    }>;
+}
+/**
+ * Progress update for long-running operations
+ */
+export interface ToolProgressResponse {
+    readonly type: 'progress';
+    readonly progress: number;
+    readonly message: string;
+    readonly metadata?: {
+        readonly estimatedRemaining?: number;
+        readonly currentStep?: string;
+    };
+}
+/**
+ * Comprehensive tool response union for AI flow control
+ */
+export type ToolResponse = ToolSuccessResponse | ToolErrorResponse | ToolWarningResponse | ToolProgressResponse;
+/**
+ * Type guard for successful tool responses
+ */
+export declare function isToolSuccess(response: ToolResponse): response is ToolSuccessResponse;
+/**
+ * Type guard for error tool responses
+ */
+export declare function isToolError(response: ToolResponse): response is ToolErrorResponse;
+/**
+ * Type guard for warning tool responses
+ */
+export declare function isToolWarning(response: ToolResponse): response is ToolWarningResponse;
+/**
+ * Type guard for progress tool responses
+ */
+export declare function isToolProgress(response: ToolResponse): response is ToolProgressResponse;
+export type ConversationMessage = SystemMessage | UserMessage | AssistantMessage | ToolMessage;
+/**
+ * Base interface for all JSON Schema property definitions
+ */
+export interface JSONSchemaPropertyBase {
+    readonly description?: string;
+    readonly nullable?: boolean;
+    readonly deprecated?: boolean;
+    readonly readOnly?: boolean;
+    readonly writeOnly?: boolean;
+}
+/**
+ * String schema with validation constraints
+ */
+export interface JSONSchemaString extends JSONSchemaPropertyBase {
+    readonly type: 'string';
+    readonly enum?: ReadonlyArray<string>;
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly pattern?: string;
+    readonly format?: 'date-time' | 'email' | 'uri' | 'uuid' | 'hostname';
+    readonly default?: string;
+}
+/**
+ * Number schema with validation constraints
+ */
+export interface JSONSchemaNumber extends JSONSchemaPropertyBase {
+    readonly type: 'number';
+    readonly minimum?: number;
+    readonly maximum?: number;
+    readonly exclusiveMinimum?: number;
+    readonly exclusiveMaximum?: number;
+    readonly multipleOf?: number;
+    readonly default?: number;
+}
+/**
+ * Boolean schema
+ */
+export interface JSONSchemaBoolean extends JSONSchemaPropertyBase {
+    readonly type: 'boolean';
+    readonly default?: boolean;
+}
+/**
+ * Array schema with item validation
+ */
+export interface JSONSchemaArray extends JSONSchemaPropertyBase {
+    readonly type: 'array';
+    readonly items: JSONSchemaProperty;
+    readonly minItems?: number;
+    readonly maxItems?: number;
+    readonly uniqueItems?: boolean;
+}
+/**
+ * Union type for all JSON Schema property types
+ */
+export type JSONSchemaProperty = JSONSchemaString | JSONSchemaNumber | JSONSchemaBoolean | JSONSchemaArray | JSONSchemaObject;
+/**
+ * Object schema with property validation
+ */
+export interface JSONSchemaObject extends JSONSchemaPropertyBase {
+    readonly type: 'object';
+    readonly properties?: Readonly<Record<string, JSONSchemaProperty>>;
+    readonly required?: ReadonlyArray<string>;
+    readonly additionalProperties?: boolean;
+    readonly minProperties?: number;
+    readonly maxProperties?: number;
+}
+/**
+ * Definition of a tool available to AI providers
+ */
+export interface ProviderToolDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters?: JSONSchemaObject;
+}
+/**
+ * Token usage statistics from AI provider
+ */
+export interface ProviderUsage {
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly totalTokens?: number;
+}
+/**
+ * Why the model stopped generating - critical for agentic loop control
+ */
+export type StopReason = 'end_turn' | 'tool_use' | 'max_tokens' | 'stop_sequence';
+/**
+ * Base interface for all provider responses
+ */
+export interface ProviderResponseBase {
+    readonly usage?: ProviderUsage | null;
+    /** Why the model stopped - determines if auto-continuation is needed */
+    readonly stopReason?: StopReason;
+}
+/**
+ * Discriminated union for provider responses
+ */
+export type ProviderResponse = (ProviderResponseBase & {
+    readonly type: 'message';
+    readonly content: string;
+}) | (ProviderResponseBase & {
+    readonly type: 'tool_calls';
+    readonly toolCalls: ToolCallRequest[];
+    readonly content?: string;
+});
+/**
+ * Streaming chunk for real-time AI responses
+ */
+export interface StreamChunk {
+    readonly type: 'content' | 'tool_call' | 'usage' | 'done';
+    readonly content?: string;
+    readonly toolCall?: ToolCallRequest;
+    readonly usage?: ProviderUsage;
+    /** Stop reason from the final message - included with 'done' chunk */
+    readonly stopReason?: StopReason;
+}
+/**
+ * AI Provider interface for multi-provider support
+ */
+export interface LLMProvider {
+    readonly id: ProviderId;
+    readonly model: string;
+    generate(messages: ConversationMessage[], tools: ProviderToolDefinition[]): Promise<ProviderResponse>;
+    generateStream?(messages: ConversationMessage[], tools: ProviderToolDefinition[]): AsyncIterableIterator<StreamChunk>;
+    getCapabilities?(): ProviderCapabilities;
+}
+/**
+ * Capabilities of an AI provider
+ */
+export interface ProviderCapabilities {
+    readonly streaming: boolean;
+    readonly toolCalling: boolean;
+    readonly vision: boolean;
+    readonly functionCalling: boolean;
+    readonly maxTokens: number;
+    readonly supportedModalities: ReadonlyArray<'text' | 'image' | 'audio'>;
+}
+/**
+ * Type-safe Result pattern for error handling
+ * Eliminates the need for try-catch blocks and provides compile-time safety
+ */
+export type Result<T, E = Error> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: E;
+};
+/**
+ * Type guard for successful Result
+ */
+export declare function isOk<T, E>(result: Result<T, E>): result is {
+    readonly ok: true;
+    readonly value: T;
+};
+/**
+ * Type guard for failed Result
+ */
+export declare function isErr<T, E>(result: Result<T, E>): result is {
+    readonly ok: false;
+    readonly error: E;
+};
+/**
+ * Creates a successful Result
+ */
+export declare function ok<T>(value: T): Result<T, never>;
+/**
+ * Creates a failed Result
+ */
+export declare function err<E>(error: E): Result<never, E>;
+/**
+ * Unwraps a Result, throwing if it's an error
+ */
+export declare function unwrap<T, E>(result: Result<T, E>): T;
+/**
+ * Unwraps a Result, returning a default value if it's an error
+ */
+export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+/**
+ * Maps a successful Result to a new value
+ */
+export declare function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E>;
+/**
+ * Maps an error Result to a new error
+ */
+export declare function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/types.js

@@ -0,0 +1,76 @@
+/**
+ * Type guard for successful tool responses
+ */
+export function isToolSuccess(response) {
+    return response.type === 'success';
+}
+/**
+ * Type guard for error tool responses
+ */
+export function isToolError(response) {
+    return response.type === 'error';
+}
+/**
+ * Type guard for warning tool responses
+ */
+export function isToolWarning(response) {
+    return response.type === 'warning';
+}
+/**
+ * Type guard for progress tool responses
+ */
+export function isToolProgress(response) {
+    return response.type === 'progress';
+}
+/**
+ * Type guard for successful Result
+ */
+export function isOk(result) {
+    return result.ok;
+}
+/**
+ * Type guard for failed Result
+ */
+export function isErr(result) {
+    return !result.ok;
+}
+/**
+ * Creates a successful Result
+ */
+export function ok(value) {
+    return { ok: true, value };
+}
+/**
+ * Creates a failed Result
+ */
+export function err(error) {
+    return { ok: false, error };
+}
+/**
+ * Unwraps a Result, throwing if it's an error
+ */
+export function unwrap(result) {
+    if (result.ok) {
+        return result.value;
+    }
+    throw result.error;
+}
+/**
+ * Unwraps a Result, returning a default value if it's an error
+ */
+export function unwrapOr(result, defaultValue) {
+    return result.ok ? result.value : defaultValue;
+}
+/**
+ * Maps a successful Result to a new value
+ */
+export function map(result, fn) {
+    return result.ok ? { ok: true, value: fn(result.value) } : result;
+}
+/**
+ * Maps an error Result to a new error
+ */
+export function mapErr(result, fn) {
+    return result.ok ? result : { ok: false, error: fn(result.error) };
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAyHA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAsB;IAClD,OAAO,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAsB;IAChD,OAAO,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAsB;IAClD,OAAO,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAsB;IACnD,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC;AACtC,CAAC;AA2KD;;GAEG;AACH,MAAM,UAAU,IAAI,CAAO,MAAoB;IAC7C,OAAO,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAO,MAAoB;IAC9C,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAO,MAAoB;IAC/C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,MAAM,MAAM,CAAC,KAAK,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAO,MAAoB,EAAE,YAAe;IAClE,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAU,MAAoB,EAAE,EAAmB;IACpE,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAU,MAAoB,EAAE,EAAmB;IACvE,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACrE,CAAC"}

package/dist/intelligence/codeIntelligence.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Code Intelligence Engine
+ *
+ * Automated code analysis, pattern detection, and improvement suggestions.
+ * Designed to augment (not replace) software engineers by handling
+ * repetitive analysis tasks.
+ *
+ * Principal Investigator: Bo Shang
+ * Framework: erosolar-cli
+ */
+export interface CodeIssue {
+    type: IssueType;
+    severity: Severity;
+    file: string;
+    line?: number;
+    column?: number;
+    message: string;
+    suggestion?: string;
+    autoFixable: boolean;
+    fix?: CodeFix;
+}
+export interface CodeFix {
+    description: string;
+    changes: FileChange[];
+}
+export interface FileChange {
+    file: string;
+    oldText: string;
+    newText: string;
+}
+export interface AnalysisResult {
+    files: number;
+    linesOfCode: number;
+    issues: CodeIssue[];
+    patterns: DetectedPattern[];
+    metrics: CodeMetrics;
+    suggestions: ImprovementSuggestion[];
+}
+export interface DetectedPattern {
+    name: string;
+    occurrences: number;
+    locations: PatternLocation[];
+    quality: 'good' | 'neutral' | 'problematic';
+}
+export interface PatternLocation {
+    file: string;
+    line: number;
+    snippet: string;
+}
+export interface CodeMetrics {
+    complexity: number;
+    maintainability: number;
+    testability: number;
+    duplication: number;
+    documentation: number;
+}
+export interface ImprovementSuggestion {
+    category: string;
+    priority: 'high' | 'medium' | 'low';
+    title: string;
+    description: string;
+    effort: 'trivial' | 'small' | 'medium' | 'large';
+    impact: 'high' | 'medium' | 'low';
+}
+export type IssueType = 'security' | 'performance' | 'maintainability' | 'bug' | 'style' | 'complexity' | 'duplication' | 'documentation';
+export type Severity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+export declare class CodeIntelligenceEngine {
+    private workingDir;
+    private fileExtensions;
+    private excludeDirs;
+    constructor(workingDir: string);
+    analyze(targetPath?: string): Promise<AnalysisResult>;
+    private collectFiles;
+    private analyzeFile;
+    private getPosition;
+    private detectPatterns;
+    private calculateMetrics;
+    private generateSuggestions;
+    applyFixes(issues: CodeIssue[]): number;
+    formatReport(result: AnalysisResult): string;
+    private renderBar;
+}
+export interface CodeCompletionSuggestion {
+    type: 'import' | 'function' | 'variable' | 'type' | 'method' | 'property';
+    name: string;
+    description?: string;
+    file?: string;
+    line?: number;
+    signature?: string;
+    relevance: number;
+}
+export declare class CodeCompletionEngine {
+    private suggestions;
+    /**
+     * Generate intelligent code completion suggestions based on context
+     */
+    generateSuggestions(context: {
+        currentFile: string;
+        cursorPosition: {
+            line: number;
+            column: number;
+        };
+        prefix: string;
+        imports: string[];
+        availableFunctions: string[];
+        availableTypes: string[];
+    }): CodeCompletionSuggestion[];
+    /**
+     * Add a suggestion to the completion engine
+     */
+    addSuggestion(suggestion: CodeCompletionSuggestion): void;
+    /**
+     * Clear all suggestions
+     */
+    clearSuggestions(): void;
+}
+export default CodeIntelligenceEngine;
+//# sourceMappingURL=codeIntelligence.d.ts.map

package/dist/intelligence/codeIntelligence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeIntelligence.d.ts","sourceRoot":"","sources":["../../src/intelligence/codeIntelligence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACjD,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACnC;AAED,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,aAAa,GACb,iBAAiB,GACjB,KAAK,GACL,OAAO,GACP,YAAY,GACZ,aAAa,GACb,eAAe,CAAC;AAEpB,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AA4KvE,qBAAa,sBAAsB;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAgE;IACtF,OAAO,CAAC,WAAW,CAA6E;gBAEpF,UAAU,EAAE,MAAM;IAIxB,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAyC3D,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,WAAW;IAqCnB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,cAAc;IAsCtB,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,mBAAmB;IA2E3B,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM;IA0BvC,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IA6F5C,OAAO,CAAC,SAAS;CAOlB;AAMD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,WAAW,CAAkC;IAErD;;OAEG;IACH,mBAAmB,CACjB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACjD,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,GACA,wBAAwB,EAAE;IAiD7B;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,wBAAwB,GAAG,IAAI;IAIzD;;OAEG;IACH,gBAAgB,IAAI,IAAI;CAGzB;AAMD,eAAe,sBAAsB,CAAC"}