@codeleap/styles 7.0.0 → 7.0.1

package/dist/classes/Cacher.js

@@ -0,0 +1,166 @@
+import { StyleConstants } from '../constants';
+import { hashKey } from '../tools';
+/**
+ * Generates a stale time date by adding 7 days to the current date
+ * @returns {Date} The future date representing the stale time
+ */
+function generateStaleTime() {
+    const time = 7;
+    let currentTime = new Date();
+    currentTime.setDate(currentTime.getDate() + time);
+    return currentTime;
+}
+/**
+ * Generic cache implementation with persistence and stale time management
+ * @template T - The type of values stored in the cache
+ */
+export class Cache {
+    /**
+     * Gets the persistence key for cache data
+     * @returns {string} The storage key for cache data
+     */
+    get persistKeyCache() {
+        return `@styles.caches.${this.registryName}.cache`;
+    }
+    /**
+     * Gets the persistence key for stale time
+     * @returns {string} The storage key for stale time
+     */
+    get persistKeyStaleTime() {
+        return `@styles.caches.${this.registryName}.staleTime`;
+    }
+    /**
+     * Creates a new Cache instance
+     * @param {CacheType} registryName - The name/type of the cache registry
+     * @param {StateStorage} [storage=null] - The storage implementation for persistence
+     * @param {boolean} [persistCache=!!storage] - Whether to persist cache to storage
+     */
+    constructor(registryName, storage = undefined, persistCache = !!storage) {
+        this.registryName = registryName;
+        this.storage = storage;
+        this.persistCache = persistCache;
+        /** In-memory cache storage */
+        this.cache = {};
+        /** Debounce timer for batch persistence */
+        this.persistTimer = null;
+        /** Debounce delay in milliseconds */
+        this.persistDelay = 4500;
+        if (!persistCache || !StyleConstants.STORE_CACHE_ENABLED)
+            return;
+        const { persistedCache, persistedStaleTime } = this.loadStorage();
+        const currentTime = new Date();
+        const isStaled = currentTime > persistedStaleTime;
+        if (isStaled) {
+            this.clearStorage();
+            return;
+        }
+        if (StyleConstants.LOG) {
+            console.log('Cache [constructor] ->', { persistedCache, persistedStaleTime, registryName });
+        }
+        this.setCache(persistedCache);
+        this.storeStaleTime(persistedStaleTime);
+    }
+    /**
+     * Generates a cache key and retrieves the cached value
+     * @param {string} cacheBaseKey - The base key for cache generation
+     * @param {Array<any> | any} data - The data to use for key generation
+     * @returns {{ key: string, value: T | null }} Object containing the cache key and value
+     */
+    keyFor(cacheBaseKey, data) {
+        var _a;
+        const values = [cacheBaseKey, data];
+        const cacheKey = hashKey(values);
+        const cachedValue = (_a = this.cache[cacheKey]) !== null && _a !== void 0 ? _a : null;
+        return {
+            key: cacheKey,
+            value: cachedValue,
+        };
+    }
+    /**
+     * Stores a value in the cache and optionally persists it
+     * @param {string} key - The cache key
+     * @param {T} cache - The value to cache
+     * @returns {T} The cached value
+     */
+    cacheFor(key, cache) {
+        this.cache[key] = cache;
+        if (this.persistCache) {
+            this.schedulePersist();
+        }
+        return cache;
+    }
+    /**
+     * Replaces the entire cache with new data
+     * @param {Record<string, T>} cache - The new cache data
+     */
+    setCache(cache) {
+        this.cache = cache !== null && cache !== void 0 ? cache : {};
+    }
+    /**
+     * Clears both in-memory and persistent cache
+     */
+    clear() {
+        if (this.persistTimer) {
+            clearTimeout(this.persistTimer);
+            this.persistTimer = null;
+        }
+        this.cache = {};
+        this.clearStorage();
+    }
+    /**
+     * Schedules cache persistence with debounce
+     */
+    schedulePersist() {
+        if (this.persistTimer) {
+            clearTimeout(this.persistTimer);
+        }
+        this.persistTimer = setTimeout(() => {
+            this.storeCache();
+            this.persistTimer = null;
+        }, this.persistDelay);
+    }
+    /**
+     * Loads cache data and stale time from persistent storage
+     * @returns {{ persistedStaleTime: Date, persistedCache: any }} Loaded data from storage
+     */
+    loadStorage() {
+        if (!this.persistCache)
+            return { persistedStaleTime: generateStaleTime(), persistedCache: {} };
+        const persistedStaleTime = this.storage.getItem(this.persistKeyStaleTime);
+        const persistedCache = this.storage.getItem(this.persistKeyCache);
+        return {
+            persistedStaleTime: !persistedStaleTime ? generateStaleTime() : new Date(persistedStaleTime),
+            persistedCache,
+        };
+    }
+    /**
+     * Clears cache data from persistent storage
+     */
+    clearStorage() {
+        if (!this.persistCache)
+            return;
+        this.storage.removeItem(this.persistKeyStaleTime);
+        this.storage.removeItem(this.persistKeyCache);
+    }
+    /**
+     * Stores cache data to persistent storage
+     * @param {Record<string, T>} [cache=null] - Cache data to store (uses current cache if not provided)
+     */
+    storeCache(cache = undefined) {
+        if (!this.persistCache)
+            return;
+        const value = cache !== null && cache !== void 0 ? cache : this.cache;
+        this.storage.setItem(this.persistKeyCache, value);
+    }
+    /**
+     * Stores stale time to persistent storage
+     * @param {Date} staleTime - The stale time to store
+     */
+    storeStaleTime(staleTime) {
+        if (!this.persistCache)
+            return;
+        const value = staleTime.toISOString();
+        this.storage.setItem(this.persistKeyStaleTime, value);
+    }
+}
+//# sourceMappingURL=Cacher.js.map

