packlyze 3.0.9 → 4.0.1

package/README.md

@@ -224,9 +224,12 @@ packlyze analyze stats.json
   
   **How Packlyze detects entry points:**
   Packlyze scans your `src` folder for common entry files in this priority order:
-  - React: `App.tsx`, `App.jsx`, `index.tsx`, `index.jsx`
-  - Generic: `main.ts`, `main.js`, `main.tsx`, `main.jsx`, `index.ts`, `index.js`
-  - Vue/Angular: `app.ts`, `app.js`
+  1. **Main entry points** (highest priority): `main.tsx`, `main.ts`, `main.jsx`, `main.js`
+  2. **React App files**: `App.tsx`, `App.jsx`, `app.tsx`, `app.jsx`
+  3. **Index files**: `index.tsx`, `index.ts`, `index.jsx`, `index.js`
+  4. **Vue/Angular**: `app.ts`, `app.js`
+  
+  **Note:** `main.*` files are prioritized because they're typically the actual entry points, while `App.*` files are usually components imported by the entry point.
   
   **Example fixes:**
   ```javascript
@@ -244,6 +247,74 @@ packlyze analyze stats.json
   **Note for ES Module projects:**  
   If your `package.json` has `"type": "module"`, you need to use `webpack.config.cjs` instead of `webpack.config.js`. Packlyze will automatically detect this and suggest the correct filename.
 
+### **TypeScript/Webpack Compatibility Issues**
+
+**Important:** TypeScript and Webpack handle path resolution differently. Here are common issues:
+
+#### **1. Path Aliases Not Working in Webpack**
+**Problem:** Your code uses `@/hooks/useAuth` which works in TypeScript/your editor, but webpack can't resolve it.
+
+**Why:** TypeScript reads path aliases from `tsconfig.json`, but webpack doesn't. Webpack needs its own `resolve.alias` configuration.
+
+**Solution:** Packlyze automatically detects path aliases from `tsconfig.json` and adds them to your webpack config. However, make sure:
+
+1. ✅ Your `tsconfig.json` has `compilerOptions.paths` configured
+2. ✅ Use `moduleResolution: "node"` (not `"bundler"`) for webpack compatibility
+3. ✅ Path aliases are in the main `tsconfig.json` (not just in extended configs)
+
+**Example tsconfig.json:**
+```json
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "moduleResolution": "node",  // ✅ Use "node" for webpack
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  }
+}
+```
+
+#### **2. moduleResolution: "bundler" Issue**
+**Problem:** `moduleResolution: "bundler"` works with Vite/esbuild but not webpack.
+
+**Solution:** Change to `"node"` or `"node16"`:
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "node"  // ✅ Works with webpack
+  }
+}
+```
+
+Packlyze will warn you if it detects `moduleResolution: "bundler"` in your tsconfig.json.
+
+#### **3. ts-loader transpileOnly Mode**
+**Note:** Packlyze generates webpack configs with `transpileOnly: true` for faster builds. This means:
+- ✅ TypeScript is transpiled to JavaScript
+- ✅ Path aliases are resolved by webpack's `resolve.alias` (which packlyze adds automatically)
+- ⚠️ Type checking happens separately (run `tsc --noEmit` for type checking)
+
+#### **4. Alternative: tsconfig-paths-webpack-plugin**
+If you prefer automatic synchronization between `tsconfig.json` and webpack:
+
+```bash
+npm install --save-dev tsconfig-paths-webpack-plugin
+```
+
+Then in your webpack config:
+```javascript
+const TsconfigPathsPlugin = require('tsconfig-paths-webpack-plugin');
+
+module.exports = {
+  resolve: {
+    plugins: [new TsconfigPathsPlugin()]
+  }
+};
+```
+
+Packlyze uses `resolve.alias` by default, which is simpler and doesn't require additional dependencies.
+
 ---
 
 ## 📁 File  Structure

package/dist/analyzer/packlyze.d.ts

@@ -30,6 +30,33 @@ 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;
     /**
      * 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;IA4HhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsE1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6L7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8I3B,OAAO,CAAC,SAAS;IA6DjB,OAAO,CAAC,aAAa;IA+Xf,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,wBAAwB;IAmIhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsE1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+N7B;;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"}