packlyze 4.0.0 → 4.0.2

package/README.md

@@ -42,24 +42,22 @@ npm install -g packlyze
 npx packlyze --help
 ```
 
-**2. Generate a stats file from your bundler (e.g., webpack):**
-
-> ⚠️ **Important:**  
-> You must generate a valid JSON stats file before running Packlyze.  
-> For webpack, use the following command in your project folder:
-
-```bash
-npx webpack --profile --json stats.json
-```
-- This will create a readable `stats.json` file in your project directory.
-
-**3. Run Packlyze analysis (CLI):**
+**2. Run Packlyze analysis (CLI):**
 ```bash
 packlyze analyze stats.json
 # or (if using npx)
 npx packlyze analyze stats.json
 ```
 
+> ✨ **New!** Packlyze automatically generates `stats.json` if it doesn't exist!  
+> If `stats.json` is missing, Packlyze will run `npx webpack --profile --json stats.json` for you automatically, then proceed with the analysis.
+
+**3. (Optional) Generate stats manually:**
+```bash
+# If you prefer to generate stats.json yourself:
+npx webpack --profile --json stats.json
+```
+
 **4. (Optional) Output an HTML report:**
 ```bash
 packlyze analyze stats.json -o ./reports/bundle-report.html
@@ -78,18 +76,22 @@ npm install -g packlyze
 npx packlyze --help
 ```
 
-### **Step 2: Generate Stats File**
+### **Step 2: Analyze with Packlyze (One Command!)**
 ```bash
-# Make sure webpack is installed
-npm install --save-dev webpack webpack-cli
-
-# Generate stats.json
-npx webpack --profile --json stats.json
+# Packlyze automatically generates stats.json if it doesn't exist!
+packlyze analyze stats.json
 ```
 
-### **Step 3: Analyze with Packlyze**
+> ✨ **Automatic Stats Generation:**  
+> If `stats.json` doesn't exist, Packlyze will automatically run `npx webpack --profile --json stats.json` for you, then proceed with the analysis. No manual steps needed!
+
+### **Step 3: (Optional) Generate Stats Manually**
 ```bash
-# Basic analysis
+# If you prefer to generate stats.json yourself:
+npm install --save-dev webpack webpack-cli
+npx webpack --profile --json stats.json
+
+# Then analyze
 packlyze analyze stats.json
 
 # With auto-install for missing dependencies
@@ -109,11 +111,8 @@ packlyze analyze stats.json --json
 # Packlyze will show you the exact command, or use auto-install:
 packlyze analyze stats.json --auto-install
 
-# Then regenerate stats.json
-npx webpack --profile --json stats.json
-
-# Analyze again
-packlyze analyze stats.json
+# Packlyze will automatically regenerate stats.json and analyze again
+# (No need to run webpack manually!)
 ```
 
 **If you see path alias errors:**
@@ -121,11 +120,8 @@ packlyze analyze stats.json
 # Packlyze will automatically regenerate your webpack config with path aliases
 packlyze analyze stats.json
 
-# Then regenerate stats.json
-npx webpack --profile --json stats.json
-
-# Analyze again
-packlyze analyze stats.json
+# Packlyze will automatically regenerate stats.json and analyze again
+# (No need to run webpack manually - Packlyze does it for you!)
 ```
 
 **If you see entry point errors:**
@@ -148,8 +144,11 @@ packlyze analyze stats.json
 ## 🐛 Common Issues & Solutions
 
 ### **"Stats file not found"**
-Make sure `stats.json` exists in your folder.  
-Generate it using your bundler (see above).
+✨ **Packlyze automatically generates `stats.json` for you!**  
+If auto-generation fails, you can generate it manually:
+```bash
+npx webpack --profile --json stats.json
+```
 
 ### **"Invalid JSON in stats file"**
 Your stats file may be corrupted or not plain JSON.  

package/dist/analyzer/packlyze.d.ts

@@ -30,6 +30,38 @@ export declare class Packlyze {
      * Find project root by looking for package.json
      */
     private findProjectRoot;
+    /**
+     * Detect missing file extensions in resolve.extensions
+     * Example: Error resolving './App' when App.tsx exists but .tsx not in extensions
+     */
+    private detectMissingExtensions;
+    /**
+     * Detect missing CSS/image loaders
+     */
+    private detectMissingAssetLoaders;
+    /**
+     * Detect baseUrl usage without proper webpack configuration
+     */
+    private detectBaseUrlIssues;
+    /**
+     * Detect case-sensitivity issues
+     */
+    private detectCaseSensitivityIssues;
+    /**
+     * Extract alias patterns from error messages
+     * Example: "Can't resolve '@/hooks/useAuth'" -> { alias: '@', path: '@/hooks/useAuth' }
+     */
+    private extractAliasFromErrors;
+    /**
+     * Infer alias mapping by analyzing project structure
+     * Example: '@' -> 'src' (most common convention)
+     */
+    private inferAliasMapping;
+    /**
+     * Scan source files for alias usage patterns
+     * Example: Finds '@/hooks/useAuth' in source files -> detects '@' alias is needed
+     */
+    private scanSourceFilesForAliases;
     /**
      * Extract TypeScript path aliases from tsconfig.json
      * Note: Does not handle "extends" - only reads the direct tsconfig.json file

package/dist/analyzer/packlyze.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packlyze.d.ts","sourceRoot":"","sources":["../../src/analyzer/packlyze.ts"],"names":[],"mappings":"AAGA,OAAO,EAUL,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAcV;IACP,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAC,CAA4B;gBAEnC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;IASrE,OAAO,CAAC,GAAG;IAMX;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAuGxB;;OAEG;IACU,0BAA0B,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBpF;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA2DjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqD9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6B9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAmIhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsE1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqN7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8I3B,OAAO,CAAC,SAAS;IA6DjB,OAAO,CAAC,aAAa;IAmYf,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC;IAuCxC,OAAO,CAAC,kBAAkB;IAqG1B,OAAO,CAAC,YAAY;IA2CpB,OAAO,CAAC,gBAAgB;IAuCxB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,uBAAuB;IAkD/B,OAAO,CAAC,uBAAuB;IAmB/B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,cAAc;IAoCtB,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,mBAAmB;IAkD3B,OAAO,CAAC,aAAa;IAgErB,OAAO,CAAC,gBAAgB;CAuBzB"}
+{"version":3,"file":"packlyze.d.ts","sourceRoot":"","sources":["../../src/analyzer/packlyze.ts"],"names":[],"mappings":"AAGA,OAAO,EAUL,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAcV;IACP,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAC,CAA4B;gBAEnC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;IASrE,OAAO,CAAC,GAAG;IAMX;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAuGxB;;OAEG;IACU,0BAA0B,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBpF;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA2DjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqD9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6B9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA+B/B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAyBjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAmCnC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA8B9B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA8DzB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IA8HjC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAmIhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsE1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0O7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8I3B,OAAO,CAAC,SAAS;IA6DjB,OAAO,CAAC,aAAa;IAmqBf,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC;IAuCxC,OAAO,CAAC,kBAAkB;IAqG1B,OAAO,CAAC,YAAY;IA2CpB,OAAO,CAAC,gBAAgB;IAuCxB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,uBAAuB;IAkD/B,OAAO,CAAC,uBAAuB;IAmB/B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,cAAc;IAoCtB,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,mBAAmB;IAkD3B,OAAO,CAAC,aAAa;IAgErB,OAAO,CAAC,gBAAgB;CAuBzB"}