lwc-convert 1.0.0

package/dist/index.js

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * lwc-convert - CLI tool to convert Aura and Visualforce components to LWC
+ */
+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 });
+const commander_1 = require("commander");
+const options_1 = require("./cli/options");
+const aura_1 = require("./cli/commands/aura");
+const vf_1 = require("./cli/commands/vf");
+const logger_1 = require("./utils/logger");
+const session_store_1 = require("./utils/session-store");
+const program = new commander_1.Command();
+program
+    .name(options_1.CLI_NAME)
+    .description(options_1.CLI_DESCRIPTION)
+    .version(options_1.CLI_VERSION);
+// Aura conversion command
+program
+    .command('aura <path>')
+    .description('Convert an Aura component bundle to LWC')
+    .option('--full', 'Run full automated conversion (default: scaffolding only)', false)
+    .option('-o, --output <dir>', 'Output directory', options_1.DEFAULT_OUTPUT_DIR)
+    .option('--open', 'Open output folder in file explorer after conversion', false)
+    .option('--dry-run', 'Preview conversion without writing files', false)
+    .option('--verbose', 'Show detailed conversion logs', false)
+    .action(async (bundlePath, options) => {
+    logger_1.logger.setVerbose(options.verbose);
+    await (0, aura_1.convertAura)(bundlePath, {
+        output: options.output,
+        full: options.full,
+        dryRun: options.dryRun,
+        verbose: options.verbose,
+        open: options.open,
+    });
+});
+// Visualforce conversion command
+program
+    .command('vf <path>')
+    .description('Convert a Visualforce page to LWC')
+    .option('--full', 'Run full automated conversion (default: scaffolding only)', false)
+    .option('-o, --output <dir>', 'Output directory', options_1.DEFAULT_OUTPUT_DIR)
+    .option('--controller <path>', 'Include Apex controller file for analysis')
+    .option('--open', 'Open output folder in file explorer after conversion', false)
+    .option('--dry-run', 'Preview conversion without writing files', false)
+    .option('--verbose', 'Show detailed conversion logs', false)
+    .action(async (pagePath, options) => {
+    logger_1.logger.setVerbose(options.verbose);
+    await (0, vf_1.convertVf)(pagePath, {
+        output: options.output,
+        full: options.full,
+        dryRun: options.dryRun,
+        verbose: options.verbose,
+        controller: options.controller,
+        open: options.open,
+    });
+});
+// Session management command
+program
+    .command('session')
+    .description('View session information and conversion history')
+    .option('--report', 'Generate full session report', false)
+    .option('--patterns', 'Show learned patterns from session', false)
+    .option('--cleanup', 'Clean up session data', false)
+    .action(async (options) => {
+    await session_store_1.sessionStore.init();
+    const summary = session_store_1.sessionStore.getSessionSummary();
+    if (options.cleanup) {
+        await session_store_1.sessionStore.cleanup();
+        logger_1.logger.success('Session data cleaned up');
+        return;
+    }
+    if (options.report) {
+        const report = session_store_1.sessionStore.generateSessionReport();
+        console.log(report);
+        return;
+    }
+    if (options.patterns) {
+        logger_1.logger.header('Session Pattern Library');
+        const patterns = summary.patternLibrary;
+        if (patterns.length === 0) {
+            logger_1.logger.info('No patterns learned yet. Run some conversions first!');
+        }
+        else {
+            logger_1.logger.info(`${patterns.length} patterns learned:`);
+            logger_1.logger.blank();
+            for (const pattern of patterns.slice(0, 20)) {
+                console.log(`  [${pattern.type}] ${pattern.auraPattern} → ${pattern.lwcPattern}`);
+                console.log(`         Used: ${pattern.frequency}x, Success: ${(pattern.successRate * 100).toFixed(0)}%`);
+            }
+        }
+        return;
+    }
+    // Default: show session summary
+    logger_1.logger.banner();
+    logger_1.logger.header('Current Session');
+    logger_1.logger.info(`Session ID: ${summary.sessionId}`);
+    logger_1.logger.info(`Started: ${summary.startedAt.toISOString()}`);
+    logger_1.logger.info(`Conversions: ${summary.conversions}`);
+    logger_1.logger.info(`Behaviors mapped: ${summary.totalBehaviors}`);
+    logger_1.logger.info(`Patterns learned: ${summary.patternLibrary.length}`);
+    logger_1.logger.info(`Session directory: ${session_store_1.sessionStore.getSessionDir()}`);
+    if (summary.conversions > 0) {
+        logger_1.logger.blank();
+        logger_1.logger.subheader('Recent Conversions:');
+        const conversions = session_store_1.sessionStore.getConversions().slice(-5);
+        for (const conv of conversions) {
+            console.log(`  • ${conv.sourceName} → ${conv.targetName} (${conv.behaviorCount} behaviors)`);
+        }
+    }
+    if (summary.commonWarnings.length > 0) {
+        logger_1.logger.blank();
+        logger_1.logger.subheader('Common Warnings:');
+        for (const { warning, count } of summary.commonWarnings.slice(0, 5)) {
+            console.log(`  [${count}x] ${warning.substring(0, 70)}...`);
+        }
+    }
+});
+// Examples in help
+program.addHelpText('after', `
+Examples:
+  # Convert Aura component (just use the name!)
+  $ ${options_1.CLI_NAME} aura AccountCard
+  $ ${options_1.CLI_NAME} aura AccountCard --full
+
+  # Convert Visualforce page (just use the name!)
+  $ ${options_1.CLI_NAME} vf ContactList
+  $ ${options_1.CLI_NAME} vf ContactList --controller ContactListController
+
+  # Full paths also work
+  $ ${options_1.CLI_NAME} aura ./force-app/main/default/aura/MyComponent
+  $ ${options_1.CLI_NAME} vf ./pages/MyPage.page --controller ./classes/MyController.cls
+
+  # Preview without writing files
+  $ ${options_1.CLI_NAME} aura MyComponent --dry-run --verbose
+
+  # Specify output directory
+  $ ${options_1.CLI_NAME} vf ContactList -o ./src/lwc
+
+  # View session data and learned patterns
+  $ ${options_1.CLI_NAME} session
+  $ ${options_1.CLI_NAME} session --report
+  $ ${options_1.CLI_NAME} session --patterns
+
+Smart Path Resolution:
+  The CLI searches common Salesforce project locations automatically:
+  - Aura: force-app/main/default/aura/, src/aura/, aura/
+  - VF:   force-app/main/default/pages/, src/pages/, pages/
+  - Apex: force-app/main/default/classes/, src/classes/, classes/
+
+Session Management:
+  Conversion data is stored in a temp folder during your session.
+  This helps the tool learn from patterns and provide better suggestions.
+  Use 'session --report' to see full session statistics.
+`);
+// Parse and execute
+// If no arguments provided, launch interactive TUI
+if (process.argv.slice(2).length === 0) {
+    // Dynamic import to avoid loading TUI dependencies if not needed
+    Promise.resolve().then(() => __importStar(require('./cli/interactive'))).then(async ({ runInteractiveTui }) => {
+        const answers = await runInteractiveTui();
+        if (answers) {
+            // Execute the conversion based on user selections
+            logger_1.logger.setVerbose(false);
+            if (answers.conversionType === 'aura') {
+                await (0, aura_1.convertAura)(answers.componentPath, {
+                    output: answers.outputDir,
+                    full: answers.conversionMode === 'full',
+                    dryRun: false,
+                    verbose: false,
+                    open: answers.openFolder,
+                });
+            }
+            else {
+                await (0, vf_1.convertVf)(answers.componentPath, {
+                    output: answers.outputDir,
+                    full: answers.conversionMode === 'full',
+                    dryRun: false,
+                    verbose: false,
+                    controller: answers.controllerPath,
+                    open: answers.openFolder,
+                });
+            }
+        }
+    }).catch((err) => {
+        console.error('Failed to start interactive mode:', err.message);
+        program.outputHelp();
+    });
+}
+else {
+    program.parse(process.argv);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mappings/aura-to-lwc.json

@@ -0,0 +1,321 @@
+{
+    "components": {
+        "aura:component": {
+            "lwc": "template",
+            "notes": "Root element becomes <template>"
+        },
+        "aura:if": {
+            "lwc": "template",
+            "attributes": {
+                "isTrue": "if:true",
+                "isFalse": "if:false"
+            },
+            "notes": "Conditional rendering using template directives"
+        },
+        "aura:iteration": {
+            "lwc": "template",
+            "attributes": {
+                "items": "for:each",
+                "var": "for:item",
+                "indexVar": "for:index"
+            },
+            "requiresKey": true,
+            "notes": "Iteration requires key attribute on first child element"
+        },
+        "aura:set": {
+            "lwc": null,
+            "notes": "Attribute sets handled differently in LWC - set via JavaScript"
+        },
+        "aura:handler": {
+            "lwc": null,
+            "notes": "Event handlers defined as class methods and bound in template"
+        },
+        "aura:method": {
+            "lwc": "@api method",
+            "notes": "Public methods decorated with @api"
+        },
+        "aura:registerEvent": {
+            "lwc": "CustomEvent",
+            "notes": "Events dispatched using CustomEvent and dispatchEvent()"
+        },
+        "aura:attribute": {
+            "lwc": "property",
+            "notes": "Attributes become class properties, public ones use @api"
+        },
+        "lightning:button": {
+            "lwc": "lightning-button",
+            "attributes": {
+                "onclick": "onclick",
+                "label": "label",
+                "variant": "variant",
+                "disabled": "disabled",
+                "name": "name",
+                "title": "title",
+                "iconName": "icon-name",
+                "iconPosition": "icon-position"
+            }
+        },
+        "lightning:input": {
+            "lwc": "lightning-input",
+            "attributes": {
+                "type": "type",
+                "label": "label",
+                "value": "value",
+                "placeholder": "placeholder",
+                "required": "required",
+                "disabled": "disabled",
+                "name": "name",
+                "onchange": "onchange"
+            }
+        },
+        "lightning:card": {
+            "lwc": "lightning-card",
+            "attributes": {
+                "title": "title",
+                "iconName": "icon-name",
+                "variant": "variant"
+            }
+        },
+        "lightning:icon": {
+            "lwc": "lightning-icon",
+            "attributes": {
+                "iconName": "icon-name",
+                "size": "size",
+                "variant": "variant",
+                "alternativeText": "alternative-text"
+            }
+        },
+        "lightning:spinner": {
+            "lwc": "lightning-spinner",
+            "attributes": {
+                "alternativeText": "alternative-text",
+                "size": "size",
+                "variant": "variant"
+            }
+        },
+        "lightning:datatable": {
+            "lwc": "lightning-datatable",
+            "attributes": {
+                "data": "data",
+                "columns": "columns",
+                "keyField": "key-field",
+                "hideCheckboxColumn": "hide-checkbox-column",
+                "onrowselection": "onrowselection",
+                "onrowaction": "onrowaction"
+            }
+        },
+        "lightning:recordEditForm": {
+            "lwc": "lightning-record-edit-form",
+            "attributes": {
+                "recordId": "record-id",
+                "objectApiName": "object-api-name",
+                "onsubmit": "onsubmit",
+                "onsuccess": "onsuccess",
+                "onerror": "onerror"
+            }
+        },
+        "lightning:recordViewForm": {
+            "lwc": "lightning-record-view-form",
+            "attributes": {
+                "recordId": "record-id",
+                "objectApiName": "object-api-name"
+            }
+        },
+        "lightning:inputField": {
+            "lwc": "lightning-input-field",
+            "attributes": {
+                "fieldName": "field-name",
+                "value": "value",
+                "variant": "variant"
+            }
+        },
+        "lightning:outputField": {
+            "lwc": "lightning-output-field",
+            "attributes": {
+                "fieldName": "field-name",
+                "variant": "variant"
+            }
+        },
+        "lightning:combobox": {
+            "lwc": "lightning-combobox",
+            "attributes": {
+                "label": "label",
+                "value": "value",
+                "options": "options",
+                "placeholder": "placeholder",
+                "onchange": "onchange"
+            }
+        },
+        "lightning:select": {
+            "lwc": "lightning-combobox",
+            "notes": "lightning:select maps to lightning-combobox in LWC"
+        },
+        "lightning:textarea": {
+            "lwc": "lightning-textarea",
+            "attributes": {
+                "label": "label",
+                "value": "value",
+                "placeholder": "placeholder",
+                "maxlength": "max-length",
+                "onchange": "onchange"
+            }
+        },
+        "lightning:checkboxGroup": {
+            "lwc": "lightning-checkbox-group",
+            "attributes": {
+                "label": "label",
+                "options": "options",
+                "value": "value",
+                "onchange": "onchange"
+            }
+        },
+        "lightning:radioGroup": {
+            "lwc": "lightning-radio-group",
+            "attributes": {
+                "label": "label",
+                "options": "options",
+                "value": "value",
+                "onchange": "onchange",
+                "type": "type"
+            }
+        },
+        "lightning:modal": {
+            "lwc": "lightning-modal",
+            "notes": "Modals in LWC extend LightningModal base class"
+        },
+        "lightning:tabset": {
+            "lwc": "lightning-tabset",
+            "attributes": {
+                "variant": "variant",
+                "activeTabValue": "active-tab-value"
+            }
+        },
+        "lightning:tab": {
+            "lwc": "lightning-tab",
+            "attributes": {
+                "label": "label",
+                "value": "value",
+                "iconName": "icon-name"
+            }
+        },
+        "lightning:accordion": {
+            "lwc": "lightning-accordion",
+            "attributes": {
+                "allowMultipleSectionsOpen": "allow-multiple-sections-open",
+                "activeSectionName": "active-section-name"
+            }
+        },
+        "lightning:accordionSection": {
+            "lwc": "lightning-accordion-section",
+            "attributes": {
+                "name": "name",
+                "label": "label"
+            }
+        },
+        "lightning:tile": {
+            "lwc": "lightning-tile",
+            "attributes": {
+                "label": "label",
+                "href": "href"
+            }
+        },
+        "lightning:badge": {
+            "lwc": "lightning-badge",
+            "attributes": {
+                "label": "label"
+            }
+        },
+        "lightning:progressBar": {
+            "lwc": "lightning-progress-bar",
+            "attributes": {
+                "value": "value",
+                "size": "size",
+                "variant": "variant"
+            }
+        },
+        "lightning:helptext": {
+            "lwc": "lightning-helptext",
+            "attributes": {
+                "content": "content",
+                "iconName": "icon-name"
+            }
+        },
+        "lightning:formattedText": {
+            "lwc": "lightning-formatted-text",
+            "attributes": {
+                "value": "value",
+                "linkify": "linkify"
+            }
+        },
+        "lightning:formattedNumber": {
+            "lwc": "lightning-formatted-number",
+            "attributes": {
+                "value": "value",
+                "formatStyle": "format-style",
+                "currencyCode": "currency-code"
+            }
+        },
+        "lightning:formattedDateTime": {
+            "lwc": "lightning-formatted-date-time",
+            "attributes": {
+                "value": "value",
+                "year": "year",
+                "month": "month",
+                "day": "day"
+            }
+        },
+        "force:recordData": {
+            "lwc": "@wire(getRecord)",
+            "notes": "Use getRecord wire adapter from lightning/uiRecordApi"
+        },
+        "force:navigateToSObject": {
+            "lwc": "NavigationMixin",
+            "notes": "Use NavigationMixin from lightning/navigation"
+        },
+        "ui:inputText": {
+            "lwc": "lightning-input",
+            "notes": "Legacy ui: namespace components should use lightning-input"
+        },
+        "ui:outputText": {
+            "lwc": "lightning-formatted-text",
+            "notes": "Legacy ui: namespace components should use lightning-formatted-*"
+        },
+        "ui:button": {
+            "lwc": "lightning-button",
+            "notes": "Legacy ui:button maps to lightning-button"
+        }
+    },
+    "expressions": {
+        "v.": {
+            "pattern": "\\{!v\\.(\\w+)\\}",
+            "replacement": "{$1}",
+            "notes": "View attribute reference becomes simple property reference"
+        },
+        "c.": {
+            "pattern": "\\{!c\\.(\\w+)\\}",
+            "replacement": "{$1}",
+            "notes": "Controller function reference becomes method reference"
+        },
+        "globalId": {
+            "pattern": "\\{!globalId\\}",
+            "replacement": "data-id",
+            "notes": "globalId should use data attributes or this.template.querySelector"
+        }
+    },
+    "attributes": {
+        "aura:id": {
+            "lwc": "data-id",
+            "alternativeApproach": "class or unique data attribute",
+            "notes": "Use this.template.querySelector('[data-id=\"name\"]') or refs"
+        },
+        "class": {
+            "lwc": "class",
+            "notes": "Class attribute works the same, but use computed getters for dynamic classes"
+        }
+    },
+    "serverActions": {
+        "pattern": "$A.enqueueAction",
+        "lwc": "@wire or imperative Apex",
+        "notes": "Server actions become wire adapters or imperative Apex calls"
+    }
+}