@skillsmith/core 0.1.0

package/dist/src/activation/ActivationManager.d.ts

@@ -0,0 +1,141 @@
+/**
+ * @fileoverview Skill Activation Manager for one-click skill installation
+ * @module @skillsmith/core/activation/ActivationManager
+ * @see Phase 4: Trigger System Architecture - One-Click Activation
+ *
+ * Provides infrastructure for:
+ * - Pre-validation before activation
+ * - Background skill prefetching
+ * - Hot-reload activation (no restart)
+ * - Undo/rollback capability
+ *
+ * @example
+ * const manager = new ActivationManager();
+ * const result = await manager.activateSkill({
+ *   skill_id: 'anthropic/commit',
+ *   validate_first: true,
+ *   hot_reload: true
+ * });
+ */
+/**
+ * Options for skill activation
+ */
+export interface ActivationOptions {
+    /** Skill ID to activate */
+    skill_id: string;
+    /** Validate skill before activating (default: true) */
+    validate_first?: boolean;
+    /** Enable hot-reload without restart (default: true) */
+    hot_reload?: boolean;
+    /** Auto-configure with defaults (default: false) */
+    auto_configure?: boolean;
+    /** Force reinstall even if already installed */
+    force?: boolean;
+}
+/**
+ * Result of skill activation
+ */
+export interface ActivationResult {
+    /** Whether activation succeeded */
+    success: boolean;
+    /** Skill ID that was activated */
+    skill_id: string;
+    /** Time taken to activate (ms) */
+    activation_time_ms: number;
+    /** Whether Claude restart is required */
+    requires_restart: boolean;
+    /** Undo token for rollback (if successful) */
+    undo_token?: string;
+    /** Error message (if failed) */
+    error?: string;
+    /** Installation path */
+    install_path?: string;
+}
+/**
+ * Undo snapshot for rollback
+ */
+interface UndoSnapshot {
+    /** Unique undo token */
+    token: string;
+    /** Skill ID */
+    skill_id: string;
+    /** Installation path */
+    install_path: string;
+    /** Timestamp of activation */
+    activated_at: string;
+    /** Previous state (null if new installation) */
+    previous_state: {
+        existed: boolean;
+        backup_path?: string;
+    };
+}
+/**
+ * ActivationManager - Manages skill installation and activation
+ *
+ * Provides one-click skill activation with validation, prefetching,
+ * hot-reload, and rollback capabilities.
+ */
+export declare class ActivationManager {
+    private readonly skillsDir;
+    private readonly undoSnapshots;
+    private readonly prefetchCache;
+    constructor(skillsDir?: string);
+    /**
+     * Activate a skill with optional validation and hot-reload
+     *
+     * @param options - Activation options
+     * @returns Activation result
+     */
+    activateSkill(options: ActivationOptions): Promise<ActivationResult>;
+    /**
+     * Undo a previous activation using undo token
+     *
+     * @param undoToken - Undo token from activation
+     * @returns Whether undo succeeded
+     */
+    undo(undoToken: string): Promise<boolean>;
+    /**
+     * Check if a skill is already installed
+     */
+    private isInstalled;
+    /**
+     * Get installation path for a skill
+     */
+    private getInstallPath;
+    /**
+     * Validate skill before activation
+     */
+    private validateSkill;
+    /**
+     * Prefetch skill metadata and files
+     */
+    private prefetchSkill;
+    /**
+     * Install skill to filesystem
+     */
+    private installSkill;
+    /**
+     * Create backup of existing installation
+     */
+    private createBackup;
+    /**
+     * Hot-reload skill without restarting Claude
+     *
+     * @returns Whether hot-reload succeeded
+     */
+    private hotReload;
+    /**
+     * Create undo snapshot for rollback
+     */
+    private createUndoSnapshot;
+    /**
+     * Get all undo snapshots
+     */
+    getUndoHistory(): UndoSnapshot[];
+    /**
+     * Clear undo history (e.g., on session end)
+     */
+    clearUndoHistory(): void;
+}
+export default ActivationManager;
+//# sourceMappingURL=ActivationManager.d.ts.map

