@souscheflabs/ml-vision 0.1.1 → 0.1.3

package/dist/esm/core/ServerClient.js

@@ -0,0 +1,305 @@
+/**
+ * ServerClient - HTTP client for ML inference server communication
+ *
+ * Handles:
+ * - Health checks
+ * - Product detection requests
+ * - OCR requests
+ * - Error handling and retries
+ */
+import { logger } from '../utils/logger';
+// ============================================================================
+// Server Error
+// ============================================================================
+/**
+ * Custom error for server communication failures
+ */
+export class ServerError extends Error {
+    constructor(message, code, statusCode, details) {
+        super(message);
+        this.name = 'ServerError';
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+    }
+    static fromResponse(response, statusCode) {
+        return new ServerError(response.error, response.code, statusCode, response.details);
+    }
+    static networkError(originalError) {
+        return new ServerError(originalError?.message || 'Network request failed', 'NETWORK_ERROR');
+    }
+    static timeoutError() {
+        return new ServerError('Request timed out', 'TIMEOUT_ERROR');
+    }
+}
+// ============================================================================
+// ServerClient Class
+// ============================================================================
+/**
+ * Client for communicating with the ML inference server
+ *
+ * @example
+ * ```typescript
+ * const client = new ServerClient('http://192.168.1.100:8000');
+ *
+ * // Check health
+ * const health = await client.checkHealth();
+ *
+ * // Detect products
+ * const detections = await client.detectProducts({
+ *   image: base64Image,
+ *   isBase64: true,
+ * });
+ * ```
+ */
+export class ServerClient {
+    constructor(baseUrl, defaultTimeout = 5000) {
+        // Remove trailing slash
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+        this.defaultTimeout = defaultTimeout;
+    }
+    // ==========================================================================
+    // Health Check
+    // ==========================================================================
+    /**
+     * Check server health status
+     */
+    async checkHealth(options) {
+        const response = await this.request('/health', 'GET', undefined, options);
+        return response;
+    }
+    /**
+     * Quick connectivity check (returns boolean)
+     */
+    async isAvailable() {
+        try {
+            const health = await this.checkHealth({ timeout: 2000 });
+            return health.status === 'healthy';
+        }
+        catch {
+            return false;
+        }
+    }
+    // ==========================================================================
+    // Detection Endpoints
+    // ==========================================================================
+    /**
+     * Detect products in an image
+     */
+    async detectProducts(imageData, options) {
+        logger.debug('[ServerClient] detectProducts called');
+        logger.debug('[ServerClient] baseUrl:', this.baseUrl);
+        logger.debug('[ServerClient] imageData.image:', imageData.image?.substring(0, 100));
+        logger.debug('[ServerClient] imageData.isBase64:', imageData.isBase64);
+        const formData = this.createImageFormData(imageData);
+        if (options?.maxDetections) {
+            formData.append('max_detections', String(options.maxDetections));
+        }
+        if (options?.minConfidence) {
+            formData.append('min_confidence', String(options.minConfidence));
+        }
+        if (options?.categories) {
+            formData.append('categories', options.categories.join(','));
+        }
+        logger.debug('[ServerClient] Sending request to /api/v1/detect/products...');
+        try {
+            const response = await this.requestWithForm('/api/v1/detect/products', formData, options);
+            logger.debug('[ServerClient] Response received:', JSON.stringify(response));
+            return response.detections;
+        }
+        catch (err) {
+            logger.error('[ServerClient] Request failed:', err);
+            throw err;
+        }
+    }
+    /**
+     * Detect fresh produce with quality assessment
+     */
+    async detectProduce(imageData, options) {
+        const formData = this.createImageFormData(imageData);
+        const response = await this.requestWithForm('/api/v1/detect/produce', formData, options);
+        return response.detections;
+    }
+    /**
+     * Detect spice jars (requires larger model on server)
+     */
+    async detectSpices(imageData, options) {
+        const formData = this.createImageFormData(imageData);
+        const response = await this.requestWithForm('/api/v1/detect/spices', formData, options);
+        return response.detections;
+    }
+    // ==========================================================================
+    // OCR Endpoints
+    // ==========================================================================
+    /**
+     * Extract text and items from a receipt image
+     */
+    async scanReceipt(imageData, options) {
+        const formData = this.createImageFormData(imageData);
+        if (options?.storeHint) {
+            formData.append('store_hint', options.storeHint);
+        }
+        if (options?.languageHint) {
+            formData.append('language_hint', options.languageHint);
+        }
+        const response = await this.requestWithForm('/api/v1/ocr/receipt', formData, options);
+        return response;
+    }
+    /**
+     * Read text from a product label
+     */
+    async readLabel(imageData, options) {
+        const formData = this.createImageFormData(imageData);
+        const response = await this.requestWithForm('/api/v1/ocr/label', formData, options);
+        return response;
+    }
+    // ==========================================================================
+    // Private Methods
+    // ==========================================================================
+    /**
+     * Create FormData with image
+     */
+    createImageFormData(imageData) {
+        const formData = new FormData();
+        if (imageData.isBase64) {
+            // For base64, send as a field
+            formData.append('image_base64', imageData.image);
+            if (imageData.mimeType) {
+                formData.append('mime_type', imageData.mimeType);
+            }
+        }
+        else {
+            // For file URI, create a file object
+            // React Native's FormData handles file:// URIs
+            const uri = imageData.image;
+            const filename = uri.split('/').pop() || 'image.jpg';
+            const type = imageData.mimeType || 'image/jpeg';
+            formData.append('image', {
+                uri,
+                name: filename,
+                type,
+            });
+        }
+        return formData;
+    }
+    /**
+     * Make a JSON request
+     */
+    async request(endpoint, method, body, options) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const timeout = options?.timeout ?? this.defaultTimeout;
+        // Create abort controller for timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        // Track external abort handler for cleanup
+        let externalAbortHandler = null;
+        // Combine with external signal if provided
+        if (options?.signal) {
+            externalAbortHandler = () => controller.abort();
+            options.signal.addEventListener('abort', externalAbortHandler);
+        }
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json',
+                },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorBody = await response.json().catch(() => ({
+                    error: 'Unknown error',
+                    code: 'UNKNOWN_ERROR',
+                }));
+                throw ServerError.fromResponse(errorBody, response.status);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            if (error instanceof ServerError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === 'AbortError') {
+                    throw ServerError.timeoutError();
+                }
+                throw ServerError.networkError(error);
+            }
+            throw ServerError.networkError();
+        }
+        finally {
+            // Clean up timeout
+            clearTimeout(timeoutId);
+            // Clean up external abort listener
+            if (options?.signal && externalAbortHandler) {
+                options.signal.removeEventListener('abort', externalAbortHandler);
+            }
+        }
+    }
+    /**
+     * Make a multipart form request
+     */
+    async requestWithForm(endpoint, formData, options) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const timeout = options?.timeout ?? this.defaultTimeout;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        // Track external abort handler for cleanup
+        let externalAbortHandler = null;
+        if (options?.signal) {
+            externalAbortHandler = () => controller.abort();
+            options.signal.addEventListener('abort', externalAbortHandler);
+        }
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    Accept: 'application/json',
+                    // Don't set Content-Type for FormData - fetch will set it with boundary
+                },
+                body: formData,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorBody = await response.json().catch(() => ({
+                    error: 'Unknown error',
+                    code: 'UNKNOWN_ERROR',
+                }));
+                throw ServerError.fromResponse(errorBody, response.status);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            if (error instanceof ServerError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === 'AbortError') {
+                    throw ServerError.timeoutError();
+                }
+                throw ServerError.networkError(error);
+            }
+            throw ServerError.networkError();
+        }
+        finally {
+            // Clean up timeout
+            clearTimeout(timeoutId);
+            // Clean up external abort listener
+            if (options?.signal && externalAbortHandler) {
+                options.signal.removeEventListener('abort', externalAbortHandler);
+            }
+        }
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a ServerClient instance
+ */
+export function createServerClient(baseUrl, timeout) {
+    return new ServerClient(baseUrl, timeout);
+}
+//# sourceMappingURL=ServerClient.js.map

