dartmind 17.0.0

package/dist/engine/ResourceMonitor.d.ts

@@ -0,0 +1,113 @@
+/**
+ * FlutterAI V16 - ResourceMonitor
+ * Issue 26.2: Resource Exhaustion Abort
+ *
+ * Monitor and abort when resources are exhausted:
+ * - Context window: abort at 95% capacity
+ * - Memory usage
+ * - Execution time
+ *
+ * @module engine/ResourceMonitor
+ * @version 16.0.0
+ */
+import { EventEmitter } from 'events';
+export interface ResourceStatus {
+    contextTokens: {
+        used: number;
+        max: number;
+        percentage: number;
+    };
+    memoryMB: {
+        used: number;
+        max: number;
+        percentage: number;
+    };
+    executionTime: {
+        elapsedMs: number;
+        maxMs: number;
+        percentage: number;
+    };
+}
+export interface AbortDecision {
+    shouldAbort: boolean;
+    reason?: string;
+    resource?: 'context' | 'memory' | 'time';
+    resourceStatus: ResourceStatus;
+}
+export interface ResourceMonitorConfig {
+    maxContextTokens?: number;
+    maxMemoryMB?: number;
+    maxExecutionTimeMs?: number;
+    abortThreshold?: number;
+    warningThreshold?: number;
+}
+export declare class ResourceMonitor extends EventEmitter {
+    private config;
+    private tokenCount;
+    private startTime;
+    private checkInterval;
+    private warningEmitted;
+    constructor(config?: ResourceMonitorConfig);
+    /**
+     * Update the current token count
+     */
+    updateTokenCount(tokens: number): void;
+    /**
+     * Add tokens to current count
+     */
+    addTokens(tokens: number): void;
+    /**
+     * Start the execution timer
+     */
+    startTimer(): void;
+    /**
+     * Stop the timer
+     */
+    stopTimer(): void;
+    /**
+     * Check all resources and return abort decision
+     */
+    checkResources(): AbortDecision;
+    /**
+     * Enforce resource limits - throws if exceeded
+     */
+    enforceLimit(): void;
+    /**
+     * Get current resource status
+     */
+    getStatus(): ResourceStatus;
+    /**
+     * Reset all counters
+     */
+    reset(): void;
+    /**
+     * Get health status
+     */
+    getHealth(): {
+        healthy: boolean;
+        message: string;
+        status: ResourceStatus;
+    };
+    /**
+     * Estimate tokens from text (rough approximation)
+     */
+    static estimateTokens(text: string): number;
+    /**
+     * Estimate tokens for code (typically more tokens due to syntax)
+     */
+    static estimateCodeTokens(code: string): number;
+}
+/**
+ * Create a ResourceMonitor with default settings
+ */
+export declare function createResourceMonitor(config?: ResourceMonitorConfig): ResourceMonitor;
+/**
+ * Create a ResourceMonitor with strict limits
+ */
+export declare function createStrictResourceMonitor(): ResourceMonitor;
+/**
+ * Create a ResourceMonitor for long-running tasks
+ */
+export declare function createLongRunningResourceMonitor(): ResourceMonitor;
+export default ResourceMonitor;
+//# sourceMappingURL=ResourceMonitor.d.ts.map

package/dist/engine/ResourceMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceMonitor.d.ts","sourceRoot":"","sources":["../../src/engine/ResourceMonitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,aAAa,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAkBD,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,cAAc,CAA0B;gBAEpC,MAAM,CAAC,EAAE,qBAAqB;IAK1C;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAiBtC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,IAAI,IAAI;IAgBlB;;OAEG;IACH,SAAS,IAAI,IAAI;IAOjB;;OAEG;IACH,cAAc,IAAI,aAAa;IA8C/B;;OAEG;IACH,YAAY,IAAI,IAAI;IAWpB;;OAEG;IACH,SAAS,IAAI,cAAc;IAyB3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,SAAS,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE;IAuC1E;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK3C;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAIhD;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,eAAe,CAErF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,eAAe,CAQ7D;AAED;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,eAAe,CAQlE;AAMD,eAAe,eAAe,CAAC"}

