@tachui/cli 0.8.0-alpha → 0.8.5-alpha

package/README.md

@@ -109,6 +109,21 @@ tacho migrate swiftui-project ./MySwiftUIApp
 tacho migrate --interactive ./ContentView.swift
 ```
 
+### Modifier Migration Utilities
+
+```bash
+# Preview legacy `.modifier` trigger removal without touching files
+tacho migrate remove-modifier-trigger --dry-run
+
+# Apply the transformation to your source tree
+tacho migrate remove-modifier-trigger --pattern "src/**/*.{ts,tsx,js,jsx}"
+
+# Run in CI to ensure no legacy triggers remain
+tacho migrate remove-modifier-trigger --check
+```
+
+Use `--ignore` to skip certain glob patterns (for example, generated output) and `--preview`/`--dry-run` to review changes before applying them.
+
 ### Development Tools
 
 ```bash

package/bin/tacho.js

@@ -1,10 +1,60 @@
 #!/usr/bin/env node
 
-import('../dist/index.js')
-  .then(({ main }) => {
-    main()
-  })
-  .catch((error) => {
-    console.error('Failed to start Tacho CLI:', error)
+const moduleCandidates = [
+  new URL('../dist/index.js', import.meta.url).href,
+  new URL('../dist/cli/src/index.js', import.meta.url).href,
+]
+
+const isMissingModule = (error, candidate) => {
+  if (!error) return false
+  if (error.code === 'ERR_MODULE_NOT_FOUND') {
+    return true
+  }
+  return (
+    typeof error.message === 'string' &&
+    error.message.includes(candidate)
+  )
+}
+
+async function start() {
+  for (const candidate of moduleCandidates) {
+    try {
+      const { main } = await import(candidate)
+      if (typeof main === 'function') {
+        await main()
+        return
+      }
+    } catch (error) {
+      if (!isMissingModule(error, candidate)) {
+        console.error('Failed to start Tacho CLI:', error)
+        process.exit(1)
+      }
+    }
+  }
+
+  await startFromSource()
+}
+
+async function startFromSource() {
+  try {
+    // Register TSX loader so we can import TypeScript sources without building
+    await import('tsx/esm')
+    const { main } = await import(
+      new URL('../src/index.ts', import.meta.url).href
+    )
+
+    if (typeof main !== 'function') {
+      throw new Error('CLI entry did not export a main() function')
+    }
+
+    await main()
+  } catch (error) {
+    console.error(
+      'Failed to start Tacho CLI. Build artifacts missing and TSX loader unavailable.',
+      error
+    )
     process.exit(1)
-  })
+  }
+}
+
+start()

package/dist/cli/src/commands/analyze-imports.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * TachUI CLI - Import Analysis Command
+ *
+ * Analyzes project imports and provides optimization recommendations
+ */
+interface AnalyzeOptions {
+    project?: string;
+    output?: string;
+    interactive?: boolean;
+    fix?: boolean;
+    threshold?: number;
+}
+declare function analyzeImports(options: AnalyzeOptions): Promise<void>;
+declare function showImportGuide(packageName?: string): Promise<void>;
+declare function showCheatSheet(): Promise<void>;
+export { analyzeImports, showImportGuide, showCheatSheet };
+//# sourceMappingURL=analyze-imports.d.ts.map

package/dist/cli/src/commands/analyze-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-imports.d.ts","sourceRoot":"","sources":["../../../../src/commands/analyze-imports.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAWH,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAqCD,iBAAe,cAAc,CAAC,OAAO,EAAE,cAAc,iBAwFpD;AAiCD,iBAAe,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,iBAgBlD;AAED,iBAAe,cAAc,kBAI5B;AAGD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,CAAA"}

