@coherent.js/core 1.0.0-beta.2

package/dist/performance/cache-manager.js

@@ -0,0 +1,314 @@
+/**
+ * Advanced caching system with memory management and smart invalidation for Coherent.js
+ *
+ * @module @coherent/performance/cache-manager
+ * @license MIT
+ */
+/**
+ * @typedef {Object} CacheEntry
+ * @property {any} value - The cached value
+ * @property {number} timestamp - When the entry was created
+ * @property {number} lastAccess - Last access time
+ * @property {number} size - Approximate size in bytes
+ * @property {Object} metadata - Additional metadata
+ * @property {number} accessCount - Number of times accessed
+ */
+/**
+ * @typedef {Object} CacheStats
+ * @property {number} hits - Number of cache hits
+ * @property {number} misses - Number of cache misses
+ * @property {number} size - Current cache size in bytes
+ * @property {number} entries - Number of cache entries
+ * @property {Record<string, number>} hitRate - Hit rate by cache type
+ */
+/**
+ * @typedef {Object} CacheOptions
+ * @property {number} [maxCacheSize=1000] - Maximum number of entries per cache type
+ * @property {number} [maxMemoryMB=100] - Maximum memory usage in MB
+ * @property {number} [ttlMs=300000] - Default time-to-live in milliseconds (5 minutes)
+ * @property {boolean} [enableStatistics=true] - Whether to collect usage statistics
+ */
+/**
+ * Creates a new CacheManager instance
+ * @param {CacheOptions} [options] - Configuration options
+ * @returns {Object} Cache manager instance
+ */
+export function createCacheManager(options = {}) {
+    const { maxCacheSize = 1000, maxMemoryMB = 100, ttlMs = 1000 * 60 * 5, // 5 minutes
+    enableStatistics = true } = options;
+    // Internal state
+    const caches = {
+        static: new Map(), // Never-changing components
+        component: new Map(), // Component results with deps
+        template: new Map(), // Template strings
+        data: new Map() // General purpose data
+    };
+    let memoryUsage = 0;
+    const stats = {
+        hits: 0,
+        misses: 0,
+        hitRate: {
+            static: 0,
+            component: 0,
+            template: 0,
+            data: 0
+        },
+        accessCount: {
+            static: 0,
+            component: 0,
+            template: 0,
+            data: 0
+        }
+    };
+    // Cleanup interval (doesn't keep Node.js process alive)
+    let cleanupInterval;
+    if (typeof setInterval === 'function') {
+        cleanupInterval = setInterval(() => cleanup(), 30000);
+        if (cleanupInterval.unref) {
+            cleanupInterval.unref();
+        }
+    }
+    /**
+     * Generate a cache key from component and props
+     * @param {any} component - Component or component name
+     * @param {Object} [props={}] - Component props
+     * @param {Object} [context={}] - Additional context
+     * @returns {string} Cache key
+     */
+    function generateCacheKey(component, props = {}, context = {}) {
+        const componentStr = typeof component === 'function'
+            ? component.name || component.toString()
+            : JSON.stringify(component);
+        const propsStr = JSON.stringify(props, Object.keys(_props).sort());
+        const contextStr = JSON.stringify(_context);
+        const hash = simpleHash(componentStr + propsStr + contextStr);
+        return `${extractComponentName(component)}_${hash}`;
+    }
+    /**
+     * Get a value from the cache
+     * @param {string} key - Cache key
+     * @param {string} [type='component'] - Cache type
+     * @returns {any|null} Cached value or null if not found
+     */
+    function get(key, type = 'component') {
+        const cache = caches[type] || caches.component;
+        const _entry = cache.get(key);
+        if (!entry) {
+            stats.misses++;
+            if (enableStatistics)
+                stats.accessCount[type]++;
+            return null;
+        }
+        // Check TTL
+        if (Date.now() - entry.timestamp > ttlMs) {
+            cache.delete(key);
+            updateMemoryUsage(-entry.size);
+            stats.misses++;
+            if (enableStatistics)
+                stats.accessCount[type]++;
+            return null;
+        }
+        // Update access time and stats
+        entry.lastAccess = Date.now();
+        entry.accessCount++;
+        stats.hits++;
+        if (enableStatistics) {
+            stats.accessCount[type]++;
+            stats.hitRate[type] = (stats.hits / (stats.hits + stats.misses)) * 100;
+        }
+        return entry.value;
+    }
+    /**
+     * Store a value in the cache
+     * @param {string} key - Cache key
+     * @param {any} value - Value to cache
+     * @param {string} [type='component'] - Cache type
+     * @param {Object} [metadata={}] - Additional metadata
+     */
+    function set(key, value, type = 'component', metadata = {}) {
+        const cache = caches[type] || caches.component;
+        const size = calculateSize(value);
+        // Check memory limits
+        if (memoryUsage + size > maxMemoryMB * 1024 * 1024) {
+            optimize(type, size);
+        }
+        const _entry = {
+            value,
+            timestamp: Date.now(),
+            lastAccess: Date.now(),
+            size,
+            metadata,
+            accessCount: 0
+        };
+        // Remove existing entry if it exists
+        const existing = cache.get(key);
+        if (existing) {
+            updateMemoryUsage(-existing.size);
+        }
+        cache.set(key, entry);
+        updateMemoryUsage(size);
+        // Enforce cache size limits
+        if (cache.size > maxCacheSize) {
+            optimize(type);
+        }
+    }
+    /**
+     * Remove an entry from the cache
+     * @param {string} key - Cache key
+     * @param {string} [type] - Cache type (optional, checks all caches if not provided)
+     * @returns {boolean} True if an entry was removed
+     */
+    function remove(key, type) {
+        if (type) {
+            const cache = caches[type];
+            if (!cache)
+                return false;
+            const _entry = cache.get(key);
+            if (entry) {
+                updateMemoryUsage(-entry.size);
+                return cache.delete(key);
+            }
+            return false;
+        }
+        // Check all caches if no type specified
+        for (const [, cache] of Object.entries(caches)) {
+            const _entry = cache.get(key);
+            if (entry) {
+                updateMemoryUsage(-entry.size);
+                return cache.delete(key);
+            }
+        }
+        return false;
+    }
+    /**
+     * Clear all caches or a specific cache type
+     * @param {string} [type] - Cache type to clear (optional, clears all if not provided)
+     */
+    function clear(type) {
+        if (type) {
+            const cache = caches[type];
+            if (cache) {
+                cache.clear();
+            }
+        }
+        else {
+            Object.values(caches).forEach(cache => cache.clear());
+        }
+        memoryUsage = 0;
+    }
+    /**
+     * Get cache statistics
+     * @returns {CacheStats} Cache statistics
+     */
+    function getStats() {
+        const entries = Object.values(caches).reduce((sum, cache) => sum + cache.size, 0);
+        return {
+            hits: stats.hits,
+            misses: stats.misses,
+            size: memoryUsage,
+            entries,
+            hitRate: stats.hitRate,
+            accessCount: stats.accessCount
+        };
+    }
+    /**
+     * Clean up expired entries
+     */
+    function cleanup() {
+        const now = Date.now();
+        let freed = 0;
+        for (const [, cache] of Object.entries(caches)) {
+            for (const [key, entry] of cache.entries()) {
+                if (now - entry.timestamp > ttlMs) {
+                    cache.delete(key);
+                    updateMemoryUsage(-entry.size);
+                    freed++;
+                }
+            }
+        }
+        return { freed };
+    }
+    // Internal helper functions
+    function calculateSize(value) {
+        if (value === null || value === undefined)
+            return 0;
+        if (typeof value === 'string')
+            return value.length * 2; // UTF-16
+        if (typeof value === 'number')
+            return 8; // 64-bit float
+        if (typeof value === 'boolean')
+            return 4;
+        if (Array.isArray(value)) {
+            return value.reduce((sum, item) => sum + calculateSize(item), 0);
+        }
+        if (typeof value === 'object') {
+            return Object.values(value).reduce((sum, val) => sum + calculateSize(val), 0);
+        }
+        return 0;
+    }
+    function updateMemoryUsage(delta) {
+        memoryUsage = Math.max(0, memoryUsage + delta);
+    }
+    function optimize(type, requiredSpace = 0) {
+        const cache = caches[type] || caches.component;
+        const entries = Array.from(cache.entries())
+            .sort(([, a], [, b]) => a.lastAccess - b.lastAccess);
+        let freed = 0;
+        for (const [key, entry] of entries) {
+            if (freed >= requiredSpace)
+                break;
+            cache.delete(key);
+            updateMemoryUsage(-entry.size);
+            freed += entry.size;
+        }
+        return { freed };
+    }
+    function simpleHash(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        return Math.abs(hash).toString(36);
+    }
+    function extractComponentName(component) {
+        if (typeof component === 'function') {
+            return component.name || 'AnonymousComponent';
+        }
+        if (component && typeof component === 'object') {
+            const keys = Object.keys(component);
+            return keys.length > 0 ? keys[0] : 'ObjectComponent';
+        }
+        return 'UnknownComponent';
+    }
+    // Clean up on destroy
+    function destroy() {
+        if (cleanupInterval) {
+            clearInterval(cleanupInterval);
+        }
+        clear();
+    }
+    // Public API
+    return {
+        get,
+        set,
+        remove,
+        clear,
+        getStats,
+        cleanup,
+        destroy,
+        generateCacheKey,
+        get memoryUsage() {
+            return memoryUsage;
+        },
+        get maxMemory() {
+            return maxMemoryMB * 1024 * 1024;
+        }
+    };
+}
+// Create a default instance for convenience
+export const cacheManager = createCacheManager();
+// For backward compatibility
+export const CacheManager = { create: createCacheManager };
+//# sourceMappingURL=cache-manager.js.map