package/dist/classes/Cacher.js.map

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

package/dist/classes/StaleControl.js

@@ -0,0 +1,101 @@
+/**
+ * @UNUSED_IMPLEMENTATION - Class available for future use
+ * Stale data controller with temporal expiration system
+ *
+ * @description This implementation is complete but not currently being used.
+ * Developed for potential future need of time-based cache invalidation.
+ */
+export class StaleControl {
+    /**
+     * @param staleTime - Expiration time in minutes (default: 60 minutes)
+     * @param staleTimeIdentifier - Separator to identify timestamp in value (default: '//:')
+     * @param wiperInterval - Expired data check interval in milliseconds (default: 30 minutes)
+     */
+    constructor(staleTime = 60, // minutes
+    staleTimeIdentifier = '//:', wiperInterval = 30 * 60 * 1000) {
+        this.staleTime = staleTime;
+        this.staleTimeIdentifier = staleTimeIdentifier;
+        this.wiperInterval = wiperInterval;
+        this.wiperId = null;
+    }
+    /**
+     * Checks if a value is expired based on embedded timestamp
+     * @param value - Value with embedded timestamp
+     * @returns boolean indicating if value is expired
+     */
+    isStaled(value) {
+        const { staleTime } = this.extractStaleTime(value);
+        const currentTime = new Date();
+        const isStaled = currentTime > staleTime;
+        return isStaled;
+    }
+    /**
+     * Inserts expiration timestamp into a value
+     * @param value - Original value without timestamp
+     * @returns Value with expiration timestamp embedded
+     */
+    insertStaleTime(value) {
+        const currentTime = new Date();
+        currentTime.setMinutes(currentTime.getMinutes() + this.staleTime);
+        const staleTime = currentTime.toISOString();
+        const valueWithStaleTime = `${value}${this.staleTimeIdentifier}${staleTime}`;
+        return valueWithStaleTime;
+    }
+    /**
+     * Refreshes the expiration timestamp of a value
+     * @param value - Value with existing timestamp
+     * @returns Value with refreshed expiration timestamp
+     */
+    refreshStaleTime(value) {
+        const { value: extractedValue } = this.extractStaleTime(value);
+        const refreshedValue = this.insertStaleTime(extractedValue);
+        return refreshedValue;
+    }
+    /**
+     * Extracts expiration timestamp and original value
+     * @param value - Value with embedded timestamp
+     * @returns Object containing expiration date and original value
+     */
+    extractStaleTime(value) {
+        const [extractedValue, _staleTime] = (value === null || value === void 0 ? void 0 : value.split(this.staleTimeIdentifier)) || [];
+        const staleTime = new Date(_staleTime || 0);
+        return {
+            staleTime,
+            value: extractedValue || value,
+        };
+    }
+    /**
+     * Wipes expired cache; verifies isStaled values and removes them
+     * @throws Error indicating method is not implemented
+     */
+    cacheWiper() {
+        throw new Error('Cache Wiper not implemented - Requires storage integration for future use');
+    }
+    /**
+     * Registers periodic cache cleaning interval
+     */
+    registerCacheWiper() {
+        if (this.wiperId !== null) {
+            this.unregisterCacheWiper();
+        }
+        this.wiperId = setInterval(() => {
+            this.cacheWiper();
+        }, this.wiperInterval);
+    }
+    /**
+     * Unregisters periodic cache cleaning interval
+     */
+    unregisterCacheWiper() {
+        if (this.wiperId) {
+            clearInterval(this.wiperId);
+            this.wiperId = null;
+        }
+    }
+    /**
+     * Cleanup method to clear intervals when instance is no longer needed
+     */
+    destroy() {
+        this.unregisterCacheWiper();
+    }
+}
+//# sourceMappingURL=StaleControl.js.map

