@coherent.js/core 1.0.0-beta.2

package/dist/performance/bundle-optimizer.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Bundle size optimization through tree-shaking and code analysis
+ */
+export class BundleOptimizer {
+    usedComponents: Set<any>;
+    usedUtilities: Set<any>;
+    componentDependencies: Map<any, any>;
+    unusedCode: Set<any>;
+    analyzeUsage(rootComponent: any, props?: {}): {
+        usedComponents: any[];
+        componentDependencies: any;
+        optimizationOpportunities: {
+            type: string;
+            impact: string;
+            description: string;
+            estimatedSavings: number;
+        }[];
+        bundleEstimate: {
+            estimated: number;
+            breakdown: {
+                framework: number;
+                components: number;
+                utilities: number;
+            };
+        };
+        recommendations: {
+            priority: string;
+            action: string;
+            impact: string;
+        }[];
+    };
+    traverseComponent(component: any, props: any, context: any): void;
+    analyzeFunctionComponent(component: any, props: any, context: any): void;
+    analyzeObjectComponent(obj: any, context: any): void;
+    getComponentName(component: any): any;
+    generateOptimizationReport(): {
+        usedComponents: any[];
+        componentDependencies: any;
+        optimizationOpportunities: {
+            type: string;
+            impact: string;
+            description: string;
+            estimatedSavings: number;
+        }[];
+        bundleEstimate: {
+            estimated: number;
+            breakdown: {
+                framework: number;
+                components: number;
+                utilities: number;
+            };
+        };
+        recommendations: {
+            priority: string;
+            action: string;
+            impact: string;
+        }[];
+    };
+    findOptimizationOpportunities(): {
+        type: string;
+        impact: string;
+        description: string;
+        estimatedSavings: number;
+    }[];
+    estimateBundleSize(): {
+        estimated: number;
+        breakdown: {
+            framework: number;
+            components: number;
+            utilities: number;
+        };
+    };
+    generateRecommendations(): {
+        priority: string;
+        action: string;
+        impact: string;
+    }[];
+    generateOptimizedConfig(): {
+        entryPoints: {
+            core: string[];
+            components: string[];
+            utilities: string[];
+        };
+        treeShaking: {
+            unusedExports: any[];
+            sideEffects: boolean;
+        };
+        optimization: {
+            minify: boolean;
+            splitChunks: boolean;
+        };
+    };
+}
+export const bundleOptimizer: BundleOptimizer;
+//# sourceMappingURL=bundle-optimizer.d.ts.map

package/dist/performance/bundle-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-optimizer.d.ts","sourceRoot":"","sources":["../../../../src/performance/bundle-optimizer.js"],"names":[],"mappings":"AAAA;;GAEG;AAEH;IAEQ,yBAA+B;IAC/B,wBAA8B;IAC9B,qCAAsC;IACtC,qBAA2B;IAI/B;;;;;;;;;;;;;;;;;;;;;;MASC;IAED,kEAkBC;IAED,yEA0BC;IAED,qDA+BC;IAED,sCASC;IAGD;;;;;;;;;;;;;;;;;;;;;;MAQC;IAED;;;;;QA8BC;IAED;;;;;;;MAaC;IAED;;;;QAoBC;IAGD;;;;;;;;;;;;;;MAmBC;CACJ;AAED,8CAAqD"}

package/dist/performance/bundle-optimizer.js