package/dist/performance/cache-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.js","sourceRoot":"","sources":["../../../../src/performance/cache-manager.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AAEH;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAO,GAAG,EAAE;IAC7C,MAAM,EACJ,YAAY,GAAG,IAAI,EACnB,WAAW,GAAG,GAAG,EACjB,KAAK,GAAG,IAAI,GAAG,EAAE,GAAG,CAAC,EAAE,YAAY;IACnC,gBAAgB,GAAG,IAAI,EACxB,GAAG,OAAO,CAAC;IAEZ,iBAAiB;IACjB,MAAM,MAAM,GAAG;QACb,MAAM,EAAE,IAAI,GAAG,EAAE,EAAM,4BAA4B;QACnD,SAAS,EAAE,IAAI,GAAG,EAAE,EAAG,8BAA8B;QACrD,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAI,mBAAmB;QAC1C,IAAI,EAAE,IAAI,GAAG,EAAE,CAAQ,uBAAuB;KAC/C,CAAC;IAEF,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,CAAC;QACP,MAAM,EAAE,CAAC;QACT,OAAO,EAAE;YACP,MAAM,EAAE,CAAC;YACT,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE,CAAC;SACR;QACD,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;YACT,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE,CAAC;SACR;KACF,CAAC;IAEF,wDAAwD;IACxD,IAAI,eAAe,CAAC;IACpB,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;QACtC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;QACtD,IAAI,eAAe,CAAC,KAAK,EAAE,CAAC;YAC1B,eAAe,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,SAAS,gBAAgB,CAAC,SAAS,EAAE,KAAK,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE;QAC3D,MAAM,YAAY,GAAG,OAAO,SAAS,KAAK,UAAU;YAClD,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE;YACxC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAE9B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC;QAE9D,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACH,SAAS,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,WAAW;QAClC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC;QAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,CAAC,MAAM,EAAE,CAAC;YACf,IAAI,gBAAgB;gBAAE,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,YAAY;QACZ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,EAAE,CAAC;YACzC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,iBAAiB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,KAAK,CAAC,MAAM,EAAE,CAAC;YACf,IAAI,gBAAgB;gBAAE,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,+BAA+B;QAC/B,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,KAAK,CAAC,WAAW,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,IAAI,gBAAgB,EAAE,CAAC;YACrB,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC;QACzE,CAAC;QAED,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED;;;;;;OAMG;IACH,SAAS,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,GAAG,WAAW,EAAE,QAAQ,GAAG,EAAE;QACxD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC;QAC/C,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAElC,sBAAsB;QACtB,IAAI,WAAW,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YACnD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvB,CAAC;QAED,MAAM,KAAK,GAAG;YACZ,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,IAAI;YACJ,QAAQ;YACR,WAAW,EAAE,CAAC;SACf,CAAC;QAEF,qCAAqC;QACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,QAAQ,EAAE,CAAC;YACb,iBAAiB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtB,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExB,4BAA4B;QAC5B,IAAI,KAAK,CAAC,IAAI,GAAG,YAAY,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,SAAS,MAAM,CAAC,GAAG,EAAE,IAAI;QACvB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YAEzB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,KAAK,EAAE,CAAC;gBACV,iBAAiB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC/B,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,wCAAwC;QACxC,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,KAAK,EAAE,CAAC;gBACV,iBAAiB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC/B,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,SAAS,KAAK,CAAC,IAAI;QACjB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,WAAW,GAAG,CAAC,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,SAAS,QAAQ;QACf,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAElF,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,WAAW;YACjB,OAAO;YACP,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS,OAAO;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC3C,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,EAAE,CAAC;oBAClC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBAClB,iBAAiB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC/B,KAAK,EAAE,CAAC;gBACV,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,4BAA4B;IAC5B,SAAS,aAAa,CAAC,KAAK;QAC1B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS;QACjE,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC,CAAC,eAAe;QACxD,IAAI,OAAO,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,SAAS,iBAAiB,CAAC,KAAK;QAC9B,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,SAAS,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC;QAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;aACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QAEvD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACnC,IAAI,KAAK,IAAI,aAAa;gBAAE,MAAM;YAElC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,iBAAiB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC;QACtB,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,SAAS,UAAU,CAAC,GAAG;QACrB,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YACnC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,4BAA4B;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,SAAS,oBAAoB,CAAC,SAAS;QACrC,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;YACpC,OAAO,SAAS,CAAC,IAAI,IAAI,oBAAoB,CAAC;QAChD,CAAC;QACD,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACpC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;QACvD,CAAC;QACD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,sBAAsB;IACtB,SAAS,OAAO;QACd,IAAI,eAAe,EAAE,CAAC;YACpB,aAAa,CAAC,eAAe,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,EAAE,CAAC;IACV,CAAC;IAED,aAAa;IACb,OAAO;QACL,GAAG;QACH,GAAG;QACH,MAAM;QACN,KAAK;QACL,QAAQ;QACR,OAAO;QACP,OAAO;QACP,gBAAgB;QAChB,IAAI,WAAW;YACb,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,IAAI,SAAS;YACX,OAAO,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,4CAA4C;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;AAEjD,6BAA6B;AAC7B,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/performance/component-cache.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Create a new component cache instance
+ */
+export function createComponentCache(options?: {}): ComponentCache;
+/**
+ * Memoization decorator for components
+ */
+export function memoize(component: any, keyGenerator: any, options?: {}): (...args: any[]) => any;
+/**
+ * Component Cache Manager with intelligent invalidation
+ */
+export class ComponentCache {
+    constructor(options?: {});
+    options: {
+        maxSize: any;
+        defaultTTL: any;
+        cleanupInterval: any;
+        enableStats: boolean;
+    };
+    cache: Map<any, any>;
+    dependencies: Map<any, any>;
+    stats: {
+        hits: number;
+        misses: number;
+        evictions: number;
+        cleanups: number;
+        invalidations: number;
+    };
+    cleanupTimer: NodeJS.Timeout | undefined;
+    /**
+     * Generate cache key from component and props
+     */
+    generateKey(component: any, props?: {}, context?: {}): string;
+    /**
+     * Serialize component for cache key generation
+     */
+    serializeComponent(component: any, maxDepth?: number, currentDepth?: number): any;
+    /**
+     * Get component from cache
+     */
+    get(key: any, dependencies?: any[]): any;
+    /**
+     * Set component in cache
+     */
+    set(key: any, component: any, options?: {}): boolean;
+    /**
+     * Check if component exists in cache
+     */
+    has(key: any): any;
+    /**
+     * Invalidate cache entries by dependency
+     */
+    invalidate(dependency: any): number;
+    /**
+     * Invalidate multiple dependencies
+     */
+    invalidateMultiple(dependencies: any): number;
+    /**
+     * Clear entire cache
+     */
+    clear(): number;
+    /**
+     * Add dependency mapping
+     */
+    addDependencyMapping(dependency: any, key: any): void;
+    /**
+     * Remove dependency mappings for a cache key
+     */
+    removeDependencyMappings(key: any): void;
+    /**
+     * Evict least recently used entry
+     */
+    evictLeastUsed(): void;
+    /**
+     * Cleanup expired entries
+     */
+    cleanup(): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        maxSize: any;
+        hits: number;
+        misses: number;
+        hitRate: string | number;
+        evictions: number;
+        cleanups: number;
+        invalidations: number;
+        dependencies: number;
+        memoryUsage: number;
+    };
+    /**
+     * Estimate memory usage (rough approximation)
+     */
+    estimateMemoryUsage(): number;
+    /**
+     * Get hot path components (most accessed)
+     */
+    getHotComponents(limit?: number): {
+        key: any;
+        accessCount: any;
+        component: any;
+        dependencies: any[];
+    }[];
+    /**
+     * Get cache recommendations
+     */
+    getRecommendations(): {
+        type: string;
+        message: string;
+        priority: string;
+    }[];
+    /**
+     * Destroy cache and cleanup
+     */
+    destroy(): void;
+}
+export default ComponentCache;
+//# sourceMappingURL=component-cache.d.ts.map