package/dist/cli/src/commands/analyze-imports.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+/**
+ * TachUI CLI - Import Analysis Command
+ *
+ * Analyzes project imports and provides optimization recommendations
+ */
+import { Command } from 'commander';
+import { ImportOptimizer } from '../import-optimizer.js';
+import { ImportGuidanceSystem } from '@tachui/devtools';
+import chalk from 'chalk';
+import { existsSync } from 'fs';
+import { join } from 'path';
+const program = new Command();
+program
+    .name('tachui-analyze-imports')
+    .description('Analyze and optimize TachUI imports for better bundle size')
+    .version('1.0.0');
+program
+    .command('analyze')
+    .description('Analyze imports in your TachUI project')
+    .option('-p, --project <path>', 'Project root directory', process.cwd())
+    .option('-o, --output <file>', 'Output report to file')
+    .option('-i, --interactive', 'Interactive optimization mode', false)
+    .option('-f, --fix', 'Automatically apply safe optimizations', false)
+    .option('-t, --threshold <kb>', 'Bundle size threshold for warnings', '50')
+    .action(async (options) => {
+    await analyzeImports(options);
+});
+program
+    .command('guide')
+    .description('Show import guidance for TachUI packages')
+    .argument('[package]', 'Package to show guidance for (core, primitives, etc.)')
+    .action(async (packageName) => {
+    await showImportGuide(packageName);
+});
+program
+    .command('cheat-sheet')
+    .description('Display TachUI import cheat sheet')
+    .action(async () => {
+    await showCheatSheet();
+});
+async function analyzeImports(options) {
+    const { project = process.cwd(), output, interactive, fix, threshold = 50, } = options;
+    console.log(chalk.blue('🔍 Analyzing TachUI imports...\n'));
+    // Check if project has TachUI
+    const packageJsonPath = join(project, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        console.error(chalk.red('❌ No package.json found in project directory'));
+        process.exit(1);
+    }
+    try {
+        const packageJson = JSON.parse(await import(packageJsonPath));
+        const hasTachUI = Object.keys({
+            ...packageJson.dependencies,
+            ...packageJson.devDependencies,
+        }).some(dep => dep.startsWith('@tachui/'));
+        if (!hasTachUI) {
+            console.log(chalk.yellow('⚠️  No TachUI dependencies found in this project'));
+            return;
+        }
+        const optimizer = new ImportOptimizer();
+        const optimizations = await optimizer.analyzeProject(project);
+        if (optimizations.length === 0) {
+            console.log(chalk.green('✅ All imports are already optimal!'));
+            return;
+        }
+        // Generate report
+        const report = optimizer.generateReport(optimizations);
+        console.log(report);
+        // Calculate total potential savings
+        const totalSavings = optimizations.reduce((sum, opt) => sum + parseInt(opt.savings.replace(/[^\d]/g, '')), 0);
+        if (totalSavings > threshold) {
+            console.log(chalk.yellow(`\n⚠️  Bundle size could be reduced by ~${totalSavings}KB`));
+        }
+        // Interactive mode
+        if (interactive) {
+            const inquirer = await import('inquirer');
+            const { applyOptimizations } = await inquirer.default.prompt([
+                {
+                    type: 'confirm',
+                    name: 'applyOptimizations',
+                    message: 'Would you like to apply safe optimizations automatically?',
+                    default: false,
+                },
+            ]);
+            if (applyOptimizations) {
+                await applyAutomaticOptimizations(project, optimizations);
+            }
+        }
+        // Auto-fix mode
+        if (fix) {
+            await applyAutomaticOptimizations(project, optimizations);
+        }
+        // Output to file
+        if (output) {
+            const { writeFileSync } = await import('fs-extra');
+            writeFileSync(output, report);
+            console.log(chalk.green(`\n📄 Report saved to: ${output}`));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Error analyzing imports:'), error);
+        process.exit(1);
+    }
+}
+async function applyAutomaticOptimizations(_projectPath, optimizations) {
+    console.log(chalk.blue('\n🔧 Applying automatic optimizations...\n'));
+    const safeOptimizations = optimizations.filter(opt => opt.risk === 'low');
+    if (safeOptimizations.length === 0) {
+        console.log(chalk.yellow('⚠️  No safe automatic optimizations available'));
+        return;
+    }
+    let applied = 0;
+    for (const opt of safeOptimizations) {
+        try {
+            // Apply optimization (simplified - would need actual file transformation)
+            console.log(chalk.green(`✅ ${opt.from} → ${opt.to} (saves ${opt.savings})`));
+            applied++;
+        }
+        catch (_error) {
+            console.error(chalk.red(`❌ Failed to apply: ${opt.from} → ${opt.to}`));
+        }
+    }
+    console.log(chalk.green(`\n🎉 Applied ${applied} optimizations successfully!`));
+}
+async function showImportGuide(packageName) {
+    const guidance = new ImportGuidanceSystem();
+    if (!packageName) {
+        // Show all available guides
+        console.log(chalk.blue('📚 TachUI Import Guides\n'));
+        console.log('Available packages:');
+        console.log('  • core - Core framework imports');
+        console.log('  • primitives - UI component imports');
+        console.log('  • bundle-optimization - Bundle size guidance');
+        console.log('\nUsage: tachui analyze guide <package>');
+        return;
+    }
+    const guide = guidance.generatePackageGuide(packageName);
+    console.log(guide);
+}
+async function showCheatSheet() {
+    const guidance = new ImportGuidanceSystem();
+    const cheatSheet = guidance.generateCheatSheet();
+    console.log(cheatSheet);
+}
+// Export functions for programmatic use
+export { analyzeImports, showImportGuide, showCheatSheet };
+// CLI execution
+if (import.meta.url === `file://${process.argv[1]}`) {
+    program.parse();
+}
+//# sourceMappingURL=analyze-imports.js.map

package/dist/cli/src/commands/analyze-imports.js.map

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

package/dist/cli/src/commands/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../../src/commands/analyze.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmanC,eAAO,MAAM,cAAc,SAqavB,CAAA"}

package/dist/{commands → cli/src/commands}/analyze.js

@@ -5,10 +5,130 @@
  */
 import { readFileSync, statSync, writeFileSync } from 'node:fs';
 import { resolve } from 'node:path';
+import * as ts from 'typescript';
 import chalk from 'chalk';
 import { Command } from 'commander';
 import { glob } from 'glob';
 import ora from 'ora';
+/**
+ * CLI-specific concatenation pattern analysis using TypeScript AST
+ * Replaces regex-based approach with proper AST analysis
+ */
+function analyzeConcatenationPatterns(content, filename = 'temp.ts') {
+    const patterns = [];
+    try {
+        // Parse the code into a TypeScript AST
+        const sourceFile = ts.createSourceFile(filename, content, ts.ScriptTarget.Latest, true, filename.endsWith('.tsx') ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
+        // Walk the AST to find .concat() calls
+        function visit(node) {
+            if (ts.isCallExpression(node) &&
+                ts.isPropertyAccessExpression(node.expression) &&
+                node.expression.name.text === 'concat') {
+                // Check if this is a .build().concat() pattern
+                const leftExpression = node.expression.expression;
+                if (ts.isCallExpression(leftExpression) &&
+                    ts.isPropertyAccessExpression(leftExpression.expression) &&
+                    leftExpression.expression.name.text === 'build') {
+                    // Extract left component (everything before .build())
+                    const componentChain = leftExpression.expression.expression;
+                    const leftComponent = extractComponentExpression(componentChain, content);
+                    // Extract right component (first argument to .concat())
+                    const rightComponent = node.arguments.length > 0
+                        ? extractComponentExpression(node.arguments[0], content)
+                        : '';
+                    if (leftComponent && rightComponent) {
+                        // Get source location
+                        const start = node.getStart(sourceFile);
+                        const end = node.getEnd();
+                        // Simple static analysis
+                        const hasVariable = /\$\{[^}]+\}|[a-zA-Z_$][a-zA-Z0-9_$]*\[[^\]]*\]|entry\[/.test(leftComponent + rightComponent);
+                        const isStatic = !hasVariable;
+                        // Accessibility analysis
+                        const hasInteractive = /\bButton\b|\bLink\b/i.test(leftComponent + rightComponent);
+                        const hasComplexLayout = /\bVStack\b|\bHStack\b|\bZStack\b/i.test(content);
+                        let accessibilityNeeds;
+                        if (hasComplexLayout) {
+                            accessibilityNeeds = 'full';
+                        }
+                        else if (hasInteractive) {
+                            accessibilityNeeds = 'aria';
+                        }
+                        else {
+                            accessibilityNeeds = 'minimal';
+                        }
+                        patterns.push({
+                            type: isStatic ? 'static' : 'dynamic',
+                            location: { start, end },
+                            leftComponent: leftComponent.trim(),
+                            rightComponent: rightComponent.trim(),
+                            optimizable: isStatic,
+                            accessibilityNeeds,
+                        });
+                    }
+                }
+            }
+            // Continue traversing child nodes
+            ts.forEachChild(node, visit);
+        }
+        visit(sourceFile);
+    }
+    catch (error) {
+        // If AST parsing fails, return empty patterns (graceful fallback)
+        console.warn(`Failed to parse for concatenation analysis:`, error);
+    }
+    return patterns;
+}
+/**
+ * Helper function to extract component expression text from AST node
+ */
+function extractComponentExpression(node, sourceCode) {
+    const start = node.getStart();
+    const end = node.getEnd();
+    return sourceCode.substring(start, end);
+}
+/**
+ * Generate comprehensive concatenation analysis for CLI reporting
+ */
+function generateConcatenationAnalysis(allPatterns) {
+    const staticPatterns = allPatterns.filter(p => p.type === 'static').length;
+    const dynamicPatterns = allPatterns.filter(p => p.type === 'dynamic').length;
+    const optimizedPatterns = allPatterns.filter(p => p.optimizable).length;
+    // Calculate bundle savings
+    const baseConcatenationSize = 87.76; // KB
+    const selectedRuntimes = new Set(allPatterns.map(p => p.accessibilityNeeds));
+    const optimizedSize = selectedRuntimes.size * 5; // 5KB per runtime
+    const bundleSavingsKB = Math.max(0, baseConcatenationSize - optimizedSize);
+    // Accessibility breakdown
+    const accessibilityBreakdown = {
+        minimal: allPatterns.filter(p => p.accessibilityNeeds === 'minimal').length,
+        aria: allPatterns.filter(p => p.accessibilityNeeds === 'aria').length,
+        full: allPatterns.filter(p => p.accessibilityNeeds === 'full').length,
+    };
+    // Generate recommendations
+    const recommendations = [];
+    if (dynamicPatterns > staticPatterns) {
+        recommendations.push('Consider extracting variables from concatenation patterns to enable static optimization');
+    }
+    if (accessibilityBreakdown.full >
+        accessibilityBreakdown.minimal + accessibilityBreakdown.aria) {
+        recommendations.push('Many concatenations require full accessibility - consider simplifying component structures');
+    }
+    if (allPatterns.length > 10 && optimizedPatterns / allPatterns.length < 0.5) {
+        recommendations.push('Low optimization rate - review concatenation patterns for static optimization opportunities');
+    }
+    if (bundleSavingsKB > 50) {
+        recommendations.push(`High bundle savings potential: ${bundleSavingsKB.toFixed(1)}KB - implement concatenation optimization`);
+    }
+    return {
+        totalPatterns: allPatterns.length,
+        optimizedPatterns,
+        staticPatterns,
+        dynamicPatterns,
+        bundleSavingsKB,
+        accessibilityBreakdown,
+        recommendations,
+    };
+}
 function analyzeFile(filePath, content) {
     const lines = content.split('\n');
     const analysis = {
@@ -28,6 +148,7 @@ function analyzeFile(filePath, content) {
         lifecycleUsage: [],
         navigationUsage: [],
         complexity: 0,
+        concatenationPatterns: [],
     };
     // Analyze imports
     const importMatches = content.match(/import.*from ['"]@tachui\/core['"]/g) || [];
@@ -44,9 +165,11 @@ function analyzeFile(filePath, content) {
     if (content.includes('.modifier')) {
         analysis.hasModifiers = true;
         const modifierChains = content.match(/\.modifier[\s\S]*?\.build\(\)/g) || [];
-        analysis.modifierUsage = modifierChains.map((chain) => chain
+        analysis.modifierUsage = modifierChains.map(chain => chain
             .split('.')
-            .filter((part) => part.trim() && !part.includes('modifier') && !part.includes('build()'))
+            .filter(part => part.trim() &&
+            !part.includes('modifier') &&
+            !part.includes('build()'))
             .join('.'));
     }
     // Analyze layout usage
@@ -57,15 +180,20 @@ function analyzeFile(filePath, content) {
     }
     // Analyze lifecycle usage
     const lifecycleModifiers = ['onAppear', 'onDisappear', 'task', 'refreshable'];
-    lifecycleModifiers.forEach((modifier) => {
+    lifecycleModifiers.forEach(modifier => {
         if (content.includes(`.${modifier}(`)) {
             analysis.hasLifecycle = true;
             analysis.lifecycleUsage.push(modifier);
         }
     });
     // Analyze navigation usage
-    const navigationComponents = ['NavigationView', 'NavigationLink', 'TabView', 'useNavigation'];
-    navigationComponents.forEach((component) => {
+    const navigationComponents = [
+        'NavigationView',
+        'NavigationLink',
+        'TabView',
+        'useNavigation',
+    ];
+    navigationComponents.forEach(component => {
         if (content.includes(component)) {
             analysis.hasNavigation = true;
             analysis.navigationUsage.push(component);
@@ -73,7 +201,7 @@ function analyzeFile(filePath, content) {
     });
     // Find component definitions
     const componentMatches = content.match(/export function (\w+)\(/g) || [];
-    analysis.components = componentMatches.map((match) => match.replace('export function ', '').replace('(', ''));
+    analysis.components = componentMatches.map(match => match.replace('export function ', '').replace('(', ''));
     // Calculate complexity score
     analysis.complexity += (content.match(/if\s*\(/g) || []).length * 2;
     analysis.complexity += (content.match(/for\s*\(/g) || []).length * 2;
@@ -82,6 +210,8 @@ function analyzeFile(filePath, content) {
     analysis.complexity += (content.match(/\.map\(/g) || []).length;
     analysis.complexity += (content.match(/\.filter\(/g) || []).length;
     analysis.complexity += analysis.modifierUsage.length * 0.5;
+    // Analyze concatenation patterns
+    analysis.concatenationPatterns = analyzeConcatenationPatterns(content, filePath);
     return analysis;
 }
 function generateSuggestions(results) {
@@ -92,7 +222,7 @@ function generateSuggestions(results) {
     }
     // Modifier usage suggestions
     if (results.components.withModifiers < results.components.total * 0.7) {
-        suggestions.push('Use TachUI modifiers for consistent styling (.modifier.padding(), .foregroundColor())');
+        suggestions.push('Use TachUI modifiers for consistent styling (.padding(), .foregroundColor())');
     }
     // Lifecycle suggestions
     if (results.components.withLifecycle < results.components.total * 0.2) {
@@ -111,7 +241,7 @@ function generateSuggestions(results) {
         suggestions.push('Consider adding navigation (NavigationView, TabView) for better user experience');
     }
     // Layout suggestions
-    const layoutTypes = new Set(results.patterns.layoutUsage.map((usage) => usage.split('.')[1]));
+    const layoutTypes = new Set(results.patterns.layoutUsage.map(usage => usage.split('.')[1]));
     if (layoutTypes.size === 1 && layoutTypes.has('VStack')) {
         suggestions.push('Consider using HStack or ZStack for more dynamic layouts');
     }
@@ -124,6 +254,7 @@ export const analyzeCommand = new Command('analyze')
     .option('--performance', 'Include performance analysis', true)
     .option('--suggestions', 'Include improvement suggestions', true)
     .option('--detailed', 'Show detailed component analysis', false)
+    .option('--concatenation', 'Focus on concatenation optimization analysis', false)
     .action(async (options) => {
     try {
         console.log(chalk.cyan(`
@@ -165,6 +296,19 @@ export const analyzeCommand = new Command('analyze')
                 lifecycleUsage: [],
                 navigationUsage: [],
             },
+            concatenation: {
+                totalPatterns: 0,
+                optimizedPatterns: 0,
+                staticPatterns: 0,
+                dynamicPatterns: 0,
+                bundleSavingsKB: 0,
+                accessibilityBreakdown: {
+                    minimal: 0,
+                    aria: 0,
+                    full: 0,
+                },
+                recommendations: [],
+            },
             performance: {
                 largeComponents: [],
                 complexComponents: [],
@@ -220,6 +364,9 @@ export const analyzeCommand = new Command('analyze')
             }
         }
         results.files.averageSize = results.files.totalSize / results.files.total;
+        // Generate concatenation analysis
+        const allConcatenationPatterns = fileAnalyses.flatMap(f => f.concatenationPatterns);
+        results.concatenation = generateConcatenationAnalysis(allConcatenationPatterns);
         // Generate suggestions
         if (options.suggestions) {
             results.suggestions = generateSuggestions(results);
@@ -246,7 +393,9 @@ export const analyzeCommand = new Command('analyze')
         console.log(`${chalk.gray('With navigation:')} ${results.components.withNavigation} (${((results.components.withNavigation / results.files.total) * 100).toFixed(1)}%)`);
         // Pattern usage
         console.log(`\n${chalk.yellow('🎨 Pattern Usage:')}`);
-        const topModifiers = [...new Set(results.patterns.modifierUsage.flat())].slice(0, 5);
+        const topModifiers = [
+            ...new Set(results.patterns.modifierUsage.flat()),
+        ].slice(0, 5);
         if (topModifiers.length > 0) {
             console.log(`${chalk.gray('Top modifiers:')} ${topModifiers.join(', ')}`);
         }
@@ -258,18 +407,82 @@ export const analyzeCommand = new Command('analyze')
         if (lifecycleTypes.length > 0) {
             console.log(`${chalk.gray('Lifecycle modifiers:')} ${lifecycleTypes.join(', ')}`);
         }
+        // Concatenation Analysis (Enhanced when --concatenation flag is used)
+        if (results.concatenation.totalPatterns > 0) {
+            console.log(`\n${chalk.yellow('🔗 Concatenation Analysis:')}`);
+            console.log(`${chalk.gray('Total patterns:')} ${results.concatenation.totalPatterns}`);
+            console.log(`${chalk.gray('✅ Static/Optimizable:')} ${results.concatenation.optimizedPatterns} (${Math.round((results.concatenation.optimizedPatterns / results.concatenation.totalPatterns) * 100)}%)`);
+            console.log(`${chalk.gray('🔄 Dynamic/Runtime:')} ${results.concatenation.dynamicPatterns}`);
+            console.log(`${chalk.gray('💾 Bundle savings:')} ${results.concatenation.bundleSavingsKB.toFixed(1)}KB`);
+            const { accessibilityBreakdown } = results.concatenation;
+            console.log(`${chalk.gray('♿ Accessibility breakdown:')} Minimal: ${accessibilityBreakdown.minimal}, ARIA: ${accessibilityBreakdown.aria}, Full: ${accessibilityBreakdown.full}`);
+            if (results.concatenation.recommendations.length > 0) {
+                console.log(`${chalk.gray('💡 Recommendations:')}`);
+                const maxRecs = options.concatenation
+                    ? results.concatenation.recommendations.length
+                    : 3;
+                results.concatenation.recommendations
+                    .slice(0, maxRecs)
+                    .forEach((rec, index) => {
+                    console.log(`  ${index + 1}. ${rec}`);
+                });
+            }
+            // Enhanced concatenation analysis when --concatenation flag is used
+            if (options.concatenation && allConcatenationPatterns.length > 0) {
+                console.log(`\n${chalk.cyan('📋 Detailed Concatenation Report:')}`);
+                // Group patterns by file for detailed analysis
+                const patternsByFile = new Map();
+                fileAnalyses.forEach(analysis => {
+                    if (analysis.concatenationPatterns.length > 0) {
+                        const shortFilename = analysis.file.split('/').pop() || analysis.file;
+                        patternsByFile.set(shortFilename, analysis.concatenationPatterns);
+                    }
+                });
+                patternsByFile.forEach((patterns, filename) => {
+                    console.log(`\n${chalk.green(filename)}:`);
+                    patterns.forEach((pattern, index) => {
+                        const optimizationIcon = pattern.optimizable ? '✅' : '🔄';
+                        const accessibilityColor = pattern.accessibilityNeeds === 'minimal'
+                            ? chalk.green
+                            : pattern.accessibilityNeeds === 'aria'
+                                ? chalk.yellow
+                                : chalk.red;
+                        console.log(`  ${optimizationIcon} Pattern ${index + 1}: ${pattern.type} (${accessibilityColor(pattern.accessibilityNeeds)})`);
+                        console.log(`     Left: ${pattern.leftComponent.substring(0, 50)}${pattern.leftComponent.length > 50 ? '...' : ''}`);
+                        console.log(`     Right: ${pattern.rightComponent.substring(0, 50)}${pattern.rightComponent.length > 50 ? '...' : ''}`);
+                    });
+                });
+                // Optimization opportunities
+                const optimizablePatterns = allConcatenationPatterns.filter(p => !p.optimizable);
+                if (optimizablePatterns.length > 0) {
+                    console.log(`\n${chalk.yellow('🚀 Optimization Opportunities:')}`);
+                    optimizablePatterns.slice(0, 5).forEach((pattern, index) => {
+                        console.log(`  ${index + 1}. Convert dynamic pattern to static in ${pattern.leftComponent}`);
+                    });
+                }
+                console.log(`\n${chalk.cyan('💾 Bundle Impact Projection:')}`);
+                console.log(`  Current concatenation system: 87.76KB`);
+                console.log(`  Optimized system: ${(87.76 - results.concatenation.bundleSavingsKB).toFixed(1)}KB`);
+                console.log(`  ${chalk.green(`Savings: ${results.concatenation.bundleSavingsKB.toFixed(1)}KB (${Math.round((results.concatenation.bundleSavingsKB / 87.76) * 100)}%)`)}`);
+            }
+        }
+        else if (options.concatenation) {
+            console.log(`\n${chalk.yellow('🔗 Concatenation Analysis:')}`);
+            console.log(chalk.gray('No concatenation patterns found in analyzed files'));
+            console.log(chalk.gray('💡 Concatenation optimization is available when you use .build().concat() patterns'));
+        }
         // Performance insights
         if (options.performance) {
             console.log(`\n${chalk.yellow('⚡ Performance Insights:')}`);
             if (results.performance.largeComponents.length > 0) {
                 console.log(`${chalk.red('Large components:')} ${results.performance.largeComponents.length}`);
-                results.performance.largeComponents.slice(0, 3).forEach((comp) => {
+                results.performance.largeComponents.slice(0, 3).forEach(comp => {
                     console.log(`  ${comp.file}: ${comp.lines} lines`);
                 });
             }
             if (results.performance.complexComponents.length > 0) {
                 console.log(`${chalk.red('Complex components:')} ${results.performance.complexComponents.length}`);
-                results.performance.complexComponents.slice(0, 3).forEach((comp) => {
+                results.performance.complexComponents.slice(0, 3).forEach(comp => {
                     console.log(`  ${comp.file}: complexity ${comp.complexity}`);
                 });
             }
@@ -289,9 +502,9 @@ export const analyzeCommand = new Command('analyze')
         if (options.detailed && fileAnalyses.length > 0) {
             console.log(`\n${chalk.yellow('🔍 Detailed Component Analysis:')}`);
             fileAnalyses
-                .filter((analysis) => analysis.components.length > 0)
+                .filter(analysis => analysis.components.length > 0)
                 .slice(0, 5)
-                .forEach((analysis) => {
+                .forEach(analysis => {
                 const fileName = analysis.file.split('/').pop();
                 console.log(`\n${chalk.cyan(fileName)}:`);
                 console.log(`  Components: ${analysis.components.join(', ')}`);