@revealui/core 0.0.1-pre.4 → 0.2.0

package/dist/optimization/build-optimizer.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Build Performance Optimization
+ *
+ * Utilities for optimizing build performance and configuration
+ */
+/**
+ * Next.js optimization configuration
+ */
+export interface NextOptimizationConfig {
+    compiler?: {
+        removeConsole?: boolean | {
+            exclude?: string[];
+        };
+        reactRemoveProperties?: boolean | {
+            properties?: string[];
+        };
+        styledComponents?: boolean;
+        emotion?: boolean;
+    };
+    swcMinify?: boolean;
+    outputFileTracing?: boolean;
+    experimental?: {
+        optimizeCss?: boolean;
+        optimizePackageImports?: string[];
+        turbotrace?: {
+            logLevel?: 'bug' | 'fatal' | 'error' | 'warning' | 'hint' | 'note' | 'suggestions' | 'info';
+        };
+    };
+    productionBrowserSourceMaps?: boolean;
+    generateEtags?: boolean;
+    poweredByHeader?: boolean;
+    compress?: boolean;
+    webpack?: {
+        analyze?: boolean;
+    };
+}
+export declare const DEFAULT_NEXT_CONFIG: NextOptimizationConfig;
+/**
+ * Webpack optimization configuration
+ */
+export interface WebpackOptimizationConfig {
+    minimize?: boolean;
+    minimizer?: string[];
+    splitChunks?: {
+        chunks?: 'all' | 'async' | 'initial';
+        minSize?: number;
+        maxSize?: number;
+        minChunks?: number;
+        maxAsyncRequests?: number;
+        maxInitialRequests?: number;
+        automaticNameDelimiter?: string;
+        cacheGroups?: Record<string, unknown>;
+    };
+    runtimeChunk?: boolean | 'single' | 'multiple';
+    moduleIds?: 'natural' | 'named' | 'deterministic';
+    chunkIds?: 'natural' | 'named' | 'deterministic';
+    concatenateModules?: boolean;
+    usedExports?: boolean;
+    sideEffects?: boolean;
+    providedExports?: boolean;
+    innerGraph?: boolean;
+}
+export declare const DEFAULT_WEBPACK_CONFIG: WebpackOptimizationConfig;
+/**
+ * Turbopack configuration
+ */
+export interface TurbopackConfig {
+    resolveExtensions?: string[];
+    resolveAlias?: Record<string, string>;
+    rules?: Array<{
+        test: RegExp;
+        use: string[];
+    }>;
+}
+export declare const DEFAULT_TURBOPACK_CONFIG: TurbopackConfig;
+/**
+ * Build cache configuration
+ */
+export interface BuildCacheConfig {
+    type?: 'memory' | 'filesystem';
+    cacheDirectory?: string;
+    compression?: boolean | 'gzip' | 'brotli';
+    maxAge?: number;
+    name?: string;
+    version?: string;
+}
+export declare const DEFAULT_CACHE_CONFIG: BuildCacheConfig;
+/**
+ * Tree shaking configuration
+ */
+export interface TreeShakingConfig {
+    usedExports?: boolean;
+    sideEffects?: boolean;
+    providedExports?: boolean;
+    innerGraph?: boolean;
+    mangleExports?: boolean;
+}
+export declare const DEFAULT_TREE_SHAKING_CONFIG: TreeShakingConfig;
+/**
+ * Generate package.json sideEffects field
+ */
+export declare function generateSideEffectsConfig(includeCSS?: boolean): boolean | string[];
+/**
+ * Module resolution configuration
+ */
+export interface ModuleResolutionConfig {
+    extensions?: string[];
+    alias?: Record<string, string>;
+    modules?: string[];
+    symlinks?: boolean;
+    fullySpecified?: boolean;
+}
+export declare const DEFAULT_MODULE_RESOLUTION: ModuleResolutionConfig;
+/**
+ * Parallel build configuration
+ */
+export interface ParallelBuildConfig {
+    parallel?: boolean | number;
+    cache?: boolean;
+    threads?: number;
+}
+export declare const DEFAULT_PARALLEL_CONFIG: ParallelBuildConfig;
+/**
+ * Performance hints configuration
+ */
+export interface PerformanceConfig {
+    hints?: false | 'warning' | 'error';
+    maxEntrypointSize?: number;
+    maxAssetSize?: number;
+    assetFilter?: (assetFilename: string) => boolean;
+}
+export declare const DEFAULT_PERFORMANCE_CONFIG: PerformanceConfig;
+/**
+ * Build statistics
+ */
+export interface BuildStats {
+    duration: number;
+    entrySize: number;
+    outputSize: number;
+    assets: Array<{
+        name: string;
+        size: number;
+    }>;
+    chunks: Array<{
+        id: string | number;
+        size: number;
+        files: string[];
+    }>;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Analyze build performance
+ */
+export declare function analyzeBuildPerformance(stats: BuildStats): {
+    score: number;
+    issues: Array<{
+        type: 'error' | 'warning' | 'info';
+        message: string;
+    }>;
+};
+/**
+ * Generate tsconfig for optimal builds
+ */
+export declare function generateOptimizedTSConfig(): {
+    compilerOptions: Record<string, unknown>;
+};
+/**
+ * Dependency prebuilding
+ */
+export interface PrebuildConfig {
+    include?: string[];
+    exclude?: string[];
+    force?: boolean;
+    entries?: string[];
+}
+export declare function shouldPrebuildDependency(packageName: string, config?: PrebuildConfig): boolean;
+/**
+ * Build profiling
+ */
+export interface BuildProfile {
+    name: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    children: BuildProfile[];
+}
+export declare class BuildProfiler {
+    private profiles;
+    private stack;
+    start(name: string): void;
+    end(name: string): void;
+    getProfile(name: string): BuildProfile | undefined;
+    getAllProfiles(): BuildProfile[];
+    getSlowestProfiles(limit?: number): BuildProfile[];
+    reset(): void;
+}
+/**
+ * Build optimization recommendations
+ */
+export declare function getBuildOptimizationRecommendations(stats: BuildStats): string[];
+//# sourceMappingURL=build-optimizer.d.ts.map

package/dist/optimization/build-optimizer.d.ts.map

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

package/dist/optimization/build-optimizer.js

@@ -0,0 +1,271 @@
+/**
+ * Build Performance Optimization
+ *
+ * Utilities for optimizing build performance and configuration
+ */
+export const DEFAULT_NEXT_CONFIG = {
+    compiler: {
+        removeConsole: {
+            exclude: ['error', 'warn'],
+        },
+    },
+    swcMinify: true,
+    outputFileTracing: true,
+    experimental: {
+        optimizeCss: true,
+        optimizePackageImports: ['lodash', 'date-fns', 'recharts', '@radix-ui/react-icons'],
+    },
+    productionBrowserSourceMaps: false,
+    generateEtags: true,
+    poweredByHeader: false,
+    compress: true,
+};
+export const DEFAULT_WEBPACK_CONFIG = {
+    minimize: true,
+    splitChunks: {
+        chunks: 'all',
+        minSize: 20000,
+        maxSize: 244000,
+        minChunks: 1,
+        maxAsyncRequests: 30,
+        maxInitialRequests: 30,
+        cacheGroups: {
+            defaultVendors: {
+                test: /[\\/]node_modules[\\/]/,
+                priority: -10,
+                reuseExistingChunk: true,
+            },
+            default: {
+                minChunks: 2,
+                priority: -20,
+                reuseExistingChunk: true,
+            },
+        },
+    },
+    runtimeChunk: 'single',
+    moduleIds: 'deterministic',
+    chunkIds: 'deterministic',
+    concatenateModules: true,
+    usedExports: true,
+    sideEffects: true,
+    providedExports: true,
+    innerGraph: true,
+};
+export const DEFAULT_TURBOPACK_CONFIG = {
+    resolveExtensions: ['.tsx', '.ts', '.jsx', '.js', '.json'],
+    resolveAlias: {
+        '@': './src',
+        '@components': './src/components',
+        '@lib': './src/lib',
+        '@utils': './src/utils',
+    },
+};
+export const DEFAULT_CACHE_CONFIG = {
+    type: 'filesystem',
+    cacheDirectory: '.next/cache',
+    compression: 'gzip',
+    maxAge: 1000 * 60 * 60 * 24 * 7, // 1 week
+};
+export const DEFAULT_TREE_SHAKING_CONFIG = {
+    usedExports: true,
+    sideEffects: true,
+    providedExports: true,
+    innerGraph: true,
+    mangleExports: true,
+};
+/**
+ * Generate package.json sideEffects field
+ */
+export function generateSideEffectsConfig(includeCSS = true) {
+    if (!includeCSS) {
+        return false;
+    }
+    return ['*.css', '*.scss', '*.sass', '*.less'];
+}
+export const DEFAULT_MODULE_RESOLUTION = {
+    extensions: ['.tsx', '.ts', '.jsx', '.js', '.json'],
+    alias: {
+        '@': './src',
+        '@components': './src/components',
+        '@lib': './src/lib',
+        '@utils': './src/utils',
+        '@hooks': './src/hooks',
+        '@types': './src/types',
+    },
+    modules: ['node_modules'],
+    symlinks: true,
+    fullySpecified: false,
+};
+export const DEFAULT_PARALLEL_CONFIG = {
+    parallel: true,
+    cache: true,
+    threads: 4,
+};
+export const DEFAULT_PERFORMANCE_CONFIG = {
+    hints: 'warning',
+    maxEntrypointSize: 250000, // 250KB
+    maxAssetSize: 250000,
+    assetFilter: (assetFilename) => {
+        return !assetFilename.endsWith('.map');
+    },
+};
+/**
+ * Analyze build performance
+ */
+export function analyzeBuildPerformance(stats) {
+    const issues = [];
+    let score = 100;
+    // Check build duration
+    if (stats.duration > 60000) {
+        issues.push({
+            type: 'warning',
+            message: `Build time (${(stats.duration / 1000).toFixed(1)}s) is slow. Consider parallel builds.`,
+        });
+        score -= 10;
+    }
+    // Check output size
+    if (stats.outputSize > 1024 * 1024) {
+        issues.push({
+            type: 'warning',
+            message: `Output size (${(stats.outputSize / 1024 / 1024).toFixed(1)}MB) is large. Consider code splitting.`,
+        });
+        score -= 15;
+    }
+    // Check for large assets
+    const largeAssets = stats.assets.filter((a) => a.size > 250000);
+    if (largeAssets.length > 0) {
+        issues.push({
+            type: 'warning',
+            message: `${largeAssets.length} assets exceed 250KB. Consider optimization.`,
+        });
+        score -= 10;
+    }
+    // Check for errors
+    if (stats.errors.length > 0) {
+        issues.push({
+            type: 'error',
+            message: `${stats.errors.length} build errors found.`,
+        });
+        score -= 30;
+    }
+    // Check for warnings
+    if (stats.warnings.length > 5) {
+        issues.push({
+            type: 'warning',
+            message: `${stats.warnings.length} build warnings found.`,
+        });
+        score -= 5;
+    }
+    return {
+        score: Math.max(0, score),
+        issues,
+    };
+}
+/**
+ * Generate tsconfig for optimal builds
+ */
+export function generateOptimizedTSConfig() {
+    return {
+        compilerOptions: {
+            target: 'ES2020',
+            lib: ['ES2020', 'DOM', 'DOM.Iterable'],
+            module: 'ESNext',
+            moduleResolution: 'bundler',
+            resolveJsonModule: true,
+            isolatedModules: true,
+            jsx: 'preserve',
+            incremental: true,
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            forceConsistentCasingInFileNames: true,
+            noEmit: true,
+            paths: {
+                '@/*': ['./src/*'],
+                '@components/*': ['./src/components/*'],
+                '@lib/*': ['./src/lib/*'],
+                '@utils/*': ['./src/utils/*'],
+            },
+        },
+    };
+}
+export function shouldPrebuildDependency(packageName, config = {}) {
+    const { include = [], exclude = [] } = config;
+    if (exclude.includes(packageName)) {
+        return false;
+    }
+    if (include.length > 0) {
+        return include.includes(packageName);
+    }
+    // Prebuild large, stable dependencies by default
+    const prebuildByDefault = ['react', 'react-dom', 'lodash', 'date-fns', 'zod', '@radix-ui'];
+    return prebuildByDefault.some((pkg) => packageName.startsWith(pkg));
+}
+export class BuildProfiler {
+    profiles = new Map();
+    stack = [];
+    start(name) {
+        const profile = {
+            name,
+            startTime: Date.now(),
+            children: [],
+        };
+        if (this.stack.length > 0) {
+            const parentName = this.stack[this.stack.length - 1];
+            if (parentName) {
+                const parent = this.profiles.get(parentName);
+                if (parent) {
+                    parent.children.push(profile);
+                }
+            }
+        }
+        this.profiles.set(name, profile);
+        this.stack.push(name);
+    }
+    end(name) {
+        const profile = this.profiles.get(name);
+        if (profile) {
+            profile.endTime = Date.now();
+            profile.duration = profile.endTime - profile.startTime;
+        }
+        const index = this.stack.indexOf(name);
+        if (index !== -1) {
+            this.stack.splice(index, 1);
+        }
+    }
+    getProfile(name) {
+        return this.profiles.get(name);
+    }
+    getAllProfiles() {
+        return Array.from(this.profiles.values()).filter((p) => p.endTime !== undefined);
+    }
+    getSlowestProfiles(limit = 10) {
+        return this.getAllProfiles()
+            .sort((a, b) => (b.duration || 0) - (a.duration || 0))
+            .slice(0, limit);
+    }
+    reset() {
+        this.profiles.clear();
+        this.stack = [];
+    }
+}
+/**
+ * Build optimization recommendations
+ */
+export function getBuildOptimizationRecommendations(stats) {
+    const recommendations = [];
+    if (stats.duration > 30000) {
+        recommendations.push('Enable parallel builds with --parallel flag', 'Use build cache with filesystem caching', 'Consider using Turbopack for faster builds');
+    }
+    if (stats.outputSize > 500000) {
+        recommendations.push('Enable code splitting for better chunking', 'Use dynamic imports for large components', 'Enable tree shaking in production');
+    }
+    const largeAssets = stats.assets.filter((a) => a.size > 250000);
+    if (largeAssets.length > 0) {
+        recommendations.push('Compress large assets with gzip/brotli', 'Optimize images using next/image', 'Split large vendor bundles');
+    }
+    if (stats.chunks.length > 100) {
+        recommendations.push('Too many chunks - adjust splitChunks configuration', 'Increase minSize and minChunks thresholds');
+    }
+    return recommendations;
+}

package/dist/optimization/bundle-analyzer.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Bundle Analyzer
+ *
+ * Analyzes bundle size, dependencies, and optimization opportunities
+ */
+export interface BundleStats {
+    totalSize: number;
+    gzipSize?: number;
+    files: BundleFile[];
+    chunks: BundleChunk[];
+    dependencies: DependencyStats[];
+    duplicates: DuplicateModule[];
+    largeFiles: BundleFile[];
+}
+export interface BundleFile {
+    path: string;
+    size: number;
+    gzipSize?: number;
+    type: string;
+    relativeSize: number;
+}
+export interface BundleChunk {
+    name: string;
+    size: number;
+    files: string[];
+    dependencies: string[];
+}
+export interface DependencyStats {
+    name: string;
+    version: string;
+    size: number;
+    instances: number;
+    treeshakeable: boolean;
+}
+export interface DuplicateModule {
+    name: string;
+    versions: string[];
+    totalSize: number;
+    locations: string[];
+}
+/**
+ * Analyze bundle directory
+ */
+export declare function analyzeBundleDirectory(bundlePath: string): BundleStats;
+/**
+ * Format file size
+ */
+export declare function formatSize(bytes: number): string;
+/**
+ * Analyze webpack stats
+ */
+export declare function analyzeWebpackStats(statsPath: string): BundleStats;
+/**
+ * Find duplicate dependencies
+ */
+export declare function findDuplicateDependencies(_stats: BundleStats): DuplicateModule[];
+/**
+ * Get optimization suggestions
+ */
+export interface OptimizationSuggestion {
+    type: 'bundle-split' | 'tree-shaking' | 'dynamic-import' | 'compression' | 'dependency';
+    severity: 'critical' | 'warning' | 'info';
+    message: string;
+    potentialSavings?: number;
+    file?: string;
+}
+export declare function getOptimizationSuggestions(stats: BundleStats): OptimizationSuggestion[];
+/**
+ * Generate bundle report
+ */
+export declare function generateBundleReport(stats: BundleStats): string;
+/**
+ * Compare two bundle stats
+ */
+export interface BundleComparison {
+    sizeDiff: number;
+    sizeChangePercent: number;
+    filesAdded: number;
+    filesRemoved: number;
+    filesChanged: number;
+    newLargeFiles: BundleFile[];
+    improvements: string[];
+    regressions: string[];
+}
+export declare function compareBundles(before: BundleStats, after: BundleStats): BundleComparison;
+/**
+ * Get bundle health score (0-100)
+ */
+export declare function getBundleHealthScore(stats: BundleStats): {
+    score: number;
+    factors: Array<{
+        name: string;
+        score: number;
+        weight: number;
+        reason: string;
+    }>;
+};
+//# sourceMappingURL=bundle-analyzer.d.ts.map

package/dist/optimization/bundle-analyzer.d.ts.map

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