lwc-convert 1.0.0

package/dist/utils/file-io.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * File I/O utilities for reading and writing component files
+ */
+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.readAuraBundle = readAuraBundle;
+exports.readVfPage = readVfPage;
+exports.writeLwcBundle = writeLwcBundle;
+exports.writeConversionNotes = writeConversionNotes;
+exports.writeFile = writeFile;
+exports.toLwcName = toLwcName;
+exports.toPascalCase = toPascalCase;
+exports.toCamelCase = toCamelCase;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const logger_1 = require("./logger");
+/**
+ * Read an Aura component bundle from a directory
+ */
+async function readAuraBundle(bundlePath) {
+    const resolvedPath = path.resolve(bundlePath);
+    if (!await fs.pathExists(resolvedPath)) {
+        throw new Error(`Aura bundle not found at: ${resolvedPath}`);
+    }
+    const stat = await fs.stat(resolvedPath);
+    if (!stat.isDirectory()) {
+        throw new Error(`Expected a directory for Aura bundle: ${resolvedPath}`);
+    }
+    const bundleName = path.basename(resolvedPath);
+    const files = await fs.readdir(resolvedPath);
+    const bundle = {
+        name: bundleName,
+        path: resolvedPath,
+    };
+    for (const file of files) {
+        const filePath = path.join(resolvedPath, file);
+        const content = await fs.readFile(filePath, 'utf-8');
+        if (file.endsWith('.cmp')) {
+            bundle.markup = content;
+            logger_1.logger.debug(`Read markup: ${file}`);
+        }
+        else if (file.endsWith('Controller.js')) {
+            bundle.controller = content;
+            logger_1.logger.debug(`Read controller: ${file}`);
+        }
+        else if (file.endsWith('Helper.js')) {
+            bundle.helper = content;
+            logger_1.logger.debug(`Read helper: ${file}`);
+        }
+        else if (file.endsWith('.css')) {
+            bundle.style = content;
+            logger_1.logger.debug(`Read style: ${file}`);
+        }
+        else if (file.endsWith('.design')) {
+            bundle.design = content;
+            logger_1.logger.debug(`Read design: ${file}`);
+        }
+        else if (file.endsWith('.auradoc')) {
+            bundle.documentation = content;
+            logger_1.logger.debug(`Read documentation: ${file}`);
+        }
+        else if (file.endsWith('.svg')) {
+            bundle.svg = content;
+            logger_1.logger.debug(`Read SVG: ${file}`);
+        }
+    }
+    if (!bundle.markup) {
+        throw new Error(`No .cmp file found in Aura bundle: ${resolvedPath}`);
+    }
+    return bundle;
+}
+/**
+ * Read a Visualforce page file
+ */
+async function readVfPage(pagePath, controllerPath) {
+    const resolvedPath = path.resolve(pagePath);
+    if (!await fs.pathExists(resolvedPath)) {
+        throw new Error(`Visualforce page not found at: ${resolvedPath}`);
+    }
+    if (!resolvedPath.endsWith('.page')) {
+        throw new Error(`Expected a .page file: ${resolvedPath}`);
+    }
+    const pageName = path.basename(resolvedPath, '.page');
+    const markup = await fs.readFile(resolvedPath, 'utf-8');
+    const vfPage = {
+        name: pageName,
+        path: resolvedPath,
+        markup,
+    };
+    // Read associated controller if provided
+    if (controllerPath) {
+        const resolvedControllerPath = path.resolve(controllerPath);
+        if (await fs.pathExists(resolvedControllerPath)) {
+            vfPage.controller = await fs.readFile(resolvedControllerPath, 'utf-8');
+            vfPage.controllerPath = resolvedControllerPath;
+            logger_1.logger.debug(`Read controller: ${controllerPath}`);
+        }
+        else {
+            logger_1.logger.warn(`Controller not found: ${resolvedControllerPath}`);
+        }
+    }
+    return vfPage;
+}
+/**
+ * Write an LWC bundle to the output directory
+ * Creates a subfolder with the component name containing all bundle files
+ */
+async function writeLwcBundle(outputDir, bundle, dryRun = false) {
+    // Component files go directly into outputDir/componentName/
+    const componentDir = path.join(outputDir, bundle.name);
+    const writtenFiles = [];
+    if (dryRun) {
+        logger_1.logger.info(`[DRY RUN] Would create directory: ${componentDir}`);
+        logger_1.logger.info(`[DRY RUN] Would write: ${bundle.name}.html`);
+        logger_1.logger.info(`[DRY RUN] Would write: ${bundle.name}.js`);
+        if (bundle.css) {
+            logger_1.logger.info(`[DRY RUN] Would write: ${bundle.name}.css`);
+        }
+        logger_1.logger.info(`[DRY RUN] Would write: ${bundle.name}.js-meta.xml`);
+        return writtenFiles;
+    }
+    await fs.ensureDir(componentDir);
+    // Write HTML template
+    const htmlPath = path.join(componentDir, `${bundle.name}.html`);
+    await fs.writeFile(htmlPath, bundle.html, 'utf-8');
+    writtenFiles.push(htmlPath);
+    logger_1.logger.file('CREATE', htmlPath);
+    // Write JavaScript
+    const jsPath = path.join(componentDir, `${bundle.name}.js`);
+    await fs.writeFile(jsPath, bundle.js, 'utf-8');
+    writtenFiles.push(jsPath);
+    logger_1.logger.file('CREATE', jsPath);
+    // Write CSS if present
+    if (bundle.css) {
+        const cssPath = path.join(componentDir, `${bundle.name}.css`);
+        await fs.writeFile(cssPath, bundle.css, 'utf-8');
+        writtenFiles.push(cssPath);
+        logger_1.logger.file('CREATE', cssPath);
+    }
+    // Write meta XML
+    const metaPath = path.join(componentDir, `${bundle.name}.js-meta.xml`);
+    await fs.writeFile(metaPath, bundle.meta, 'utf-8');
+    writtenFiles.push(metaPath);
+    logger_1.logger.file('CREATE', metaPath);
+    return writtenFiles;
+}
+/**
+ * Write a conversion notes file
+ */
+async function writeConversionNotes(outputDir, componentName, notes, dryRun = false) {
+    const notesPath = path.join(outputDir, componentName, `${componentName}-conversion-notes.md`);
+    const content = `# Conversion Notes for ${componentName}
+
+This file documents items that require manual attention after automated conversion.
+
+## Action Items
+
+${notes.map((note, i) => `${i + 1}. ${note}`).join('\n')}
+
+## Verification Checklist
+
+- [ ] Review all TODO comments in the generated code
+- [ ] Verify Apex method imports and wire adapters
+- [ ] Test event handling and data flow
+- [ ] Validate styling matches original component
+- [ ] Deploy to scratch org and test functionality
+`;
+    if (dryRun) {
+        logger_1.logger.info(`[DRY RUN] Would write conversion notes: ${notesPath}`);
+        return;
+    }
+    await fs.writeFile(notesPath, content, 'utf-8');
+    logger_1.logger.file('CREATE', notesPath);
+}
+/**
+ * Write a generic file with directory creation
+ */
+async function writeFile(filePath, content, dryRun = false) {
+    if (dryRun) {
+        logger_1.logger.info(`[DRY RUN] Would write: ${filePath}`);
+        return;
+    }
+    // Ensure directory exists
+    const dir = path.dirname(filePath);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(filePath, content, 'utf-8');
+    logger_1.logger.file('CREATE', filePath);
+}
+/**
+ * Convert a component name to LWC naming convention (camelCase to kebab-case)
+ */
+function toLwcName(name) {
+    // Convert PascalCase or camelCase to kebab-case
+    return name
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+        .toLowerCase();
+}
+/**
+ * Convert kebab-case to PascalCase for class names
+ */
+function toPascalCase(name) {
+    return name
+        .split('-')
+        .map(part => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+/**
+ * Convert to camelCase for property names
+ */
+function toCamelCase(name) {
+    const pascal = toPascalCase(name);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+//# sourceMappingURL=file-io.js.map

package/dist/utils/file-io.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Logger utility for colored console output with enhanced UX
+ */
+export interface LoggerOptions {
+    verbose: boolean;
+}
+declare class Logger {
+    private verbose;
+    setVerbose(verbose: boolean): void;
+    banner(): void;
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    step(stepNumber: number, message: string): void;
+    header(message: string): void;
+    subheader(message: string): void;
+    divider(): void;
+    file(action: string, filePath: string): void;
+    conversion(from: string, to: string): void;
+    todo(message: string): void;
+    done(message: string): void;
+    summaryBox(title: string, items: {
+        label: string;
+        value: string;
+        type?: 'success' | 'warn' | 'info';
+    }[]): void;
+    nextSteps(steps: string[]): void;
+    blank(): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkCH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,cAAM,MAAM;IACV,OAAO,CAAC,OAAO,CAAkB;IAEjC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKlC,MAAM,IAAI,IAAI;IASd,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO5B,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAK/C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO7B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,IAAI,IAAI;IAKf,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO5C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAK1C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,EAAE,GAAG,IAAI;IAc9G,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAUhC,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Logger utility for colored console output with enhanced UX
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const COLORS = {
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    dim: '\x1b[2m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    white: '\x1b[37m',
+    bgBlue: '\x1b[44m',
+    bgGreen: '\x1b[42m',
+};
+// Emojis for visual feedback
+const ICONS = {
+    success: '✓',
+    error: '✗',
+    warn: '⚠',
+    info: 'ℹ',
+    step: '→',
+    file: '+',
+    folder: '📁',
+    component: '⚡',
+    test: '🧪',
+    docs: '📄',
+    lightning: '⚡',
+    aura: '🌀',
+    vf: '📋',
+};
+class Logger {
+    verbose = false;
+    setVerbose(verbose) {
+        this.verbose = verbose;
+    }
+    // Brand banner for tool startup
+    banner() {
+        console.log('');
+        console.log(`${COLORS.bright}${COLORS.cyan}  ╭─────────────────────────────────────────────╮${COLORS.reset}`);
+        console.log(`${COLORS.bright}${COLORS.cyan}  │${COLORS.reset}  ${COLORS.bright}${COLORS.yellow}⚡ LWC Convert${COLORS.reset}                            ${COLORS.cyan}│${COLORS.reset}`);
+        console.log(`${COLORS.bright}${COLORS.cyan}  │${COLORS.reset}  ${COLORS.dim}Aura & Visualforce → Lightning Web Components${COLORS.reset} ${COLORS.cyan}│${COLORS.reset}`);
+        console.log(`${COLORS.bright}${COLORS.cyan}  ╰─────────────────────────────────────────────╯${COLORS.reset}`);
+        console.log('');
+    }
+    info(message) {
+        console.log(`${COLORS.blue}${ICONS.info}${COLORS.reset}  ${message}`);
+    }
+    success(message) {
+        console.log(`${COLORS.green}${ICONS.success}${COLORS.reset}  ${message}`);
+    }
+    warn(message) {
+        console.log(`${COLORS.yellow}${ICONS.warn}${COLORS.reset}  ${message}`);
+    }
+    error(message) {
+        console.error(`${COLORS.red}${ICONS.error}${COLORS.reset}  ${message}`);
+    }
+    debug(message) {
+        if (this.verbose) {
+            console.log(`${COLORS.dim}   ${message}${COLORS.reset}`);
+        }
+    }
+    // Step indicator with better visual hierarchy
+    step(stepNumber, message) {
+        console.log(`${COLORS.cyan}${ICONS.step}${COLORS.reset}  ${COLORS.dim}Step ${stepNumber}:${COLORS.reset} ${message}`);
+    }
+    // Section header
+    header(message) {
+        console.log('');
+        console.log(`${COLORS.bright}${COLORS.white}  ${message}${COLORS.reset}`);
+        console.log(`${COLORS.dim}  ${'─'.repeat(message.length + 2)}${COLORS.reset}`);
+    }
+    // Sub-section for grouping related output
+    subheader(message) {
+        console.log(`\n${COLORS.dim}  ${message}${COLORS.reset}`);
+    }
+    divider() {
+        console.log('');
+    }
+    // File creation with icon
+    file(action, filePath) {
+        const icon = filePath.includes('__tests__') ? ICONS.test :
+            filePath.endsWith('.md') ? ICONS.docs : ICONS.file;
+        console.log(`   ${COLORS.green}${icon}${COLORS.reset} ${COLORS.dim}${action}${COLORS.reset} ${filePath}`);
+    }
+    // Conversion arrow
+    conversion(from, to) {
+        console.log(`   ${COLORS.yellow}${from}${COLORS.reset} ${COLORS.dim}→${COLORS.reset} ${COLORS.green}${to}${COLORS.reset}`);
+    }
+    // Todo/action item
+    todo(message) {
+        console.log(`   ${COLORS.yellow}○${COLORS.reset} ${message}`);
+    }
+    // Completed item
+    done(message) {
+        console.log(`   ${COLORS.green}●${COLORS.reset} ${message}`);
+    }
+    // Summary box for final output
+    summaryBox(title, items) {
+        console.log('');
+        console.log(`${COLORS.bright}  ${title}${COLORS.reset}`);
+        console.log(`${COLORS.dim}  ${'─'.repeat(40)}${COLORS.reset}`);
+        for (const item of items) {
+            const color = item.type === 'success' ? COLORS.green :
+                item.type === 'warn' ? COLORS.yellow : COLORS.white;
+            console.log(`   ${COLORS.dim}${item.label}:${COLORS.reset} ${color}${item.value}${COLORS.reset}`);
+        }
+        console.log('');
+    }
+    // Next steps guidance
+    nextSteps(steps) {
+        console.log(`${COLORS.bright}  Next Steps${COLORS.reset}`);
+        console.log(`${COLORS.dim}  ${'─'.repeat(40)}${COLORS.reset}`);
+        steps.forEach((step, i) => {
+            console.log(`   ${COLORS.cyan}${i + 1}.${COLORS.reset} ${step}`);
+        });
+        console.log('');
+    }
+    // Blank line
+    blank() {
+        console.log('');
+    }
+}
+exports.logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/open-folder.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cross-platform utility to open a folder in the system file explorer
+ */
+/**
+ * Opens the specified folder in the system's file explorer.
+ * Works on Windows, macOS, and Linux.
+ */
+export declare function openFolder(folderPath: string): Promise<void>;
+//# sourceMappingURL=open-folder.d.ts.map

package/dist/utils/open-folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-folder.d.ts","sourceRoot":"","sources":["../../src/utils/open-folder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B5D"}

package/dist/utils/open-folder.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * Cross-platform utility to open a folder in the system file explorer
+ */
+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.openFolder = openFolder;
+const child_process_1 = require("child_process");
+const os = __importStar(require("os"));
+/**
+ * Opens the specified folder in the system's file explorer.
+ * Works on Windows, macOS, and Linux.
+ */
+function openFolder(folderPath) {
+    return new Promise((resolve, _reject) => {
+        const platform = os.platform();
+        let command;
+        switch (platform) {
+            case 'win32':
+                // Windows: use start command which handles paths better
+                command = `start "" "${folderPath}"`;
+                break;
+            case 'darwin':
+                // macOS: use open
+                command = `open "${folderPath}"`;
+                break;
+            default:
+                // Linux and others: use xdg-open
+                command = `xdg-open "${folderPath}"`;
+                break;
+        }
+        (0, child_process_1.exec)(command, (error) => {
+            if (error) {
+                // Don't fail the whole conversion if we can't open the folder
+                console.warn(`Could not open folder: ${error.message}`);
+                resolve();
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+//# sourceMappingURL=open-folder.js.map

package/dist/utils/open-folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-folder.js","sourceRoot":"","sources":["../../src/utils/open-folder.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASH,gCA8BC;AArCD,iDAAqC;AACrC,uCAAyB;AAEzB;;;GAGG;AACH,SAAgB,UAAU,CAAC,UAAkB;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACtC,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAe,CAAC;QAEpB,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,OAAO;gBACV,wDAAwD;gBACxD,OAAO,GAAG,aAAa,UAAU,GAAG,CAAC;gBACrC,MAAM;YACR,KAAK,QAAQ;gBACX,kBAAkB;gBAClB,OAAO,GAAG,SAAS,UAAU,GAAG,CAAC;gBACjC,MAAM;YACR;gBACE,iCAAiC;gBACjC,OAAO,GAAG,aAAa,UAAU,GAAG,CAAC;gBACrC,MAAM;QACV,CAAC;QAED,IAAA,oBAAI,EAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACtB,IAAI,KAAK,EAAE,CAAC;gBACV,8DAA8D;gBAC9D,OAAO,CAAC,IAAI,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACxD,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/path-resolver.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Smart path resolver for Salesforce components
+ * Searches common project locations when only a component name is provided
+ */
+export interface ResolvedPath {
+    found: boolean;
+    path: string;
+    searchedLocations?: string[];
+}
+/**
+ * Resolve an Aura component path
+ * If just a name is provided, searches common locations
+ */
+export declare function resolveAuraPath(input: string): Promise<ResolvedPath>;
+/**
+ * Resolve a Visualforce page path
+ * If just a name is provided, searches common locations
+ */
+export declare function resolveVfPath(input: string): Promise<ResolvedPath>;
+/**
+ * Resolve an Apex controller path
+ * If just a name is provided, searches common locations
+ */
+export declare function resolveApexPath(input: string): Promise<ResolvedPath>;
+/**
+ * Format search locations for user-friendly error message
+ */
+export declare function formatSearchLocations(locations: string[], cwd: string): string;
+//# sourceMappingURL=path-resolver.d.ts.map

package/dist/utils/path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/path-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6BH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAcD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoD1E;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAsCxE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAsC1E;AAyCD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9E"}