@robota-sdk/agent-core 3.0.0-beta.2 → 3.0.0-beta.21

package/dist/managers/module-type-registry-helpers.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Builtin type registrations and helper logic for ModuleDescriptorRegistry.
+ *
+ * Extracted from module-type-registry.ts to keep each file under 300 lines.
+ * @internal
+ */
+import type { IModuleDescriptor } from '../abstracts/abstract-module';
+import { ModuleCategory, ModuleLayer } from '../abstracts/abstract-module';
+import type { IModuleDescriptorValidationResult, IModuleDependencyResolution } from './module-type-registry';
+/** @internal */
+export declare function getBuiltinTypeDescriptors(): IModuleDescriptor[];
+/** Validate a module type descriptor. @internal */
+export declare function validateTypeDescriptor(typeDescriptor: IModuleDescriptor, getType: (type: string) => IModuleDescriptor | undefined): IModuleDescriptorValidationResult;
+/** Resolve module dependencies via topological sort. @internal */
+export declare function resolveDependenciesHelper(moduleTypes: string[], getType: (type: string) => IModuleDescriptor | undefined, hasType: (type: string) => boolean): IModuleDependencyResolution;
+/** Check compatibility between module types. @internal */
+export declare function checkCompatibilityHelper(moduleTypes: string[], getType: (type: string) => IModuleDescriptor | undefined): {
+    compatible: boolean;
+    conflicts: Array<{
+        module1: string;
+        module2: string;
+        reason: string;
+    }>;
+    suggestions: string[];
+};
+/** Build registry stats. @internal */
+export declare function buildTypeRegistryStats(registeredTypes: Map<string, IModuleDescriptor>): {
+    totalTypes: number;
+    typesByCategory: Record<ModuleCategory, number>;
+    typesByLayer: Record<ModuleLayer, number>;
+    typesWithDependencies: number;
+    typesWithCapabilities: number;
+};
+//# sourceMappingURL=module-type-registry-helpers.d.ts.map

package/dist/managers/module-type-registry-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-type-registry-helpers.d.ts","sourceRoot":"","sources":["../../src/managers/module-type-registry-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,KAAK,EACV,iCAAiC,EACjC,2BAA2B,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,gBAAgB;AAChB,wBAAgB,yBAAyB,IAAI,iBAAiB,EAAE,CAoE/D;AAED,mDAAmD;AACnD,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,iBAAiB,EACjC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,GACvD,iCAAiC,CA4CnC;AAED,kEAAkE;AAClE,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,EACxD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACjC,2BAA2B,CA+C7B;AAED,0DAA0D;AAC1D,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,GACvD;IACD,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CA4CA;AAED,sCAAsC;AACtC,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG;IACvF,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAChD,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC1C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CA+BA"}

package/dist/managers/module-type-registry-helpers.js