package/dist/esm/core/ServerClient.js.map

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

package/dist/esm/core/index.js

@@ -0,0 +1,7 @@
+/**
+ * Core module exports
+ */
+export { MLVisionProvider, useMLVisionContext, useMLVisionReady, } from './MLVisionProvider';
+export { CacheManager, createCacheManager, CACHE_TTL, } from './CacheManager';
+export { ServerClient, createServerClient, ServerError, } from './ServerClient';
+//# sourceMappingURL=index.js.map

package/dist/esm/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,GAGjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,SAAS,GAGV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,WAAW,GAKZ,MAAM,gBAAgB,CAAC"}

package/dist/esm/hooks/classLabels.js

@@ -0,0 +1,174 @@
+/**
+ * Class label mappings for the trained SousChef YOLOv8 model
+ *
+ * These labels correspond to the 43 classes in the souschef_products_v2 model.
+ * The model was trained on curated grocery product images.
+ */
+/**
+ * Categorize a food item label
+ */
+function categorizeLabel(label) {
+    // Produce
+    const produce = [
+        'apple', 'banana', 'blackberries', 'blueberries', 'cherries',
+        'lettuce', 'pomegranate', 'red_onion', 'serrano_pepper', 'tomato'
+    ];
+    // Meat & Seafood
+    const meat = [
+        'beef_tenderloin', 'chicken_drumsticks', 'chicken_tenders', 'chicken_wings',
+        'chuck_roast', 'ground_beef', 'pork_chops', 'pork_loin', 'pork_shoulder',
+        'pork_tenderloin', 'rotisserie_chicken', 'sirloin_steak'
+    ];
+    // Dairy
+    const dairy = [
+        'butter', 'goat_cheese', 'greek_yogurt', 'half_and_half', 'provolone_cheese',
+        'salted_butter', 'shredded_cheese', 'sliced_cheese', 'unsalted_butter',
+        'whole_milk', 'yogurt'
+    ];
+    // Packaged/Pantry
+    const packaged = [
+        'all_purpose_flour', 'crushed_tomatoes', 'flour', 'honey', 'mixed_nuts',
+        'rice', 'sugar', 'white_rice'
+    ];
+    // Beverages
+    const beverage = [
+        'bottled_water', 'sparkling_water'
+    ];
+    if (produce.includes(label))
+        return 'produce';
+    if (meat.includes(label))
+        return 'meat';
+    if (dairy.includes(label))
+        return 'dairy';
+    if (packaged.includes(label))
+        return 'packaged';
+    if (beverage.includes(label))
+        return 'beverage';
+    // Default categorization based on common patterns
+    if (label.includes('cheese'))
+        return 'dairy';
+    if (label.includes('milk') || label.includes('cream') || label.includes('butter'))
+        return 'dairy';
+    if (label.includes('beef') || label.includes('chicken') || label.includes('pork') ||
+        label.includes('fish') || label.includes('shrimp') || label.includes('salmon'))
+        return 'meat';
+    if (label.includes('bread') || label.includes('bun'))
+        return 'bakery';
+    if (label.includes('juice') || label.includes('water') || label.includes('soda'))
+        return 'beverage';
+    return 'unknown';
+}
+/**
+ * Map class index to label and category (43 classes)
+ */
+export const CLASS_LABELS = {
+    0: { label: 'all_purpose_flour', category: 'packaged' },
+    1: { label: 'apple', category: 'produce' },
+    2: { label: 'banana', category: 'produce' },
+    3: { label: 'beef_tenderloin', category: 'meat' },
+    4: { label: 'blackberries', category: 'produce' },
+    5: { label: 'blueberries', category: 'produce' },
+    6: { label: 'bottled_water', category: 'beverage' },
+    7: { label: 'butter', category: 'dairy' },
+    8: { label: 'cherries', category: 'produce' },
+    9: { label: 'chicken_drumsticks', category: 'meat' },
+    10: { label: 'chicken_tenders', category: 'meat' },
+    11: { label: 'chicken_wings', category: 'meat' },
+    12: { label: 'chuck_roast', category: 'meat' },
+    13: { label: 'crushed_tomatoes', category: 'packaged' },
+    14: { label: 'flour', category: 'packaged' },
+    15: { label: 'goat_cheese', category: 'dairy' },
+    16: { label: 'greek_yogurt', category: 'dairy' },
+    17: { label: 'ground_beef', category: 'meat' },
+    18: { label: 'half_and_half', category: 'dairy' },
+    19: { label: 'honey', category: 'packaged' },
+    20: { label: 'lettuce', category: 'produce' },
+    21: { label: 'mixed_nuts', category: 'snack' },
+    22: { label: 'pomegranate', category: 'produce' },
+    23: { label: 'pork_chops', category: 'meat' },
+    24: { label: 'pork_loin', category: 'meat' },
+    25: { label: 'pork_shoulder', category: 'meat' },
+    26: { label: 'pork_tenderloin', category: 'meat' },
+    27: { label: 'provolone_cheese', category: 'dairy' },
+    28: { label: 'red_onion', category: 'produce' },
+    29: { label: 'rice', category: 'packaged' },
+    30: { label: 'rotisserie_chicken', category: 'meat' },
+    31: { label: 'salted_butter', category: 'dairy' },
+    32: { label: 'serrano_pepper', category: 'produce' },
+    33: { label: 'shredded_cheese', category: 'dairy' },
+    34: { label: 'sirloin_steak', category: 'meat' },
+    35: { label: 'sliced_cheese', category: 'dairy' },
+    36: { label: 'sparkling_water', category: 'beverage' },
+    37: { label: 'sugar', category: 'packaged' },
+    38: { label: 'tomato', category: 'produce' },
+    39: { label: 'unsalted_butter', category: 'dairy' },
+    40: { label: 'white_rice', category: 'packaged' },
+    41: { label: 'whole_milk', category: 'dairy' },
+    42: { label: 'yogurt', category: 'dairy' },
+};
+/**
+ * Number of classes in the model
+ */
+export const NUM_CLASSES = 43;
+/**
+ * Get label info for a class index
+ */
+export function getClassInfo(classIndex) {
+    const info = CLASS_LABELS[classIndex];
+    if (info) {
+        return info;
+    }
+    // Fallback for unknown indices
+    return { label: `class_${classIndex}`, category: 'unknown' };
+}
+/**
+ * Get all labels as an array (ordered by class index)
+ */
+export function getLabelsArray() {
+    const labels = [];
+    for (let i = 0; i < NUM_CLASSES; i++) {
+        labels.push(CLASS_LABELS[i]?.label ?? `class_${i}`);
+    }
+    return labels;
+}
+/**
+ * Category to class indices mapping
+ */
+export const CATEGORY_CLASSES = {
+    produce: Object.entries(CLASS_LABELS)
+        .filter(([, v]) => v.category === 'produce')
+        .map(([k]) => parseInt(k, 10)),
+    meat: Object.entries(CLASS_LABELS)
+        .filter(([, v]) => v.category === 'meat')
+        .map(([k]) => parseInt(k, 10)),
+    dairy: Object.entries(CLASS_LABELS)
+        .filter(([, v]) => v.category === 'dairy')
+        .map(([k]) => parseInt(k, 10)),
+    packaged: Object.entries(CLASS_LABELS)
+        .filter(([, v]) => v.category === 'packaged')
+        .map(([k]) => parseInt(k, 10)),
+    bakery: Object.entries(CLASS_LABELS)
+        .filter(([, v]) => v.category === 'bakery')
+        .map(([k]) => parseInt(k, 10)),
+    snack: Object.entries(CLASS_LABELS)
+        .filter(([, v]) => v.category === 'snack')
+        .map(([k]) => parseInt(k, 10)),
+    beverage: Object.entries(CLASS_LABELS)
+        .filter(([, v]) => v.category === 'beverage')
+        .map(([k]) => parseInt(k, 10)),
+    condiment: Object.entries(CLASS_LABELS)
+        .filter(([, v]) => v.category === 'condiment')
+        .map(([k]) => parseInt(k, 10)),
+    spice: Object.entries(CLASS_LABELS)
+        .filter(([, v]) => v.category === 'spice')
+        .map(([k]) => parseInt(k, 10)),
+    frozen: Object.entries(CLASS_LABELS)
+        .filter(([, v]) => v.category === 'frozen')
+        .map(([k]) => parseInt(k, 10)),
+    unknown: Object.entries(CLASS_LABELS)
+        .filter(([, v]) => v.category === 'unknown')
+        .map(([k]) => parseInt(k, 10)),
+};
+// Export the categorize function for use elsewhere
+export { categorizeLabel };
+//# sourceMappingURL=classLabels.js.map