package/dist/classes/StaleControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StaleControl.js","sourceRoot":"","sources":["../../src/classes/StaleControl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACF,MAAM,OAAO,YAAY;IAGxB;;;;OAIG;IACH,YACU,YAAoB,EAAE,EAAE,UAAU;IAClC,sBAA8B,KAAK,EACnC,gBAAwB,EAAE,GAAG,EAAE,GAAG,IAAI;QAFtC,cAAS,GAAT,SAAS,CAAa;QACtB,wBAAmB,GAAnB,mBAAmB,CAAgB;QACnC,kBAAa,GAAb,aAAa,CAAyB;QAVxC,YAAO,GAA0C,IAAI,CAAA;IAW1D,CAAC;IAEJ;;;;OAIG;IACH,QAAQ,CAAC,KAAa;QACpB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAElD,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAA;QAE9B,MAAM,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAA;QAExC,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,KAAa;QAC3B,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAA;QAC9B,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;QAEjE,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,CAAA;QAC3C,MAAM,kBAAkB,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC,mBAAmB,GAAG,SAAS,EAAE,CAAA;QAE5E,OAAO,kBAAkB,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,KAAa;QAC5B,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAC9D,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,CAAA;QAE3D,OAAO,cAAc,CAAA;IACvB,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,KAAa;QAC5B,MAAM,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAI,EAAE,CAAA;QACjF,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAA;QAE3C,OAAO;YACL,SAAS;YACT,KAAK,EAAE,cAAc,IAAI,KAAK;SAC/B,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAA;IAC9F,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,oBAAoB,EAAE,CAAA;QAC7B,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;YAC9B,IAAI,CAAC,UAAU,EAAE,CAAA;QACnB,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;IACxB,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACrB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,oBAAoB,EAAE,CAAA;IAC7B,CAAC;CACF"}

package/dist/classes/StyleCache.js

@@ -0,0 +1,91 @@
+import { Cache } from './Cacher';
+import { hashKey, minifier } from '../tools';
+import { StyleConstants } from '../constants';
+/**
+ * Aggregates the six typed `Cache` buckets used by the style registry.
+ * Three buckets (`styles`, `compositions`, `responsive`) are in-memory only.
+ * Three buckets (`variants`, `common`, `components`) are backed by the
+ * provided `StateStorage` and survive page reloads until the stale window expires.
+ *
+ * All keys are derived from a `baseKey` that encodes the active color scheme,
+ * theme snapshot, and common variants — so switching color scheme automatically
+ * invalidates all cached values without an explicit `wipeCache` call.
+ */
+export class StyleCache {
+    /**
+     * Creates a new StyleCache instance
+     * @param storage - State storage instance for persistent caches
+     */
+    constructor(storage) {
+        /** Cache for style data */
+        this.styles = new Cache('styles');
+        /** Cache for style compositions */
+        this.compositions = new Cache('compositions');
+        /** Cache for responsive styles */
+        this.responsive = new Cache('responsive');
+        this.variants = new Cache('variants', storage);
+        this.common = new Cache('common', storage);
+        this.components = new Cache('components', storage);
+    }
+    /**
+     * Registers and generates a base key for cache operations
+     * @param keys - Array of values to include in base key generation
+     * @returns The generated base key hash
+     */
+    registerBaseKey(keys) {
+        keys.push(StyleConstants.STORES_PERSIST_VERSION);
+        const baseKey = hashKey(keys);
+        this.baseKey = baseKey;
+        return baseKey;
+    }
+    /**
+     * Clears all cache instances
+     */
+    wipeCache() {
+        this.components.clear();
+        this.responsive.clear();
+        this.compositions.clear();
+        this.variants.clear();
+        this.common.clear();
+        this.styles.clear();
+    }
+    /**
+     * Generates a cache key and retrieves cached value if exists
+     * @param type - The cache type to use
+     * @param keyData - Data to use for key generation (array or object)
+     * @returns Object containing the generated key and cached value (if any)
+     */
+    keyFor(type, keyData) {
+        var _a;
+        const cache = this[type];
+        const withFunctionsHash = Object.values(keyData).map((value) => {
+            if (typeof value === 'function') {
+                return value.toString();
+            }
+            return value;
+        });
+        const values = [this.baseKey, ...withFunctionsHash];
+        const cacheKey = hashKey(values);
+        const cachedValue = minifier.decompress((_a = cache.cache[cacheKey]) !== null && _a !== void 0 ? _a : null);
+        return {
+            key: cacheKey,
+            value: cachedValue,
+        };
+    }
+    /**
+     * Stores a value in the specified cache with compression
+     * @param type - The cache type to use
+     * @param key - Cache key
+     * @param value - Value to cache
+     * @returns The cached value (compressed if caching is enabled)
+     */
+    cacheFor(type, key, value) {
+        if (!StyleConstants.CACHE_ENABLED) {
+            return value;
+        }
+        const cache = this[type];
+        const minifiedValue = minifier.compress(value);
+        return cache.cacheFor(key, minifiedValue);
+    }
+}
+//# sourceMappingURL=StyleCache.js.map

