ai-props 2.1.3 → 2.3.0

package/dist/cache.js

@@ -1,183 +0,0 @@
-/**
- * Props caching for ai-props
- *
- * Provides in-memory caching for generated props to avoid
- * redundant AI calls with the same context.
- *
- * @packageDocumentation
- */
-/**
- * Default cache TTL (5 minutes)
- */
-export const DEFAULT_CACHE_TTL = 5 * 60 * 1000;
-/**
- * Create a cache key from schema and context
- */
-export function createCacheKey(schema, context) {
-    const schemaStr = typeof schema === 'string' ? schema : JSON.stringify(schema);
-    const contextStr = context ? JSON.stringify(sortObject(context)) : '';
-    return `${hashString(schemaStr)}:${hashString(contextStr)}`;
-}
-/**
- * Simple string hash function
- */
-function hashString(str) {
-    let hash = 0;
-    for (let i = 0; i < str.length; i++) {
-        const char = str.charCodeAt(i);
-        hash = ((hash << 5) - hash) + char;
-        hash = hash & hash; // Convert to 32-bit integer
-    }
-    return hash.toString(36);
-}
-/**
- * Sort object keys for consistent hashing
- */
-function sortObject(obj) {
-    const sorted = {};
-    for (const key of Object.keys(obj).sort()) {
-        const value = obj[key];
-        sorted[key] = value && typeof value === 'object' && !Array.isArray(value)
-            ? sortObject(value)
-            : value;
-    }
-    return sorted;
-}
-/**
- * In-memory props cache implementation
- */
-export class MemoryPropsCache {
-    cache = new Map();
-    ttl;
-    constructor(ttl = DEFAULT_CACHE_TTL) {
-        this.ttl = ttl;
-    }
-    get(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return undefined;
-        // Check if expired
-        if (Date.now() - entry.timestamp > this.ttl) {
-            this.cache.delete(key);
-            return undefined;
-        }
-        return entry;
-    }
-    set(key, props) {
-        this.cache.set(key, {
-            props,
-            timestamp: Date.now(),
-            key
-        });
-    }
-    delete(key) {
-        return this.cache.delete(key);
-    }
-    clear() {
-        this.cache.clear();
-    }
-    get size() {
-        return this.cache.size;
-    }
-    /**
-     * Remove expired entries
-     */
-    cleanup() {
-        const now = Date.now();
-        let removed = 0;
-        for (const [key, entry] of this.cache) {
-            if (now - entry.timestamp > this.ttl) {
-                this.cache.delete(key);
-                removed++;
-            }
-        }
-        return removed;
-    }
-    /**
-     * Get all entries (for debugging)
-     */
-    entries() {
-        return this.cache.entries();
-    }
-}
-/**
- * Global default cache instance
- */
-let defaultCache = null;
-/**
- * Get or create the default cache
- */
-export function getDefaultCache() {
-    if (!defaultCache) {
-        defaultCache = new MemoryPropsCache();
-    }
-    return defaultCache;
-}
-/**
- * Configure the default cache
- */
-export function configureCache(ttl) {
-    defaultCache = new MemoryPropsCache(ttl);
-}
-/**
- * Clear the default cache
- */
-export function clearCache() {
-    if (defaultCache) {
-        defaultCache.clear();
-    }
-}
-/**
- * LRU (Least Recently Used) cache implementation
- * For scenarios where memory usage needs to be bounded
- */
-export class LRUPropsCache {
-    cache = new Map();
-    maxSize;
-    ttl;
-    constructor(maxSize = 100, ttl = DEFAULT_CACHE_TTL) {
-        this.maxSize = maxSize;
-        this.ttl = ttl;
-    }
-    get(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return undefined;
-        // Check if expired
-        if (Date.now() - entry.timestamp > this.ttl) {
-            this.cache.delete(key);
-            return undefined;
-        }
-        // Move to end (most recently used)
-        this.cache.delete(key);
-        this.cache.set(key, entry);
-        return entry;
-    }
-    set(key, props) {
-        // Remove oldest entries if at capacity
-        while (this.cache.size >= this.maxSize) {
-            const oldest = this.cache.keys().next().value;
-            if (oldest) {
-                this.cache.delete(oldest);
-            }
-            else {
-                break;
-            }
-        }
-        this.cache.set(key, {
-            props,
-            timestamp: Date.now(),
-            key
-        });
-    }
-    delete(key) {
-        return this.cache.delete(key);
-    }
-    clear() {
-        this.cache.clear();
-    }
-    get size() {
-        return this.cache.size;
-    }
-}
-//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/generate.d.ts