package/dist/performance/component-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-cache.d.ts","sourceRoot":"","sources":["../../../../src/performance/component-cache.js"],"names":[],"mappings":"AA2YA;;GAEG;AACH,mEAEC;AAED;;GAEG;AACH,2EAMsC,GAAG,WAAI,SAY5C;AA3XD;;GAEG;AACH;IACI,0BAyBC;IAxBG;;;;;MAMC;IAED,qBAAsB;IACtB,4BAA6B;IAC7B;;;;;;MAMC;IAIG,yCAEgC;IAIxC;;OAEG;IACH,8DAiBC;IAED;;OAEG;IACH,kFAyBC;IAED;;OAEG;IACH,yCA2BC;IAED;;OAEG;IACH,qDAoBC;IAED;;OAEG;IACH,mBAGC;IAED;;OAEG;IACH,oCAgBC;IAED;;OAEG;IACH,8CAMC;IAED;;OAEG;IACH,gBAKC;IAED;;OAEG;IACH,sDAKC;IAED;;OAEG;IACH,yCAOC;IAED;;OAEG;IACH,uBAgBC;IAED;;OAEG;IACH,kBAqBC;IAED;;OAEG;IACH;;;;;;;;;;;MAcC;IAED;;OAEG;IACH,8BAOC;IAED;;OAEG;IACH;;;;;QAWC;IAED;;OAEG;IACH;;;;QA6BC;IAED;;OAEG;IACH,gBAKC;CACJ"}