packlyze 4.0.0 → 4.0.2

package/dist/analyzer/packlyze.js

@@ -291,6 +291,325 @@ class Packlyze {
         }
         return possibleRoots;
     }
+    /**
+     * Detect missing file extensions in resolve.extensions
+     * Example: Error resolving './App' when App.tsx exists but .tsx not in extensions
+     */
+    detectMissingExtensions(errors) {
+        const missingExtensions = new Set();
+        for (const error of errors) {
+            const message = (error.message || '') + ' ' + (error.details || '');
+            // Pattern: Can't resolve './App' or './Component'
+            // Check if file exists with common extensions
+            const resolveError = message.match(/Can't resolve ['"]([^'"]+)['"]/);
+            if (resolveError) {
+                const importPath = resolveError[1];
+                // Skip if it's a package (starts with letter, no ./ or ../)
+                if (importPath.startsWith('./') || importPath.startsWith('../')) {
+                    const projectRoot = this.baseDir;
+                    const possibleExtensions = ['.tsx', '.ts', '.jsx', '.js', '.json', '.css', '.scss', '.svg', '.png'];
+                    for (const ext of possibleExtensions) {
+                        const possibleFile = path_1.default.resolve(projectRoot, importPath + ext);
+                        if (fs_1.default.existsSync(possibleFile)) {
+                            // File exists with this extension, but webpack couldn't resolve it
+                            // This suggests the extension is missing from resolve.extensions
+                            missingExtensions.add(ext);
+                        }
+                    }
+                }
+            }
+        }
+        return Array.from(missingExtensions);
+    }
+    /**
+     * Detect missing CSS/image loaders
+     */
+    detectMissingAssetLoaders(errors) {
+        let css = false;
+        let images = false;
+        for (const error of errors) {
+            const message = (error.message || '') + ' ' + (error.details || '');
+            // CSS loader errors
+            if (message.includes('.css') &&
+                (message.includes("You may need an appropriate loader") ||
+                    message.includes("Can't resolve") && message.match(/\.css['"]/))) {
+                css = true;
+            }
+            // Image loader errors
+            if ((message.includes('.svg') || message.includes('.png') || message.includes('.jpg') || message.includes('.gif')) &&
+                (message.includes("You may need an appropriate loader") ||
+                    message.includes("Can't resolve") && message.match(/\.(svg|png|jpg|jpeg|gif)['"]/))) {
+                images = true;
+            }
+        }
+        return { css, images };
+    }
+    /**
+     * Detect baseUrl usage without proper webpack configuration
+     */
+    detectBaseUrlIssues(errors) {
+        for (const error of errors) {
+            const message = (error.message || '') + ' ' + (error.details || '');
+            // Pattern: Can't resolve 'src/utils' or 'app/components' (absolute imports without ./ or ../)
+            // This suggests baseUrl is set in tsconfig but not configured in webpack
+            const absoluteImportError = message.match(/Can't resolve ['"]([^./][^'"]+)['"]/);
+            if (absoluteImportError) {
+                const importPath = absoluteImportError[1];
+                // Check if it's not a node_modules package (doesn't start with @ or common package names)
+                if (!importPath.startsWith('@') &&
+                    !importPath.match(/^(react|vue|angular|@babel|@types)/)) {
+                    // Check if this path exists in the project
+                    const projectRoot = this.baseDir;
+                    const possiblePath = path_1.default.join(projectRoot, importPath);
+                    if (fs_1.default.existsSync(possiblePath) || fs_1.default.existsSync(possiblePath + '.ts') || fs_1.default.existsSync(possiblePath + '.tsx')) {
+                        return true;
+                    }
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Detect case-sensitivity issues
+     */
+    detectCaseSensitivityIssues(errors) {
+        const issues = [];
+        for (const error of errors) {
+            const message = (error.message || '') + ' ' + (error.details || '');
+            // Pattern: Can't resolve './components/Button' but './Components/button.tsx' exists
+            const resolveError = message.match(/Can't resolve ['"]([^'"]+)['"]/);
+            if (resolveError) {
+                const importPath = resolveError[1];
+                if (importPath.startsWith('./') || importPath.startsWith('../')) {
+                    const projectRoot = this.baseDir;
+                    const fullPath = path_1.default.resolve(projectRoot, importPath);
+                    const dir = path_1.default.dirname(fullPath);
+                    const basename = path_1.default.basename(fullPath);
+                    if (fs_1.default.existsSync(dir)) {
+                        // Check for case-insensitive matches
+                        const files = fs_1.default.readdirSync(dir);
+                        const lowerBasename = basename.toLowerCase();
+                        for (const file of files) {
+                            if (file.toLowerCase() === lowerBasename && file !== basename) {
+                                issues.push({ expected: importPath, actual: path_1.default.join(path_1.default.dirname(importPath), file) });
+                                break;
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return issues;
+    }
+    /**
+     * Extract alias patterns from error messages
+     * Example: "Can't resolve '@/hooks/useAuth'" -> { alias: '@', path: '@/hooks/useAuth' }
+     */
+    extractAliasFromErrors(errors) {
+        const aliases = new Map();
+        for (const error of errors) {
+            const message = (error.message || '') + ' ' + (error.details || '');
+            // Match patterns like '@/hooks/useAuth', '@\\hooks\\useAuth', or "'@/hooks/useAuth'"
+            const aliasPatterns = [
+                /['"`]?(@[^/\\'"`\s]+)[/\\]/g, // @/something or @\something
+                /Can't resolve ['"`]?(@[^/\\'"`\s]+)[/\\]/g,
+                /Cannot resolve ['"`]?(@[^/\\'"`\s]+)[/\\]/g,
+            ];
+            for (const pattern of aliasPatterns) {
+                let match;
+                while ((match = pattern.exec(message)) !== null) {
+                    const alias = match[1];
+                    if (alias && !aliases.has(alias)) {
+                        // Extract the example path
+                        const escapedAlias = alias.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+                        const fullPathMatch = message.match(new RegExp(`['"]?${escapedAlias}[/\\\\][^'"\\s]+`));
+                        aliases.set(alias, fullPathMatch ? fullPathMatch[0].replace(/['"`]/g, '') : `${alias}/...`);
+                    }
+                }
+            }
+        }
+        return Array.from(aliases.entries()).map(([alias, examplePath]) => ({ alias, examplePath }));
+    }
+    /**
+     * Infer alias mapping by analyzing project structure
+     * Example: '@' -> 'src' (most common convention)
+     */
+    inferAliasMapping(alias, examplePath) {
+        // Common alias mappings
+        const commonMappings = {
+            '@': ['src', 'source', 'app', 'lib'],
+            '~': ['src', 'source'],
+            '@app': ['src/app', 'app'],
+            '@components': ['src/components', 'components'],
+            '@utils': ['src/utils', 'utils'],
+            '@lib': ['src/lib', 'lib'],
+        };
+        // Check if we have a known mapping
+        if (commonMappings[alias]) {
+            const projectRoot = this.baseDir;
+            for (const possiblePath of commonMappings[alias]) {
+                const fullPath = path_1.default.join(projectRoot, possiblePath);
+                if (fs_1.default.existsSync(fullPath) && fs_1.default.statSync(fullPath).isDirectory()) {
+                    return possiblePath;
+                }
+            }
+        }
+        // Try to infer from the example path
+        // If error is '@/hooks/useAuth', try to find where 'hooks' directory exists
+        const pathParts = examplePath.split(/[/\\]/);
+        if (pathParts.length >= 2) {
+            const firstPart = pathParts[1]; // e.g., 'hooks' from '@/hooks/useAuth'
+            const projectRoot = this.baseDir;
+            // Check common locations
+            const possibleLocations = [
+                path_1.default.join(projectRoot, 'src', firstPart),
+                path_1.default.join(projectRoot, firstPart),
+                path_1.default.join(path_1.default.dirname(projectRoot), 'src', firstPart),
+            ];
+            for (const location of possibleLocations) {
+                if (fs_1.default.existsSync(location) && fs_1.default.statSync(location).isDirectory()) {
+                    // Found the directory, infer the base path
+                    const relativePath = path_1.default.relative(projectRoot, path_1.default.dirname(location));
+                    return relativePath || 'src'; // Default to 'src' if at root
+                }
+            }
+            // If we found 'hooks' in 'src/hooks', infer '@' -> 'src'
+            const srcHooks = path_1.default.join(projectRoot, 'src', firstPart);
+            if (fs_1.default.existsSync(srcHooks)) {
+                return 'src';
+            }
+        }
+        // Default inference: '@' usually maps to 'src'
+        if (alias === '@') {
+            const srcPath = path_1.default.join(this.baseDir, 'src');
+            if (fs_1.default.existsSync(srcPath) && fs_1.default.statSync(srcPath).isDirectory()) {
+                return 'src';
+            }
+        }
+        return null;
+    }
+    /**
+     * Scan source files for alias usage patterns
+     * Example: Finds '@/hooks/useAuth' in source files -> detects '@' alias is needed
+     */
+    scanSourceFilesForAliases() {
+        const aliases = new Map();
+        const projectRoot = this.baseDir;
+        // Common alias patterns to look for
+        const aliasPatterns = [
+            /['"]@\/([^'"]+)['"]/g, // '@/hooks/useAuth'
+            /['"]@\\([^'"]+)['"]/g, // '@\hooks\useAuth' (Windows)
+            /['"]~\/([^'"]+)['"]/g, // '~/components/Button'
+            /from\s+['"]@\/([^'"]+)['"]/g, // from '@/hooks/useAuth'
+            /import\s+.*from\s+['"]@\/([^'"]+)['"]/g, // import ... from '@/hooks/useAuth'
+            /require\(['"]@\/([^'"]+)['"]\)/g, // require('@/hooks/useAuth')
+        ];
+        // Scan common source directories
+        const sourceDirs = [
+            path_1.default.join(projectRoot, 'src'),
+            path_1.default.join(path_1.default.dirname(projectRoot), 'src'),
+            projectRoot,
+        ];
+        const scannedFiles = new Set();
+        const maxFilesToScan = 100; // Limit to avoid performance issues
+        let filesScanned = 0;
+        const scanDirectory = (dir, depth = 0) => {
+            if (depth > 5 || filesScanned >= maxFilesToScan)
+                return; // Limit depth and file count
+            if (!fs_1.default.existsSync(dir) || !fs_1.default.statSync(dir).isDirectory())
+                return;
+            try {
+                const entries = fs_1.default.readdirSync(dir);
+                for (const entry of entries) {
+                    if (filesScanned >= maxFilesToScan)
+                        break;
+                    // Skip node_modules, dist, build, etc.
+                    if (entry === 'node_modules' || entry === 'dist' || entry === 'build' ||
+                        entry === '.git' || entry.startsWith('.')) {
+                        continue;
+                    }
+                    const fullPath = path_1.default.join(dir, entry);
+                    try {
+                        const stats = fs_1.default.statSync(fullPath);
+                        if (stats.isDirectory()) {
+                            scanDirectory(fullPath, depth + 1);
+                        }
+                        else if (stats.isFile()) {
+                            // Only scan JS/TS files
+                            if (/\.(ts|tsx|js|jsx)$/.test(entry)) {
+                                if (scannedFiles.has(fullPath))
+                                    continue;
+                                scannedFiles.add(fullPath);
+                                filesScanned++;
+                                try {
+                                    const content = fs_1.default.readFileSync(fullPath, 'utf-8');
+                                    // Check for alias patterns
+                                    for (const pattern of aliasPatterns) {
+                                        let match;
+                                        while ((match = pattern.exec(content)) !== null && filesScanned < maxFilesToScan) {
+                                            const aliasPath = match[1] || match[0];
+                                            // Extract alias prefix
+                                            if (match[0].includes('@/') || match[0].includes('@\\')) {
+                                                const alias = '@';
+                                                if (!aliases.has(alias)) {
+                                                    // Try to infer the mapping
+                                                    const inferredPath = this.inferAliasMapping(alias, `@/${aliasPath}`);
+                                                    if (inferredPath) {
+                                                        const absolutePath = path_1.default.isAbsolute(inferredPath)
+                                                            ? inferredPath
+                                                            : path_1.default.resolve(projectRoot, inferredPath);
+                                                        aliases.set(alias, absolutePath);
+                                                        this.log(`Detected alias usage: ${alias} -> ${inferredPath} (from source file: ${entry})`);
+                                                    }
+                                                }
+                                            }
+                                            else if (match[0].includes('~/')) {
+                                                const alias = '~';
+                                                if (!aliases.has(alias)) {
+                                                    const inferredPath = this.inferAliasMapping(alias, `~/${aliasPath}`);
+                                                    if (inferredPath) {
+                                                        const absolutePath = path_1.default.isAbsolute(inferredPath)
+                                                            ? inferredPath
+                                                            : path_1.default.resolve(projectRoot, inferredPath);
+                                                        aliases.set(alias, absolutePath);
+                                                        this.log(`Detected alias usage: ${alias} -> ${inferredPath} (from source file: ${entry})`);
+                                                    }
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                                catch (error) {
+                                    // Skip files that can't be read
+                                    continue;
+                                }
+                            }
+                        }
+                    }
+                    catch (error) {
+                        // Skip entries that can't be accessed
+                        continue;
+                    }
+                }
+            }
+            catch (error) {
+                // Skip directories that can't be read
+                return;
+            }
+        };
+        // Scan all source directories
+        for (const sourceDir of sourceDirs) {
+            if (fs_1.default.existsSync(sourceDir)) {
+                scanDirectory(sourceDir);
+            }
+        }
+        // Convert Map to Record
+        const result = {};
+        for (const [key, value] of aliases.entries()) {
+            result[key] = value;
+        }
+        return result;
+    }
     /**
      * Extract TypeScript path aliases from tsconfig.json
      * Note: Does not handle "extends" - only reads the direct tsconfig.json file
@@ -485,7 +804,16 @@ class Packlyze {
         const useTypeScript = hasTypeScript;
         const isReact = framework === 'react';
         // Get TypeScript path aliases if available
-        const pathAliases = hasTypeScript ? this.getTypeScriptPathAliases() : {};
+        let pathAliases = hasTypeScript ? this.getTypeScriptPathAliases() : {};
+        // If no aliases found in tsconfig.json, scan source files for alias usage
+        if (Object.keys(pathAliases).length === 0) {
+            this.log('No path aliases found in tsconfig.json, scanning source files for alias usage...');
+            const detectedAliases = this.scanSourceFilesForAliases();
+            if (Object.keys(detectedAliases).length > 0) {
+                this.log(`Detected ${Object.keys(detectedAliases).length} alias(es) from source files: ${Object.keys(detectedAliases).join(', ')}`);
+                pathAliases = { ...pathAliases, ...detectedAliases };
+            }
+        }
         const hasAliases = Object.keys(pathAliases).length > 0;
         // Generate alias configuration string
         let aliasConfig = '';
@@ -537,7 +865,8 @@ module.exports = {
   },
   
   resolve: {
-    extensions: ['.js', '.jsx'${useTypeScript ? ", '.ts', '.tsx'" : ''}]${aliasConfig},
+    extensions: ['.js', '.jsx'${useTypeScript ? ", '.ts', '.tsx'" : ''}, '.json']${aliasConfig},
+    modules: ['node_modules', path.resolve(__dirname, 'src')],
   },
   
   module: {
@@ -581,6 +910,10 @@ module.exports = {
             config += `      {
         test: /\\.(png|jpg|jpeg|gif|svg)$/,
         type: 'asset/resource'
+      },
+      {
+        test: /\\.css$/,
+        use: ['style-loader', 'css-loader']
       }
     ]
   },
@@ -611,7 +944,8 @@ module.exports = {
   },
   
   resolve: {
-    extensions: ['.js', '.jsx'${useTypeScript ? ", '.ts', '.tsx'" : ''}]${aliasConfig},
+    extensions: ['.js', '.jsx'${useTypeScript ? ", '.ts', '.tsx'" : ''}, '.json']${aliasConfig},
+    modules: ['node_modules', path.resolve(__dirname, 'src')],
   },
   
   module: {
@@ -655,6 +989,10 @@ module.exports = {
             config += `      {
         test: /\\.(png|jpg|jpeg|gif|svg)$/,
         type: 'asset/resource'
+      },
+      {
+        test: /\\.css$/,
+        use: ['style-loader', 'css-loader']
       }
     ]
   },
@@ -1066,29 +1404,162 @@ module.exports = {
                     }
                 }
                 else {
-                    // Get the search paths for better error message
-                    const searchPaths = this.findProjectRoot();
-                    const searchedLocations = searchPaths.map(p => path_1.default.join(p, 'tsconfig.json')).join('\n     - ');
-                    pathAliasSuggestion = `\n\n⚠️  Path alias errors detected, but no path aliases found in tsconfig.json.\n\n` +
-                        `   Searched for tsconfig.json in:\n` +
-                        `     - ${searchedLocations}\n\n` +
-                        `   Make sure:\n` +
-                        `     1. tsconfig.json exists in one of the locations above\n` +
-                        `     2. tsconfig.json has compilerOptions.paths configured:\n` +
-                        `        {\n` +
-                        `          "compilerOptions": {\n` +
-                        `            "baseUrl": ".",\n` +
-                        `            "moduleResolution": "node",\n` +
-                        `            "paths": {\n` +
-                        `              "@/*": ["src/*"]\n` +
-                        `            }\n` +
-                        `          }\n` +
-                        `        }\n` +
-                        `     3. If using "extends", path aliases must be in the main tsconfig.json (not just in extended config)\n` +
-                        `     4. If using moduleResolution: "bundler", change it to "node" or "node16" for webpack compatibility\n` +
-                        `     5. Run with --verbose to see detailed search logs\n\n` +
-                        `   💡 Alternative: Install tsconfig-paths-webpack-plugin for automatic path alias resolution:\n` +
-                        `      npm install --save-dev tsconfig-paths-webpack-plugin\n`;
+                    // No aliases in tsconfig.json, but we have path alias errors
+                    // Try to infer aliases from error messages and auto-fix
+                    const inferredAliases = this.extractAliasFromErrors(pathAliasErrors);
+                    if (inferredAliases.length > 0) {
+                        this.log(`Detected ${inferredAliases.length} alias pattern(s) from error messages: ${inferredAliases.map(a => a.alias).join(', ')}`);
+                        // Try to infer mappings and add them to webpack config
+                        const aliasMappings = {};
+                        for (const { alias, examplePath } of inferredAliases) {
+                            const inferredPath = this.inferAliasMapping(alias, examplePath);
+                            if (inferredPath) {
+                                const projectRoot = this.baseDir;
+                                const absolutePath = path_1.default.isAbsolute(inferredPath)
+                                    ? inferredPath
+                                    : path_1.default.resolve(projectRoot, inferredPath);
+                                aliasMappings[alias] = absolutePath;
+                                this.log(`Inferred mapping: ${alias} -> ${inferredPath}`);
+                            }
+                            else {
+                                this.log(`Could not infer mapping for alias: ${alias}`);
+                            }
+                        }
+                        // If we found mappings, try to add them to webpack config
+                        if (Object.keys(aliasMappings).length > 0 && configCheck.exists) {
+                            try {
+                                // Read existing config
+                                const configPath = configCheck.path;
+                                let configContent = fs_1.default.readFileSync(configPath, 'utf-8');
+                                // Check if alias section exists
+                                const hasAliasSection = configContent.includes('resolve:') &&
+                                    configContent.includes('alias:');
+                                if (!hasAliasSection) {
+                                    // Add alias section to resolve
+                                    const aliasEntries = Object.entries(aliasMappings)
+                                        .map(([key, absolutePath]) => {
+                                        const relativePath = path_1.default.relative(this.baseDir, absolutePath);
+                                        const normalizedPath = relativePath.replace(/\\/g, '/');
+                                        const escapedKey = key.replace(/'/g, "\\'");
+                                        return `      '${escapedKey}': path.resolve(__dirname, '${normalizedPath}')`;
+                                    })
+                                        .join(',\n');
+                                    // Try to insert alias into resolve section
+                                    if (configContent.includes('resolve:')) {
+                                        // Find resolve section and add alias
+                                        const resolveMatch = configContent.match(/resolve:\s*\{[^}]*\}/s);
+                                        if (resolveMatch) {
+                                            const resolveSection = resolveMatch[0];
+                                            if (!resolveSection.includes('alias:')) {
+                                                // Add alias before closing brace
+                                                const newResolveSection = resolveSection.replace(/\}\s*$/, `,\n    alias: {\n${aliasEntries}\n    }\n  }`);
+                                                configContent = configContent.replace(resolveSection, newResolveSection);
+                                                fs_1.default.writeFileSync(configPath, configContent, 'utf-8');
+                                                configRegenerated = true;
+                                                pathAliasSuggestion = `\n\n✅ Auto-detected and added path aliases to ${configCheck.correctFileName}!\n` +
+                                                    `   Detected aliases from error messages:\n` +
+                                                    Object.entries(aliasMappings).map(([key, mappedPath]) => {
+                                                        const relativePath = path_1.default.relative(this.baseDir, mappedPath);
+                                                        return `     - ${key} -> ${relativePath}`;
+                                                    }).join('\n') +
+                                                    `\n\n   💡 Next steps:\n` +
+                                                    `      1. Regenerate stats.json: npx webpack --profile --json stats.json\n` +
+                                                    `      2. Run packlyze analyze stats.json again\n`;
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                            catch (error) {
+                                this.log(`Could not auto-add aliases to config: ${error}`);
+                            }
+                        }
+                        // If we couldn't auto-fix, provide helpful suggestions
+                        if (!configRegenerated) {
+                            const searchPaths = this.findProjectRoot();
+                            const searchedLocations = searchPaths.map(p => path_1.default.join(p, 'tsconfig.json')).join('\n     - ');
+                            const aliasExamples = inferredAliases.map(a => `     - ${a.alias} (from: ${a.examplePath})`).join('\n');
+                            const suggestedMappings = Object.entries(aliasMappings).length > 0
+                                ? `\n   Inferred mappings:\n` +
+                                    Object.entries(aliasMappings).map(([key, mappedPath]) => {
+                                        const relativePath = path_1.default.relative(this.baseDir, mappedPath);
+                                        return `     - ${key} -> ${relativePath}`;
+                                    }).join('\n')
+                                : '';
+                            pathAliasSuggestion = `\n\n⚠️  Path alias errors detected, but no path aliases found in tsconfig.json.\n\n` +
+                                `   Detected alias patterns from errors:\n${aliasExamples}\n` +
+                                (suggestedMappings || '') +
+                                `\n   Searched for tsconfig.json in:\n` +
+                                `     - ${searchedLocations}\n\n` +
+                                (Object.keys(aliasMappings).length > 0 ?
+                                    `   💡 Quick fix - Add to your ${configCheck.correctFileName}:\n` +
+                                        `      resolve: {\n` +
+                                        `        alias: {\n` +
+                                        Object.entries(aliasMappings).map(([key, mappedPath]) => {
+                                            const relativePath = path_1.default.relative(this.baseDir, mappedPath);
+                                            const normalizedPath = relativePath.replace(/\\/g, '/');
+                                            return `          '${key}': path.resolve(__dirname, '${normalizedPath}')`;
+                                        }).join(',\n') +
+                                        `\n        }\n` +
+                                        `      }\n\n` +
+                                        `   Or add to tsconfig.json:\n` +
+                                        `     {\n` +
+                                        `       "compilerOptions": {\n` +
+                                        `         "baseUrl": ".",\n` +
+                                        `         "moduleResolution": "node",\n` +
+                                        `         "paths": {\n` +
+                                        Object.entries(aliasMappings).map(([key, mappedPath]) => {
+                                            const relativePath = path_1.default.relative(this.baseDir, mappedPath);
+                                            const normalizedPath = relativePath.replace(/\\/g, '/');
+                                            return `           "${key}/*": ["${normalizedPath}/*"]`;
+                                        }).join(',\n') +
+                                        `\n         }\n` +
+                                        `       }\n` +
+                                        `     }\n` :
+                                    `   Make sure:\n` +
+                                        `     1. tsconfig.json exists in one of the locations above\n` +
+                                        `     2. tsconfig.json has compilerOptions.paths configured:\n` +
+                                        `        {\n` +
+                                        `          "compilerOptions": {\n` +
+                                        `            "baseUrl": ".",\n` +
+                                        `            "moduleResolution": "node",\n` +
+                                        `            "paths": {\n` +
+                                        `              "@/*": ["src/*"]\n` +
+                                        `            }\n` +
+                                        `          }\n` +
+                                        `        }\n` +
+                                        `     3. If using "extends", path aliases must be in the main tsconfig.json (not just in extended config)\n` +
+                                        `     4. If using moduleResolution: "bundler", change it to "node" or "node16" for webpack compatibility\n` +
+                                        `     5. Run with --verbose to see detailed search logs\n\n` +
+                                        `   💡 Alternative: Install tsconfig-paths-webpack-plugin for automatic path alias resolution:\n` +
+                                        `      npm install --save-dev tsconfig-paths-webpack-plugin\n`);
+                        }
+                    }
+                    else {
+                        // Could not extract aliases from errors
+                        const searchPaths = this.findProjectRoot();
+                        const searchedLocations = searchPaths.map(p => path_1.default.join(p, 'tsconfig.json')).join('\n     - ');
+                        pathAliasSuggestion = `\n\n⚠️  Path alias errors detected, but no path aliases found in tsconfig.json.\n\n` +
+                            `   Searched for tsconfig.json in:\n` +
+                            `     - ${searchedLocations}\n\n` +
+                            `   Make sure:\n` +
+                            `     1. tsconfig.json exists in one of the locations above\n` +
+                            `     2. tsconfig.json has compilerOptions.paths configured:\n` +
+                            `        {\n` +
+                            `          "compilerOptions": {\n` +
+                            `            "baseUrl": ".",\n` +
+                            `            "moduleResolution": "node",\n` +
+                            `            "paths": {\n` +
+                            `              "@/*": ["src/*"]\n` +
+                            `            }\n` +
+                            `          }\n` +
+                            `        }\n` +
+                            `     3. If using "extends", path aliases must be in the main tsconfig.json (not just in extended config)\n` +
+                            `     4. If using moduleResolution: "bundler", change it to "node" or "node16" for webpack compatibility\n` +
+                            `     5. Run with --verbose to see detailed search logs\n\n` +
+                            `   💡 Alternative: Install tsconfig-paths-webpack-plugin for automatic path alias resolution:\n` +
+                            `      npm install --save-dev tsconfig-paths-webpack-plugin\n`;
+                    }
                 }
             }
             // Build the error message
@@ -1110,8 +1581,138 @@ module.exports = {
             if (!configRegenerated && pathAliasSuggestion) {
                 errorMessage += pathAliasSuggestion;
             }
+            // Detect and handle other common issues
+            let otherIssues = '';
+            // 1. Missing extensions in resolve.extensions
+            const missingExtensions = this.detectMissingExtensions(errors);
+            if (missingExtensions.length > 0) {
+                const configCheck = this.checkWebpackConfig();
+                if (configCheck.exists && configCheck.path) {
+                    try {
+                        let configContent = fs_1.default.readFileSync(configCheck.path, 'utf-8');
+                        // Check if extensions are already in config
+                        const hasExtensions = configContent.includes('extensions:');
+                        if (hasExtensions) {
+                            // Try to add missing extensions
+                            const extensionsMatch = configContent.match(/extensions:\s*\[([^\]]+)\]/);
+                            if (extensionsMatch) {
+                                const existingExtensions = extensionsMatch[1];
+                                const newExtensions = missingExtensions
+                                    .filter(ext => !existingExtensions.includes(ext))
+                                    .map(ext => `'${ext}'`)
+                                    .join(', ');
+                                if (newExtensions) {
+                                    const newExtensionsList = existingExtensions.trim()
+                                        ? `${existingExtensions}, ${newExtensions}`
+                                        : newExtensions;
+                                    configContent = configContent.replace(/extensions:\s*\[([^\]]+)\]/, `extensions: [${newExtensionsList}]`);
+                                    fs_1.default.writeFileSync(configCheck.path, configContent, 'utf-8');
+                                    otherIssues += `\n\n✅ Auto-added missing extensions to resolve.extensions: ${missingExtensions.join(', ')}\n`;
+                                }
+                            }
+                        }
+                        else {
+                            // Add extensions section
+                            if (configContent.includes('resolve:')) {
+                                const resolveMatch = configContent.match(/resolve:\s*\{[^}]*\}/s);
+                                if (resolveMatch) {
+                                    const extensionsList = missingExtensions.map(ext => `'${ext}'`).join(', ');
+                                    const newResolveSection = resolveMatch[0].replace(/\}\s*$/, `,\n    extensions: ['.js', '.jsx', '.ts', '.tsx', ${extensionsList}]\n  }`);
+                                    configContent = configContent.replace(resolveMatch[0], newResolveSection);
+                                    fs_1.default.writeFileSync(configCheck.path, configContent, 'utf-8');
+                                    otherIssues += `\n\n✅ Auto-added resolve.extensions: ${missingExtensions.join(', ')}\n`;
+                                }
+                            }
+                        }
+                    }
+                    catch (error) {
+                        otherIssues += `\n\n⚠️  Missing file extensions in resolve.extensions: ${missingExtensions.join(', ')}\n` +
+                            `   Add to your webpack config:\n` +
+                            `   resolve: {\n` +
+                            `     extensions: ['.js', '.jsx', '.ts', '.tsx', ${missingExtensions.map(e => `'${e}'`).join(', ')}]\n` +
+                            `   }\n`;
+                    }
+                }
+                else {
+                    otherIssues += `\n\n⚠️  Missing file extensions in resolve.extensions: ${missingExtensions.join(', ')}\n` +
+                        `   Add these extensions to your webpack config's resolve.extensions array.\n`;
+                }
+            }
+            // 2. Missing CSS/image loaders
+            const missingLoaders = this.detectMissingAssetLoaders(errors);
+            if (missingLoaders.css || missingLoaders.images) {
+                const missingPackages = [];
+                if (missingLoaders.css) {
+                    missingPackages.push('css-loader', 'style-loader');
+                }
+                if (missingLoaders.images) {
+                    // Webpack 5 uses asset/resource, no loader needed, but we should suggest it
+                }
+                if (missingPackages.length > 0) {
+                    const dependencyCheck = this.checkPackagesInstalled(missingPackages);
+                    if (dependencyCheck && dependencyCheck.missing.length > 0) {
+                        const installCommand = this.generateInstallCommand(dependencyCheck.missing);
+                        otherIssues += `\n\n⚠️  Missing CSS/Asset loaders detected!\n` +
+                            `   The following packages are required but not installed:\n` +
+                            `   ${dependencyCheck.missing.map(p => `     - ${p}`).join('\n')}\n\n` +
+                            `   💡 Install them with:\n` +
+                            `      ${installCommand}\n\n` +
+                            `   Then add to your webpack config:\n` +
+                            (missingLoaders.css ?
+                                `   module: {\n` +
+                                    `     rules: [\n` +
+                                    `       { test: /\\.css$/, use: ['style-loader', 'css-loader'] }\n` +
+                                    `     ]\n` +
+                                    `   }\n` : '');
+                    }
+                }
+            }
+            // 3. baseUrl issues
+            const hasBaseUrlIssue = this.detectBaseUrlIssues(errors);
+            if (hasBaseUrlIssue) {
+                const tsconfigPath = this.findProjectRoot().map(p => path_1.default.join(p, 'tsconfig.json')).find(p => fs_1.default.existsSync(p));
+                if (tsconfigPath) {
+                    try {
+                        const tsconfigContent = fs_1.default.readFileSync(tsconfigPath, 'utf-8');
+                        const cleanedContent = tsconfigContent.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '');
+                        const tsconfig = JSON.parse(cleanedContent);
+                        if (tsconfig.compilerOptions?.baseUrl && !tsconfig.compilerOptions?.paths) {
+                            otherIssues += `\n\n⚠️  baseUrl is set in tsconfig.json but paths are not configured.\n` +
+                                `   TypeScript can resolve imports like 'src/utils', but webpack cannot.\n\n` +
+                                `   💡 Solution 1: Add resolve.modules to webpack config:\n` +
+                                `      resolve: {\n` +
+                                `        modules: ['node_modules', '${tsconfig.compilerOptions.baseUrl}']\n` +
+                                `      }\n\n` +
+                                `   💡 Solution 2: Add paths to tsconfig.json:\n` +
+                                `      "compilerOptions": {\n` +
+                                `        "baseUrl": ".",\n` +
+                                `        "paths": {\n` +
+                                `          "src/*": ["src/*"],\n` +
+                                `          "app/*": ["app/*"]\n` +
+                                `        }\n` +
+                                `      }\n`;
+                        }
+                    }
+                    catch (error) {
+                        // Ignore parse errors
+                    }
+                }
+            }
+            // 4. Case-sensitivity issues
+            const caseIssues = this.detectCaseSensitivityIssues(errors);
+            if (caseIssues.length > 0) {
+                otherIssues += `\n\n⚠️  Case-sensitivity issues detected!\n` +
+                    `   Your imports use different casing than the actual files:\n` +
+                    caseIssues.map(issue => `     - Imported: ${issue.expected}\n       Actual: ${issue.actual}`).join('\n') +
+                    `\n\n   💡 Fix: Update your imports to match the exact file casing.\n` +
+                    `   This is especially important for Linux/CI environments where file systems are case-sensitive.\n`;
+            }
+            // Add other issues to error message
+            if (otherIssues) {
+                errorMessage += otherIssues;
+            }
             // Add default suggestion if no other suggestions
-            if (!suggestion && !pathAliasSuggestion && !dependencySuggestion) {
+            if (!suggestion && !pathAliasSuggestion && !dependencySuggestion && !otherIssues) {
                 errorMessage += `\n💡 Fix the webpack build errors first, then regenerate stats.json:\n` +
                     `   npx webpack --profile --json stats.json`;
             }