lwc-convert 1.0.1 → 1.1.0

package/README.md

@@ -7,20 +7,6 @@
   <a href="#-features">Features</a> •
   <a href="#-conversion-mappings">Mappings</a> •
   <a href="#-cli-reference">CLI Reference</a> •
-  <a href="#-contributing">Contributing</a>
-</p>
-
----
-
-[![Node.js](https://img.shields.io/badge/Node.js-18%2B-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
-[![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/Lastonedown86/lwc-convert/pulls)
-
----
-
-## 🎯 Overview
-
 `lwc-convert` automates the migration of legacy Salesforce UI technologies to modern Lightning Web Components:
 
 | Source Technology | Target | Confidence |
@@ -46,6 +32,7 @@ myComponent/
 ## ✨ Features
 
 ### 🎯 Single-Component Focus
+
 Unlike batch tools that sacrifice accuracy, `lwc-convert` processes **one component at a time** for maximum precision and detailed error reporting.
 
 ### 📝 Two Output Modes
@@ -56,13 +43,17 @@ Unlike batch tools that sacrifice accuracy, `lwc-convert` processes **one compon
 | **Full Conversion** (`--full`) | Complete transformation with `// REVIEW:` markers | Simple, standard components |
 
 ### 🔍 Smart Analysis
+
 - Parses Aura markup, controllers, helpers, and styles
 - Analyzes Apex controllers for VF pages
 - Detects patterns and suggests modern equivalents
 - Identifies potential issues upfront
+- **New!** 📊 **Complexity Grading**: Analyze components before conversion to estimate effort and identify risks.
 
 ### 📋 Conversion Notes
+
 Every conversion includes a detailed markdown file with:
+
 - ✅ Completed transformations
 - ⚠️ Items needing manual attention
 - 📖 Migration guidance and best practices
@@ -80,6 +71,7 @@ npx lwc-convert
 ```
 
 You'll be guided through:
+
 1. **Select conversion type** (Aura or Visualforce)
 2. **Choose component** from auto-discovered list or enter path
 3. **Configure options** (scaffolding/full, output dir, open folder)
@@ -147,7 +139,18 @@ lwc-convert vf ./pages/ContactList.page --controller ./classes/ContactListContro
 lwc-convert aura MyComponent --dry-run --verbose
 ```
 
+**Assess Conversion Complexity:**
+
+```bash
+# Grade a single component
+lwc-convert grade AccountCard --type aura
+
+# Scan entire project and export report
+lwc-convert grade --type both --format json --output report.json
+```
+
 > **💡 Smart Path Resolution:** The CLI automatically searches common Salesforce project locations:
+>
 > - `force-app/main/default/aura/`, `src/aura/`, `aura/`
 > - `force-app/main/default/pages/`, `src/pages/`, `pages/`
 > - `force-app/main/default/classes/`, `src/classes/`, `classes/`
@@ -161,6 +164,7 @@ lwc-convert aura MyComponent --dry-run --verbose
 ```bash
 lwc-convert aura <name-or-path>   # Convert Aura component bundle
 lwc-convert vf <name-or-path>     # Convert Visualforce page
+lwc-convert grade [target]        # Assess conversion complexity
 ```
 
 ### Global Options
@@ -199,6 +203,21 @@ lwc-convert vf <page-path> [options]
 | `--dry-run` | Preview without writing files | `false` |
 | `--verbose` | Show detailed logs | `false` |
 
+### Grade Command Options
+
+```bash
+lwc-convert grade [target] [options]
+```
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-t, --type <type>` | Component type (`aura`, `vf`, `both`) | `both` |
+| `-o, --output <file>` | Output file for report | — |
+| `--format <format>` | Output format (`json`, `console`, `md`) | `console` |
+| `--detailed` | Show detailed breakdown | `false` |
+| `--sort-by <field>` | Sort by `score`, `complexity`, or `name` | `score` |
+| `--filter <filter>` | Filter results (e.g., `grade:D,F`) | — |
+
 ---
 
 ## 🔄 Output Modes
@@ -595,17 +614,20 @@ npm test -- --coverage                # Generate coverage report
 ## ⚠️ Limitations
 
 ### General
+
 - **Single component only** — No batch processing by design
 - **Static analysis** — Cannot detect runtime behavior
 - **Manual testing required** — Generated code should be tested
 
 ### Aura-Specific
+
 - Complex/nested expressions may need manual adjustment
 - `$A.createComponent` patterns require manual migration
 - Application events need manual pub/sub or LMS setup
 - Custom renderers need manual conversion
 
 ### Visualforce-Specific
+
 - `apex:actionRegion` needs architectural redesign
 - Page includes need component composition
 - `renderAs="pdf"` has no LWC equivalent
@@ -689,7 +711,11 @@ Contributions are welcome! Here's how to help:
 - Follow existing code style
 - Add tests for new features
 - Update documentation for new mappings
-- Keep commits focused and atomic
+- Use [Conventional Commits](https://www.conventionalcommits.org/) format:
+  - `feat: add new feature` (triggers minor release)
+  - `fix: resolve bug` (triggers patch release)
+  - `docs: update README` (no release)
+  - `feat!: breaking change` (triggers major release)
 
 ---
 

package/dist/cli/commands/grade.d.ts

@@ -0,0 +1,2 @@
+export declare function grade(target: string | undefined, options: any): Promise<void>;
+//# sourceMappingURL=grade.d.ts.map

package/dist/cli/commands/grade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/grade.ts"],"names":[],"mappings":"AAOA,wBAAsB,KAAK,CACvB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,GAAG,GACb,OAAO,CAAC,IAAI,CAAC,CAuGf"}

package/dist/cli/commands/grade.js

@@ -0,0 +1,211 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.grade = grade;
+const fs = __importStar(require("fs-extra"));
+const logger_1 = require("../../utils/logger");
+const grader_1 = require("../../grading/grader");
+const path_resolver_1 = require("../../utils/path-resolver");
+async function grade(target, options) {
+    const grader = new grader_1.Grader();
+    // Determine scope and target
+    let scope = 'project';
+    let targetPath = target;
+    if (target) {
+        if (await fs.pathExists(target)) {
+            const stat = await fs.stat(target);
+            if (stat.isDirectory()) {
+                // Check if it's a component bundle or just a folder
+                const files = await fs.readdir(target);
+                if (files.some(f => f.endsWith('.cmp'))) {
+                    scope = 'component';
+                }
+                else {
+                    scope = 'folder';
+                }
+            }
+            else {
+                scope = 'file';
+            }
+        }
+        else {
+            // Try to resolve as component name
+            if (options.type === 'aura') {
+                const resolved = await (0, path_resolver_1.resolveAuraPath)(target);
+                if (resolved.found) {
+                    targetPath = resolved.path;
+                    scope = 'component';
+                }
+            }
+            else if (options.type === 'vf') {
+                const resolved = await (0, path_resolver_1.resolveVfPath)(target);
+                if (resolved.found) {
+                    targetPath = resolved.path;
+                    scope = 'file'; // VF pages are single files
+                }
+            }
+        }
+    }
+    const gradingOptions = {
+        type: options.type || 'both',
+        scope,
+        targetPath,
+        detailLevel: options.detailed ? 'detailed' : 'summary',
+        sortBy: options.sortBy,
+        filter: options.filter,
+        exportFormats: options.format ? [options.format] : ['console'],
+        exportDir: options.output,
+        dryRun: options.dryRun
+    };
+    logger_1.logger.banner();
+    logger_1.logger.header('Conversion Complexity Grading');
+    logger_1.logger.info(`Type: ${gradingOptions.type}`);
+    logger_1.logger.info(`Scope: ${gradingOptions.scope}`);
+    if (targetPath)
+        logger_1.logger.info(`Target: ${targetPath}`);
+    logger_1.logger.divider();
+    try {
+        logger_1.logger.info('Grading components...');
+        const results = await grader.grade(gradingOptions);
+        if (results.length === 0) {
+            logger_1.logger.warn('No components found to grade.');
+            return;
+        }
+        // Sort results
+        if (options.sortBy) {
+            sortResults(results, options.sortBy);
+        }
+        else {
+            // Default sort by score ascending (hardest first? or easiest? Plan says score-high default in TUI)
+            // Let's sort by score ascending (lowest score/hardest first) to highlight issues?
+            // Or descending (best first)?
+            // Plan says "Sort by score (highest first)" in TUI example.
+            results.sort((a, b) => b.overallScore - a.overallScore);
+        }
+        // Filter results
+        const filteredResults = filterResults(results, options.filter);
+        // Generate summary
+        const summary = grader.generateSummary(filteredResults);
+        // Output results
+        if (options.format === 'json') {
+            const output = { summary, components: filteredResults };
+            if (options.output) {
+                await fs.writeJson(options.output, output, { spaces: 2 });
+                logger_1.logger.success(`Results written to ${options.output}`);
+            }
+            else {
+                console.log(JSON.stringify(output, null, 2));
+            }
+        }
+        else {
+            // Console output
+            printConsoleReport(filteredResults, summary, options.detailed);
+        }
+    }
+    catch (error) {
+        logger_1.logger.error(`Grading failed: ${error.message}`);
+        if (options.verbose)
+            console.error(error);
+        process.exit(1);
+    }
+}
+function sortResults(results, sortBy) {
+    switch (sortBy) {
+        case 'score':
+            results.sort((a, b) => b.overallScore - a.overallScore);
+            break;
+        case 'complexity':
+            // Map complexity to number
+            const complexityMap = {
+                'Simple': 1, 'Easy': 2, 'Moderate': 3, 'Complex': 4, 'Very Complex': 5
+            };
+            results.sort((a, b) => complexityMap[a.complexity] - complexityMap[b.complexity]);
+            break;
+        case 'name':
+            results.sort((a, b) => a.componentName.localeCompare(b.componentName));
+            break;
+    }
+}
+function filterResults(results, filter) {
+    if (!filter)
+        return results;
+    // Simple filter implementation: "grade:D,F" or "score:<60"
+    if (filter.startsWith('grade:')) {
+        const grades = filter.substring(6).split(',');
+        return results.filter(r => grades.includes(r.letterGrade));
+    }
+    if (filter.startsWith('score:')) {
+        const condition = filter.substring(6);
+        if (condition.startsWith('<')) {
+            const val = parseInt(condition.substring(1));
+            return results.filter(r => r.overallScore < val);
+        }
+        if (condition.startsWith('>')) {
+            const val = parseInt(condition.substring(1));
+            return results.filter(r => r.overallScore > val);
+        }
+    }
+    return results;
+}
+function printConsoleReport(results, summary, detailed) {
+    // Summary Table
+    console.log('Component'.padEnd(30) + 'Type'.padEnd(10) + 'Score'.padEnd(10) + 'Grade'.padEnd(10) + 'Complexity');
+    console.log('-'.repeat(80));
+    results.forEach(r => {
+        console.log(r.componentName.padEnd(30) +
+            r.componentType.padEnd(10) +
+            r.overallScore.toString().padEnd(10) +
+            r.letterGrade.padEnd(10) +
+            r.complexity);
+    });
+    logger_1.logger.blank();
+    logger_1.logger.summaryBox('Grading Summary', [
+        { label: 'Total Components', value: summary.totalComponents.toString(), type: 'info' },
+        { label: 'Average Score', value: `${summary.averageScore} (${summary.averageGrade})`, type: 'info' },
+        { label: 'Manual Effort', value: `${summary.totalEffort.manualHours.estimate} hours`, type: 'warn' }
+    ]);
+    if (detailed) {
+        logger_1.logger.divider();
+        logger_1.logger.subheader('Detailed Breakdown');
+        results.forEach(r => {
+            logger_1.logger.info(`${r.componentName} (${r.letterGrade})`);
+            r.complexityFactors.forEach(f => {
+                console.log(`  - [${f.category}] ${f.factor}`);
+            });
+            logger_1.logger.blank();
+        });
+    }
+}
+//# sourceMappingURL=grade.js.map

package/dist/cli/commands/grade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade.js","sourceRoot":"","sources":["../../../src/cli/commands/grade.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,sBA0GC;AAhHD,6CAA+B;AAC/B,+CAA4C;AAC5C,iDAA8C;AAE9C,6DAA2E;AAEpE,KAAK,UAAU,KAAK,CACvB,MAA0B,EAC1B,OAAY;IAEZ,MAAM,MAAM,GAAG,IAAI,eAAM,EAAE,CAAC;IAE5B,6BAA6B;IAC7B,IAAI,KAAK,GAA4B,SAAS,CAAC;IAC/C,IAAI,UAAU,GAAG,MAAM,CAAC;IAExB,IAAI,MAAM,EAAE,CAAC;QACT,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrB,oDAAoD;gBACpD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACvC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;oBACtC,KAAK,GAAG,WAAW,CAAC;gBACxB,CAAC;qBAAM,CAAC;oBACJ,KAAK,GAAG,QAAQ,CAAC;gBACrB,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,KAAK,GAAG,MAAM,CAAC;YACnB,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,mCAAmC;YACnC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,MAAM,IAAA,+BAAe,EAAC,MAAM,CAAC,CAAC;gBAC/C,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;oBACjB,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC;oBAC3B,KAAK,GAAG,WAAW,CAAC;gBACxB,CAAC;YACL,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,MAAM,IAAA,6BAAa,EAAC,MAAM,CAAC,CAAC;gBAC7C,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;oBACjB,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC;oBAC3B,KAAK,GAAG,MAAM,CAAC,CAAC,4BAA4B;gBAChD,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED,MAAM,cAAc,GAAmB;QACnC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;QAC5B,KAAK;QACL,UAAU;QACV,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QACtD,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,SAAS,EAAE,OAAO,CAAC,MAAM;QACzB,MAAM,EAAE,OAAO,CAAC,MAAM;KACzB,CAAC;IAEF,eAAM,CAAC,MAAM,EAAE,CAAC;IAChB,eAAM,CAAC,MAAM,CAAC,+BAA+B,CAAC,CAAC;IAC/C,eAAM,CAAC,IAAI,CAAC,SAAS,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,eAAM,CAAC,IAAI,CAAC,UAAU,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9C,IAAI,UAAU;QAAE,eAAM,CAAC,IAAI,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;IACrD,eAAM,CAAC,OAAO,EAAE,CAAC;IAEjB,IAAI,CAAC;QACD,eAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAEnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,eAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC7C,OAAO;QACX,CAAC;QAED,eAAe;QACf,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACjB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACJ,mGAAmG;YACnG,kFAAkF;YAClF,8BAA8B;YAC9B,4DAA4D;YAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;QAC5D,CAAC;QAED,iBAAiB;QACjB,MAAM,eAAe,GAAG,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAE/D,mBAAmB;QACnB,MAAM,OAAO,GAAG,MAAM,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;QAExD,iBAAiB;QACjB,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;YACxD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC1D,eAAM,CAAC,OAAO,CAAC,sBAAsB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACjD,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,iBAAiB;YACjB,kBAAkB,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnE,CAAC;IAEL,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,eAAM,CAAC,KAAK,CAAC,mBAAmB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,IAAI,OAAO,CAAC,OAAO;YAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,OAAyB,EAAE,MAAc;IAC1D,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,OAAO;YACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;YACxD,MAAM;QACV,KAAK,YAAY;YACb,2BAA2B;YAC3B,MAAM,aAAa,GAA2B;gBAC1C,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC;aACzE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;YAClF,MAAM;QACV,KAAK,MAAM;YACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;YACvE,MAAM;IACd,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,OAAyB,EAAE,MAAe;IAC7D,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAE5B,2DAA2D;IAC3D,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC;QACrD,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAyB,EAAE,OAAuB,EAAE,QAAiB;IAC7F,gBAAgB;IAChB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC;IACjH,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QAChB,OAAO,CAAC,GAAG,CACP,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,CAAC,CAAC,UAAU,CACf,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,eAAM,CAAC,KAAK,EAAE,CAAC;IACf,eAAM,CAAC,UAAU,CAAC,iBAAiB,EAAE;QACjC,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACtF,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,YAAY,KAAK,OAAO,CAAC,YAAY,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE;QACpG,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,QAAQ,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE;KACvG,CAAC,CAAC;IAEH,IAAI,QAAQ,EAAE,CAAC;QACX,eAAM,CAAC,OAAO,EAAE,CAAC;QACjB,eAAM,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACvC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YAChB,eAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;YACrD,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;gBAC5B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;YACH,eAAM,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC,CAAC,CAAC;IACP,CAAC;AACL,CAAC"}

package/dist/cli/interactive.d.ts

@@ -3,16 +3,19 @@
  * Redesigned with @clack/prompts for a modern, polished experience
  */
 import { VfControllerReference } from '../utils/vf-controller-resolver';
+import { GradingOptions } from '../grading/types';
 export interface TuiAnswers {
-    conversionType: 'aura' | 'vf';
-    componentPath: string;
+    action: 'convert' | 'grade';
+    conversionType?: 'aura' | 'vf';
+    componentPath?: string;
     controllerPath?: string;
     controllerPaths?: string[];
     detectedControllers?: VfControllerReference[];
-    outputDir: string;
-    conversionMode: 'scaffolding' | 'full';
-    openFolder: boolean;
-    preview: boolean;
+    outputDir?: string;
+    conversionMode?: 'scaffolding' | 'full';
+    openFolder?: boolean;
+    preview?: boolean;
+    gradingOptions?: GradingOptions;
 }
 /**
  * Run the interactive TUI

package/dist/cli/interactive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/cli/interactive.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAEL,qBAAqB,EAEtB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,aAAa,GAAG,MAAM,CAAC;IACvC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAoLD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAgapE"}
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/cli/interactive.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAEL,qBAAqB,EAEtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAoLD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAugBpE"}

package/dist/cli/interactive.js

@@ -215,6 +215,7 @@ async function runInteractiveTui() {
     showHeader();
     // State management
     let currentStep = 0;
+    let action = 'convert';
     let conversionType;
     let componentPath;
     let controllerPath;
@@ -224,22 +225,57 @@ async function runInteractiveTui() {
     let conversionMode = 'scaffolding';
     let openFolder = true;
     let preview = false;
+    let gradingOptions;
     // Main wizard loop - allows navigation back to any step
     wizardLoop: while (currentStep < 4) {
-        // Step 1: Select conversion type
+        // Step 1: Select action and type
         while (currentStep === 0) {
             showBreadcrumbs(currentStep);
-            const typeResult = await p.select({
-                message: 'What would you like to convert?',
+            const actionResult = await p.select({
+                message: 'What would you like to do?',
                 options: [
-                    { value: 'aura', label: '⚡ Aura Component → LWC', hint: 'Convert Aura bundles' },
-                    { value: 'vf', label: '📄 Visualforce Page → LWC', hint: 'Convert VF pages' },
+                    { value: 'convert_aura', label: '⚡ Convert Aura Component', hint: 'Convert Aura bundles to LWC' },
+                    { value: 'convert_vf', label: '📄 Convert Visualforce Page', hint: 'Convert VF pages to LWC' },
+                    { value: 'grade', label: '📊 Grade Complexity', hint: 'Analyze components before conversion' },
                 ],
             });
-            if (isCancel(typeResult))
+            if (isCancel(actionResult))
                 return handleCancel();
-            conversionType = typeResult;
-            currentStep = 1;
+            const selected = actionResult;
+            if (selected === 'grade') {
+                action = 'grade';
+                // Grading flow
+                const gradeTypeResult = await p.select({
+                    message: 'What would you like to grade?',
+                    options: [
+                        { value: 'aura', label: '⚡ Aura Components' },
+                        { value: 'vf', label: '📄 Visualforce Pages' },
+                        { value: 'both', label: '🔄 Both (Project Scan)' },
+                    ]
+                });
+                if (isCancel(gradeTypeResult))
+                    return handleCancel();
+                // Setup default grading options
+                gradingOptions = {
+                    type: gradeTypeResult,
+                    scope: 'project', // Default
+                    detailLevel: 'summary',
+                    exportFormats: ['console']
+                };
+                // If both, we default to project scope and skip to options
+                if (gradeTypeResult === 'both') {
+                    currentStep = 3; // Jump to options
+                }
+                else {
+                    conversionType = gradeTypeResult;
+                    currentStep = 1; // Go to scope selection (reuse component selection logic)
+                }
+            }
+            else {
+                action = 'convert';
+                conversionType = selected === 'convert_aura' ? 'aura' : 'vf';
+                currentStep = 1;
+            }
         }
         // Step 2: Select source component/page
         while (currentStep === 1) {
@@ -386,9 +422,17 @@ async function runInteractiveTui() {
                 }
                 currentStep = 2;
             }
+            // If grading, update target path and skip controller selection
+            if (action === 'grade' && componentPath) {
+                if (gradingOptions) {
+                    gradingOptions.targetPath = componentPath;
+                    gradingOptions.scope = conversionType === 'aura' ? 'component' : 'file';
+                }
+                currentStep = 3; // Skip to options
+            }
         }
-        // Step 3: Controllers (VF only)
-        while (currentStep === 2 && conversionType === 'vf' && componentPath) {
+        // Step 3: Controllers (VF only, skip for grading)
+        while (currentStep === 2 && conversionType === 'vf' && componentPath && action !== 'grade') {
             showBreadcrumbs(currentStep, conversionType);
             const resolvedPagePath = path.resolve(componentPath);
             if (await fs.pathExists(resolvedPagePath)) {
@@ -494,6 +538,44 @@ async function runInteractiveTui() {
         // Step 4: Options
         while (currentStep === 3) {
             showBreadcrumbs(currentStep, conversionType);
+            if (action === 'grade' && gradingOptions) {
+                // Grading Options
+                const detailResult = await p.select({
+                    message: 'Detail level:',
+                    options: [
+                        { value: 'summary', label: '📊 Summary', hint: 'Overview with scores' },
+                        { value: 'standard', label: '📋 Standard', hint: 'Category breakdowns' },
+                        { value: 'detailed', label: '🔍 Detailed', hint: 'Full analysis with factors' },
+                    ]
+                });
+                if (isCancel(detailResult))
+                    return handleCancel();
+                gradingOptions.detailLevel = detailResult;
+                const exportResult = await p.multiselect({
+                    message: 'Export options:',
+                    options: [
+                        { value: 'console', label: '🖥️ Console display', hint: 'Show in terminal' },
+                        { value: 'json', label: '💾 JSON export', hint: 'Save to file' },
+                    ],
+                    initialValues: ['console'],
+                    required: true
+                });
+                if (isCancel(exportResult))
+                    return handleCancel();
+                gradingOptions.exportFormats = exportResult;
+                if (exportResult.includes('json')) {
+                    const outputResult = await p.text({
+                        message: 'Export file path:',
+                        initialValue: './grading-report.json',
+                    });
+                    if (isCancel(outputResult))
+                        return handleCancel();
+                    gradingOptions.exportDir = outputResult;
+                }
+                currentStep = 4;
+                continue wizardLoop;
+            }
+            // Conversion Options
             const modeResult = await p.select({
                 message: 'Conversion mode:',
                 options: [
@@ -548,31 +630,45 @@ async function runInteractiveTui() {
     } // end wizardLoop
     // Step 5: Confirmation
     showBreadcrumbs(currentStep, conversionType);
-    const summaryLines = [
-        `${picocolors_1.default.dim('Type:')}         ${conversionType === 'aura' ? '⚡ Aura → LWC' : '📄 VF → LWC'}`,
-        `${picocolors_1.default.dim('Source:')}       ${componentPath}`,
-    ];
-    if (controllerPaths.length > 0) {
-        summaryLines.push(`${picocolors_1.default.dim('Controllers:')}  ${controllerPaths.length} selected`);
-        controllerPaths.forEach(cp => {
-            summaryLines.push(`               ${picocolors_1.default.dim('•')} ${path.basename(cp)}`);
-        });
+    const summaryLines = [];
+    if (action === 'grade') {
+        summaryLines.push(`${picocolors_1.default.dim('Action:')}       📊 Grade Complexity`);
+        summaryLines.push(`${picocolors_1.default.dim('Type:')}         ${gradingOptions?.type === 'both' ? 'Project Scan' : (gradingOptions?.type === 'aura' ? '⚡ Aura' : '📄 VF')}`);
+        if (gradingOptions?.targetPath) {
+            summaryLines.push(`${picocolors_1.default.dim('Target:')}       ${gradingOptions.targetPath}`);
+        }
+        else {
+            summaryLines.push(`${picocolors_1.default.dim('Scope:')}        Entire Project`);
+        }
+        summaryLines.push(`${picocolors_1.default.dim('Detail:')}       ${gradingOptions?.detailLevel}`);
+        summaryLines.push(`${picocolors_1.default.dim('Export:')}       ${gradingOptions?.exportFormats?.join(', ')}`);
+    }
+    else {
+        summaryLines.push(`${picocolors_1.default.dim('Type:')}         ${conversionType === 'aura' ? '⚡ Aura → LWC' : '📄 VF → LWC'}`);
+        summaryLines.push(`${picocolors_1.default.dim('Source:')}       ${componentPath}`);
+        if (controllerPaths.length > 0) {
+            summaryLines.push(`${picocolors_1.default.dim('Controllers:')}  ${controllerPaths.length} selected`);
+            controllerPaths.forEach(cp => {
+                summaryLines.push(`               ${picocolors_1.default.dim('•')} ${path.basename(cp)}`);
+            });
+        }
+        summaryLines.push(`${picocolors_1.default.dim('Mode:')}         ${conversionMode === 'full' ? '⚡ Full' : '📝 Scaffolding'}`);
+        summaryLines.push(`${picocolors_1.default.dim('Output:')}       ${outputDir}`);
+        summaryLines.push(`${picocolors_1.default.dim('Open folder:')} ${openFolder ? '✓ Yes' : '✗ No'}`);
+        summaryLines.push(`${picocolors_1.default.dim('UI Preview:')}   ${preview ? '✓ Yes' : '✗ No'}`);
     }
-    summaryLines.push(`${picocolors_1.default.dim('Mode:')}         ${conversionMode === 'full' ? '⚡ Full' : '📝 Scaffolding'}`);
-    summaryLines.push(`${picocolors_1.default.dim('Output:')}       ${outputDir}`);
-    summaryLines.push(`${picocolors_1.default.dim('Open folder:')} ${openFolder ? '✓ Yes' : '✗ No'}`);
-    summaryLines.push(`${picocolors_1.default.dim('UI Preview:')}   ${preview ? '✓ Yes' : '✗ No'}`);
-    p.note(summaryLines.join('\n'), '📋 Conversion Summary');
+    p.note(summaryLines.join('\n'), action === 'grade' ? '📋 Grading Configuration' : '📋 Conversion Summary');
     const confirm = await p.confirm({
-        message: 'Proceed with conversion?',
+        message: action === 'grade' ? 'Proceed with grading?' : 'Proceed with conversion?',
         initialValue: true,
     });
     if (isCancel(confirm) || !confirm) {
-        p.cancel('Conversion cancelled.');
+        p.cancel('Operation cancelled.');
         return null;
     }
-    p.outro(picocolors_1.default.green('Starting conversion...'));
+    p.outro(picocolors_1.default.green(action === 'grade' ? 'Starting grading...' : 'Starting conversion...'));
     return {
+        action,
         conversionType: conversionType,
         componentPath: componentPath,
         controllerPath,
@@ -582,6 +678,7 @@ async function runInteractiveTui() {
         conversionMode,
         openFolder,
         preview,
+        gradingOptions
     };
 }
 //# sourceMappingURL=interactive.js.map