@@ -1,69 +0,0 @@
-/**
- * Props generation for ai-props
- *
- * Core functionality for generating component props using AI.
- *
- * @packageDocumentation
- */
-import type { PropSchema, GeneratePropsOptions, GeneratePropsResult, AIPropsConfig } from './types.js';
-/**
- * Configure global AI props settings
- */
-export declare function configureAIProps(config: Partial<AIPropsConfig>): void;
-/**
- * Get current configuration
- */
-export declare function getConfig(): AIPropsConfig;
-/**
- * Reset configuration to defaults
- */
-export declare function resetConfig(): void;
-/**
- * Generate props using AI
- *
- * @example
- * ```ts
- * const result = await generateProps({
- *   schema: {
- *     title: 'A compelling page title',
- *     description: 'A brief description',
- *     keywords: ['Relevant SEO keywords'],
- *   },
- *   context: { topic: 'AI-powered applications' },
- * })
- *
- * console.log(result.props)
- * // { title: '...', description: '...', keywords: [...] }
- * ```
- */
-export declare function generateProps<T = Record<string, unknown>>(options: GeneratePropsOptions): Promise<GeneratePropsResult<T>>;
-/**
- * Generate props synchronously from cache or throw
- *
- * Useful for SSR scenarios where async isn't available.
- * Throws if props aren't in cache.
- */
-export declare function getPropsSync<T = Record<string, unknown>>(schema: PropSchema, context?: Record<string, unknown>): T;
-/**
- * Pre-generate props for warming the cache
- *
- * @example
- * ```ts
- * await prefetchProps([
- *   { schema: userProfileSchema, context: { userId: '123' } },
- *   { schema: productSchema, context: { category: 'electronics' } },
- * ])
- * ```
- */
-export declare function prefetchProps(requests: GeneratePropsOptions[]): Promise<void>;
-/**
- * Generate multiple prop sets in parallel
- */
-export declare function generatePropsMany<T = Record<string, unknown>>(requests: GeneratePropsOptions[]): Promise<GeneratePropsResult<T>[]>;
-/**
- * Merge partial props with generated props
- *
- * Generates only the missing props, keeping provided ones.
- */
-export declare function mergeWithGenerated<T extends Record<string, unknown>>(schema: PropSchema, partialProps: Partial<T>, options?: Omit<GeneratePropsOptions, 'schema' | 'context'>): Promise<T>;
-//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAA;AAiBnB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,aAAa,CAEzC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAiDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAkEjC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,CAAC,CAYH;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,oBAAoB,EAAE,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,QAAQ,EAAE,oBAAoB,EAAE,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAEnC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,SAAS,CAAC,GACzD,OAAO,CAAC,CAAC,CAAC,CA8BZ"}

package/dist/generate.js