package/dist/src/activation/ActivationManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivationManager.d.ts","sourceRoot":"","sources":["../../../src/activation/ActivationManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,oDAAoD;IACpD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,kBAAkB,EAAE,MAAM,CAAA;IAC1B,yCAAyC;IACzC,gBAAgB,EAAE,OAAO,CAAA;IACzB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,eAAe;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,gDAAgD;IAChD,cAAc,EAAE;QACd,OAAO,EAAE,OAAO,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAcD;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;gBAEpD,SAAS,CAAC,EAAE,MAAM;IAK9B;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmF1E;;;;;OAKG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA4B/C;;OAEG;YACW,WAAW;IAUzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;YACW,aAAa;IAyB3B;;OAEG;YACW,aAAa;IAY3B;;OAEG;YACW,YAAY;IAiB1B;;OAEG;YACW,YAAY;IAO1B;;;;OAIG;YACW,SAAS;IAiBvB;;OAEG;YACW,kBAAkB;IAuBhC;;OAEG;IACH,cAAc,IAAI,YAAY,EAAE;IAIhC;;OAEG;IACH,gBAAgB,IAAI,IAAI;CAIzB;AAED,eAAe,iBAAiB,CAAA"}

package/dist/src/activation/ActivationManager.js

@@ -0,0 +1,282 @@
+/**
+ * @fileoverview Skill Activation Manager for one-click skill installation
+ * @module @skillsmith/core/activation/ActivationManager
+ * @see Phase 4: Trigger System Architecture - One-Click Activation
+ *
+ * Provides infrastructure for:
+ * - Pre-validation before activation
+ * - Background skill prefetching
+ * - Hot-reload activation (no restart)
+ * - Undo/rollback capability
+ *
+ * @example
+ * const manager = new ActivationManager();
+ * const result = await manager.activateSkill({
+ *   skill_id: 'anthropic/commit',
+ *   validate_first: true,
+ *   hot_reload: true
+ * });
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { homedir } from 'os';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('ActivationManager');
+/**
+ * ActivationManager - Manages skill installation and activation
+ *
+ * Provides one-click skill activation with validation, prefetching,
+ * hot-reload, and rollback capabilities.
+ */
+export class ActivationManager {
+    skillsDir;
+    undoSnapshots = new Map();
+    prefetchCache = new Map();
+    constructor(skillsDir) {
+        this.skillsDir = skillsDir || path.join(homedir(), '.claude', 'skills');
+        log.info('ActivationManager initialized', { skillsDir: this.skillsDir });
+    }
+    /**
+     * Activate a skill with optional validation and hot-reload
+     *
+     * @param options - Activation options
+     * @returns Activation result
+     */
+    async activateSkill(options) {
+        const startTime = performance.now();
+        const { skill_id, validate_first = true, hot_reload = true, force = false } = options;
+        log.info('Activating skill', { skill_id, validate_first, hot_reload, force });
+        try {
+            // 1. Pre-validation
+            if (validate_first) {
+                const validation = await this.validateSkill(skill_id);
+                if (!validation.valid) {
+                    return {
+                        success: false,
+                        skill_id,
+                        activation_time_ms: 0,
+                        requires_restart: false,
+                        error: `Validation failed: ${validation.errors.join(', ')}`,
+                    };
+                }
+                if (validation.warnings.length > 0) {
+                    log.warn('Skill validation warnings', { skill_id, warnings: validation.warnings });
+                }
+            }
+            // 2. Check if already installed
+            const installPath = this.getInstallPath(skill_id);
+            const alreadyInstalled = await this.isInstalled(skill_id);
+            if (alreadyInstalled && !force) {
+                return {
+                    success: true,
+                    skill_id,
+                    activation_time_ms: Math.round(performance.now() - startTime),
+                    requires_restart: false,
+                    install_path: installPath,
+                };
+            }
+            // 3. Create backup if reinstalling
+            if (alreadyInstalled && force) {
+                await this.createBackup(skill_id, installPath);
+            }
+            // 4. Prefetch skill (if not cached)
+            await this.prefetchSkill(skill_id);
+            // 5. Install skill
+            await this.installSkill(skill_id, installPath);
+            // 6. Hot-reload (if supported)
+            let requiresRestart = true;
+            if (hot_reload) {
+                const reloaded = await this.hotReload(installPath);
+                requiresRestart = !reloaded;
+            }
+            // 7. Create undo snapshot
+            const undoToken = await this.createUndoSnapshot(skill_id, installPath, alreadyInstalled);
+            const endTime = performance.now();
+            return {
+                success: true,
+                skill_id,
+                activation_time_ms: Math.round(endTime - startTime),
+                requires_restart: requiresRestart,
+                undo_token: undoToken,
+                install_path: installPath,
+            };
+        }
+        catch (error) {
+            log.error('Skill activation failed', error instanceof Error ? error : undefined, { skill_id });
+            return {
+                success: false,
+                skill_id,
+                activation_time_ms: Math.round(performance.now() - startTime),
+                requires_restart: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    /**
+     * Undo a previous activation using undo token
+     *
+     * @param undoToken - Undo token from activation
+     * @returns Whether undo succeeded
+     */
+    async undo(undoToken) {
+        const snapshot = this.undoSnapshots.get(undoToken);
+        if (!snapshot) {
+            log.warn('Undo snapshot not found', { undoToken });
+            return false;
+        }
+        try {
+            if (snapshot.previous_state.existed && snapshot.previous_state.backup_path) {
+                // Restore from backup
+                await fs.rm(snapshot.install_path, { recursive: true, force: true });
+                await fs.rename(snapshot.previous_state.backup_path, snapshot.install_path);
+                log.info('Restored skill from backup', { skill_id: snapshot.skill_id });
+            }
+            else {
+                // Remove installation
+                await fs.rm(snapshot.install_path, { recursive: true, force: true });
+                log.info('Removed skill installation', { skill_id: snapshot.skill_id });
+            }
+            this.undoSnapshots.delete(undoToken);
+            return true;
+        }
+        catch (error) {
+            log.error('Undo failed', error instanceof Error ? error : undefined, { undoToken });
+            return false;
+        }
+    }
+    /**
+     * Check if a skill is already installed
+     */
+    async isInstalled(skillId) {
+        const installPath = this.getInstallPath(skillId);
+        try {
+            await fs.access(installPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get installation path for a skill
+     */
+    getInstallPath(skillId) {
+        // Convert skill ID to directory name (e.g., anthropic/commit -> anthropic-commit)
+        const dirName = skillId.replace('/', '-');
+        return path.join(this.skillsDir, dirName);
+    }
+    /**
+     * Validate skill before activation
+     */
+    async validateSkill(skillId) {
+        const errors = [];
+        const warnings = [];
+        // Basic ID validation
+        if (!skillId || skillId.trim().length === 0) {
+            errors.push('Skill ID cannot be empty');
+        }
+        if (!skillId.includes('/')) {
+            errors.push('Skill ID must be in format "author/name"');
+        }
+        // Check for valid characters
+        if (!/^[a-zA-Z0-9_-]+\/[a-zA-Z0-9_-]+$/.test(skillId)) {
+            errors.push('Skill ID contains invalid characters');
+        }
+        // In production, would fetch and validate skill manifest
+        // For now, just check basic structure
+        const valid = errors.length === 0;
+        return { valid, errors, warnings };
+    }
+    /**
+     * Prefetch skill metadata and files
+     */
+    async prefetchSkill(skillId) {
+        if (this.prefetchCache.has(skillId)) {
+            log.debug('Skill already prefetched', { skillId });
+            return;
+        }
+        // In production, this would download skill files in background
+        // For now, just mark as prefetched
+        this.prefetchCache.set(skillId, true);
+        log.debug('Skill prefetched', { skillId });
+    }
+    /**
+     * Install skill to filesystem
+     */
+    async installSkill(skillId, installPath) {
+        // Ensure skills directory exists
+        await fs.mkdir(this.skillsDir, { recursive: true });
+        // Ensure install directory exists
+        await fs.mkdir(installPath, { recursive: true });
+        // In production, this would copy skill files from registry/download
+        // For now, create a placeholder SKILL.md
+        const skillMdPath = path.join(installPath, 'SKILL.md');
+        const placeholder = `# ${skillId}\n\nSkill installed via one-click activation.\n`;
+        await fs.writeFile(skillMdPath, placeholder, 'utf-8');
+        log.info('Skill installed', { skillId, installPath });
+    }
+    /**
+     * Create backup of existing installation
+     */
+    async createBackup(skillId, installPath) {
+        const backupPath = `${installPath}.backup-${Date.now()}`;
+        await fs.rename(installPath, backupPath);
+        log.info('Created backup', { skillId, backupPath });
+        return backupPath;
+    }
+    /**
+     * Hot-reload skill without restarting Claude
+     *
+     * @returns Whether hot-reload succeeded
+     */
+    async hotReload(installPath) {
+        // In production, this would:
+        // 1. Notify Claude to reload skills
+        // 2. Re-parse SKILL.md
+        // 3. Update skill registry
+        //
+        // For now, just check if path exists
+        try {
+            await fs.access(installPath);
+            log.info('Hot-reload simulated', { installPath });
+            return true;
+        }
+        catch {
+            log.warn('Hot-reload failed', { installPath });
+            return false;
+        }
+    }
+    /**
+     * Create undo snapshot for rollback
+     */
+    async createUndoSnapshot(skillId, installPath, previouslyInstalled) {
+        const token = `undo-${skillId}-${Date.now()}`;
+        const snapshot = {
+            token,
+            skill_id: skillId,
+            install_path: installPath,
+            activated_at: new Date().toISOString(),
+            previous_state: {
+                existed: previouslyInstalled,
+            },
+        };
+        this.undoSnapshots.set(token, snapshot);
+        log.debug('Created undo snapshot', { token, skillId });
+        return token;
+    }
+    /**
+     * Get all undo snapshots
+     */
+    getUndoHistory() {
+        return Array.from(this.undoSnapshots.values());
+    }
+    /**
+     * Clear undo history (e.g., on session end)
+     */
+    clearUndoHistory() {
+        this.undoSnapshots.clear();
+        log.debug('Cleared undo history');
+    }
+}
+export default ActivationManager;
+//# sourceMappingURL=ActivationManager.js.map

package/dist/src/activation/ActivationManager.js.map

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

package/dist/src/activation/ZeroConfigActivator.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @fileoverview Zero-Config Skill Activation System
+ * @module @skillsmith/core/activation/ZeroConfigActivator
+ * @see Phase 4: Trigger System Architecture - Zero-Config Activation
+ *
+ * Enables activation of skills with configuration requirements by:
+ * - Injecting safe default values
+ * - Deferring configuration until first use
+ * - Providing configuration prompts on demand
+ *
+ * @example
+ * const activator = new ZeroConfigActivator(manager);
+ * const result = await activator.activate('community/api-client');
+ * // Skill is activated with defaults, user can configure later
+ */
+import type { ActivationManager, ActivationOptions, ActivationResult } from './ActivationManager.js';
+/**
+ * Skill configuration schema
+ */
+export interface SkillConfigSchema {
+    /** Configuration is required for this skill */
+    config_required: boolean;
+    /** Allow deferred configuration */
+    config_defer: boolean;
+    /** Default configuration values */
+    config_defaults?: Record<string, unknown>;
+    /** Configuration field definitions */
+    config_fields?: ConfigField[];
+}
+/**
+ * Configuration field definition
+ */
+export interface ConfigField {
+    /** Field name */
+    name: string;
+    /** Field type */
+    type: 'string' | 'number' | 'boolean' | 'url' | 'secret';
+    /** Field description */
+    description: string;
+    /** Whether field is required */
+    required: boolean;
+    /** Default value */
+    default?: unknown;
+    /** Validation pattern (for strings) */
+    pattern?: string;
+}
+/**
+ * Configuration status
+ */
+export interface ConfigStatus {
+    /** Whether skill has required configuration */
+    has_config: boolean;
+    /** Whether using default values */
+    using_defaults: boolean;
+    /** Whether user has customized config */
+    user_configured: boolean;
+    /** Configuration fields */
+    fields: ConfigField[];
+    /** Missing required fields */
+    missing_required: string[];
+}
+/**
+ * Zero-config activation options
+ */
+export interface ZeroConfigOptions extends Omit<ActivationOptions, 'auto_configure' | 'skill_id'> {
+    /** Skip configuration entirely (use defaults) */
+    skip_config?: boolean;
+}
+/**
+ * ZeroConfigActivator - Activates skills with automatic default configuration
+ *
+ * Handles skills that require configuration by:
+ * 1. Checking if defaults are available
+ * 2. Injecting defaults during installation
+ * 3. Marking skill as "needs configuration"
+ * 4. Providing configure endpoint for customization
+ */
+export declare class ZeroConfigActivator {
+    private readonly activationManager;
+    constructor(activationManager: ActivationManager);
+    /**
+     * Activate a skill with zero-config defaults
+     *
+     * @param skillId - Skill ID to activate
+     * @param options - Activation options
+     * @returns Activation result with configuration status
+     */
+    activate(skillId: string, options?: ZeroConfigOptions): Promise<ActivationResult & {
+        config_status?: ConfigStatus;
+    }>;
+    /**
+     * Activate skill with default configuration values
+     */
+    private activateWithDefaults;
+    /**
+     * Inject default configuration into skill directory
+     */
+    private injectDefaultConfig;
+    /**
+     * Get configuration schema for a skill
+     *
+     * In production, this would fetch from skill registry
+     * For now, returns mock schema based on skill ID
+     */
+    private getConfigSchema;
+    /**
+     * Get current configuration status for a skill
+     */
+    getConfigStatus(skillId: string, configSchema?: SkillConfigSchema): Promise<ConfigStatus>;
+    /**
+     * Check if a skill needs configuration
+     *
+     * @param skillId - Skill ID to check
+     * @returns Whether skill needs user configuration
+     */
+    needsConfiguration(skillId: string): Promise<boolean>;
+    /**
+     * Generate configuration prompt for user
+     *
+     * @param skillId - Skill ID
+     * @returns Configuration instructions
+     */
+    getConfigurationPrompt(skillId: string): Promise<string>;
+}
+export default ZeroConfigActivator;
+//# sourceMappingURL=ZeroConfigActivator.d.ts.map

package/dist/src/activation/ZeroConfigActivator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZeroConfigActivator.d.ts","sourceRoot":"","sources":["../../../src/activation/ZeroConfigActivator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAIpG;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,eAAe,EAAE,OAAO,CAAA;IACxB,mCAAmC;IACnC,YAAY,EAAE,OAAO,CAAA;IACrB,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,sCAAsC;IACtC,aAAa,CAAC,EAAE,WAAW,EAAE,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB;IACjB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAA;IACxD,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,gCAAgC;IAChC,QAAQ,EAAE,OAAO,CAAA;IACjB,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAA;IACnB,mCAAmC;IACnC,cAAc,EAAE,OAAO,CAAA;IACvB,yCAAyC;IACzC,eAAe,EAAE,OAAO,CAAA;IACxB,2BAA2B;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,8BAA8B;IAC9B,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,gBAAgB,GAAG,UAAU,CAAC;IAC/F,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,iBAAiB;IAIjE;;;;;;OAMG;IACG,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,GAAG;QAAE,aAAa,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;IA0C/D;;OAEG;YACW,oBAAoB;IA8BlC;;OAEG;YACW,mBAAmB;IAoCjC;;;;;OAKG;YACW,eAAe;IAoD7B;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IA6B/F;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3D;;;;;OAKG;IACG,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAiC/D;AAED,eAAe,mBAAmB,CAAA"}