package/dist/engine/ResourceMonitor.js

@@ -0,0 +1,262 @@
+/**
+ * FlutterAI V16 - ResourceMonitor
+ * Issue 26.2: Resource Exhaustion Abort
+ *
+ * Monitor and abort when resources are exhausted:
+ * - Context window: abort at 95% capacity
+ * - Memory usage
+ * - Execution time
+ *
+ * @module engine/ResourceMonitor
+ * @version 16.0.0
+ */
+import { EventEmitter } from 'events';
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_CONFIG = {
+    maxContextTokens: 200000, // Claude's context window
+    maxMemoryMB: 4096, // 4GB
+    maxExecutionTimeMs: 300000, // 5 minutes
+    abortThreshold: 0.95,
+    warningThreshold: 0.8,
+};
+// ============================================================================
+// ResourceMonitor Class
+// ============================================================================
+export class ResourceMonitor extends EventEmitter {
+    config;
+    tokenCount = 0;
+    startTime = null;
+    checkInterval = null;
+    warningEmitted = new Set();
+    constructor(config) {
+        super();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Update the current token count
+     */
+    updateTokenCount(tokens) {
+        this.tokenCount = tokens;
+        const status = this.getStatus();
+        // Check thresholds
+        if (status.contextTokens.percentage >= this.config.abortThreshold) {
+            this.emit('abort-threshold', { resource: 'context', status });
+        }
+        else if (status.contextTokens.percentage >= this.config.warningThreshold &&
+            !this.warningEmitted.has('context')) {
+            this.warningEmitted.add('context');
+            this.emit('warning-threshold', { resource: 'context', status });
+        }
+    }
+    /**
+     * Add tokens to current count
+     */
+    addTokens(tokens) {
+        this.updateTokenCount(this.tokenCount + tokens);
+    }
+    /**
+     * Start the execution timer
+     */
+    startTimer() {
+        this.startTime = Date.now();
+        this.warningEmitted.clear();
+        // Periodic checks
+        this.checkInterval = setInterval(() => {
+            const decision = this.checkResources();
+            if (decision.shouldAbort) {
+                this.emit('abort-threshold', {
+                    resource: decision.resource,
+                    status: decision.resourceStatus,
+                });
+            }
+        }, 5000); // Check every 5 seconds
+    }
+    /**
+     * Stop the timer
+     */
+    stopTimer() {
+        if (this.checkInterval) {
+            clearInterval(this.checkInterval);
+            this.checkInterval = null;
+        }
+    }
+    /**
+     * Check all resources and return abort decision
+     */
+    checkResources() {
+        const status = this.getStatus();
+        // Check context tokens
+        if (status.contextTokens.percentage >= this.config.abortThreshold) {
+            return {
+                shouldAbort: true,
+                reason: `Context window ${(status.contextTokens.percentage * 100).toFixed(1)}% full ` +
+                    `(${status.contextTokens.used}/${status.contextTokens.max} tokens)`,
+                resource: 'context',
+                resourceStatus: status,
+            };
+        }
+        // Check memory
+        if (status.memoryMB.percentage >= this.config.abortThreshold) {
+            return {
+                shouldAbort: true,
+                reason: `Memory usage ${(status.memoryMB.percentage * 100).toFixed(1)}% ` +
+                    `(${status.memoryMB.used}/${status.memoryMB.max} MB)`,
+                resource: 'memory',
+                resourceStatus: status,
+            };
+        }
+        // Check execution time
+        if (status.executionTime.percentage >= this.config.abortThreshold) {
+            return {
+                shouldAbort: true,
+                reason: `Execution time ${(status.executionTime.percentage * 100).toFixed(1)}% ` +
+                    `(${Math.round(status.executionTime.elapsedMs / 1000)}s / ` +
+                    `${Math.round(status.executionTime.maxMs / 1000)}s)`,
+                resource: 'time',
+                resourceStatus: status,
+            };
+        }
+        return {
+            shouldAbort: false,
+            resourceStatus: status,
+        };
+    }
+    /**
+     * Enforce resource limits - throws if exceeded
+     */
+    enforceLimit() {
+        const decision = this.checkResources();
+        if (decision.shouldAbort) {
+            const error = new Error(`Resource exhaustion: ${decision.reason}`);
+            error.name = 'ResourceExhaustedError';
+            error.abortDecision = decision;
+            throw error;
+        }
+    }
+    /**
+     * Get current resource status
+     */
+    getStatus() {
+        const memUsage = process.memoryUsage();
+        const usedMemoryMB = Math.round(memUsage.heapUsed / 1024 / 1024);
+        const elapsedMs = this.startTime ? Date.now() - this.startTime : 0;
+        return {
+            contextTokens: {
+                used: this.tokenCount,
+                max: this.config.maxContextTokens,
+                percentage: this.tokenCount / this.config.maxContextTokens,
+            },
+            memoryMB: {
+                used: usedMemoryMB,
+                max: this.config.maxMemoryMB,
+                percentage: usedMemoryMB / this.config.maxMemoryMB,
+            },
+            executionTime: {
+                elapsedMs,
+                maxMs: this.config.maxExecutionTimeMs,
+                percentage: elapsedMs / this.config.maxExecutionTimeMs,
+            },
+        };
+    }
+    /**
+     * Reset all counters
+     */
+    reset() {
+        this.tokenCount = 0;
+        this.startTime = null;
+        this.warningEmitted.clear();
+        this.stopTimer();
+        this.emit('reset');
+    }
+    /**
+     * Get health status
+     */
+    getHealth() {
+        const status = this.getStatus();
+        const decision = this.checkResources();
+        if (decision.shouldAbort) {
+            return {
+                healthy: false,
+                message: `Resource limit exceeded: ${decision.reason}`,
+                status,
+            };
+        }
+        // Check warning levels
+        const warnings = [];
+        if (status.contextTokens.percentage >= this.config.warningThreshold) {
+            warnings.push(`context ${(status.contextTokens.percentage * 100).toFixed(0)}%`);
+        }
+        if (status.memoryMB.percentage >= this.config.warningThreshold) {
+            warnings.push(`memory ${(status.memoryMB.percentage * 100).toFixed(0)}%`);
+        }
+        if (status.executionTime.percentage >= this.config.warningThreshold) {
+            warnings.push(`time ${(status.executionTime.percentage * 100).toFixed(0)}%`);
+        }
+        if (warnings.length > 0) {
+            return {
+                healthy: true,
+                message: `ResourceMonitor warnings: ${warnings.join(', ')}`,
+                status,
+            };
+        }
+        return {
+            healthy: true,
+            message: 'ResourceMonitor healthy',
+            status,
+        };
+    }
+    /**
+     * Estimate tokens from text (rough approximation)
+     */
+    static estimateTokens(text) {
+        // Rough estimate: ~4 characters per token for English
+        return Math.ceil(text.length / 4);
+    }
+    /**
+     * Estimate tokens for code (typically more tokens due to syntax)
+     */
+    static estimateCodeTokens(code) {
+        // Code has more tokens per character due to syntax
+        return Math.ceil(code.length / 3);
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create a ResourceMonitor with default settings
+ */
+export function createResourceMonitor(config) {
+    return new ResourceMonitor(config);
+}
+/**
+ * Create a ResourceMonitor with strict limits
+ */
+export function createStrictResourceMonitor() {
+    return new ResourceMonitor({
+        maxContextTokens: 100000,
+        maxMemoryMB: 2048,
+        maxExecutionTimeMs: 120000, // 2 minutes
+        abortThreshold: 0.9,
+        warningThreshold: 0.7,
+    });
+}
+/**
+ * Create a ResourceMonitor for long-running tasks
+ */
+export function createLongRunningResourceMonitor() {
+    return new ResourceMonitor({
+        maxContextTokens: 200000,
+        maxMemoryMB: 8192,
+        maxExecutionTimeMs: 600000, // 10 minutes
+        abortThreshold: 0.95,
+        warningThreshold: 0.85,
+    });
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export default ResourceMonitor;
+//# sourceMappingURL=ResourceMonitor.js.map

package/dist/engine/ResourceMonitor.js.map

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

package/dist/engine/V16AgenticEngine.d.ts

@@ -0,0 +1,204 @@
+/**
+ * FlutterAI V16 - Agentic Engine
+ * Issue 4.1: Agentic Loop Integration
+ * Issue 4.2: Error Recovery Pipeline
+ *
+ * CRITICAL DESIGN PRINCIPLES:
+ * 1. NO BYPASS MECHANISMS - All safety gates MUST execute
+ * 2. Doom loop detection with automatic abort
+ * 3. Resource monitoring with 95% abort threshold
+ * 4. Central abort controller coordination
+ * 5. Structured error surfacing
+ *
+ * Integrates:
+ * - V16SafetyPipeline (NO skip gates)
+ * - DoomLoopDetector (similarity-based loop prevention)
+ * - ResourceMonitor (95% context abort)
+ * - FlutterAIAbortController (central abort coordination)
+ * - ErrorSurface (structured FAI-XXX-NNN codes)
+ *
+ * @module engine/V16AgenticEngine
+ * @version 16.0.0
+ */
+import { EventEmitter } from 'events';
+import { AbortReason } from './AbortController.js';
+export type V16AgenticState = 'IDLE' | 'INITIALIZING' | 'GENERATING' | 'VALIDATING' | 'FIXING' | 'VERIFYING' | 'FINALIZING' | 'SUCCESS' | 'ERROR' | 'ABORTED';
+export interface V16GenerationTask {
+    /** User prompt */
+    prompt: string;
+    /** Project context */
+    context?: string;
+    /** Target files to modify/create */
+    targetFiles?: string[];
+    /** Task goal description */
+    goal: string;
+    /** Maximum retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Cost limit in USD (default: 5.00) */
+    costLimit?: number;
+    /** Project path for gate execution */
+    projectPath?: string;
+    /** External abort signal */
+    signal?: AbortSignal;
+}
+export interface V16GenerationResult {
+    /** Whether generation succeeded */
+    success: boolean;
+    /** Files created */
+    filesCreated: string[];
+    /** Files modified */
+    filesModified: string[];
+    /** Gate violations that blocked generation */
+    violations: Array<{
+        gateId: string;
+        message: string;
+        severity: string;
+    }>;
+    /** Token usage */
+    tokenUsage: V16TokenUsage;
+    /** Total duration in ms */
+    duration: number;
+    /** Number of retry attempts */
+    retryCount: number;
+    /** Transaction ID for rollback */
+    transactionId: string;
+    /** Abort reason if aborted */
+    abortReason?: AbortReason;
+}
+export interface V16TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cachedTokens: number;
+    totalCost: number;
+}
+export interface V16AgenticEngineConfig {
+    /** Anthropic API key */
+    apiKey: string;
+    /** Project path */
+    projectPath: string;
+    /** Model to use (default: claude-sonnet-4-20250514) */
+    model?: string;
+    /** Enable streaming (default: true) */
+    enableStreaming?: boolean;
+    /** Maximum retries (default: 3) */
+    maxRetries?: number;
+    /** Cost limit USD (default: 5.00) */
+    costLimit?: number;
+    /** Enable auto-fix (default: true) */
+    autoFix?: boolean;
+    /** Enable auto-test (default: false) */
+    autoTest?: boolean;
+    /** Strict mode - fail fast on any violation */
+    strictMode?: boolean;
+    /** Context window max tokens */
+    maxContextTokens?: number;
+}
+export interface V16AgenticHealth {
+    healthy: boolean;
+    state: V16AgenticState;
+    doomLoopHealth: {
+        healthy: boolean;
+        message: string;
+    };
+    resourceHealth: {
+        healthy: boolean;
+        message: string;
+    };
+    pipelineHealth: {
+        healthy: boolean;
+        message: string;
+    };
+    message: string;
+}
+export declare class V16AgenticEngine extends EventEmitter {
+    private config;
+    private anthropic;
+    private safetyPipeline;
+    private doomDetector;
+    private resourceMonitor;
+    private abortController;
+    private currentState;
+    private retryCount;
+    private totalTokenUsage;
+    private totalExecutions;
+    private successfulExecutions;
+    private abortedExecutions;
+    constructor(config: V16AgenticEngineConfig);
+    /**
+     * Execute a generation task with V16 safety
+     * CRITICAL: All gates execute, NO bypass
+     */
+    execute(task: V16GenerationTask): Promise<V16GenerationResult>;
+    /**
+     * Generate code using Claude
+     */
+    private generate;
+    /**
+     * Build system prompt for Flutter generation
+     */
+    private buildSystemPrompt;
+    /**
+     * Build user prompt with context and violations
+     */
+    private buildUserPrompt;
+    /**
+     * Parse response for file blocks
+     */
+    private parseResponse;
+    /**
+     * Update token usage
+     */
+    private updateTokenUsage;
+    /**
+     * Recalculate total cost
+     */
+    private recalculateCost;
+    /**
+     * Create aborted result
+     */
+    private abortedResult;
+    /**
+     * Set state with event emission
+     */
+    private setState;
+    /**
+     * Get current state
+     */
+    getState(): V16AgenticState;
+    /**
+     * Abort current operation
+     */
+    abort(): boolean;
+    /**
+     * Check if currently running
+     */
+    isRunning(): boolean;
+    /**
+     * Get comprehensive health status
+     */
+    getHealth(): V16AgenticHealth;
+    /**
+     * Get execution statistics
+     */
+    getStats(): {
+        totalExecutions: number;
+        successfulExecutions: number;
+        abortedExecutions: number;
+        successRate: number;
+        totalTokenUsage: V16TokenUsage;
+    };
+    /**
+     * Reset engine state
+     */
+    reset(): void;
+}
+/**
+ * Create V16AgenticEngine with standard configuration
+ */
+export declare function createV16AgenticEngine(config: V16AgenticEngineConfig): V16AgenticEngine;
+/**
+ * Create V16AgenticEngine in strict mode
+ */
+export declare function createStrictV16AgenticEngine(config: V16AgenticEngineConfig): V16AgenticEngine;
+export default V16AgenticEngine;
+//# sourceMappingURL=V16AgenticEngine.d.ts.map

package/dist/engine/V16AgenticEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"V16AgenticEngine.d.ts","sourceRoot":"","sources":["../../src/engine/V16AgenticEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAOtC,OAAO,EAGL,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAO9B,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,cAAc,GACd,YAAY,GACZ,YAAY,GACZ,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,SAAS,GACT,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,8CAA8C;IAC9C,UAAU,EAAE,KAAK,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,kBAAkB;IAClB,UAAU,EAAE,aAAa,CAAC;IAC1B,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,eAAe,CAAC;IACvB,cAAc,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,cAAc,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,cAAc,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AA4BD,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,SAAS,CAAY;IAG7B,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAA2B;IAGlD,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,eAAe,CAKrB;IAGF,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,iBAAiB,CAAK;gBAElB,MAAM,EAAE,sBAAsB;IA+C1C;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA6OpE;;OAEG;YACW,QAAQ;IA6EtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,aAAa;IA+BrB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAKhB;;OAEG;IACH,QAAQ,IAAI,eAAe;IAI3B;;OAEG;IACH,KAAK,IAAI,OAAO;IAQhB;;OAEG;IACH,SAAS,IAAI,OAAO;IASpB;;OAEG;IACH,SAAS,IAAI,gBAAgB;IAoB7B;;OAEG;IACH,QAAQ,IAAI;QACV,eAAe,EAAE,MAAM,CAAC;QACxB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,aAAa,CAAC;KAChC;IAaD;;OAEG;IACH,KAAK,IAAI,IAAI;CAcd;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,gBAAgB,CAElB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,sBAAsB,GAC7B,gBAAgB,CAMlB;AAMD,eAAe,gBAAgB,CAAC"}