@@ -1,221 +0,0 @@
-/**
- * Props generation for ai-props
- *
- * Core functionality for generating component props using AI.
- *
- * @packageDocumentation
- */
-import { generateObject, schema as createSchema } from 'ai-functions';
-import { createCacheKey, getDefaultCache } from './cache.js';
-/**
- * Default configuration
- */
-const DEFAULT_CONFIG = {
-    model: 'sonnet',
-    cache: true,
-    cacheTTL: 5 * 60 * 1000, // 5 minutes
-};
-/**
- * Global configuration
- */
-let globalConfig = { ...DEFAULT_CONFIG };
-/**
- * Configure global AI props settings
- */
-export function configureAIProps(config) {
-    globalConfig = { ...globalConfig, ...config };
-}
-/**
- * Get current configuration
- */
-export function getConfig() {
-    return { ...globalConfig };
-}
-/**
- * Reset configuration to defaults
- */
-export function resetConfig() {
-    globalConfig = { ...DEFAULT_CONFIG };
-}
-/**
- * Resolve a prop schema to a SimpleSchema
- *
- * If the schema is a string, it's treated as a named type
- * that generates a single property or description.
- */
-function resolveSchema(schema) {
-    if (typeof schema === 'string') {
-        // Named type or description string
-        return { value: schema };
-    }
-    return schema;
-}
-/**
- * Build a prompt from context and schema
- */
-function buildPrompt(schema, context, additionalPrompt) {
-    const parts = [];
-    // Add context information
-    if (context && Object.keys(context).length > 0) {
-        parts.push('Given the following context:');
-        parts.push(JSON.stringify(context, null, 2));
-        parts.push('');
-    }
-    // Add schema information
-    if (typeof schema === 'string') {
-        parts.push(`Generate a value for: ${schema}`);
-    }
-    else {
-        parts.push('Generate props matching the schema.');
-    }
-    // Add additional prompt
-    if (additionalPrompt) {
-        parts.push('');
-        parts.push(additionalPrompt);
-    }
-    return parts.join('\n');
-}
-/**
- * Generate props using AI
- *
- * @example
- * ```ts
- * const result = await generateProps({
- *   schema: {
- *     title: 'A compelling page title',
- *     description: 'A brief description',
- *     keywords: ['Relevant SEO keywords'],
- *   },
- *   context: { topic: 'AI-powered applications' },
- * })
- *
- * console.log(result.props)
- * // { title: '...', description: '...', keywords: [...] }
- * ```
- */
-export async function generateProps(options) {
-    const { schema, context, prompt, model, system } = options;
-    const config = getConfig();
-    const startTime = Date.now();
-    // Check cache
-    if (config.cache) {
-        const cache = getDefaultCache();
-        const cacheKey = createCacheKey(schema, context);
-        const cached = cache.get(cacheKey);
-        if (cached) {
-            return {
-                props: cached.props,
-                cached: true,
-                metadata: {
-                    model: config.model || 'cached',
-                },
-            };
-        }
-    }
-    // Resolve schema
-    const resolvedSchema = resolveSchema(schema);
-    // Build prompt
-    const fullPrompt = buildPrompt(schema, context, prompt);
-    // Use custom generator if provided
-    if (config.generate) {
-        const props = await config.generate(resolvedSchema, context || {});
-        return {
-            props,
-            cached: false,
-            metadata: {
-                model: 'custom',
-                duration: Date.now() - startTime,
-            },
-        };
-    }
-    // Generate using AI
-    const result = await generateObject({
-        model: model || config.model || 'sonnet',
-        schema: resolvedSchema,
-        prompt: fullPrompt,
-        system: system || config.system,
-    });
-    const props = result.object;
-    // Cache result
-    if (config.cache) {
-        const cache = getDefaultCache();
-        const cacheKey = createCacheKey(schema, context);
-        cache.set(cacheKey, props);
-    }
-    return {
-        props,
-        cached: false,
-        metadata: {
-            model: model || config.model || 'sonnet',
-            duration: Date.now() - startTime,
-        },
-    };
-}
-/**
- * Generate props synchronously from cache or throw
- *
- * Useful for SSR scenarios where async isn't available.
- * Throws if props aren't in cache.
- */
-export function getPropsSync(schema, context) {
-    const cache = getDefaultCache();
-    const cacheKey = createCacheKey(schema, context);
-    const cached = cache.get(cacheKey);
-    if (!cached) {
-        throw new Error('Props not in cache. Use generateProps() first or ensure caching is enabled.');
-    }
-    return cached.props;
-}
-/**
- * Pre-generate props for warming the cache
- *
- * @example
- * ```ts
- * await prefetchProps([
- *   { schema: userProfileSchema, context: { userId: '123' } },
- *   { schema: productSchema, context: { category: 'electronics' } },
- * ])
- * ```
- */
-export async function prefetchProps(requests) {
-    await Promise.all(requests.map(generateProps));
-}
-/**
- * Generate multiple prop sets in parallel
- */
-export async function generatePropsMany(requests) {
-    return Promise.all(requests.map(req => generateProps(req)));
-}
-/**
- * Merge partial props with generated props
- *
- * Generates only the missing props, keeping provided ones.
- */
-export async function mergeWithGenerated(schema, partialProps, options) {
-    // Get list of missing keys
-    const schemaObj = typeof schema === 'string' ? { value: schema } : schema;
-    const schemaKeys = Object.keys(schemaObj);
-    const providedKeys = Object.keys(partialProps);
-    const missingKeys = schemaKeys.filter(k => !providedKeys.includes(k));
-    // If all props are provided, return as-is
-    if (missingKeys.length === 0) {
-        return partialProps;
-    }
-    // Build partial schema for missing props only
-    const partialSchema = {};
-    for (const key of missingKeys) {
-        partialSchema[key] = schemaObj[key];
-    }
-    // Generate missing props
-    const result = await generateProps({
-        schema: partialSchema,
-        context: partialProps,
-        ...options,
-    });
-    // Merge
-    return {
-        ...result.props,
-        ...partialProps,
-    };
-}
-//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/hoc.d.ts

