ai-props 2.3.0 → 2.4.0

package/dist/streaming.js

@@ -0,0 +1,402 @@
+/**
+ * Optimized streaming utilities for AI-powered props rendering
+ *
+ * This module provides high-performance streaming capabilities with:
+ * - Adaptive chunk sizing for network efficiency
+ * - Backpressure handling to prevent memory overflow
+ * - Progress callbacks for streaming status
+ * - Memory-efficient streaming for large components
+ *
+ * @packageDocumentation
+ */
+import { renderToReadableStream as baseRenderToReadableStream, streamJSXResponse as baseStreamJSXResponse, createStreamingRenderer as baseCreateStreamingRenderer, createHydrationContext, serializeHydrationData, } from './hono-jsx.js';
+import { streamMDXWithProps as baseStreamMDXWithProps } from './mdx.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Default chunk size for optimal network performance (16KB) */
+export const DEFAULT_CHUNK_SIZE = 16 * 1024;
+/** Minimum chunk size to avoid excessive overhead (1KB) */
+export const MIN_CHUNK_SIZE = 1024;
+/** Maximum chunk size for memory efficiency (64KB) */
+export const MAX_CHUNK_SIZE = 64 * 1024;
+/** High water mark for backpressure (64KB) */
+export const DEFAULT_HIGH_WATER_MARK = 64 * 1024;
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Calculate optimal chunk size based on content size
+ *
+ * @param contentLength - Total content length in bytes
+ * @returns Optimal chunk size
+ */
+export function calculateOptimalChunkSize(contentLength) {
+    // For very small content, use minimum chunk size
+    if (contentLength < MIN_CHUNK_SIZE * 2) {
+        return MIN_CHUNK_SIZE;
+    }
+    // For medium content, use default
+    if (contentLength < MAX_CHUNK_SIZE * 4) {
+        return DEFAULT_CHUNK_SIZE;
+    }
+    // For large content, use larger chunks
+    return MAX_CHUNK_SIZE;
+}
+/**
+ * Create a progress tracker for streaming operations
+ */
+function createProgressTracker(totalBytes, onProgress) {
+    const startTime = Date.now();
+    return {
+        startTime,
+        update(bytesProcessed, chunksProcessed, phase) {
+            if (!onProgress)
+                return;
+            const elapsedMs = Date.now() - startTime;
+            const progress = {
+                bytesProcessed,
+                chunksProcessed,
+                phase,
+                elapsedMs,
+            };
+            if (totalBytes !== undefined) {
+                progress.totalBytes = totalBytes;
+                progress.percentComplete = Math.min(100, (bytesProcessed / totalBytes) * 100);
+            }
+            onProgress(progress);
+        },
+    };
+}
+// ============================================================================
+// Core Streaming Functions
+// ============================================================================
+/**
+ * Render a component to a ReadableStream with optimizations
+ *
+ * Features:
+ * - Adaptive chunk sizing based on content
+ * - Backpressure handling to prevent memory overflow
+ * - Progress callbacks for monitoring
+ * - Memory-efficient streaming for large content
+ *
+ * @param component - Component function to render
+ * @param props - Props to pass to component
+ * @param options - Optimized streaming options
+ * @returns ReadableStream of rendered HTML
+ *
+ * @example
+ * ```ts
+ * const stream = await renderToReadableStream(
+ *   MyComponent,
+ *   { title: 'Hello' },
+ *   {
+ *     chunkSize: 8192,
+ *     onProgress: (progress) => console.log(`${progress.percentComplete}% complete`),
+ *   }
+ * )
+ * ```
+ */
+export async function renderToReadableStream(component, props, options) {
+    const encoder = new TextEncoder();
+    const chunkSize = options?.chunkSize ?? DEFAULT_CHUNK_SIZE;
+    const highWaterMark = options?.highWaterMark ?? DEFAULT_HIGH_WATER_MARK;
+    // Create hydration context if needed
+    let hydrationContext = null;
+    if (options?.includeHydration) {
+        hydrationContext = createHydrationContext();
+    }
+    // Render the component
+    let content;
+    try {
+        content = await component(props);
+    }
+    catch (error) {
+        if (options?.onError && error instanceof Error) {
+            content = options.onError(error);
+        }
+        else {
+            throw error;
+        }
+    }
+    // Register for hydration
+    if (hydrationContext) {
+        const componentName = component.name || 'Anonymous';
+        hydrationContext.register(componentName, props);
+    }
+    // Prepare hydration script
+    let hydrationScript = '';
+    if (options?.includeHydration && hydrationContext) {
+        const hydrationData = hydrationContext.getData();
+        hydrationScript = `<script>window.__HYDRATION_DATA__=${serializeHydrationData(hydrationData)}</script>`;
+    }
+    const fullContent = content + hydrationScript;
+    const contentBytes = encoder.encode(fullContent);
+    const totalLength = contentBytes.length;
+    // Calculate optimal chunk size if not specified
+    const effectiveChunkSize = options?.chunkSize ?? calculateOptimalChunkSize(totalLength);
+    // Create progress tracker
+    const tracker = createProgressTracker(totalLength, options?.onProgress);
+    let bytesProcessed = 0;
+    let chunksProcessed = 0;
+    let offset = 0;
+    tracker.update(0, 0, 'starting');
+    return new ReadableStream({
+        pull(controller) {
+            // Check if we're done
+            if (offset >= totalLength) {
+                tracker.update(bytesProcessed, chunksProcessed, 'complete');
+                controller.close();
+                return;
+            }
+            // Calculate chunk end
+            const end = Math.min(offset + effectiveChunkSize, totalLength);
+            const chunk = contentBytes.slice(offset, end);
+            controller.enqueue(chunk);
+            bytesProcessed += chunk.length;
+            chunksProcessed++;
+            offset = end;
+            tracker.update(bytesProcessed, chunksProcessed, 'streaming');
+        },
+        cancel() {
+            tracker.update(bytesProcessed, chunksProcessed, 'error');
+        },
+    }, 
+    // Queuing strategy for backpressure
+    new ByteLengthQueuingStrategy({ highWaterMark }));
+}
+/**
+ * Create a streaming Response with optimizations
+ *
+ * @param component - Component function to render
+ * @param props - Props to pass to component
+ * @param options - Optimized streaming options
+ * @returns Response with streaming body
+ *
+ * @example
+ * ```ts
+ * // In a Hono/Worker handler
+ * export default {
+ *   fetch(request, env) {
+ *     return streamJSXResponse(
+ *       PageComponent,
+ *       { data: pageData },
+ *       {
+ *         streaming: true,
+ *         compressionHint: true,
+ *       }
+ *     )
+ *   }
+ * }
+ * ```
+ */
+export async function streamJSXResponse(component, props, options) {
+    const stream = await renderToReadableStream(component, props, options);
+    const headers = new Headers({
+        'Content-Type': 'text/html; charset=utf-8',
+        'X-Content-Type-Options': 'nosniff',
+        ...options?.headers,
+    });
+    // Add streaming hints
+    if (options?.streaming) {
+        headers.set('Transfer-Encoding', 'chunked');
+    }
+    // Add compression hint
+    if (options?.compressionHint) {
+        headers.set('Vary', 'Accept-Encoding');
+    }
+    return new Response(stream, {
+        status: 200,
+        headers,
+    });
+}
+/**
+ * Create a reusable streaming renderer with configuration
+ *
+ * @param options - Renderer options with optimization controls
+ * @returns Streaming renderer instance with stats
+ *
+ * @example
+ * ```ts
+ * const renderer = createStreamingRenderer({
+ *   doctype: '<!DOCTYPE html>',
+ *   includeHydration: true,
+ *   chunkSize: 8192,
+ *   onProgress: (p) => console.log(p.phase),
+ * })
+ *
+ * const stream = await renderer.render(MyComponent, props)
+ * const stats = renderer.getStats()
+ * ```
+ */
+export function createStreamingRenderer(options) {
+    const encoder = new TextEncoder();
+    const chunkSize = options.chunkSize ?? DEFAULT_CHUNK_SIZE;
+    const highWaterMark = options.highWaterMark ?? DEFAULT_HIGH_WATER_MARK;
+    // Stats tracking
+    let currentStats = null;
+    return {
+        async render(component, props) {
+            const startTime = Date.now();
+            let timeToFirstByte = 0;
+            let totalBytes = 0;
+            let totalChunks = 0;
+            let encounteredBackpressure = false;
+            // Create hydration context
+            const ctx = options.includeHydration ? createHydrationContext() : null;
+            // Render the component
+            const content = await component(props);
+            // Register for hydration data
+            if (ctx) {
+                const componentName = component.name || 'Anonymous';
+                ctx.register(componentName, props);
+            }
+            // Get hydration data
+            let hydrationJson = '';
+            if (options.includeHydration && ctx) {
+                hydrationJson = serializeHydrationData(ctx.getData());
+            }
+            // Apply shell wrapper if provided
+            let output;
+            if (options.shell) {
+                const hydrationScript = hydrationJson ? `window.__HYDRATION_DATA__=${hydrationJson}` : '';
+                output = options.shell(content, hydrationScript);
+            }
+            else {
+                output = content;
+                if (options.includeHydration && hydrationJson) {
+                    output += `<script>window.__HYDRATION_DATA__=${hydrationJson}</script>`;
+                }
+            }
+            // Prepend doctype if provided
+            if (options.doctype) {
+                output = options.doctype + '\n' + output;
+            }
+            const contentBytes = encoder.encode(output);
+            const contentLength = contentBytes.length;
+            // Create progress tracker
+            const tracker = createProgressTracker(contentLength, options.onProgress);
+            tracker.update(0, 0, 'starting');
+            let offset = 0;
+            return new ReadableStream({
+                pull(controller) {
+                    // Track time to first byte
+                    if (totalChunks === 0) {
+                        timeToFirstByte = Date.now() - startTime;
+                    }
+                    if (offset >= contentLength) {
+                        // Finalize stats
+                        currentStats = {
+                            totalBytes,
+                            totalChunks,
+                            averageChunkSize: totalChunks > 0 ? totalBytes / totalChunks : 0,
+                            timeToFirstByte,
+                            totalDuration: Date.now() - startTime,
+                            encounteredBackpressure,
+                        };
+                        tracker.update(totalBytes, totalChunks, 'complete');
+                        controller.close();
+                        return;
+                    }
+                    const end = Math.min(offset + chunkSize, contentLength);
+                    const chunk = contentBytes.slice(offset, end);
+                    controller.enqueue(chunk);
+                    totalBytes += chunk.length;
+                    totalChunks++;
+                    offset = end;
+                    tracker.update(totalBytes, totalChunks, 'streaming');
+                },
+                cancel() {
+                    tracker.update(totalBytes, totalChunks, 'error');
+                },
+            }, new ByteLengthQueuingStrategy({ highWaterMark }));
+        },
+        getStats() {
+            return currentStats;
+        },
+        resetStats() {
+            currentStats = null;
+        },
+    };
+}
+/**
+ * Stream MDX content with AI-generated props and optimizations
+ *
+ * @param mdx - MDX content string
+ * @param props - Props for each component
+ * @param options - Stream options with optimizations
+ * @returns ReadableStream of rendered content
+ *
+ * @example
+ * ```ts
+ * const stream = await streamMDXWithProps(
+ *   '<Hero title="Welcome" />',
+ *   { Hero: { title: 'Welcome', subtitle: 'To the site' } },
+ *   {
+ *     chunkSize: 8192,
+ *     onProgress: (p) => console.log(`${p.chunksProcessed} chunks sent`),
+ *   }
+ * )
+ * ```
+ */
+export async function streamMDXWithProps(mdx, props, options) {
+    // Get base stream from mdx module
+    const baseStream = await baseStreamMDXWithProps(mdx, props, options);
+    // If no optimization options, return base stream
+    if (!options?.chunkSize && !options?.highWaterMark && !options?.onProgress) {
+        return baseStream;
+    }
+    // Apply optimizations by re-chunking the stream
+    const reader = baseStream.getReader();
+    const encoder = new TextEncoder();
+    const chunkSize = options?.chunkSize ?? DEFAULT_CHUNK_SIZE;
+    const highWaterMark = options?.highWaterMark ?? DEFAULT_HIGH_WATER_MARK;
+    // Buffer for accumulating content
+    let buffer = new Uint8Array(0);
+    let bytesProcessed = 0;
+    let chunksProcessed = 0;
+    const tracker = createProgressTracker(undefined, options?.onProgress);
+    tracker.update(0, 0, 'starting');
+    return new ReadableStream({
+        async pull(controller) {
+            // Read from source stream
+            const { done, value } = await reader.read();
+            if (done) {
+                // Flush remaining buffer
+                if (buffer.length > 0) {
+                    controller.enqueue(buffer);
+                    bytesProcessed += buffer.length;
+                    chunksProcessed++;
+                }
+                tracker.update(bytesProcessed, chunksProcessed, 'complete');
+                controller.close();
+                return;
+            }
+            // Append to buffer
+            const newBuffer = new Uint8Array(buffer.length + value.length);
+            newBuffer.set(buffer);
+            newBuffer.set(value, buffer.length);
+            buffer = newBuffer;
+            // Emit full chunks
+            while (buffer.length >= chunkSize) {
+                const chunk = buffer.slice(0, chunkSize);
+                controller.enqueue(chunk);
+                buffer = buffer.slice(chunkSize);
+                bytesProcessed += chunk.length;
+                chunksProcessed++;
+                tracker.update(bytesProcessed, chunksProcessed, 'streaming');
+            }
+        },
+        cancel() {
+            reader.cancel();
+            tracker.update(bytesProcessed, chunksProcessed, 'error');
+        },
+    }, new ByteLengthQueuingStrategy({ highWaterMark }));
+}
+// ============================================================================
+// Re-exports from hono-jsx for convenience
+// ============================================================================
+export { createHydrationContext, serializeHydrationData, collectHydrationData, HydrationProvider, useHydration, } from './hono-jsx.js';
+// Re-export base functions with different names for direct access
+export { baseRenderToReadableStream as renderToReadableStreamBasic, baseStreamJSXResponse as streamJSXResponseBasic, baseCreateStreamingRenderer as createStreamingRendererBasic, };
+//# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Type definitions for ai-props
+ *
+ * @packageDocumentation
+ */
+import type { SimpleSchema } from 'ai-functions';
+/**
+ * Configuration for AI prop generation
+ */
+export interface AIPropsConfig {
+    /** Model to use for generation (default: 'sonnet') */
+    model?: string;
+    /** System prompt for generation context */
+    system?: string;
+    /** Whether to cache generated props */
+    cache?: boolean;
+    /** Cache TTL in milliseconds (default: 5 minutes) */
+    cacheTTL?: number;
+    /** Custom generation function */
+    generate?: <T>(schema: SimpleSchema, context: Record<string, unknown>) => Promise<T>;
+}
+/**
+ * Schema definition for component props
+ * Can be a SimpleSchema or a named type string
+ */
+export type PropSchema = SimpleSchema | string;
+/**
+ * Options for prop generation
+ */
+export interface GeneratePropsOptions {
+    /** Schema defining the props to generate */
+    schema: PropSchema;
+    /** Partial props to use as context */
+    context?: Record<string, unknown>;
+    /** Additional prompt context */
+    prompt?: string;
+    /** Model to use */
+    model?: string;
+    /** System prompt */
+    system?: string;
+}
+/**
+ * Result of prop generation
+ */
+export interface GeneratePropsResult<T> {
+    /** Generated props */
+    props: T;
+    /** Whether props were from cache */
+    cached: boolean;
+    /** Generation metadata */
+    metadata?: {
+        model: string;
+        tokens?: number;
+        duration?: number;
+    };
+}
+/**
+ * Cache entry for generated props
+ */
+export interface PropsCacheEntry<T = unknown> {
+    props: T;
+    timestamp: number;
+    key: string;
+}
+/**
+ * Props cache interface
+ */
+export interface PropsCache {
+    get<T>(key: string): PropsCacheEntry<T> | undefined;
+    set<T>(key: string, props: T): void;
+    delete(key: string): boolean;
+    clear(): void;
+    size: number;
+}
+/**
+ * Hook result for useAIProps
+ */
+export interface UseAIPropsResult<T> {
+    /** Generated props (null while loading) */
+    props: T | null;
+    /** Whether generation is in progress */
+    loading: boolean;
+    /** Error if generation failed */
+    error: Error | null;
+    /** Regenerate props */
+    regenerate: () => Promise<void>;
+    /** Whether props were from cache */
+    cached: boolean;
+}
+/**
+ * Options for useAIProps hook
+ */
+export interface UseAIPropsOptions<T> extends Omit<GeneratePropsOptions, 'context'> {
+    /** Partial props to merge and use as context */
+    partialProps?: Partial<T>;
+    /** Skip generation if all required props are provided */
+    skipIfComplete?: boolean;
+    /** Dependencies that trigger regeneration */
+    deps?: unknown[];
+}
+/**
+ * Component wrapper options for AI()
+ */
+export interface AIComponentOptions<P> {
+    /** Schema for the component props */
+    schema: PropSchema;
+    /** Default props */
+    defaults?: Partial<P>;
+    /** Props that are always required (never generated) */
+    required?: (keyof P)[];
+    /** Props to exclude from generation */
+    exclude?: (keyof P)[];
+    /** AI generation config */
+    config?: AIPropsConfig;
+}
+/**
+ * Enhanced component type with AI capabilities
+ */
+export interface AIComponent<P> {
+    (props: Partial<P>): Promise<P>;
+    /** Original schema */
+    schema: PropSchema;
+    /** Generate props without rendering */
+    generateProps: (context?: Partial<P>) => Promise<P>;
+    /** Configuration */
+    config: AIPropsConfig;
+}
+/**
+ * Type helper to extract props type from a schema
+ */
+export type InferProps<S extends PropSchema> = S extends SimpleSchema ? S extends string ? string : S extends {
+    [key: string]: SimpleSchema;
+} ? {
+    [K in keyof S]: InferProps<S[K]>;
+} : unknown : unknown;
+/**
+ * Validation result for props
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Individual validation error
+ */
+export interface ValidationError {
+    path: string;
+    message: string;
+    expected?: string;
+    received?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for ai-props
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/validate.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Validation utilities for ai-props
+ *
+ * Provides prop validation against schemas.
+ *
+ * @packageDocumentation
+ */
+import type { PropSchema, ValidationResult } from './types.js';
+/**
+ * Validate props against a schema
+ *
+ * @example
+ * ```ts
+ * const result = validateProps(
+ *   { name: 'John', age: '25' },  // props
+ *   { name: 'Name', age: 'Age (number)' }  // schema
+ * )
+ *
+ * if (!result.valid) {
+ *   console.log(result.errors)
+ *   // [{ path: 'age', message: 'Expected number, got string' }]
+ * }
+ * ```
+ */
+export declare function validateProps(props: Record<string, unknown>, schema: PropSchema): ValidationResult;
+/**
+ * Check if all required props are present
+ */
+export declare function hasRequiredProps<P extends Record<string, unknown>>(props: Partial<P>, required: (keyof P)[]): boolean;
+/**
+ * Get list of missing required props
+ */
+export declare function getMissingProps<P extends Record<string, unknown>>(props: Partial<P>, required: (keyof P)[]): (keyof P)[];
+/**
+ * Check if props are complete according to schema
+ */
+export declare function isComplete(props: Record<string, unknown>, schema: PropSchema): boolean;
+/**
+ * Get list of missing props according to schema
+ */
+export declare function getMissingFromSchema(props: Record<string, unknown>, schema: PropSchema): string[];
+/**
+ * Sanitize props by removing extra keys not in schema
+ */
+export declare function sanitizeProps<P extends Record<string, unknown>>(props: P, schema: PropSchema): Partial<P>;
+/**
+ * Merge props with defaults, respecting schema types
+ */
+export declare function mergeWithDefaults<P extends Record<string, unknown>>(props: Partial<P>, defaults: Partial<P>, schema: PropSchema): Partial<P>;
+/**
+ * Create a props validator function
+ */
+export declare function createValidator<P extends Record<string, unknown>>(schema: PropSchema): (props: Partial<P>) => ValidationResult;
+/**
+ * Assert props are valid, throwing on error
+ */
+export declare function assertValidProps(props: Record<string, unknown>, schema: PropSchema): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAmB,MAAM,YAAY,CAAA;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,UAAU,GACjB,gBAAgB,CAwBlB;AAuID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GACpB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GACpB,CAAC,MAAM,CAAC,CAAC,EAAE,CAEb;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAMtF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAMjG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,CAAC,CAAC,CAeZ;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAsBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,MAAM,EAAE,UAAU,GACjB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAEzC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAMzF"}