@lionrapid/core 0.1.0

package/dist/browser/storage/localstorage-repository.js

@@ -0,0 +1,270 @@
+/**
+ * LocalStorage Repository for persistent cache (Browser Bundle Version)
+ * Implements ISyncRepository for synchronous access to localStorage
+ */
+const STORAGE_PREFIX = 'lionrapid:';
+const VERSION_KEY = `${STORAGE_PREFIX}version`;
+const CURRENT_VERSION = '1';
+/**
+ * LocalStorage-based repository for persistent translation caching
+ */
+export class LocalStorageRepository {
+    name = 'LocalStorageRepository';
+    type = 'memory';
+    config;
+    available;
+    prefix;
+    defaultTTL;
+    maxSize;
+    constructor(config = {}) {
+        this.config = {
+            enabled: config.enabled ?? true,
+            priority: config.priority ?? 0,
+            options: {
+                prefix: config.options?.prefix ?? STORAGE_PREFIX,
+                ttl: config.options?.ttl ?? 24 * 60 * 60 * 1000,
+                maxSize: config.options?.maxSize ?? 500,
+                ...config.options,
+            },
+        };
+        this.prefix = this.config.options?.prefix ?? STORAGE_PREFIX;
+        this.defaultTTL = this.config.options?.ttl ?? 24 * 60 * 60 * 1000;
+        this.maxSize = this.config.options?.maxSize ?? 500;
+        this.available = this.checkAvailability();
+        if (this.available) {
+            this.migrateIfNeeded();
+        }
+    }
+    checkAvailability() {
+        if (typeof window === 'undefined') {
+            return false;
+        }
+        try {
+            const testKey = `${this.prefix}__test__`;
+            window.localStorage.setItem(testKey, 'test');
+            window.localStorage.removeItem(testKey);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    migrateIfNeeded() {
+        try {
+            const storedVersion = window.localStorage.getItem(VERSION_KEY);
+            if (storedVersion !== CURRENT_VERSION) {
+                this.clear();
+                window.localStorage.setItem(VERSION_KEY, CURRENT_VERSION);
+            }
+        }
+        catch {
+            // Ignore migration errors
+        }
+    }
+    get(key) {
+        if (!this.available)
+            return null;
+        try {
+            const fullKey = this.prefix + key;
+            const itemStr = window.localStorage.getItem(fullKey);
+            if (!itemStr)
+                return null;
+            const item = JSON.parse(itemStr);
+            if (item.expiry !== null && Date.now() > item.expiry) {
+                window.localStorage.removeItem(fullKey);
+                return null;
+            }
+            return item.value;
+        }
+        catch {
+            return null;
+        }
+    }
+    set(key, value) {
+        if (!this.available)
+            return;
+        const fullKey = this.prefix + key;
+        const item = {
+            value,
+            expiry: this.defaultTTL ? Date.now() + this.defaultTTL : null,
+            timestamp: Date.now(),
+        };
+        try {
+            const entryCount = this.getEntryCount();
+            if (entryCount >= this.maxSize) {
+                this.evictOldest();
+            }
+            window.localStorage.setItem(fullKey, JSON.stringify(item));
+        }
+        catch (error) {
+            if (this.isQuotaError(error)) {
+                this.evictOldest();
+                try {
+                    window.localStorage.setItem(fullKey, JSON.stringify(item));
+                }
+                catch {
+                    // Give up silently
+                }
+            }
+        }
+    }
+    remove(key) {
+        if (!this.available)
+            return;
+        try {
+            window.localStorage.removeItem(this.prefix + key);
+        }
+        catch {
+            // Ignore removal errors
+        }
+    }
+    clear() {
+        if (!this.available)
+            return;
+        try {
+            const keysToRemove = [];
+            for (let i = 0; i < window.localStorage.length; i++) {
+                const key = window.localStorage.key(i);
+                if (key?.startsWith(this.prefix) && key !== VERSION_KEY) {
+                    keysToRemove.push(key);
+                }
+            }
+            keysToRemove.forEach((k) => window.localStorage.removeItem(k));
+        }
+        catch {
+            // Ignore clear errors
+        }
+    }
+    clearNamespace(locale, namespace) {
+        if (!this.available)
+            return;
+        const namespaceCacheKey = `@${locale}:${namespace}`;
+        const keyPrefix = `${locale}:${namespace}:`;
+        try {
+            const keysToRemove = [];
+            for (let i = 0; i < window.localStorage.length; i++) {
+                const key = window.localStorage.key(i);
+                if (!key?.startsWith(this.prefix))
+                    continue;
+                const innerKey = key.slice(this.prefix.length);
+                if (innerKey === namespaceCacheKey || innerKey.startsWith(keyPrefix)) {
+                    keysToRemove.push(key);
+                }
+            }
+            keysToRemove.forEach((k) => window.localStorage.removeItem(k));
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    getNamespace(locale, namespace) {
+        const namespaceCacheKey = `@${locale}:${namespace}`;
+        const value = this.get(namespaceCacheKey);
+        if (!value)
+            return null;
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            this.remove(namespaceCacheKey);
+            return null;
+        }
+    }
+    setNamespace(locale, namespace, translations) {
+        const namespaceCacheKey = `@${locale}:${namespace}`;
+        this.set(namespaceCacheKey, JSON.stringify(translations));
+    }
+    getEntries() {
+        const entries = {};
+        if (!this.available)
+            return entries;
+        try {
+            for (let i = 0; i < window.localStorage.length; i++) {
+                const fullKey = window.localStorage.key(i);
+                if (!fullKey?.startsWith(this.prefix) || fullKey === VERSION_KEY) {
+                    continue;
+                }
+                const key = fullKey.slice(this.prefix.length);
+                const value = this.get(key);
+                if (value !== null) {
+                    entries[key] = value;
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+        return entries;
+    }
+    getConfig() {
+        return this.config;
+    }
+    isAvailable() {
+        return this.available;
+    }
+    getEntryCount() {
+        if (!this.available)
+            return 0;
+        let count = 0;
+        try {
+            for (let i = 0; i < window.localStorage.length; i++) {
+                const key = window.localStorage.key(i);
+                if (key?.startsWith(this.prefix) && key !== VERSION_KEY) {
+                    count++;
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+        return count;
+    }
+    isQuotaError(error) {
+        if (error instanceof DOMException) {
+            return (error.name === 'QuotaExceededError' ||
+                error.name === 'NS_ERROR_DOM_QUOTA_REACHED');
+        }
+        return false;
+    }
+    evictOldest() {
+        if (!this.available)
+            return;
+        try {
+            const entries = [];
+            for (let i = 0; i < window.localStorage.length; i++) {
+                const fullKey = window.localStorage.key(i);
+                if (!fullKey?.startsWith(this.prefix) || fullKey === VERSION_KEY) {
+                    continue;
+                }
+                try {
+                    const itemStr = window.localStorage.getItem(fullKey);
+                    if (itemStr) {
+                        const item = JSON.parse(itemStr);
+                        entries.push({ key: fullKey, timestamp: item.timestamp });
+                    }
+                }
+                catch {
+                    window.localStorage.removeItem(fullKey);
+                }
+            }
+            entries.sort((a, b) => a.timestamp - b.timestamp);
+            const removeCount = Math.max(1, Math.floor(entries.length * 0.25));
+            for (let i = 0; i < removeCount && i < entries.length; i++) {
+                window.localStorage.removeItem(entries[i].key);
+            }
+        }
+        catch {
+            // Ignore eviction errors
+        }
+    }
+    getCacheStats() {
+        const size = this.getEntryCount();
+        const usage = this.maxSize > 0 ? `${Math.round((size / this.maxSize) * 100)}%` : '0%';
+        return {
+            size,
+            maxSize: this.maxSize,
+            usage,
+        };
+    }
+}
+//# sourceMappingURL=localstorage-repository.js.map

package/dist/browser/storage/localstorage-repository.js.map

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

package/dist/builder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * LionRapid Builder - Enhanced with explicit namespace preloading
+ */
+import type { LionRapidCoreConfig } from './config/lionrapid.config.js';
+import type { IEmbeddedPlugin, IPlugin } from './interfaces/plugin.interface.js';
+import { IAsyncRepository, ISyncRepository } from './interfaces/repository.interface.js';
+import { LionRapidCore } from './lionRapid.js';
+export declare class LionRapidBuilder {
+    private config;
+    private plugins;
+    private syncStorageRepos;
+    private asyncStorageRepos;
+    private networkRepos;
+    private syncQueue;
+    constructor(config: LionRapidCoreConfig);
+    static init(config?: LionRapidCoreConfig): LionRapidBuilder;
+    private useSyncStorage;
+    private useAsyncStorage;
+    private useNetwork;
+    use(instance: IPlugin | IEmbeddedPlugin | ISyncRepository | IAsyncRepository): LionRapidBuilder;
+    build(): Promise<LionRapidCore>;
+    private executePreloading;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAIxE,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EACR,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,eAAe,EAChB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI/C,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,SAAS,CAAwC;gBAE7C,MAAM,EAAE,mBAAmB;IAQvC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAE,mBAAwB,GAAG,gBAAgB;IAI/D,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,UAAU;IAKlB,GAAG,CACD,QAAQ,EAAE,OAAO,GAAG,eAAe,GAAG,eAAe,GAAG,gBAAgB,GACvE,gBAAgB;IAkBb,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;YAuGvB,iBAAiB;CA+ChC"}

package/dist/builder.js

@@ -0,0 +1,169 @@
+/**
+ * LionRapid Builder - Enhanced with explicit namespace preloading
+ */
+import { EventEmitter } from './base/event-emitter.js';
+import { HandlerChain } from './handlers/handler-chain.js';
+import { AsyncHandler, NetworkHandler, SyncHandler } from './handlers/index.js';
+import { LionRapidCore } from './lionRapid.js';
+import { MissingTranslationQueue } from './sync/missing-translation-queue.js';
+import { logger } from './utils/logger.js';
+export class LionRapidBuilder {
+    config;
+    plugins = [];
+    syncStorageRepos = [];
+    asyncStorageRepos = [];
+    networkRepos = [];
+    syncQueue = null;
+    constructor(config) {
+        this.config = {
+            defaultLocale: config.defaultLocale || 'en',
+            fallbackLocale: config.fallbackLocale || 'en',
+            namespace: config.namespace || 'app',
+        };
+    }
+    static init(config = {}) {
+        return new LionRapidBuilder(config);
+    }
+    useSyncStorage(memory) {
+        this.syncStorageRepos.push(memory);
+        return this;
+    }
+    useAsyncStorage(storage) {
+        this.asyncStorageRepos.push(storage);
+        return this;
+    }
+    useNetwork(network) {
+        this.networkRepos.push(network);
+        return this;
+    }
+    use(instance) {
+        switch (instance.type) {
+            case 'plugin':
+                this.plugins.push(instance);
+                break;
+            case 'memory':
+                this.useSyncStorage(instance);
+                break;
+            case 'storage':
+                this.useAsyncStorage(instance);
+                break;
+            case 'network':
+                this.useNetwork(instance);
+                break;
+        }
+        return this;
+    }
+    async build() {
+        const eventEmitter = new EventEmitter();
+        const buildBus = eventEmitter.builder();
+        logger.info('Builder started');
+        logger.debug('Builder config', this.config);
+        buildBus.buildStart(this.config.defaultLocale, this.config.namespace);
+        const handlerChain = new HandlerChain(eventEmitter);
+        // Always add memory cache handler first
+        for (const syncRepo of this.syncStorageRepos) {
+            if (!syncRepo.getConfig().enabled)
+                continue;
+            const syncHandler = new SyncHandler(eventEmitter, syncRepo);
+            buildBus.use('sync');
+            handlerChain.addSyncHandler(syncHandler);
+        }
+        // Always add storage cache handler second
+        for (const asyncRepo of this.asyncStorageRepos) {
+            if (!asyncRepo.getConfig().enabled)
+                continue;
+            const asyncHandler = new AsyncHandler(eventEmitter, asyncRepo);
+            buildBus.use('async');
+            handlerChain.addAsyncHandler(asyncHandler);
+        }
+        // Always add network cache handler last
+        let networkFirst = null;
+        for (const networkRepo of this.networkRepos) {
+            if (!networkRepo.getConfig().enabled ||
+                !networkRepo.getConfig().options?.baseUrl)
+                continue;
+            const networkHandler = new NetworkHandler(eventEmitter, networkRepo);
+            if (!networkFirst) {
+                networkFirst = networkHandler;
+            }
+            buildBus.use('network');
+            handlerChain.addAsyncHandler(networkHandler);
+            // ✅ Initialize missing translation sync queue if enabled
+            const config = networkRepo.getConfig();
+            if (config.options?.syncMissing?.enabled) {
+                this.syncQueue = new MissingTranslationQueue(networkRepo, {
+                    enabled: config.options.syncMissing.enabled,
+                    debounceMs: config.options.syncMissing.debounceMs || 500,
+                    batchSize: config.options.syncMissing.batchSize || 50,
+                }, eventEmitter);
+                // Subscribe to translation:not-found events (404 only)
+                // Note: translation:locked (423) is NOT synced since translation exists but is not ready
+                eventEmitter.on('translation:not-found', envelope => {
+                    if (this.syncQueue) {
+                        this.syncQueue.add({
+                            key: envelope.payload.key,
+                            fallbackValue: envelope.payload.fallbackValue,
+                            styles: envelope.payload.styles,
+                            locale: envelope.payload.locale,
+                            namespace: envelope.payload.namespace,
+                        });
+                    }
+                });
+                logger.info('Missing translation sync enabled');
+                logger.debug('Sync queue config', config.options.syncMissing);
+            }
+        }
+        logger.debug('Handler chain constructed');
+        // Create facade
+        const facade = new LionRapidCore(eventEmitter, handlerChain, this.config.defaultLocale, this.config.fallbackLocale, this.config.namespace);
+        // Initialize plugins and add their handlers
+        for (const plugin of this.plugins) {
+            buildBus.use('plugin');
+            await plugin.initialize({ core: facade, bus: eventEmitter });
+            facade.registerPlugin(plugin);
+            logger.info(`Plugin initialized: ${plugin.name}`);
+            logger.debug(`Plugin version: ${plugin.version}`, plugin.capabilities);
+        }
+        const chainInfo = handlerChain.getChainInfo();
+        // ✅ Explicit namespace preloading
+        if (networkFirst) {
+            await this.executePreloading(networkFirst, handlerChain);
+        }
+        logger.info('Builder completed');
+        buildBus.buildDone(chainInfo.handlers.map(r => r.name), this.plugins.map(p => p.name));
+        return facade;
+    }
+    // ✅ CLEAN: Preloading logic
+    async executePreloading(networkHandler, handlerChain) {
+        const eagerPreloads = networkHandler
+            .getPreload()
+            .filter(config => config.eager !== false);
+        if (!eagerPreloads || eagerPreloads.length === 0) {
+            return;
+        }
+        logger.info(`Preloading ${eagerPreloads.length} namespaces`);
+        logger.debug('Preload targets', {
+            namespaces: eagerPreloads.map(c => `${c.locale}:${c.namespace}`),
+        });
+        const promises = eagerPreloads.map(async (preloadConfig) => {
+            try {
+                const result = await networkHandler.loadNamespace(preloadConfig.locale, preloadConfig.namespace);
+                if (result && result.data && result.status === 200) {
+                    const context = {
+                        locale: preloadConfig.locale,
+                        namespace: preloadConfig.namespace,
+                        fallbackLocale: this.config.fallbackLocale,
+                    };
+                    await handlerChain.saveNamespaceToHandlers(result.data, context);
+                    logger.debug(`Preloaded: ${preloadConfig.locale}:${preloadConfig.namespace}`);
+                }
+            }
+            catch (error) {
+                logger.warn(`Preload failed: ${preloadConfig.locale}:${preloadConfig.namespace}`, error);
+            }
+        });
+        await Promise.allSettled(promises);
+        logger.info('Preloading completed');
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/builder.js.map

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

package/dist/cache/CacheManager.d.ts

@@ -0,0 +1,132 @@
+/**
+ * CacheManager - TanStack Query-inspired cache management
+ *
+ * Provides unified cache invalidation and optimistic update patterns.
+ */
+import type { EventEmitter } from '../base/event-emitter.js';
+import type { HandlerChain } from '../handlers/handler-chain.js';
+/**
+ * Options for cache invalidation (like TanStack's invalidateQueries)
+ */
+export interface InvalidateOptions {
+    /** Invalidate by namespace */
+    namespace?: string;
+    /** Invalidate by locale */
+    locale?: string;
+    /** Invalidate specific key */
+    key?: string;
+    /** Custom predicate filter */
+    predicate?: (key: string) => boolean;
+    /** Whether to refetch after invalidation (default: true) */
+    refetch?: boolean;
+}
+/**
+ * Cached translation entry
+ */
+export interface CacheEntry {
+    value: string;
+    styles?: Record<string, string[]>;
+}
+/**
+ * Cache event payloads
+ */
+export interface CacheEventPayloads {
+    'cache:invalidate': {
+        filter: InvalidateOptions;
+        keysCleared: number;
+        refetch: boolean;
+    };
+    'cache:set': {
+        key: string;
+        value: string;
+        styles?: Record<string, string[]>;
+        optimistic: boolean;
+    };
+    'cache:rollback': {
+        key: string;
+        reason: string;
+    };
+}
+/**
+ * CacheManager - Unified cache API inspired by TanStack Query
+ *
+ * @example
+ * ```typescript
+ * // Invalidate by namespace
+ * await i18n.cache.invalidate({ namespace: 'app' });
+ *
+ * // Optimistic update
+ * const previous = i18n.cache.get('en:app:welcome');
+ * i18n.cache.set('en:app:welcome', 'New value');
+ * // ... if error, rollback:
+ * i18n.cache.set('en:app:welcome', previous.value);
+ * ```
+ */
+export declare class CacheManager {
+    private handlerChain;
+    private bus;
+    private currentLocale;
+    private loadNamespaces;
+    constructor(handlerChain: HandlerChain, bus: EventEmitter, getCurrentLocale: () => string, loadNamespaces: (locale: string, namespaces: string[]) => Promise<void>);
+    /**
+     * Get a cached translation entry
+     *
+     * @param key - Full cache key (e.g., 'en:app:welcome')
+     * @returns Cache entry with value and styles, or null if not found
+     */
+    get(key: string): CacheEntry | null;
+    /**
+     * Set a cache entry (for optimistic updates)
+     *
+     * @param key - Full cache key (e.g., 'en:app:welcome')
+     * @param value - Translation value
+     * @param styles - Optional styles for indexed tags
+     */
+    set(key: string, value: string, styles?: Record<string, string[]>): void;
+    /**
+     * Check if a key exists in cache
+     *
+     * @param key - Full cache key (e.g., 'en:app:welcome')
+     * @returns true if key is cached
+     */
+    has(key: string): boolean;
+    /**
+     * Invalidate cache entries and optionally refetch
+     *
+     * Like TanStack Query's invalidateQueries, this clears matching cache entries
+     * and triggers background refetch by default.
+     *
+     * @param options - Filter options for invalidation
+     *
+     * @example
+     * ```typescript
+     * // Invalidate all
+     * await cache.invalidate();
+     *
+     * // Invalidate by namespace
+     * await cache.invalidate({ namespace: 'app' });
+     *
+     * // Invalidate by locale
+     * await cache.invalidate({ locale: 'es' });
+     *
+     * // Invalidate specific key
+     * await cache.invalidate({ key: 'en:app:welcome' });
+     *
+     * // Invalidate with predicate
+     * await cache.invalidate({ predicate: (k) => k.includes('common:') });
+     *
+     * // Invalidate without refetch
+     * await cache.invalidate({ namespace: 'app', refetch: false });
+     * ```
+     */
+    invalidate(options?: InvalidateOptions): Promise<void>;
+    /**
+     * Count keys that would be cleared (for event reporting)
+     */
+    private countClearedKeys;
+    /**
+     * Refetch data after invalidation
+     */
+    private refetchAfterInvalidate;
+}
+//# sourceMappingURL=CacheManager.d.ts.map

package/dist/cache/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/cache/CacheManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE;QAClB,MAAM,EAAE,iBAAiB,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,WAAW,EAAE;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAClC,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,gBAAgB,EAAE;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,cAAc,CAA0D;gBAG9E,YAAY,EAAE,YAAY,EAC1B,GAAG,EAAE,YAAY,EACjB,gBAAgB,EAAE,MAAM,MAAM,EAC9B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC;IAQzE;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IA0CnC;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI;IAyBxE;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgGhE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;YACW,sBAAsB;CAmBrC"}