@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/core/utils.js

@@ -0,0 +1,309 @@
+/**
+ * @rovela/sdk/core/utils
+ *
+ * Utility functions for e-commerce stores
+ */
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+// =============================================================================
+// Class Name Utilities
+// =============================================================================
+/**
+ * Merge Tailwind CSS classes with clsx
+ * Handles conflicting classes intelligently
+ *
+ * @example
+ * cn('px-4 py-2', 'px-6') // => 'py-2 px-6'
+ * cn('bg-red-500', { 'bg-blue-500': isBlue }) // => 'bg-blue-500' if isBlue
+ */
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+/**
+ * Format a price for display with proper currency formatting
+ *
+ * @param price - Price in cents or as decimal (e.g., 1999 or 19.99)
+ * @param options - Formatting options
+ * @returns Formatted price string (e.g., "$19.99")
+ *
+ * @example
+ * formatPrice(1999) // => "$19.99"
+ * formatPrice(19.99, { currency: 'EUR', locale: 'de-DE' }) // => "19,99 €"
+ */
+export function formatPrice(price, options = {}) {
+    const { currency = 'USD', locale = 'en-US', showCents = true } = options;
+    // Convert to number
+    const numPrice = typeof price === 'string' ? parseFloat(price) : price;
+    return new Intl.NumberFormat(locale, {
+        style: 'currency',
+        currency,
+        minimumFractionDigits: showCents ? 2 : 0,
+        maximumFractionDigits: showCents ? 2 : 0,
+    }).format(numPrice);
+}
+/**
+ * Parse a formatted price string back to a number
+ *
+ * @param priceString - Formatted price (e.g., "$19.99")
+ * @returns Price as a number (e.g., 19.99)
+ */
+export function parsePrice(priceString) {
+    // Remove currency symbols, spaces, and convert comma decimal to dot
+    const cleaned = priceString
+        .replace(/[^0-9.,]/g, '')
+        .replace(',', '.');
+    return parseFloat(cleaned) || 0;
+}
+/**
+ * Get the currency symbol for a given currency code
+ *
+ * @param currency - Currency code (e.g., 'USD', 'EUR', 'GBP')
+ * @param locale - Locale for formatting (e.g., 'en-US', 'de-DE')
+ * @returns Currency symbol (e.g., '$', '€', '£')
+ *
+ * @example
+ * getCurrencySymbol('USD') // => "$"
+ * getCurrencySymbol('EUR', 'de-DE') // => "€"
+ * getCurrencySymbol('GBP', 'en-GB') // => "£"
+ * getCurrencySymbol('JPY', 'ja-JP') // => "¥"
+ */
+export function getCurrencySymbol(currency = 'USD', locale = 'en-US') {
+    return new Intl.NumberFormat(locale, {
+        style: 'currency',
+        currency,
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 0,
+    })
+        .format(0)
+        .replace(/\d/g, '')
+        .trim();
+}
+// =============================================================================
+// Slug Generation
+// =============================================================================
+/**
+ * Generate a URL-safe slug from a string
+ *
+ * @param text - Text to convert to slug
+ * @returns URL-safe slug
+ *
+ * @example
+ * generateSlug('Hello World!') // => 'hello-world'
+ * generateSlug('Product Name (2024)') // => 'product-name-2024'
+ */
+export function generateSlug(text) {
+    return text
+        .toString()
+        .toLowerCase()
+        .trim()
+        // Replace spaces with hyphens
+        .replace(/\s+/g, '-')
+        // Remove special characters except hyphens
+        .replace(/[^\w-]+/g, '')
+        // Replace multiple hyphens with single hyphen
+        .replace(/--+/g, '-')
+        // Remove leading/trailing hyphens
+        .replace(/^-+/, '')
+        .replace(/-+$/, '');
+}
+// =============================================================================
+// SKU Generation
+// =============================================================================
+/**
+ * Generate a SKU (Stock Keeping Unit) from product details
+ *
+ * @param productName - Product name
+ * @param variant - Optional variant attributes
+ * @returns Generated SKU
+ *
+ * @example
+ * generateSKU('Blue T-Shirt') // => 'BLU-TSH-XXXX'
+ * generateSKU('Blue T-Shirt', { size: 'L', color: 'Blue' }) // => 'BLU-TSH-L-BLU-XXXX'
+ */
+export function generateSKU(productName, variant) {
+    // Extract first 3 characters of each significant word
+    const words = productName
+        .split(/\s+/)
+        .filter((w) => w.length > 2)
+        .slice(0, 2)
+        .map((w) => w.substring(0, 3).toUpperCase());
+    const baseSKU = words.join('-');
+    // Add variant attributes if provided
+    let variantPart = '';
+    if (variant) {
+        variantPart = Object.values(variant)
+            .map((v) => v.substring(0, 3).toUpperCase())
+            .join('-');
+    }
+    // Add random suffix for uniqueness
+    const suffix = Math.random().toString(36).substring(2, 6).toUpperCase();
+    return [baseSKU, variantPart, suffix].filter(Boolean).join('-');
+}
+// =============================================================================
+// Date Formatting
+// =============================================================================
+/**
+ * Format a date for display
+ *
+ * @param date - Date to format
+ * @param options - Intl.DateTimeFormat options
+ * @returns Formatted date string
+ */
+export function formatDate(date, options = {
+    year: 'numeric',
+    month: 'short',
+    day: 'numeric',
+}) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    return new Intl.DateTimeFormat('en-US', options).format(d);
+}
+/**
+ * Format a date as relative time (e.g., "2 hours ago")
+ *
+ * @param date - Date to format
+ * @returns Relative time string
+ */
+export function formatRelativeTime(date) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    const now = new Date();
+    const diffMs = now.getTime() - d.getTime();
+    const diffSecs = Math.floor(diffMs / 1000);
+    const diffMins = Math.floor(diffSecs / 60);
+    const diffHours = Math.floor(diffMins / 60);
+    const diffDays = Math.floor(diffHours / 24);
+    if (diffSecs < 60)
+        return 'just now';
+    if (diffMins < 60)
+        return `${diffMins} minute${diffMins > 1 ? 's' : ''} ago`;
+    if (diffHours < 24)
+        return `${diffHours} hour${diffHours > 1 ? 's' : ''} ago`;
+    if (diffDays < 7)
+        return `${diffDays} day${diffDays > 1 ? 's' : ''} ago`;
+    return formatDate(d);
+}
+// =============================================================================
+// String Utilities
+// =============================================================================
+/**
+ * Truncate text to a maximum length with ellipsis
+ *
+ * @param text - Text to truncate
+ * @param maxLength - Maximum length (default 100)
+ * @returns Truncated text with ellipsis if needed
+ */
+export function truncate(text, maxLength = 100) {
+    if (text.length <= maxLength)
+        return text;
+    return text.substring(0, maxLength - 3).trim() + '...';
+}
+/**
+ * Capitalize the first letter of a string
+ */
+export function capitalize(text) {
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+/**
+ * Convert a string to title case
+ */
+export function titleCase(text) {
+    return text
+        .toLowerCase()
+        .split(' ')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+// =============================================================================
+// Number Utilities
+// =============================================================================
+/**
+ * Clamp a number between min and max values
+ */
+export function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+/**
+ * Calculate percentage
+ */
+export function percentage(value, total) {
+    if (total === 0)
+        return 0;
+    return Math.round((value / total) * 100);
+}
+// =============================================================================
+// Validation Utilities
+// =============================================================================
+/**
+ * Validate an email address
+ */
+export function isValidEmail(email) {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+}
+/**
+ * Validate a phone number (basic validation)
+ */
+export function isValidPhone(phone) {
+    // Remove all non-digits
+    const digits = phone.replace(/\D/g, '');
+    // Check if we have 10-15 digits
+    return digits.length >= 10 && digits.length <= 15;
+}
+// =============================================================================
+// Object Utilities
+// =============================================================================
+/**
+ * Remove undefined and null values from an object
+ */
+export function compact(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v != null));
+}
+/**
+ * Pick specific keys from an object
+ */
+export function pick(obj, keys) {
+    return keys.reduce((acc, key) => {
+        if (key in obj) {
+            acc[key] = obj[key];
+        }
+        return acc;
+    }, {});
+}
+/**
+ * Omit specific keys from an object
+ */
+export function omit(obj, keys) {
+    const result = { ...obj };
+    for (const key of keys) {
+        delete result[key];
+    }
+    return result;
+}
+// =============================================================================
+// Async Utilities
+// =============================================================================
+/**
+ * Sleep for a specified duration
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Retry a function with exponential backoff
+ */
+export async function retry(fn, options = {}) {
+    const { maxAttempts = 3, delayMs = 1000 } = options;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt < maxAttempts) {
+                await sleep(delayMs * Math.pow(2, attempt - 1));
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=utils.js.map

package/dist/core/utils.js.map

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

package/dist/emails/config.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @rovela/sdk/emails/config
+ *
+ * Email configuration and Resend client management.
+ *
+ * These functions check the database for settings first, then fall back
+ * to environment variables. This allows admins to change store name and
+ * support email at runtime via the settings page.
+ */
+import { Resend } from 'resend';
+import type { EmailConfig } from './types';
+/**
+ * Get or create Resend client instance.
+ * Lazily initialized on first use.
+ *
+ * @throws Error if RESEND_API_KEY is not set
+ */
+export declare function getResend(): Resend;
+/**
+ * Get the sender email address.
+ * Format: "Store Name <email@domain.com>"
+ *
+ * Checks database settings first, then falls back to environment variables.
+ */
+export declare function getFromEmail(): Promise<string>;
+/**
+ * Get the store name, checking database settings first.
+ *
+ * Priority:
+ * 1. Database store_settings table (admin-editable)
+ * 2. STORE_NAME environment variable (deployment config)
+ * 3. Default fallback: 'Our Store'
+ *
+ * @returns Store name
+ */
+export declare function getStoreName(): Promise<string>;
+/**
+ * Get the store URL for links in emails.
+ */
+export declare function getStoreUrl(): string;
+/**
+ * Get the store logo URL, checking database settings first.
+ *
+ * Priority:
+ * 1. Database store_settings.logo_url (admin-editable, instant updates)
+ * 2. STORE_LOGO_URL environment variable (deployment config)
+ * 3. Empty string (no logo)
+ *
+ * @returns Logo URL or empty string
+ */
+export declare function getLogoUrl(): Promise<string>;
+/**
+ * Get the complete email configuration for templates.
+ * Assembles config from database and environment variables.
+ */
+export declare function getEmailConfig(): Promise<EmailConfig>;
+/**
+ * Get the support email address, checking database settings first.
+ *
+ * Priority:
+ * 1. Database store_settings.store_email (admin-editable)
+ * 2. SUPPORT_EMAIL environment variable
+ * 3. RESEND_FROM_EMAIL environment variable
+ * 4. Default fallback: 'support@example.com'
+ *
+ * @returns Support email address
+ */
+export declare function getSupportEmail(): Promise<string>;
+//# sourceMappingURL=config.d.ts.map

package/dist/emails/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/emails/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAS1C;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAgBlC;AAMD;;;;;GAKG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAKpD;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAapD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAalD;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAc3D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAiBvD"}

package/dist/emails/config.js

@@ -0,0 +1,147 @@
+/**
+ * @rovela/sdk/emails/config
+ *
+ * Email configuration and Resend client management.
+ *
+ * These functions check the database for settings first, then fall back
+ * to environment variables. This allows admins to change store name and
+ * support email at runtime via the settings page.
+ */
+import { Resend } from 'resend';
+import { findSettings } from '../core/db';
+// =============================================================================
+// Resend Client
+// =============================================================================
+let resendClient = null;
+/**
+ * Get or create Resend client instance.
+ * Lazily initialized on first use.
+ *
+ * @throws Error if RESEND_API_KEY is not set
+ */
+export function getResend() {
+    if (!resendClient) {
+        const apiKey = process.env.RESEND_API_KEY;
+        if (!apiKey) {
+            throw new Error('RESEND_API_KEY environment variable is not set. ' +
+                'Please add your Resend API key to .env.local:\n' +
+                'RESEND_API_KEY=re_xxx');
+        }
+        resendClient = new Resend(apiKey);
+    }
+    return resendClient;
+}
+// =============================================================================
+// Email Configuration (Async - checks DB first, falls back to env vars)
+// =============================================================================
+/**
+ * Get the sender email address.
+ * Format: "Store Name <email@domain.com>"
+ *
+ * Checks database settings first, then falls back to environment variables.
+ */
+export async function getFromEmail() {
+    const email = process.env.RESEND_FROM_EMAIL || 'noreply@example.com';
+    const storeName = await getStoreName();
+    return `${storeName} <${email}>`;
+}
+/**
+ * Get the store name, checking database settings first.
+ *
+ * Priority:
+ * 1. Database store_settings table (admin-editable)
+ * 2. STORE_NAME environment variable (deployment config)
+ * 3. Default fallback: 'Our Store'
+ *
+ * @returns Store name
+ */
+export async function getStoreName() {
+    // Try database first (each store has its own database)
+    try {
+        const settings = await findSettings();
+        if (settings?.storeName) {
+            return settings.storeName;
+        }
+    }
+    catch {
+        // DB not available or error - fall through to env var
+    }
+    // Fall back to environment variable
+    return process.env.STORE_NAME || 'Our Store';
+}
+/**
+ * Get the store URL for links in emails.
+ */
+export function getStoreUrl() {
+    return process.env.NEXT_PUBLIC_APP_URL || process.env.NEXTAUTH_URL || '';
+}
+/**
+ * Get the store logo URL, checking database settings first.
+ *
+ * Priority:
+ * 1. Database store_settings.logo_url (admin-editable, instant updates)
+ * 2. STORE_LOGO_URL environment variable (deployment config)
+ * 3. Empty string (no logo)
+ *
+ * @returns Logo URL or empty string
+ */
+export async function getLogoUrl() {
+    // Try database first (each store has its own database)
+    try {
+        const settings = await findSettings();
+        if (settings?.logoUrl) {
+            return settings.logoUrl;
+        }
+    }
+    catch {
+        // DB not available or error - fall through to env var
+    }
+    // Fall back to environment variable
+    return process.env.STORE_LOGO_URL || '';
+}
+/**
+ * Get the complete email configuration for templates.
+ * Assembles config from database and environment variables.
+ */
+export async function getEmailConfig() {
+    const [storeName, supportEmail, logoUrl] = await Promise.all([
+        getStoreName(),
+        getSupportEmail(),
+        getLogoUrl(),
+    ]);
+    return {
+        logoUrl,
+        storeName,
+        storeAddress: process.env.STORE_ADDRESS || '',
+        supportEmail,
+        shopUrl: getStoreUrl(),
+    };
+}
+/**
+ * Get the support email address, checking database settings first.
+ *
+ * Priority:
+ * 1. Database store_settings.store_email (admin-editable)
+ * 2. SUPPORT_EMAIL environment variable
+ * 3. RESEND_FROM_EMAIL environment variable
+ * 4. Default fallback: 'support@example.com'
+ *
+ * @returns Support email address
+ */
+export async function getSupportEmail() {
+    // Try database first (each store has its own database)
+    try {
+        const settings = await findSettings();
+        if (settings?.storeEmail) {
+            return settings.storeEmail;
+        }
+    }
+    catch {
+        // DB not available or error - fall through to env var
+    }
+    // Fall back to environment variables
+    return (process.env.SUPPORT_EMAIL ||
+        process.env.RESEND_FROM_EMAIL ||
+        'support@example.com');
+}
+//# sourceMappingURL=config.js.map

package/dist/emails/config.js.map

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

package/dist/emails/index.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @rovela/sdk/emails
+ *
+ * Transactional email module for e-commerce stores.
+ *
+ * This module provides:
+ * - Email template rendering functions
+ * - Send functions for common transactional emails
+ * - Configuration utilities for Resend integration
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { sendOrderConfirmation, sendVerificationEmail } from '@rovela/sdk/emails'
+ *
+ * // Send order confirmation
+ * await sendOrderConfirmation({
+ *   to: 'customer@example.com',
+ *   customerName: 'John',
+ *   orderNumber: 'ORD-12345',
+ *   // ... other params
+ * })
+ *
+ * // Send verification email
+ * await sendVerificationEmail({
+ *   to: 'customer@example.com',
+ *   customerName: 'John',
+ *   verificationLink: 'https://store.com/verify?token=...',
+ * })
+ * ```
+ *
+ * @example Fire-and-Forget (Webhooks)
+ * ```typescript
+ * import { sendOrderConfirmationAsync } from '@rovela/sdk/emails'
+ *
+ * // In webhook handler - don't wait for email
+ * sendOrderConfirmationAsync({
+ *   to: 'customer@example.com',
+ *   // ...
+ * })
+ *
+ * // Return immediately
+ * return Response.json({ received: true })
+ * ```
+ *
+ * @example Custom Templates
+ * ```typescript
+ * import { sendEmail, getEmailConfig, baseLayout } from '@rovela/sdk/emails'
+ *
+ * // Build custom email HTML
+ * const config = getEmailConfig()
+ * const html = baseLayout({
+ *   config,
+ *   title: 'Custom Email',
+ *   content: '<h1>Hello World</h1>',
+ * })
+ *
+ * // Send it
+ * await sendEmail({
+ *   to: 'customer@example.com',
+ *   subject: 'Custom Email',
+ *   html,
+ * })
+ * ```
+ *
+ * ## Environment Variables
+ *
+ * Required:
+ * - `RESEND_API_KEY` - Your Resend API key
+ * - `RESEND_FROM_EMAIL` - Sender email address (must be verified in Resend)
+ *
+ * Optional:
+ * - `STORE_NAME` - Store name (falls back to blueprint config)
+ * - `STORE_LOGO_URL` - Logo URL for emails
+ * - `STORE_ADDRESS` - Physical address for footer
+ * - `SUPPORT_EMAIL` - Support email (falls back to RESEND_FROM_EMAIL)
+ * - `NEXT_PUBLIC_APP_URL` - Store URL for links
+ */
+export type { EmailConfig, SendEmailOptions, SendEmailResult, EmailAddress, EmailOrderItem, EmailVerificationData, WelcomeEmailData, PasswordResetEmailData, OrderConfirmationData, OrderShippedData, OrderDeliveredData, OrderCancelledData, RefundProcessedData, EmailTemplateType, EmailData, } from './types';
+export { getResend, getFromEmail, getStoreName, getStoreUrl, getEmailConfig, getSupportEmail, } from './config';
+export { sendEmail, sendEmailAsync, sendEmailBatch } from './sender';
+export { formatDate, formatDateTime, formatPrice, formatAddressLine, formatAddressHtml, escapeHtml, emailButton, emailFooter, formatOrderNumber, } from './utils';
+export { baseLayout, primaryButton, heading, paragraph, infoBox, linkFallback, detailBox, statusBadge, highlightBox, secondaryButton, addressSection, sectionHeading, STYLES, renderEmailVerification, getEmailVerificationSubject, renderWelcomeEmail, getWelcomeEmailSubject, renderPasswordResetEmail, getPasswordResetSubject, renderOrderConfirmation, getOrderConfirmationSubject, renderOrderShipped, getOrderShippedSubject, renderOrderDelivered, getOrderDeliveredSubject, renderOrderCancelled, getOrderCancelledSubject, renderRefundProcessed, getRefundProcessedSubject, } from './templates';
+export { sendVerificationEmail, sendVerificationEmailAsync, sendWelcomeEmail, sendWelcomeEmailAsync, sendPasswordResetEmail, sendPasswordResetEmailAsync, sendAdminPasswordResetEmail, sendAdminPasswordResetEmailAsync, sendAdminInviteEmail, sendAdminInviteEmailAsync, sendOrderConfirmation, sendOrderConfirmationAsync, sendOrderShipped, sendOrderShippedAsync, sendOrderDelivered, sendOrderDeliveredAsync, sendOrderCancelled, sendOrderCancelledAsync, sendRefundProcessed, sendRefundProcessedAsync, } from './send';
+export type { SendVerificationEmailParams, SendWelcomeEmailParams, SendPasswordResetEmailParams, SendAdminPasswordResetEmailParams, SendAdminInviteEmailParams, SendOrderConfirmationParams, SendOrderShippedParams, SendOrderDeliveredParams, SendOrderCancelledParams, SendRefundProcessedParams, } from './send';
+//# sourceMappingURL=index.d.ts.map

package/dist/emails/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/emails/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AAMH,YAAY,EAEV,WAAW,EACX,gBAAgB,EAChB,eAAe,EAEf,YAAY,EACZ,cAAc,EAEd,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EAEtB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EAEnB,iBAAiB,EACjB,SAAS,GACV,MAAM,SAAS,CAAA;AAMhB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,UAAU,CAAA;AAMjB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAMpE,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAMhB,OAAO,EAEL,UAAU,EACV,aAAa,EACb,OAAO,EACP,SAAS,EACT,OAAO,EACP,YAAY,EACZ,SAAS,EACT,WAAW,EACX,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,MAAM,EAEN,uBAAuB,EACvB,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EAEvB,uBAAuB,EACvB,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,aAAa,CAAA;AAMpB,OAAO,EAEL,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAE3B,2BAA2B,EAC3B,gCAAgC,EAChC,oBAAoB,EACpB,yBAAyB,EAEzB,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,QAAQ,CAAA;AAGf,YAAY,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,4BAA4B,EAC5B,iCAAiC,EACjC,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,QAAQ,CAAA"}