@jclaw/core 0.1.0

package/dist/evolution/sandbox.js

@@ -0,0 +1,194 @@
+/**
+ * Sandbox Validator
+ *
+ * Validates mutations in an isolated environment.
+ *
+ * @module @jclaw/core/evolution/sandbox
+ */
+import path from 'path';
+import fs from 'fs/promises';
+import os from 'os';
+/**
+ * Default test command template
+ */
+const DEFAULT_TEST_COMMAND = 'npm test -- --passWithNoTests';
+/**
+ * Sandbox Validator
+ *
+ * Validates mutations by running tests in an isolated environment.
+ * Supports both local and docker execution modes.
+ *
+ * @example
+ * ```typescript
+ * const sandbox = new SandboxValidator({
+ *   executor: localExecutor,
+ *   testCommand: 'npm test'
+ * });
+ *
+ * const result = await sandbox.validate(mutation);
+ * if (result.passed) {
+ *   console.log('Mutation is safe to apply');
+ * }
+ * ```
+ */
+export class SandboxValidator {
+    config;
+    /**
+     * Create a new sandbox validator.
+     *
+     * @param config - Configuration options
+     */
+    constructor(config) {
+        this.config = {
+            timeout: 30000,
+            tempDir: os.tmpdir(),
+            testCommand: DEFAULT_TEST_COMMAND,
+            verbose: false,
+            ...config,
+        };
+    }
+    /**
+     * Validate a mutation in the sandbox.
+     *
+     * @param mutation - The mutation to validate
+     * @param targetPath - Path to the target file to mutate (optional)
+     * @returns Validation result
+     */
+    async validate(mutation, targetPath) {
+        const startTime = Date.now();
+        try {
+            // Create sandbox directory
+            const sandboxDir = await this.createSandbox();
+            // Apply mutation to sandbox
+            if (targetPath) {
+                await this.applyMutation(mutation, sandboxDir, targetPath);
+            }
+            else {
+                // Create a test file for the mutation
+                const testFile = path.join(sandboxDir, 'mutation-test.ts');
+                await fs.writeFile(testFile, mutation.mutated, 'utf-8');
+            }
+            // Run validation tests
+            const result = await this.runTests(sandboxDir);
+            // Cleanup sandbox
+            await this.cleanup(sandboxDir);
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            return {
+                passed: false,
+                errors: [error instanceof Error ? error.message : 'Unknown error'],
+                duration,
+            };
+        }
+    }
+    /**
+     * Validate multiple mutations.
+     *
+     * @param mutations - Mutations to validate
+     * @param targetPath - Target file path
+     * @returns Array of validation results
+     */
+    async validateBatch(mutations, targetPath) {
+        const results = new Map();
+        for (const mutation of mutations) {
+            const result = await this.validate(mutation, targetPath);
+            results.set(mutation.id, result);
+        }
+        return results;
+    }
+    /**
+     * Create a sandbox directory.
+     */
+    async createSandbox() {
+        const sandboxDir = path.join(this.config.tempDir, `jclaw-sandbox-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        await fs.mkdir(sandboxDir, { recursive: true });
+        this.log(`Created sandbox: ${sandboxDir}`);
+        return sandboxDir;
+    }
+    /**
+     * Apply mutation to the sandbox.
+     */
+    async applyMutation(mutation, sandboxDir, targetPath) {
+        // Get relative path
+        const fileName = path.basename(targetPath);
+        const sandboxTarget = path.join(sandboxDir, fileName);
+        // Write mutated content
+        await fs.writeFile(sandboxTarget, mutation.mutated, 'utf-8');
+        this.log(`Applied mutation to: ${sandboxTarget}`);
+    }
+    /**
+     * Run tests in the sandbox.
+     */
+    async runTests(sandboxDir) {
+        const startTime = Date.now();
+        const errors = [];
+        let output = '';
+        try {
+            const result = await this.config.executor.execute(this.config.testCommand, {
+                cwd: sandboxDir,
+                timeout: this.config.timeout,
+            });
+            output = result.stdout + '\n' + result.stderr;
+            if (result.exitCode === 0) {
+                this.log('Tests passed');
+                return {
+                    passed: true,
+                    errors: [],
+                    output,
+                    duration: Date.now() - startTime,
+                };
+            }
+            else {
+                this.log(`Tests failed with exit code ${result.exitCode}`);
+                errors.push(`Test command exited with code ${result.exitCode}`);
+                return {
+                    passed: false,
+                    errors,
+                    output,
+                    duration: Date.now() - startTime,
+                };
+            }
+        }
+        catch (error) {
+            errors.push(error instanceof Error ? error.message : 'Unknown error');
+            return {
+                passed: false,
+                errors,
+                output,
+                duration: Date.now() - startTime,
+            };
+        }
+    }
+    /**
+     * Cleanup sandbox directory.
+     */
+    async cleanup(sandboxDir) {
+        try {
+            await fs.rm(sandboxDir, { recursive: true, force: true });
+            this.log(`Cleaned up sandbox: ${sandboxDir}`);
+        }
+        catch (error) {
+            this.log(`Warning: Failed to cleanup sandbox: ${error}`);
+        }
+    }
+    /**
+     * Log message if verbose mode is enabled.
+     */
+    log(message) {
+        if (this.config.verbose) {
+            console.log(`[SandboxValidator] ${message}`);
+        }
+    }
+}
+/**
+ * Create a new sandbox validator.
+ *
+ * @param config - Configuration options
+ * @returns New SandboxValidator instance
+ */
+export function createSandbox(config) {
+    return new SandboxValidator(config);
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/evolution/sandbox.js.map

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

package/dist/evolution/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Evolution Types
+ *
+ * Type definitions for the evolution engine.
+ *
+ * @module @jclaw/core/evolution/types
+ */
+/**
+ * Evolution strategy types
+ */
+export type EvolutionStrategy = 'repair' | 'optimize' | 'innovate';
+/**
+ * Represents a mutation in the evolution process
+ */
+export interface Mutation {
+    /** Unique identifier for the mutation */
+    id: string;
+    /** The strategy used to generate this mutation */
+    strategy: EvolutionStrategy;
+    /** Original code or behavior */
+    original: string;
+    /** Mutated code or behavior */
+    mutated: string;
+    /** Description of the change */
+    description: string;
+    /** Timestamp when mutation was created */
+    createdAt: Date;
+    /** Fitness score (if evaluated) */
+    fitness?: number;
+}
+/**
+ * Result of mutation validation in sandbox
+ */
+export interface ValidationResult {
+    /** Whether the mutation passed validation */
+    passed: boolean;
+    /** Error messages if validation failed */
+    errors: string[];
+    /** Output from validation tests */
+    output?: string;
+    /** Duration of validation in milliseconds */
+    duration: number;
+}
+/**
+ * Configuration for evolution engine
+ */
+export interface EvolutionConfig {
+    /** Maximum mutations per evolution cycle */
+    maxMutations?: number;
+    /** Minimum fitness threshold for accepting mutations */
+    minFitness?: number;
+    /** Enable sandbox validation */
+    enableSandbox?: boolean;
+    /** Timeout for sandbox validation in milliseconds */
+    sandboxTimeout?: number;
+    /** Strategies to use for evolution */
+    strategies?: EvolutionStrategy[];
+}
+/**
+ * Gene representation for EvoMap integration
+ */
+export interface Gene {
+    /** Unique gene identifier */
+    id: string;
+    /** Gene type (behavior, knowledge, skill) */
+    type: 'behavior' | 'knowledge' | 'skill';
+    /** Gene content/code */
+    content: string;
+    /** Fitness score */
+    fitness: number;
+    /** Generation number */
+    generation: number;
+    /** Parent gene IDs */
+    parents: string[];
+    /** Creation timestamp */
+    createdAt: Date;
+}
+/**
+ * Evolution cycle result
+ */
+export interface EvolutionResult {
+    /** Whether evolution produced any improvements */
+    improved: boolean;
+    /** Mutations generated in this cycle */
+    mutations: Mutation[];
+    /** Mutations that passed validation */
+    validatedMutations: Mutation[];
+    /** Best mutation (if any) */
+    bestMutation?: Mutation;
+    /** Duration of the evolution cycle */
+    duration: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/evolution/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,SAAS,EAAE,IAAI,CAAC;IAChB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;IACzC,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,uCAAuC;IACvC,kBAAkB,EAAE,QAAQ,EAAE,CAAC;IAC/B,6BAA6B;IAC7B,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/evolution/types.js

@@ -0,0 +1,9 @@
+/**
+ * Evolution Types
+ *
+ * Type definitions for the evolution engine.
+ *
+ * @module @jclaw/core/evolution/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/evolution/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/evolution/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/executor/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Executor Module
+ *
+ * Re-exports executor interfaces and implementations.
+ *
+ * @module @jclaw/core/executor
+ */
+export type { Executor, ExecuteOptions, ExecuteResult } from './interface.js';
+export { LocalExecutor, createLocalExecutor } from './local.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/executor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/executor/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/executor/index.js

@@ -0,0 +1,10 @@
+/**
+ * Executor Module
+ *
+ * Re-exports executor interfaces and implementations.
+ *
+ * @module @jclaw/core/executor
+ */
+// Implementations
+export { LocalExecutor, createLocalExecutor } from './local.js';
+//# sourceMappingURL=index.js.map

package/dist/executor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/executor/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/executor/interface.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Executor Interface Module
+ *
+ * Re-exports the Executor interface and related types for the command execution system.
+ *
+ * @module @jclaw/core/executor/interface
+ */
+export type { Executor, ExecuteOptions, ExecuteResult } from '../types.js';
+//# sourceMappingURL=interface.d.ts.map

package/dist/executor/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/executor/interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/executor/interface.js

@@ -0,0 +1,9 @@
+/**
+ * Executor Interface Module
+ *
+ * Re-exports the Executor interface and related types for the command execution system.
+ *
+ * @module @jclaw/core/executor/interface
+ */
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/executor/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/executor/interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/executor/local.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Local Executor Implementation
+ *
+ * Executes shell commands locally using Node.js spawn.
+ * Supports Windows and Unix platforms with timeout control.
+ *
+ * @module @jclaw/core/executor/local
+ */
+import type { Executor, ExecuteOptions, ExecuteResult } from './interface.js';
+/**
+ * Local command executor using Node.js spawn
+ *
+ * Executes shell commands on the local system with support for:
+ * - Cross-platform execution (Windows/Unix)
+ * - Configurable timeout
+ * - Working directory and environment variable customization
+ */
+export declare class LocalExecutor implements Executor {
+    /** Execution mode identifier */
+    readonly mode: "local";
+    /**
+     * Execute a shell command locally
+     *
+     * @param command - The command to execute
+     * @param options - Execution options (timeout, cwd, env, etc.)
+     * @returns Promise resolving to execution result
+     */
+    execute(command: string, options?: ExecuteOptions): Promise<ExecuteResult>;
+}
+/**
+ * Create a new LocalExecutor instance
+ *
+ * @returns A new LocalExecutor instance
+ */
+export declare function createLocalExecutor(): LocalExecutor;
+//# sourceMappingURL=local.d.ts.map

package/dist/executor/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/executor/local.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAO9E;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC5C,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAEjC;;;;;;OAMG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC;CAgE1B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/executor/local.js

@@ -0,0 +1,95 @@
+/**
+ * Local Executor Implementation
+ *
+ * Executes shell commands locally using Node.js spawn.
+ * Supports Windows and Unix platforms with timeout control.
+ *
+ * @module @jclaw/core/executor/local
+ */
+import { spawn } from 'child_process';
+/**
+ * Default timeout for command execution (5 minutes)
+ */
+const DEFAULT_TIMEOUT = 5 * 60 * 1000;
+/**
+ * Local command executor using Node.js spawn
+ *
+ * Executes shell commands on the local system with support for:
+ * - Cross-platform execution (Windows/Unix)
+ * - Configurable timeout
+ * - Working directory and environment variable customization
+ */
+export class LocalExecutor {
+    /** Execution mode identifier */
+    mode = 'local';
+    /**
+     * Execute a shell command locally
+     *
+     * @param command - The command to execute
+     * @param options - Execution options (timeout, cwd, env, etc.)
+     * @returns Promise resolving to execution result
+     */
+    async execute(command, options) {
+        const startTime = Date.now();
+        const timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+        return new Promise((resolve) => {
+            let stdout = '';
+            let stderr = '';
+            let timedOut = false;
+            // Determine shell based on platform
+            const isWindows = process.platform === 'win32';
+            const shell = isWindows ? 'cmd.exe' : '/bin/sh';
+            const shellArgs = isWindows ? ['/c', command] : ['-c', command];
+            // Spawn the process
+            const proc = spawn(shell, shellArgs, {
+                cwd: options?.cwd,
+                env: { ...process.env, ...options?.env },
+                windowsHide: true,
+            });
+            // Set up timeout handler
+            const timeoutId = setTimeout(() => {
+                timedOut = true;
+                proc.kill('SIGKILL');
+            }, timeout);
+            // Collect stdout
+            proc.stdout.on('data', (data) => {
+                stdout += data.toString('utf8');
+            });
+            // Collect stderr
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString('utf8');
+            });
+            // Handle process completion
+            proc.on('close', (code) => {
+                clearTimeout(timeoutId);
+                const duration = Date.now() - startTime;
+                resolve({
+                    stdout,
+                    stderr,
+                    exitCode: timedOut ? 124 : (code ?? 1),
+                    duration,
+                });
+            });
+            // Handle process errors
+            proc.on('error', (error) => {
+                clearTimeout(timeoutId);
+                const duration = Date.now() - startTime;
+                resolve({
+                    stdout,
+                    stderr: error.message,
+                    exitCode: 1,
+                    duration,
+                });
+            });
+        });
+    }
+}
+/**
+ * Create a new LocalExecutor instance
+ *
+ * @returns A new LocalExecutor instance
+ */
+export function createLocalExecutor() {
+    return new LocalExecutor();
+}
+//# sourceMappingURL=local.js.map

package/dist/executor/local.js.map

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

package/dist/extension-system/capability-router.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Capability Router
+ *
+ * Routes capability requests to the appropriate extension.
+ *
+ * @module @jclaw/core/extension-system/capability-router
+ */
+import type { Capability } from '../types.js';
+import { ExtensionRegistry } from './registry.js';
+/**
+ * Capability resolution result
+ */
+export interface CapabilityResolution {
+    /** Name of the extension providing the capability */
+    extensionName: string;
+    /** The resolved capability */
+    capability: Capability;
+}
+/**
+ * Capability Router
+ *
+ * Provides capability lookup and routing functionality.
+ * Acts as a query interface over the extension registry.
+ */
+export declare class CapabilityRouter {
+    private readonly registry;
+    constructor(registry: ExtensionRegistry);
+    /**
+     * Resolve a capability by name
+     *
+     * @param capabilityName - Name of the capability to resolve
+     * @returns Capability resolution or null if not found
+     */
+    resolve(capabilityName: string): CapabilityResolution | null;
+    /**
+     * Check if a capability is available
+     *
+     * @param name - Capability name
+     * @returns True if capability is registered
+     */
+    hasCapability(name: string): boolean;
+    /**
+     * Get all available capability names
+     *
+     * @returns Array of capability names
+     */
+    getAvailableCapabilities(): string[];
+    /**
+     * Get all capabilities with their providers
+     *
+     * @returns Array of capability resolutions
+     */
+    getAllCapabilities(): CapabilityResolution[];
+    /**
+     * Get capabilities provided by a specific extension
+     *
+     * @param extensionName - Name of the extension
+     * @returns Array of capabilities or empty array if extension not found
+     */
+    getCapabilitiesByExtension(extensionName: string): Capability[];
+    /**
+     * Check if an extension provides a specific capability
+     *
+     * @param extensionName - Name of the extension
+     * @param capabilityName - Name of the capability
+     * @returns True if the extension provides the capability
+     */
+    extensionProvides(extensionName: string, capabilityName: string): boolean;
+    /**
+     * Find capability by partial name match
+     *
+     * @param partial - Partial capability name to search for
+     * @returns Array of matching capabilities
+     */
+    searchCapabilities(partial: string): CapabilityResolution[];
+    /**
+     * Get the extension name that provides a capability
+     *
+     * @param capabilityName - Name of the capability
+     * @returns Extension name or undefined if not found
+     */
+    getProvider(capabilityName: string): string | undefined;
+    /**
+     * Validate capability input against its schema
+     *
+     * @param capabilityName - Name of the capability
+     * @param input - Input to validate
+     * @returns True if valid, false if invalid or no schema defined
+     */
+    validateInput(capabilityName: string, input: unknown): boolean;
+    /**
+     * Basic input validation against schema
+     *
+     * Note: This is a simplified validation. For production use,
+     * integrate a proper JSON Schema validator like ajv.
+     */
+    private performBasicValidation;
+    /**
+     * Get capability statistics
+     */
+    get stats(): {
+        totalCapabilities: number;
+        capabilitiesByExtension: Map<string, number>;
+    };
+}
+//# sourceMappingURL=capability-router.d.ts.map

package/dist/extension-system/capability-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-router.d.ts","sourceRoot":"","sources":["../../src/extension-system/capability-router.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,iBAAiB;IAExD;;;;;OAKG;IACH,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAU5D;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;OAIG;IACH,wBAAwB,IAAI,MAAM,EAAE;IAIpC;;;;OAIG;IACH,kBAAkB,IAAI,oBAAoB,EAAE;IAO5C;;;;;OAKG;IACH,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,EAAE;IAI/D;;;;;;OAMG;IACH,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO;IAKzE;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAgB3D;;;;;OAKG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKvD;;;;;;OAMG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO;IAY9D;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;IACH,IAAI,KAAK,IAAI;QACX,iBAAiB,EAAE,MAAM,CAAC;QAC1B,uBAAuB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC9C,CAcA;CACF"}