@@ -1,164 +0,0 @@
-/**
- * Higher-Order Component (HOC) for React components
- *
- * Provides withAIProps HOC for wrapping React components
- * with AI-powered prop generation.
- *
- * @packageDocumentation
- */
-import type { PropSchema, AIComponentOptions, AIPropsConfig } from './types.js';
-/**
- * Options for withAIProps HOC
- */
-export interface WithAIPropsOptions<P> extends Omit<AIComponentOptions<P>, 'schema'> {
-    /** Schema for props to generate */
-    schema: PropSchema;
-    /** Loading component to show while generating */
-    loading?: () => unknown;
-    /** Error component to show on generation failure */
-    error?: (error: Error) => unknown;
-    /** Fallback props to use if generation fails */
-    fallback?: Partial<P>;
-}
-/**
- * Create props wrapper that can be used with any component system
- *
- * This is framework-agnostic and returns the enhanced props.
- *
- * @example
- * ```ts
- * const enhancer = createPropsEnhancer({
- *   schema: {
- *     title: 'Page title',
- *     description: 'Page description',
- *   },
- *   defaults: {
- *     title: 'Default Title',
- *   },
- * })
- *
- * // Use with any component
- * const props = await enhancer({ description: 'My page' })
- * // { title: 'Default Title', description: 'My page' }
- *
- * const generatedProps = await enhancer({})
- * // { title: 'AI-generated title', description: 'AI-generated description' }
- * ```
- */
-export declare function createPropsEnhancer<P extends Record<string, unknown>>(options: WithAIPropsOptions<P>): (partialProps: Partial<P>) => Promise<P>;
-/**
- * Create an async props provider
- *
- * Returns a function that generates props on each call.
- * Useful for SSR and static generation.
- *
- * @example
- * ```ts
- * const getPageProps = createAsyncPropsProvider({
- *   schema: {
- *     title: 'SEO-optimized page title',
- *     meta: { description: 'Meta description' },
- *   },
- * })
- *
- * // In getStaticProps or getServerSideProps
- * export async function getStaticProps() {
- *   const props = await getPageProps({ slug: 'about' })
- *   return { props }
- * }
- * ```
- */
-export declare function createAsyncPropsProvider<P extends Record<string, unknown>>(options: WithAIPropsOptions<P>): {
-    /**
-     * Get props with AI generation
-     */
-    getProps: (partialProps: Partial<P>) => Promise<P>;
-    /**
-     * Get props for multiple items
-     */
-    getManyProps: (contexts: Partial<P>[]) => Promise<P[]>;
-    /**
-     * Get props with caching hint
-     */
-    getCachedProps: (context: Partial<P>, revalidate?: number) => Promise<{
-        props: P;
-        revalidate?: number;
-    }>;
-};
-/**
- * Create a props transformer
- *
- * Transforms existing props by filling in missing values.
- *
- * @example
- * ```ts
- * const transformUserProps = createPropsTransformer({
- *   schema: {
- *     displayName: 'Display name for the user',
- *     initials: 'User initials (2 letters)',
- *   },
- * })
- *
- * const user = await transformUserProps({
- *   username: 'johndoe',
- *   email: 'john@example.com',
- * })
- * // { username: 'johndoe', email: '...', displayName: 'John Doe', initials: 'JD' }
- * ```
- */
-export declare function createPropsTransformer<I extends Record<string, unknown>, O extends Record<string, unknown>>(options: {
-    schema: PropSchema;
-    transform?: (input: I, generated: Record<string, unknown>) => O;
-    config?: AIPropsConfig;
-}): (input: I) => Promise<I & O>;
-/**
- * Create a conditional props generator
- *
- * Only generates props when a condition is met.
- *
- * @example
- * ```ts
- * const maybeGenerateProps = createConditionalGenerator({
- *   schema: { summary: 'Article summary' },
- *   condition: (props) => !props.summary && props.content?.length > 100,
- * })
- * ```
- */
-export declare function createConditionalGenerator<P extends Record<string, unknown>>(options: {
-    schema: PropSchema;
-    condition: (props: Partial<P>) => boolean;
-    config?: AIPropsConfig;
-}): (props: Partial<P>) => Promise<P>;
-/**
- * Batch props generator for list rendering
- *
- * Efficiently generates props for multiple items.
- *
- * @example
- * ```ts
- * const batchGenerator = createBatchGenerator({
- *   schema: { title: 'Item title', description: 'Item description' },
- * })
- *
- * const items = await batchGenerator.generate([
- *   { id: 1, category: 'tech' },
- *   { id: 2, category: 'science' },
- *   { id: 3, category: 'art' },
- * ])
- * ```
- */
-export declare function createBatchGenerator<P extends Record<string, unknown>>(options: {
-    schema: PropSchema;
-    concurrency?: number;
-    config?: AIPropsConfig;
-}): {
-    /**
-     * Generate props for multiple items
-     */
-    generate: (items: Partial<P>[]) => Promise<P[]>;
-    /**
-     * Generate props one at a time (for rate limiting)
-     */
-    generateSequential: (items: Partial<P>[]) => Promise<P[]>;
-};
-//# sourceMappingURL=hoc.d.ts.map

package/dist/hoc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hoc.d.ts","sourceRoot":"","sources":["../src/hoc.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/E;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAE,SAAQ,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC;IAClF,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAA;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,OAAO,CAAA;IACvB,oDAAoD;IACpD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IACjC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,IAIhB,cAAc,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC,CAgCpD;AAmBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAK5B;;OAEG;;IAGH;;OAEG;6BAC4B,OAAO,CAAC,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAI1D;;OAEG;8BAEQ,OAAO,CAAC,CAAC,CAAC,eACN,MAAM,KAClB,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;EAKhD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CACpC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE;IACT,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAC/D,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB,IAGe,OAAO,CAAC,KAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAgBxC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE;IACrF,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;IACzC,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB,IAGe,OAAO,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC,CAU7C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE;IAC/E,MAAM,EAAE,UAAU,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;IAIG;;OAEG;sBACqB,OAAO,CAAC,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAoBnD;;OAEG;gCAC+B,OAAO,CAAC,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;EAchE"}