@@ -0,0 +1,192 @@
+/**
+ * Bundle size optimization through tree-shaking and code analysis
+ */
+export class BundleOptimizer {
+    constructor() {
+        this.usedComponents = new Set();
+        this.usedUtilities = new Set();
+        this.componentDependencies = new Map();
+        this.unusedCode = new Set();
+    }
+    // Analyze component tree to identify what's actually used
+    analyzeUsage(rootComponent, props = {}) {
+        const analysisContext = {
+            componentStack: [],
+            propsFlow: new Map(),
+            conditionalBranches: new Set()
+        };
+        this.traverseComponent(rootComponent, props, analysisContext);
+        return this.generateOptimizationReport();
+    }
+    traverseComponent(component, props, _context) {
+        const componentName = this.getComponentName(component);
+        // Track component usage
+        this.usedComponents.add(componentName);
+        context.componentStack.push(componentName);
+        // Track props flow for optimization
+        context.propsFlow.set(componentName, Object.keys(_props));
+        // Analyze component implementation
+        if (typeof component === 'function') {
+            this.analyzeFunctionComponent(component, props, _context);
+        }
+        else if (typeof component === 'object') {
+            this.analyzeObjectComponent(component, _context);
+        }
+        context.componentStack.pop();
+    }
+    analyzeFunctionComponent(component, props, _context) {
+        const componentStr = component.toString();
+        // Detect conditional rendering patterns
+        const conditionalPatterns = [
+            /\?\s*\{/g, // Conditional objects
+            /&&\s*\{/g, // Logical AND rendering
+            /if\s*\(/g // If statements
+        ];
+        for (const pattern of conditionalPatterns) {
+            const matches = componentStr.match(pattern);
+            if (matches) {
+                context.conditionalBranches.add(`${this.getComponentName(component)}_conditional`);
+            }
+        }
+        // Try to execute with sample props to discover runtime paths
+        try {
+            const result = component(_props);
+            if (result) {
+                this.traverseComponent(result, {}, _context);
+            }
+        }
+        catch {
+            // Component might need specific props, skip runtime analysis
+        }
+    }
+    analyzeObjectComponent(obj, _context) {
+        if (Array.isArray(obj)) {
+            obj.forEach(item => {
+                if (item && typeof item === 'object') {
+                    this.traverseComponent(item, {}, _context);
+                }
+            });
+            return;
+        }
+        const keys = Object.keys(obj);
+        if (keys.length === 1) {
+            const tagName = keys[0];
+            const props = obj[tagName];
+            // Track HTML tag usage
+            this.usedComponents.add(`html_${tagName}`);
+            // Traverse children
+            if (props && typeof props === 'object') {
+                if (props.children) {
+                    if (Array.isArray(props.children)) {
+                        props.children.forEach(child => {
+                            this.traverseComponent(child, {}, _context);
+                        });
+                    }
+                    else {
+                        this.traverseComponent(props.children, {}, _context);
+                    }
+                }
+            }
+        }
+    }
+    getComponentName(component) {
+        if (typeof component === 'function') {
+            return component.name || 'AnonymousFunction';
+        }
+        if (typeof component === 'object' && component) {
+            const keys = Object.keys(component);
+            return keys.length > 0 ? `Object_${keys[0]}` : 'EmptyObject';
+        }
+        return 'Unknown';
+    }
+    // Generate optimization recommendations
+    generateOptimizationReport() {
+        return {
+            usedComponents: Array.from(this.usedComponents),
+            componentDependencies: Object.fromEntries(this.componentDependencies),
+            optimizationOpportunities: this.findOptimizationOpportunities(),
+            bundleEstimate: this.estimateBundleSize(),
+            recommendations: this.generateRecommendations()
+        };
+    }
+    findOptimizationOpportunities() {
+        const opportunities = [];
+        // Check for unused utilities
+        const coreUtilities = ['validateCoherentObject', 'mergeProps', 'cloneCoherentObject'];
+        const unusedUtilities = coreUtilities.filter(util => !this.usedUtilities.has(util));
+        if (unusedUtilities.length > 0) {
+            opportunities.push({
+                type: 'unused_utilities',
+                impact: 'medium',
+                description: `Remove unused utilities: ${unusedUtilities.join(', ')}`,
+                estimatedSavings: unusedUtilities.length * 2 // KB estimate
+            });
+        }
+        // Check for component consolidation opportunities
+        const htmlComponents = Array.from(this.usedComponents)
+            .filter(name => name.startsWith('html_'));
+        if (htmlComponents.length < 10) {
+            opportunities.push({
+                type: 'minimal_html_tags',
+                impact: 'high',
+                description: 'Create minimal HTML tag bundle for smaller apps',
+                estimatedSavings: 15 // KB estimate
+            });
+        }
+        return opportunities;
+    }
+    estimateBundleSize() {
+        const baseFrameworkSize = 25; // KB
+        const componentOverhead = this.usedComponents.size * 0.5; // KB per component
+        const utilitySize = this.usedUtilities.size * 2; // KB per utility
+        return {
+            estimated: baseFrameworkSize + componentOverhead + utilitySize,
+            breakdown: {
+                framework: baseFrameworkSize,
+                components: componentOverhead,
+                utilities: utilitySize
+            }
+        };
+    }
+    generateRecommendations() {
+        const recommendations = [];
+        if (this.usedComponents.size < 5) {
+            recommendations.push({
+                priority: 'high',
+                action: 'Consider creating a minimal bundle with only required components',
+                impact: 'Reduce bundle size by 40-60%'
+            });
+        }
+        if (this.usedComponents.size > 50) {
+            recommendations.push({
+                priority: 'medium',
+                action: 'Implement code-splitting to load components on demand',
+                impact: 'Improve initial load time by 30-50%'
+            });
+        }
+        return recommendations;
+    }
+    // Generate optimized bundle configuration
+    generateOptimizedConfig() {
+        return {
+            entryPoints: {
+                core: ['./src/coherent.js'],
+                components: Array.from(this.usedComponents)
+                    .filter(name => !name.startsWith('html_'))
+                    .map(name => `./src/components/${name}.js`),
+                utilities: Array.from(this.usedUtilities)
+                    .map(name => `./src/core/${name}.js`)
+            },
+            treeShaking: {
+                unusedExports: Array.from(this.unusedCode),
+                sideEffects: false
+            },
+            optimization: {
+                minify: true,
+                splitChunks: this.usedComponents.size > 20
+            }
+        };
+    }
+}
+export const bundleOptimizer = new BundleOptimizer();
+//# sourceMappingURL=bundle-optimizer.js.map

package/dist/performance/bundle-optimizer.js.map

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

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

@@ -0,0 +1,107 @@
+/**
+ * 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?: CacheOptions): Object;
+export const cacheManager: Object;
+export namespace CacheManager {
+    export { createCacheManager as create };
+}
+export type CacheEntry = {
+    /**
+     * - The cached value
+     */
+    value: any;
+    /**
+     * - When the entry was created
+     */
+    timestamp: number;
+    /**
+     * - Last access time
+     */
+    lastAccess: number;
+    /**
+     * - Approximate size in bytes
+     */
+    size: number;
+    /**
+     * - Additional metadata
+     */
+    metadata: Object;
+    /**
+     * - Number of times accessed
+     */
+    accessCount: number;
+};
+export type CacheStats = {
+    /**
+     * - Number of cache hits
+     */
+    hits: number;
+    /**
+     * - Number of cache misses
+     */
+    misses: number;
+    /**
+     * - Current cache size in bytes
+     */
+    size: number;
+    /**
+     * - Number of cache entries
+     */
+    entries: number;
+    /**
+     * - Hit rate by cache type
+     */
+    hitRate: Record<string, number>;
+};
+export type CacheOptions = {
+    /**
+     * - Maximum number of entries per cache type
+     */
+    maxCacheSize?: number | undefined;
+    /**
+     * - Maximum memory usage in MB
+     */
+    maxMemoryMB?: number | undefined;
+    /**
+     * - Default time-to-live in milliseconds (5 minutes)
+     */
+    ttlMs?: number | undefined;
+    /**
+     * - Whether to collect usage statistics
+     */
+    enableStatistics?: boolean | undefined;
+};
+//# sourceMappingURL=cache-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../../../src/performance/cache-manager.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AAEH;;;;;;GAMG;AAEH;;;;GAIG;AACH,6CAHW,YAAY,GACV,MAAM,CAkTlB;AAGD,kCAAiD;;;;;;;;WAjVnC,GAAG;;;;eACH,MAAM;;;;gBACN,MAAM;;;;UACN,MAAM;;;;cACN,MAAM;;;;iBACN,MAAM;;;;;;UAKN,MAAM;;;;YACN,MAAM;;;;UACN,MAAM;;;;aACN,MAAM;;;;aACN,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC"}