@jclaw/core 0.1.0

package/dist/extension-system/capability-router.js

@@ -0,0 +1,167 @@
+/**
+ * Capability Router
+ *
+ * Routes capability requests to the appropriate extension.
+ *
+ * @module @jclaw/core/extension-system/capability-router
+ */
+/**
+ * Capability Router
+ *
+ * Provides capability lookup and routing functionality.
+ * Acts as a query interface over the extension registry.
+ */
+export class CapabilityRouter {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Resolve a capability by name
+     *
+     * @param capabilityName - Name of the capability to resolve
+     * @returns Capability resolution or null if not found
+     */
+    resolve(capabilityName) {
+        const registered = this.registry.getCapability(capabilityName);
+        if (!registered)
+            return null;
+        return {
+            extensionName: registered.extension,
+            capability: registered.capability,
+        };
+    }
+    /**
+     * Check if a capability is available
+     *
+     * @param name - Capability name
+     * @returns True if capability is registered
+     */
+    hasCapability(name) {
+        return this.registry.hasCapability(name);
+    }
+    /**
+     * Get all available capability names
+     *
+     * @returns Array of capability names
+     */
+    getAvailableCapabilities() {
+        return this.registry.getCapabilityNames();
+    }
+    /**
+     * Get all capabilities with their providers
+     *
+     * @returns Array of capability resolutions
+     */
+    getAllCapabilities() {
+        return this.registry.getAllCapabilities().map((reg) => ({
+            extensionName: reg.extension,
+            capability: reg.capability,
+        }));
+    }
+    /**
+     * 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) {
+        return this.registry.getCapabilitiesByExtension(extensionName);
+    }
+    /**
+     * 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, capabilityName) {
+        const registered = this.registry.getCapability(capabilityName);
+        return registered?.extension === extensionName;
+    }
+    /**
+     * Find capability by partial name match
+     *
+     * @param partial - Partial capability name to search for
+     * @returns Array of matching capabilities
+     */
+    searchCapabilities(partial) {
+        const lowerPartial = partial.toLowerCase();
+        const results = [];
+        for (const registered of this.registry.getAllCapabilities()) {
+            if (registered.capability.name.toLowerCase().includes(lowerPartial)) {
+                results.push({
+                    extensionName: registered.extension,
+                    capability: registered.capability,
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Get the extension name that provides a capability
+     *
+     * @param capabilityName - Name of the capability
+     * @returns Extension name or undefined if not found
+     */
+    getProvider(capabilityName) {
+        const registered = this.registry.getCapability(capabilityName);
+        return registered?.extension;
+    }
+    /**
+     * 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, input) {
+        const registered = this.registry.getCapability(capabilityName);
+        if (!registered)
+            return false;
+        const schema = registered.capability.inputSchema;
+        if (!schema)
+            return true; // No schema means no validation required
+        // Basic schema validation - in a real implementation,
+        // this would use a proper JSON Schema validator
+        return this.performBasicValidation(input, schema);
+    }
+    /**
+     * Basic input validation against schema
+     *
+     * Note: This is a simplified validation. For production use,
+     * integrate a proper JSON Schema validator like ajv.
+     */
+    performBasicValidation(input, schema) {
+        if (!input || typeof input !== 'object') {
+            return schema.type === 'null' || schema.type === undefined;
+        }
+        const schemaType = schema.type;
+        if (schemaType === 'object') {
+            const required = schema.required;
+            if (required && Array.isArray(required)) {
+                const inputObj = input;
+                for (const field of required) {
+                    if (!(field in inputObj)) {
+                        return false;
+                    }
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Get capability statistics
+     */
+    get stats() {
+        const capabilitiesByExtension = new Map();
+        for (const extension of this.registry.getAll()) {
+            capabilitiesByExtension.set(extension.name, extension.capabilities.length);
+        }
+        return {
+            totalCapabilities: this.registry.capabilityCount,
+            capabilitiesByExtension,
+        };
+    }
+}
+//# sourceMappingURL=capability-router.js.map

package/dist/extension-system/capability-router.js.map

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

package/dist/extension-system/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Extension System Module
+ *
+ * Provides extension registration, loading, and capability routing.
+ *
+ * @module @jclaw/core/extension-system
+ */
+export { ExtensionRegistry, type RegisteredCapability } from './registry.js';
+export { ExtensionLoader, type LoadOptions, type LoadResult, } from './loader.js';
+export { CapabilityRouter, type CapabilityResolution, } from './capability-router.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/extension-system/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extension-system/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC"}

package/dist/extension-system/index.js

@@ -0,0 +1,11 @@
+/**
+ * Extension System Module
+ *
+ * Provides extension registration, loading, and capability routing.
+ *
+ * @module @jclaw/core/extension-system
+ */
+export { ExtensionRegistry } from './registry.js';
+export { ExtensionLoader, } from './loader.js';
+export { CapabilityRouter, } from './capability-router.js';
+//# sourceMappingURL=index.js.map

package/dist/extension-system/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extension-system/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAA6B,MAAM,eAAe,CAAC;AAC7E,OAAO,EACL,eAAe,GAGhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC"}

package/dist/extension-system/loader.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Extension Loader
+ *
+ * Handles loading, validating, and unloading extensions.
+ *
+ * @module @jclaw/core/extension-system/loader
+ */
+import type { Extension } from '../types.js';
+import { ExtensionRegistry } from './registry.js';
+/**
+ * Options for extension loading
+ */
+export interface LoadOptions {
+    /** Skip dependency resolution */
+    skipDependencies?: boolean;
+}
+/**
+ * Result of extension loading
+ */
+export interface LoadResult {
+    /** Whether loading succeeded */
+    success: boolean;
+    /** Error message if loading failed */
+    error?: string;
+}
+/**
+ * Extension Loader
+ *
+ * Responsible for loading and unloading extensions with lifecycle management.
+ */
+export declare class ExtensionLoader {
+    private readonly registry;
+    constructor(registry: ExtensionRegistry);
+    /**
+     * Load an extension into the registry
+     *
+     * This method:
+     * 1. Validates the extension structure
+     * 2. Calls the extension's install lifecycle method
+     * 3. Registers the extension with the registry
+     *
+     * @param extension - The extension to load
+     * @param runtime - Optional runtime context to pass to install
+     * @param options - Loading options
+     * @returns Load result indicating success or failure
+     */
+    load(extension: Extension, runtime?: unknown, options?: LoadOptions): Promise<LoadResult>;
+    /**
+     * Unload an extension from the registry
+     *
+     * This method:
+     * 1. Calls the extension's uninstall lifecycle method
+     * 2. Removes the extension from the registry
+     *
+     * @param name - Name of the extension to unload
+     * @returns Load result indicating success or failure
+     */
+    unload(name: string): Promise<LoadResult>;
+    /**
+     * Load multiple extensions in dependency order
+     *
+     * @param extensions - Extensions to load
+     * @param runtime - Optional runtime context
+     * @returns Map of extension names to load results
+     */
+    loadAll(extensions: Extension[], runtime?: unknown): Promise<Map<string, LoadResult>>;
+    /**
+     * Unload all registered extensions
+     *
+     * @returns Map of extension names to unload results
+     */
+    unloadAll(): Promise<Map<string, LoadResult>>;
+    /**
+     * Validate an extension object
+     *
+     * @param extension - Extension to validate
+     * @returns Error message or null if valid
+     */
+    validateExtension(extension: unknown): string | null;
+    /**
+     * Validate a capability object
+     */
+    private validateCapability;
+    /**
+     * Find extensions that depend on a given extension
+     */
+    private findDependents;
+    /**
+     * Sort extensions by their dependencies (topological sort)
+     */
+    private sortByDependencies;
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/extension-system/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/extension-system/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,iBAAiB;IAExD;;;;;;;;;;;;OAYG;IACG,IAAI,CACR,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC;IA8CtB;;;;;;;;;OASG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAoC/C;;;;;;OAMG;IACG,OAAO,CACX,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAYnC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAcnD;;;;;OAKG;IACH,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IA4CpD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAoC3B"}

package/dist/extension-system/loader.js

@@ -0,0 +1,245 @@
+/**
+ * Extension Loader
+ *
+ * Handles loading, validating, and unloading extensions.
+ *
+ * @module @jclaw/core/extension-system/loader
+ */
+/**
+ * Extension Loader
+ *
+ * Responsible for loading and unloading extensions with lifecycle management.
+ */
+export class ExtensionLoader {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Load an extension into the registry
+     *
+     * This method:
+     * 1. Validates the extension structure
+     * 2. Calls the extension's install lifecycle method
+     * 3. Registers the extension with the registry
+     *
+     * @param extension - The extension to load
+     * @param runtime - Optional runtime context to pass to install
+     * @param options - Loading options
+     * @returns Load result indicating success or failure
+     */
+    async load(extension, runtime, options) {
+        try {
+            // Validate extension structure
+            const validationError = this.validateExtension(extension);
+            if (validationError) {
+                return { success: false, error: validationError };
+            }
+            // Check for existing registration
+            if (this.registry.has(extension.name)) {
+                return {
+                    success: false,
+                    error: `Extension "${extension.name}" is already loaded`,
+                };
+            }
+            // Check dependencies if not skipped
+            if (!options?.skipDependencies && extension.dependencies) {
+                const missingDeps = extension.dependencies.filter((dep) => !this.registry.has(dep));
+                if (missingDeps.length > 0) {
+                    return {
+                        success: false,
+                        error: `Missing required dependencies: ${missingDeps.join(', ')}`,
+                    };
+                }
+            }
+            // Call install lifecycle method
+            if (extension.install) {
+                await extension.install(runtime);
+            }
+            // Register the extension
+            this.registry.register(extension);
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    /**
+     * Unload an extension from the registry
+     *
+     * This method:
+     * 1. Calls the extension's uninstall lifecycle method
+     * 2. Removes the extension from the registry
+     *
+     * @param name - Name of the extension to unload
+     * @returns Load result indicating success or failure
+     */
+    async unload(name) {
+        try {
+            const extension = this.registry.get(name);
+            if (!extension) {
+                return {
+                    success: false,
+                    error: `Extension "${name}" is not loaded`,
+                };
+            }
+            // Check if other extensions depend on this one
+            const dependents = this.findDependents(name);
+            if (dependents.length > 0) {
+                return {
+                    success: false,
+                    error: `Cannot unload: extensions [${dependents.join(', ')}] depend on "${name}"`,
+                };
+            }
+            // Call uninstall lifecycle method
+            if (extension.uninstall) {
+                await extension.uninstall();
+            }
+            // Unregister the extension
+            this.registry.unregister(name);
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    /**
+     * Load multiple extensions in dependency order
+     *
+     * @param extensions - Extensions to load
+     * @param runtime - Optional runtime context
+     * @returns Map of extension names to load results
+     */
+    async loadAll(extensions, runtime) {
+        const results = new Map();
+        const sorted = this.sortByDependencies(extensions);
+        for (const extension of sorted) {
+            const result = await this.load(extension, runtime);
+            results.set(extension.name, result);
+        }
+        return results;
+    }
+    /**
+     * Unload all registered extensions
+     *
+     * @returns Map of extension names to unload results
+     */
+    async unloadAll() {
+        const results = new Map();
+        // Unload in reverse dependency order
+        const names = [...this.registry.getNames()].reverse();
+        for (const name of names) {
+            const result = await this.unload(name);
+            results.set(name, result);
+        }
+        return results;
+    }
+    /**
+     * Validate an extension object
+     *
+     * @param extension - Extension to validate
+     * @returns Error message or null if valid
+     */
+    validateExtension(extension) {
+        if (!extension || typeof extension !== 'object') {
+            return 'Extension must be an object';
+        }
+        const ext = extension;
+        if (!ext.name || typeof ext.name !== 'string') {
+            return 'Extension must have a string "name" property';
+        }
+        if (!ext.version || typeof ext.version !== 'string') {
+            return 'Extension must have a string "version" property';
+        }
+        if (!ext.description || typeof ext.description !== 'string') {
+            return 'Extension must have a string "description" property';
+        }
+        if (!Array.isArray(ext.capabilities)) {
+            return 'Extension must have an array "capabilities" property';
+        }
+        // Validate each capability
+        for (let i = 0; i < ext.capabilities.length; i++) {
+            const capError = this.validateCapability(ext.capabilities[i], i);
+            if (capError)
+                return capError;
+        }
+        // Validate dependencies if present
+        if (ext.dependencies !== undefined && !Array.isArray(ext.dependencies)) {
+            return 'Extension "dependencies" must be an array of strings';
+        }
+        if (ext.optionalDependencies !== undefined &&
+            !Array.isArray(ext.optionalDependencies)) {
+            return 'Extension "optionalDependencies" must be an array of strings';
+        }
+        return null;
+    }
+    /**
+     * Validate a capability object
+     */
+    validateCapability(capability, index) {
+        if (!capability || typeof capability !== 'object') {
+            return `Capability at index ${index} must be an object`;
+        }
+        const cap = capability;
+        if (!cap.name || typeof cap.name !== 'string') {
+            return `Capability at index ${index} must have a string "name" property`;
+        }
+        if (!cap.description || typeof cap.description !== 'string') {
+            return `Capability at index ${index} must have a string "description" property`;
+        }
+        return null;
+    }
+    /**
+     * Find extensions that depend on a given extension
+     */
+    findDependents(name) {
+        const dependents = [];
+        for (const ext of this.registry.getAll()) {
+            if (ext.dependencies?.includes(name)) {
+                dependents.push(ext.name);
+            }
+        }
+        return dependents;
+    }
+    /**
+     * Sort extensions by their dependencies (topological sort)
+     */
+    sortByDependencies(extensions) {
+        const sorted = [];
+        const visited = new Set();
+        const visiting = new Set();
+        const visit = (extension) => {
+            if (visited.has(extension.name))
+                return true;
+            if (visiting.has(extension.name))
+                return false; // Circular dependency
+            visiting.add(extension.name);
+            // Visit dependencies first
+            if (extension.dependencies) {
+                for (const depName of extension.dependencies) {
+                    const dep = extensions.find((e) => e.name === depName);
+                    if (dep && !visit(dep)) {
+                        return false;
+                    }
+                }
+            }
+            visiting.delete(extension.name);
+            visited.add(extension.name);
+            sorted.push(extension);
+            return true;
+        };
+        for (const extension of extensions) {
+            if (!visited.has(extension.name)) {
+                visit(extension);
+            }
+        }
+        return sorted;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/extension-system/loader.js.map

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

package/dist/extension-system/registry.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Extension Registry
+ *
+ * Manages registration and lookup of extensions and their capabilities.
+ *
+ * @module @jclaw/core/extension-system/registry
+ */
+import type { Extension, Capability } from '../types.js';
+/**
+ * Represents a registered capability with its source extension
+ */
+export interface RegisteredCapability {
+    /** Name of the extension providing this capability */
+    extension: string;
+    /** The capability definition */
+    capability: Capability;
+}
+/**
+ * Extension Registry
+ *
+ * Central registry for managing extensions and their capabilities.
+ * Provides O(1) lookup for both extensions and capabilities.
+ */
+export declare class ExtensionRegistry {
+    private readonly extensions;
+    private readonly capabilities;
+    /**
+     * Register an extension and all its capabilities
+     *
+     * @param extension - The extension to register
+     * @throws Error if extension with same name is already registered
+     */
+    register(extension: Extension): void;
+    /**
+     * Unregister an extension and all its capabilities
+     *
+     * @param name - Name of the extension to unregister
+     */
+    unregister(name: string): void;
+    /**
+     * Get an extension by name
+     *
+     * @param name - Extension name
+     * @returns The extension or undefined if not found
+     */
+    get(name: string): Extension | undefined;
+    /**
+     * Check if an extension is registered
+     *
+     * @param name - Extension name
+     * @returns True if extension is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered extensions
+     *
+     * @returns Array of all extensions
+     */
+    getAll(): Extension[];
+    /**
+     * Get all extension names
+     *
+     * @returns Array of extension names
+     */
+    getNames(): string[];
+    /**
+     * Get a registered capability by name
+     *
+     * @param name - Capability name
+     * @returns The registered capability or undefined if not found
+     */
+    getCapability(name: string): RegisteredCapability | undefined;
+    /**
+     * Check if a capability is registered
+     *
+     * @param name - Capability name
+     * @returns True if capability is registered
+     */
+    hasCapability(name: string): boolean;
+    /**
+     * Get all registered capabilities
+     *
+     * @returns Array of all registered capabilities
+     */
+    getAllCapabilities(): RegisteredCapability[];
+    /**
+     * Get all capability names
+     *
+     * @returns Array of capability names
+     */
+    getCapabilityNames(): string[];
+    /**
+     * 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[];
+    /**
+     * Clear all registered extensions and capabilities
+     */
+    clear(): void;
+    /**
+     * Get the number of registered extensions
+     */
+    get size(): number;
+    /**
+     * Get the number of registered capabilities
+     */
+    get capabilityCount(): number;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/extension-system/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/extension-system/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgD;IAE7E;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IA4BpC;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAa9B;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIxC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;OAIG;IACH,MAAM,IAAI,SAAS,EAAE;IAIrB;;;;OAIG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAI7D;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;OAIG;IACH,kBAAkB,IAAI,oBAAoB,EAAE;IAI5C;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;;;;OAKG;IACH,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,EAAE;IAK/D;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;CACF"}