@@ -0,0 +1,255 @@
+import { ModuleCategory, ModuleLayer } from '../abstracts/abstract-module';
+/** @internal */
+export function getBuiltinTypeDescriptors() {
+    return [
+        {
+            type: 'storage',
+            category: ModuleCategory.STORAGE,
+            layer: ModuleLayer.INFRASTRUCTURE,
+            capabilities: ['data-persistence', 'data-retrieval'],
+        },
+        {
+            type: 'memory-storage',
+            category: ModuleCategory.STORAGE,
+            layer: ModuleLayer.INFRASTRUCTURE,
+            dependencies: ['storage'],
+            capabilities: ['in-memory-storage', 'fast-access'],
+        },
+        {
+            type: 'file-storage',
+            category: ModuleCategory.STORAGE,
+            layer: ModuleLayer.INFRASTRUCTURE,
+            dependencies: ['storage'],
+            capabilities: ['persistent-storage', 'file-system-access'],
+        },
+        {
+            type: 'text-processing',
+            category: ModuleCategory.PROCESSING,
+            layer: ModuleLayer.APPLICATION,
+            capabilities: ['text-analysis', 'content-transformation'],
+        },
+        {
+            type: 'file-processing',
+            category: ModuleCategory.PROCESSING,
+            layer: ModuleLayer.APPLICATION,
+            dependencies: ['storage'],
+            capabilities: ['file-parsing', 'content-extraction'],
+        },
+        {
+            type: 'api-integration',
+            category: ModuleCategory.INTEGRATION,
+            layer: ModuleLayer.APPLICATION,
+            capabilities: ['external-api-access', 'data-synchronization'],
+        },
+        {
+            type: 'database-integration',
+            category: ModuleCategory.INTEGRATION,
+            layer: ModuleLayer.INFRASTRUCTURE,
+            dependencies: ['storage'],
+            capabilities: ['database-access', 'query-execution'],
+        },
+        {
+            type: 'rag',
+            category: ModuleCategory.CAPABILITY,
+            layer: ModuleLayer.DOMAIN,
+            dependencies: ['storage', 'text-processing'],
+            capabilities: ['document-search', 'context-retrieval', 'semantic-search'],
+        },
+        {
+            type: 'speech-processing',
+            category: ModuleCategory.CAPABILITY,
+            layer: ModuleLayer.DOMAIN,
+            capabilities: ['speech-to-text', 'text-to-speech', 'audio-processing'],
+        },
+        {
+            type: 'image-analysis',
+            category: ModuleCategory.CAPABILITY,
+            layer: ModuleLayer.DOMAIN,
+            capabilities: ['image-recognition', 'visual-analysis', 'content-extraction'],
+        },
+    ];
+}
+/** Validate a module type descriptor. @internal */
+export function validateTypeDescriptor(typeDescriptor, getType) {
+    const errors = [];
+    const warnings = [];
+    if (!typeDescriptor.type || typeDescriptor.type.trim() === '')
+        errors.push('Module type is required and cannot be empty');
+    if (!typeDescriptor.category)
+        errors.push('Module category is required');
+    if (!typeDescriptor.layer)
+        errors.push('Module layer is required');
+    if (typeDescriptor.type && !/^[a-zA-Z][a-zA-Z0-9-_]*$/.test(typeDescriptor.type))
+        errors.push('Module type must start with a letter and contain only letters, numbers, hyphens, and underscores');
+    if (typeDescriptor.dependencies) {
+        for (const dep of typeDescriptor.dependencies) {
+            if (!dep || dep.trim() === '')
+                errors.push('Dependencies cannot be empty');
+        }
+        if (typeDescriptor.dependencies.includes(typeDescriptor.type))
+            errors.push('Module cannot depend on itself');
+    }
+    if (typeDescriptor.capabilities) {
+        for (const cap of typeDescriptor.capabilities) {
+            if (!cap || cap.trim() === '')
+                errors.push('Capabilities cannot be empty');
+        }
+    }
+    if (typeDescriptor.dependencies) {
+        const layerOrder = [
+            ModuleLayer.INFRASTRUCTURE,
+            ModuleLayer.CORE,
+            ModuleLayer.APPLICATION,
+            ModuleLayer.DOMAIN,
+            ModuleLayer.PRESENTATION,
+        ];
+        const currentIdx = layerOrder.indexOf(typeDescriptor.layer);
+        for (const depType of typeDescriptor.dependencies) {
+            const depDesc = getType(depType);
+            if (depDesc) {
+                const depIdx = layerOrder.indexOf(depDesc.layer);
+                if (depIdx > currentIdx)
+                    warnings.push(`Module '${typeDescriptor.type}' (${typeDescriptor.layer}) depends on '${depType}' (${depDesc.layer}) which is in a higher layer`);
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/** Resolve module dependencies via topological sort. @internal */
+export function resolveDependenciesHelper(moduleTypes, getType, hasType) {
+    const visited = new Set();
+    const visiting = new Set();
+    const order = [];
+    const circularDependencies = [];
+    const missingDependencies = [];
+    for (const moduleType of moduleTypes) {
+        const descriptor = getType(moduleType);
+        if (!descriptor) {
+            missingDependencies.push(moduleType);
+            continue;
+        }
+        if (descriptor.dependencies) {
+            for (const dep of descriptor.dependencies) {
+                if (!hasType(dep) && !missingDependencies.includes(dep))
+                    missingDependencies.push(dep);
+            }
+        }
+    }
+    const visit = (moduleType, path = []) => {
+        if (visiting.has(moduleType)) {
+            const cycleStart = path.indexOf(moduleType);
+            circularDependencies.push(path.slice(cycleStart).concat([moduleType]));
+            return;
+        }
+        if (visited.has(moduleType))
+            return;
+        const descriptor = getType(moduleType);
+        if (!descriptor)
+            return;
+        visiting.add(moduleType);
+        const newPath = [...path, moduleType];
+        if (descriptor.dependencies) {
+            for (const dep of descriptor.dependencies) {
+                if (moduleTypes.includes(dep) || hasType(dep))
+                    visit(dep, newPath);
+            }
+        }
+        visiting.delete(moduleType);
+        visited.add(moduleType);
+        order.push(moduleType);
+    };
+    for (const moduleType of moduleTypes) {
+        if (!visited.has(moduleType))
+            visit(moduleType);
+    }
+    return {
+        resolved: missingDependencies.length === 0 && circularDependencies.length === 0,
+        order,
+        circularDependencies,
+        missingDependencies,
+    };
+}
+/** Check compatibility between module types. @internal */
+export function checkCompatibilityHelper(moduleTypes, getType) {
+    const conflicts = [];
+    const suggestions = [];
+    const modulesByLayer = new Map();
+    for (const moduleType of moduleTypes) {
+        const descriptor = getType(moduleType);
+        if (descriptor) {
+            if (!modulesByLayer.has(descriptor.layer))
+                modulesByLayer.set(descriptor.layer, []);
+            modulesByLayer.get(descriptor.layer).push(moduleType);
+        }
+    }
+    const capabilityProviders = new Map();
+    for (const moduleType of moduleTypes) {
+        const descriptor = getType(moduleType);
+        if (descriptor?.capabilities) {
+            for (const cap of descriptor.capabilities) {
+                if (!capabilityProviders.has(cap))
+                    capabilityProviders.set(cap, []);
+                capabilityProviders.get(cap).push(moduleType);
+            }
+        }
+    }
+    for (const [capability, providers] of Array.from(capabilityProviders.entries())) {
+        if (providers.length > 1) {
+            for (let i = 0; i < providers.length; i++) {
+                for (let j = i + 1; j < providers.length; j++) {
+                    const m1 = providers[i];
+                    const m2 = providers[j];
+                    if (m1 && m2)
+                        conflicts.push({
+                            module1: m1,
+                            module2: m2,
+                            reason: `Both modules provide capability '${capability}'`,
+                        });
+                }
+            }
+        }
+    }
+    if (conflicts.length > 0) {
+        suggestions.push('Consider using only one module per capability');
+        suggestions.push('Check if modules can be configured to avoid conflicts');
+    }
+    if (!modulesByLayer.has(ModuleLayer.INFRASTRUCTURE) && moduleTypes.length > 1)
+        suggestions.push('Consider adding infrastructure modules for better foundation');
+    return { compatible: conflicts.length === 0, conflicts, suggestions };
+}
+/** Build registry stats. @internal */
+export function buildTypeRegistryStats(registeredTypes) {
+    const typesByCategory = {
+        [ModuleCategory.CORE]: 0,
+        [ModuleCategory.STORAGE]: 0,
+        [ModuleCategory.PROCESSING]: 0,
+        [ModuleCategory.INTEGRATION]: 0,
+        [ModuleCategory.INTERFACE]: 0,
+        [ModuleCategory.CAPABILITY]: 0,
+    };
+    const typesByLayer = {
+        [ModuleLayer.INFRASTRUCTURE]: 0,
+        [ModuleLayer.CORE]: 0,
+        [ModuleLayer.APPLICATION]: 0,
+        [ModuleLayer.DOMAIN]: 0,
+        [ModuleLayer.PRESENTATION]: 0,
+    };
+    let typesWithDependencies = 0;
+    let typesWithCapabilities = 0;
+    for (const descriptor of registeredTypes.values()) {
+        typesByCategory[descriptor.category]++;
+        typesByLayer[descriptor.layer]++;
+        if (descriptor.dependencies && descriptor.dependencies.length > 0)
+            typesWithDependencies++;
+        if (descriptor.capabilities && descriptor.capabilities.length > 0)
+            typesWithCapabilities++;
+    }
+    return {
+        totalTypes: registeredTypes.size,
+        typesByCategory,
+        typesByLayer,
+        typesWithDependencies,
+        typesWithCapabilities,
+    };
+}
+//# sourceMappingURL=module-type-registry-helpers.js.map

package/dist/managers/module-type-registry-helpers.js.map

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

package/dist/managers/module-type-registry.d.ts

@@ -1,24 +1,23 @@
-import { IModuleDescriptor, ModuleCategory, ModuleLayer } from '../abstracts/abstract-module';
 /**
- * Module type validation result
+ * Registry for managing module types dynamically.
+ *
+ * Builtin registrations and helpers live in ./module-type-registry-helpers.ts.
  */
+import { IModuleDescriptor, ModuleCategory, ModuleLayer } from '../abstracts/abstract-module';
+/** Module type validation result */
 export interface IModuleDescriptorValidationResult {
     valid: boolean;
     errors: string[];
     warnings: string[];
 }
-/**
- * Module dependency resolution result
- */
+/** Module dependency resolution result */
 export interface IModuleDependencyResolution {
     resolved: boolean;
     order: string[];
     circularDependencies: string[][];
     missingDependencies: string[];
 }
-/**
- * Module compatibility check result
- */
+/** Module compatibility check result */
 export interface IModuleCompatibilityResult {
     compatible: boolean;
     conflicts: Array<{
@@ -29,79 +28,26 @@ export interface IModuleCompatibilityResult {
     suggestions: string[];
 }
 /**
- * Registry for managing module types dynamically
- * Provides type validation, dependency resolution, and compatibility checking
- *
- * This system allows for:
- * - Dynamic registration of new module types at runtime
- * - Automatic dependency resolution and ordering
- * - Type compatibility validation
- * - Circular dependency detection
+ * Registry for managing module types dynamically.
+ * Provides type validation, dependency resolution, and compatibility checking.
  */
 export declare class ModuleDescriptorRegistry {
-    private static instance;
     private registeredTypes;
     private logger;
     constructor();
-    /**
-     * Get singleton instance of ModuleDescriptorRegistry
-     */
-    static getInstance(): ModuleDescriptorRegistry;
-    /**
-     * Register a new module type
-     */
     registerType(typeDescriptor: IModuleDescriptor): void;
-    /**
-     * Unregister a module type
-     */
     unregisterType(type: string): boolean;
-    /**
-     * Get a registered module type
-     */
-    getType(type: string): IModuleDescriptor | null;
-    /**
-     * Get all registered module types
-     */
+    getType(type: string): IModuleDescriptor | undefined;
     getAllTypes(): IModuleDescriptor[];
-    /**
-     * Get module types by category
-     */
     getTypesByCategory(category: ModuleCategory): IModuleDescriptor[];
-    /**
-     * Get module types by layer
-     */
     getTypesByLayer(layer: ModuleLayer): IModuleDescriptor[];
-    /**
-     * Check if a module type is registered
-     */
     hasType(type: string): boolean;
-    /**
-     * Validate module type descriptor
-     */
     validateTypeDescriptor(typeDescriptor: IModuleDescriptor): IModuleDescriptorValidationResult;
-    /**
-     * Resolve module dependencies and return initialization order
-     */
     resolveDependencies(moduleTypes: string[]): IModuleDependencyResolution;
-    /**
-     * Check compatibility between module types
-     */
     checkCompatibility(moduleTypes: string[]): IModuleCompatibilityResult;
-    /**
-     * Find types that depend on the given type
-     */
     private findDependentTypes;
-    /**
-     * Register built-in module types
-     */
     private registerBuiltinTypes;
-    /**
-     * Clear all registered types (for testing)
-     */
     clearAllTypes(): void;
-    /**
-     * Get registry statistics
-     */
     getStats(): {
         totalTypes: number;
         typesByCategory: Record<ModuleCategory, number>;

package/dist/managers/module-type-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-type-registry.d.ts","sourceRoot":"","sources":["../../src/managers/module-type-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EACjB,cAAc,EACd,WAAW,EACd,MAAM,8BAA8B,CAAC;AAItC;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAC9C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oBAAoB,EAAE,MAAM,EAAE,EAAE,CAAC;IACjC,mBAAmB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,qBAAa,wBAAwB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAyC;IAChE,OAAO,CAAC,eAAe,CAAwC;IAC/D,OAAO,CAAC,MAAM,CAAU;;IAOxB;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,wBAAwB;IAO9C;;OAEG;IACH,YAAY,CAAC,cAAc,EAAE,iBAAiB,GAAG,IAAI;IA+BrD;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAmBrC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAI/C;;OAEG;IACH,WAAW,IAAI,iBAAiB,EAAE;IAIlC;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,iBAAiB,EAAE;IAKjE;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,EAAE;IAKxD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,sBAAsB,CAAC,cAAc,EAAE,iBAAiB,GAAG,iCAAiC;IA+E5F;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,2BAA2B;IAyEvE;;OAEG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,0BAA0B;IAsErE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqF5B;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;OAEG;IACH,QAAQ,IAAI;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAChD,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC1C,qBAAqB,EAAE,MAAM,CAAC;QAC9B,qBAAqB,EAAE,MAAM,CAAC;KACjC;CA0CJ"}
+{"version":3,"file":"module-type-registry.d.ts","sourceRoot":"","sources":["../../src/managers/module-type-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAW9F,oCAAoC;AACpC,MAAM,WAAW,iCAAiC;IAChD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,0CAA0C;AAC1C,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oBAAoB,EAAE,MAAM,EAAE,EAAE,CAAC;IACjC,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,wCAAwC;AACxC,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,eAAe,CAAwC;IAC/D,OAAO,CAAC,MAAM,CAAU;;IAOxB,YAAY,CAAC,cAAc,EAAE,iBAAiB,GAAG,IAAI;IAyBrD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAarC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAGpD,WAAW,IAAI,iBAAiB,EAAE;IAGlC,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,iBAAiB,EAAE;IAGjE,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,EAAE;IAGxD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,sBAAsB,CAAC,cAAc,EAAE,iBAAiB,GAAG,iCAAiC;IAI5F,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,2BAA2B;IAQvE,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,0BAA0B;IAIrE,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,oBAAoB;IAK5B,aAAa,IAAI,IAAI;IAKrB,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAChD,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC1C,qBAAqB,EAAE,MAAM,CAAC;QAC9B,qBAAqB,EAAE,MAAM,CAAC;KAC/B;CAGF"}