package/dist/esm/hooks/classLabels.js.map

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

package/dist/esm/hooks/classLabelsCoco.js

@@ -0,0 +1,98 @@
+/**
+ * Class label mappings for YOLOv8 COCO model
+ *
+ * These labels correspond to the 80 classes in the COCO dataset.
+ * Food-related classes: banana (46), apple (47), sandwich (48), orange (49),
+ * broccoli (50), carrot (51), hot dog (52), pizza (53), donut (54), cake (55)
+ */
+/**
+ * COCO class names in order
+ */
+export const COCO_CLASSES = [
+    'person', 'bicycle', 'car', 'motorcycle', 'airplane', 'bus', 'train', 'truck',
+    'boat', 'traffic light', 'fire hydrant', 'stop sign', 'parking meter', 'bench',
+    'bird', 'cat', 'dog', 'horse', 'sheep', 'cow', 'elephant', 'bear', 'zebra',
+    'giraffe', 'backpack', 'umbrella', 'handbag', 'tie', 'suitcase', 'frisbee',
+    'skis', 'snowboard', 'sports ball', 'kite', 'baseball bat', 'baseball glove',
+    'skateboard', 'surfboard', 'tennis racket', 'bottle', 'wine glass', 'cup',
+    'fork', 'knife', 'spoon', 'bowl', 'banana', 'apple', 'sandwich', 'orange',
+    'broccoli', 'carrot', 'hot dog', 'pizza', 'donut', 'cake', 'chair', 'couch',
+    'potted plant', 'bed', 'dining table', 'toilet', 'tv', 'laptop', 'mouse',
+    'remote', 'keyboard', 'cell phone', 'microwave', 'oven', 'toaster', 'sink',
+    'refrigerator', 'book', 'clock', 'vase', 'scissors', 'teddy bear', 'hair drier',
+    'toothbrush'
+];
+/**
+ * Map COCO class to a product category
+ */
+function getCocoCategory(label) {
+    // Food items
+    const produceItems = ['banana', 'apple', 'orange', 'broccoli', 'carrot'];
+    const meatItems = ['hot dog'];
+    const bakeryItems = ['sandwich', 'pizza', 'donut', 'cake'];
+    const dairyItems = [];
+    const beverageItems = ['bottle', 'wine glass', 'cup'];
+    const condimentItems = ['bowl']; // Often contains condiments/sauces
+    if (produceItems.includes(label))
+        return 'produce';
+    if (meatItems.includes(label))
+        return 'meat';
+    if (bakeryItems.includes(label))
+        return 'bakery';
+    if (dairyItems.includes(label))
+        return 'dairy';
+    if (beverageItems.includes(label))
+        return 'beverage';
+    if (condimentItems.includes(label))
+        return 'condiment';
+    // Kitchen items (useful for context)
+    const kitchenItems = [
+        'fork', 'knife', 'spoon', 'microwave', 'oven', 'toaster', 'sink',
+        'refrigerator', 'dining table'
+    ];
+    if (kitchenItems.includes(label))
+        return 'unknown'; // Not a product but kitchen context
+    return 'unknown';
+}
+/**
+ * Map class index to label and category for COCO
+ */
+export const CLASS_LABELS_COCO = Object.fromEntries(COCO_CLASSES.map((label, index) => [
+    index,
+    { label, category: getCocoCategory(label) }
+]));
+/**
+ * Number of classes in COCO model
+ */
+export const NUM_CLASSES_COCO = 80;
+/**
+ * Food class indices in COCO (useful for filtering)
+ */
+export const FOOD_CLASS_INDICES = [46, 47, 48, 49, 50, 51, 52, 53, 54, 55];
+/**
+ * Kitchen/dining class indices (context)
+ */
+export const KITCHEN_CLASS_INDICES = [39, 40, 41, 42, 43, 44, 45, 60, 68, 69, 70, 71, 72];
+/**
+ * Get label info for a COCO class index
+ */
+export function getCocoClassInfo(classIndex) {
+    const info = CLASS_LABELS_COCO[classIndex];
+    if (info) {
+        return info;
+    }
+    return { label: `class_${classIndex}`, category: 'unknown' };
+}
+/**
+ * Check if a class index is a food item
+ */
+export function isFoodClass(classIndex) {
+    return FOOD_CLASS_INDICES.includes(classIndex);
+}
+/**
+ * Get all COCO labels as an array
+ */
+export function getCocoLabelsArray() {
+    return [...COCO_CLASSES];
+}
+//# sourceMappingURL=classLabelsCoco.js.map

package/dist/esm/hooks/classLabelsCoco.js.map

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

package/dist/esm/hooks/index.js

@@ -0,0 +1,9 @@
+/**
+ * Hooks exports
+ */
+export { useProductDetector, default as useProductDetectorDefault } from './useProductDetector';
+export { useMultiBarcodeScanner, default as useMultiBarcodeScannerDefault } from './useMultiBarcodeScanner';
+export { useReceiptScanner, default as useReceiptScannerDefault } from './useReceiptScanner';
+export { useVideoScanner, default as useVideoScannerDefault, } from './useVideoScanner';
+export { CLASS_LABELS, NUM_CLASSES, getClassInfo, getLabelsArray, CATEGORY_CLASSES } from './classLabels';
+//# sourceMappingURL=index.js.map

package/dist/esm/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,OAAO,IAAI,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAC5G,OAAO,EAAE,iBAAiB,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EACL,eAAe,EACf,OAAO,IAAI,sBAAsB,GAKlC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}