package/dist/classes/StyleCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StyleCache.js","sourceRoot":"","sources":["../../src/classes/StyleCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAI7C;;;;;;;;;GASG;AACH,MAAM,OAAO,UAAU;IAsBrB;;;OAGG;IACH,YAAY,OAAqB;QAtBjC,2BAA2B;QAC3B,WAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAA;QAE5B,mCAAmC;QACnC,iBAAY,GAAG,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA;QAExC,kCAAkC;QAClC,eAAU,GAAG,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;QAgBlC,IAAI,CAAC,QAAQ,GAAG,IAAI,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAC1C,IAAI,CAAC,UAAU,GAAG,IAAI,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACpD,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,IAAgB;QAC9B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAA;QAEhD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QAE7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QAEtB,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;QACvB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;QACvB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;QACzB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;QACnB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAe,EAAE,OAAyB;;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;QAExB,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC7D,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAA;YACzB,CAAC;YAED,OAAO,KAAK,CAAA;QACd,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,iBAAiB,CAAC,CAAA;QAEnD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;QAChC,MAAM,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAA,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,mCAAI,IAAI,CAAC,CAAA;QAEtE,OAAO;YACL,GAAG,EAAE,QAAQ;YACb,KAAK,EAAE,WAAW;SACnB,CAAA;IACH,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,IAAe,EAAE,GAAW,EAAE,KAAU;QAC/C,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC;YAClC,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;QAExB,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAE9C,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;IAC3C,CAAC;CACF"}

package/dist/classes/StylePersistor.js

@@ -0,0 +1,54 @@
+import { minifier } from '../tools';
+import { StyleConstants } from '../constants';
+/**
+ * Adapts a platform `StoragePersistor` to the `StateStorage` interface expected by
+ * `StyleCache`. All values are LZ-compressed on write and decompressed on read,
+ * substantially reducing storage footprint for large serialised style caches.
+ */
+export class StylePersistor {
+    /**
+     * Creates a new StylePersistor instance with compression capabilities
+     * @param {StoragePersistor} storage - The underlying storage implementation
+     */
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Stores a value in the underlying storage with compression
+     *
+     * @param {string} name - Storage key identifier
+     * @param {string} value - Value to store (will be compressed)
+     * @returns {void}
+     * @throws {Error} If the underlying storage fails to set the value
+     */
+    setItem(name, value) {
+        const minifiedValue = minifier.compress(value);
+        return this.storage.set(name, minifiedValue);
+    }
+    /**
+     * Retrieves and decompresses a value from storage
+     * Returns null if key doesn't exist, value is null/undefined, or decompression fails
+     *
+     * @param {string} name - Storage key identifier
+     * @returns {string | null} Decompressed value or null if not found/invalid
+     * @throws {Error} If the underlying storage fails to get the value
+     */
+    getItem(name) {
+        const persistedValue = this.storage.get(name);
+        if (StyleConstants.LOG) {
+            console.log('StylePersistor [getItem] => ' + name, persistedValue);
+        }
+        return minifier.decompress(persistedValue !== null && persistedValue !== void 0 ? persistedValue : null);
+    }
+    /**
+     * Removes an item from storage
+     *
+     * @param {string} name - Storage key identifier
+     * @returns {void}
+     * @throws {Error} If the underlying storage fails to delete the value
+     */
+    removeItem(name) {
+        return this.storage.del(name);
+    }
+}
+//# sourceMappingURL=StylePersistor.js.map

package/dist/classes/StylePersistor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StylePersistor.js","sourceRoot":"","sources":["../../src/classes/StylePersistor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAc7C;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACzB;;;OAGG;IACH,YACU,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAC/B,CAAC;IAEL;;;;;;;OAOG;IACH,OAAO,CAAC,IAAY,EAAE,KAAa;QACjC,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAE9C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;IAC9C,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,IAAY;QAClB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAE7C,IAAI,cAAc,CAAC,GAAG,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,8BAA8B,GAAG,IAAI,EAAE,cAAc,CAAC,CAAA;QACpE,CAAC;QAED,OAAO,QAAQ,CAAC,UAAU,CAAC,cAAc,aAAd,cAAc,cAAd,cAAc,GAAI,IAAI,CAAC,CAAA;IACpD,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;CACF"}