lwc-convert 1.8.1 → 1.8.2

package/dist/index.js

@@ -51,8 +51,8 @@ var init_esm_shims = __esm({
 import { readFileSync } from "fs";
 import { join } from "path";
 function getPackageVersion() {
-  if ("1.8.1") {
-    return "1.8.1";
+  if ("1.8.2") {
+    return "1.8.2";
   }
   try {
     const possiblePaths = [
@@ -76,11 +76,12 @@ function getPackageVersion() {
     return "0.0.0";
   }
 }
-var DEFAULT_OUTPUT_DIR, CLI_VERSION, CLI_NAME, CLI_DESCRIPTION;
+var DEFAULT_API_VERSION, DEFAULT_OUTPUT_DIR, CLI_VERSION, CLI_NAME, CLI_DESCRIPTION;
 var init_options = __esm({
   "src/cli/options.ts"() {
     "use strict";
     init_esm_shims();
+    DEFAULT_API_VERSION = "62.0";
     DEFAULT_OUTPUT_DIR = "./lwc-output";
     CLI_VERSION = getPackageVersion();
     CLI_NAME = "lwc-convert";
@@ -516,7 +517,16 @@ async function writeFile(filePath, content, dryRun = false) {
   logger.file("CREATE", filePath);
 }
 function toLwcName(name) {
-  return name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z])([A-Z][a-z])/g, "$1-$2").toLowerCase();
+  let result = name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z])([A-Z][a-z])/g, "$1-$2").toLowerCase();
+  result = result.replace(/[^a-z0-9-]/g, "-");
+  result = result.replace(/-{2,}/g, "-");
+  result = result.replace(/^[^a-z]+/, "");
+  result = result.replace(/-+$/, "");
+  if (!result) {
+    result = "component";
+    logger.warn(`Component name "${name}" could not be converted to a valid LWC name. Using "${result}" as fallback.`);
+  }
+  return result;
 }
 function toPascalCase(name) {
   return name.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
@@ -770,13 +780,13 @@ function extractFunctionBody(node, source) {
   }
   return "";
 }
-function parseAttributeAccess(path19) {
-  const callee = path19.node.callee;
+function parseAttributeAccess(path20) {
+  const callee = path20.node.callee;
   if (!t.isMemberExpression(callee)) return null;
   const property = callee.property;
   if (!t.isIdentifier(property)) return null;
   if (property.name !== "get" && property.name !== "set") return null;
-  const args2 = path19.node.arguments;
+  const args2 = path20.node.arguments;
   if (args2.length === 0) return null;
   const firstArg = args2[0];
   if (!t.isStringLiteral(firstArg)) return null;
@@ -789,8 +799,8 @@ function parseAttributeAccess(path19) {
     operation
   };
 }
-function parseServerCall(path19, _source) {
-  const callee = path19.node.callee;
+function parseServerCall(path20, _source) {
+  const callee = path20.node.callee;
   if (t.isMemberExpression(callee) && t.isIdentifier(callee.object, { name: "$A" }) && t.isIdentifier(callee.property, { name: "enqueueAction" })) {
     return {
       actionName: "enqueueAction",
@@ -800,7 +810,7 @@ function parseServerCall(path19, _source) {
   if (t.isMemberExpression(callee)) {
     const property = callee.property;
     if (t.isIdentifier(property, { name: "get" })) {
-      const args2 = path19.node.arguments;
+      const args2 = path20.node.arguments;
       if (args2.length > 0 && t.isStringLiteral(args2[0])) {
         const value = args2[0].value;
         if (value.startsWith("c.")) {
@@ -815,17 +825,17 @@ function parseServerCall(path19, _source) {
   }
   return null;
 }
-function parseHelperCall(path19) {
-  const callee = path19.node.callee;
+function parseHelperCall(path20) {
+  const callee = path20.node.callee;
   if (t.isMemberExpression(callee) && t.isIdentifier(callee.object, { name: "helper" }) && t.isIdentifier(callee.property)) {
     return callee.property.name;
   }
   return null;
 }
-function parseEventFire(path19) {
-  const callee = path19.node.callee;
+function parseEventFire(path20) {
+  const callee = path20.node.callee;
   if (t.isMemberExpression(callee) && t.isIdentifier(callee.object, { name: "$A" }) && t.isIdentifier(callee.property, { name: "get" })) {
-    const args2 = path19.node.arguments;
+    const args2 = path20.node.arguments;
     if (args2.length > 0 && t.isStringLiteral(args2[0])) {
       const value = args2[0].value;
       if (value.startsWith("e.")) {
@@ -834,7 +844,7 @@ function parseEventFire(path19) {
     }
   }
   if (t.isMemberExpression(callee) && t.isIdentifier(callee.property, { name: "getEvent" })) {
-    const args2 = path19.node.arguments;
+    const args2 = path20.node.arguments;
     if (args2.length > 0 && t.isStringLiteral(args2[0])) {
       return args2[0].value;
     }
@@ -865,11 +875,11 @@ function parseAuraController(source) {
     return result;
   }
   traverse(ast, {
-    ObjectExpression(path19) {
-      if (path19.parent.type === "VariableDeclarator" && t.isIdentifier(path19.parent.id, {
+    ObjectExpression(path20) {
+      if (path20.parent.type === "VariableDeclarator" && t.isIdentifier(path20.parent.id, {
         name: "__auraController"
       })) {
-        for (const prop of path19.node.properties) {
+        for (const prop of path20.node.properties) {
           if (t.isObjectProperty(prop) && t.isIdentifier(prop.key) && t.isFunctionExpression(prop.value)) {
             const funcName = prop.key.name;
             const funcExpr = prop.value;
@@ -893,7 +903,7 @@ function parseAuraController(source) {
               (p2) => p2 === "event" || p2 === "evt"
             );
             funcDef.hasHelper = funcDef.params.some((p2) => p2 === "helper");
-            const funcPath = path19.get("properties").find((propPath) => {
+            const funcPath = path20.get("properties").find((propPath) => {
               const propNode = propPath.node;
               return t.isObjectProperty(propNode) && t.isIdentifier(propNode.key, { name: funcName });
             });
@@ -977,11 +987,11 @@ function parseAuraHelper(source) {
   }
   const helperFunctionNames = /* @__PURE__ */ new Set();
   traverse2(ast, {
-    ObjectExpression(path19) {
-      if (path19.parent.type === "VariableDeclarator" && t2.isIdentifier(path19.parent.id, {
+    ObjectExpression(path20) {
+      if (path20.parent.type === "VariableDeclarator" && t2.isIdentifier(path20.parent.id, {
         name: "__auraHelper"
       })) {
-        for (const prop of path19.node.properties) {
+        for (const prop of path20.node.properties) {
           if (t2.isObjectProperty(prop) && t2.isIdentifier(prop.key)) {
             helperFunctionNames.add(prop.key.name);
           }
@@ -990,11 +1000,11 @@ function parseAuraHelper(source) {
     }
   });
   traverse2(ast, {
-    ObjectExpression(path19) {
-      if (path19.parent.type === "VariableDeclarator" && t2.isIdentifier(path19.parent.id, {
+    ObjectExpression(path20) {
+      if (path20.parent.type === "VariableDeclarator" && t2.isIdentifier(path20.parent.id, {
         name: "__auraHelper"
       })) {
-        for (const prop of path19.node.properties) {
+        for (const prop of path20.node.properties) {
           if (t2.isObjectProperty(prop) && t2.isIdentifier(prop.key) && t2.isFunctionExpression(prop.value)) {
             const funcName = prop.key.name;
             const funcExpr = prop.value;
@@ -1010,7 +1020,7 @@ function parseAuraHelper(source) {
             funcDef.hasComponent = funcDef.params.some(
               (p2) => p2 === "component" || p2 === "cmp"
             );
-            const funcPath = path19.get("properties").find((propPath) => {
+            const funcPath = path20.get("properties").find((propPath) => {
               const propNode = propPath.node;
               return t2.isObjectProperty(propNode) && t2.isIdentifier(propNode.key, { name: funcName });
             });
@@ -4394,11 +4404,23 @@ function convertFunctionBody(body, _func, allHelperFunctions) {
     /(?:component|cmp)\.get\s*\(\s*["']v\.(\w+)["']\s*\)/g,
     "this.$1"
   );
-  converted = converted.replace(
-    /(?:component|cmp)\.set\s*\(\s*["']v\.(\w+)["']\s*,\s*/g,
-    "this.$1 = "
-  );
-  converted = converted.replace(/this\.(\w+)\s*=\s*([^;]+)\s*\)/g, "this.$1 = $2");
+  const setPattern = /(?:component|cmp)\.set\s*\(\s*["']v\.(\w+)["']\s*,\s*/g;
+  let setMatch;
+  while ((setMatch = setPattern.exec(converted)) !== null) {
+    const propName = setMatch[1];
+    const valueStart = setMatch.index + setMatch[0].length;
+    let depth = 1;
+    let i = valueStart;
+    while (i < converted.length && depth > 0) {
+      if (converted[i] === "(") depth++;
+      else if (converted[i] === ")") depth--;
+      i++;
+    }
+    const value = converted.substring(valueStart, i - 1).trim();
+    const replacement = `this.${propName} = ${value}`;
+    converted = converted.substring(0, setMatch.index) + replacement + converted.substring(i);
+    setPattern.lastIndex = setMatch.index + replacement.length;
+  }
   if (allHelperFunctions) {
     for (const helperFunc of allHelperFunctions) {
       const helperRegex = new RegExp(
@@ -4410,10 +4432,21 @@ function convertFunctionBody(body, _func, allHelperFunctions) {
   }
   if (converted.includes("$A.enqueueAction")) {
     warnings.push("Server action ($A.enqueueAction) found - convert to imperative Apex call");
-    converted = converted.replace(
-      /\$A\.enqueueAction\s*\([^)]+\)/g,
-      "/* TODO: Convert to imperative Apex call */"
-    );
+    const enqueuePattern = /\$A\.enqueueAction\s*\(/g;
+    let enqueueMatch;
+    while ((enqueueMatch = enqueuePattern.exec(converted)) !== null) {
+      const callStart = enqueueMatch.index;
+      let depth = 1;
+      let j = callStart + enqueueMatch[0].length;
+      while (j < converted.length && depth > 0) {
+        if (converted[j] === "(") depth++;
+        else if (converted[j] === ")") depth--;
+        j++;
+      }
+      const replacement = "/* TODO: Convert to imperative Apex call */";
+      converted = converted.substring(0, callStart) + replacement + converted.substring(j);
+      enqueuePattern.lastIndex = callStart + replacement.length;
+    }
   }
   if (converted.includes('.get("c.') || converted.includes(".get('c.")) {
     warnings.push("Server action reference found - import Apex method and call imperatively");
@@ -6095,7 +6128,7 @@ var init_confidence_scorer = __esm({
 // src/generators/full-conversion.ts
 function generateMetaXml2(_componentName, options) {
   const {
-    apiVersion = "62.0",
+    apiVersion = DEFAULT_API_VERSION,
     isExposed = true,
     targets = ["lightning__RecordPage", "lightning__AppPage", "lightning__HomePage"],
     description,
@@ -6661,6 +6694,7 @@ var init_full_conversion = __esm({
     init_test_generator();
     init_file_io();
     init_logger();
+    init_options();
     init_confidence_scorer();
   }
 });
@@ -6715,40 +6749,53 @@ var init_project_detector = __esm({
   }
 });
 
+// src/utils/constants.ts
+var AURA_SEARCH_PATHS, VF_PAGE_SEARCH_PATHS, VF_COMPONENT_SEARCH_PATHS, APEX_SEARCH_PATHS;
+var init_constants = __esm({
+  "src/utils/constants.ts"() {
+    "use strict";
+    init_esm_shims();
+    AURA_SEARCH_PATHS = [
+      "force-app/main/default/aura",
+      "src/aura",
+      "aura",
+      "force-app/main/aura"
+    ];
+    VF_PAGE_SEARCH_PATHS = [
+      "force-app/main/default/pages",
+      "src/pages",
+      "pages",
+      "force-app/main/pages"
+    ];
+    VF_COMPONENT_SEARCH_PATHS = [
+      "force-app/main/default/components",
+      "src/components",
+      "components",
+      "force-app/main/components"
+    ];
+    APEX_SEARCH_PATHS = [
+      "force-app/main/default/classes",
+      "src/classes",
+      "classes",
+      "force-app/main/classes"
+    ];
+  }
+});
+
 // src/utils/fuzzy-suggest.ts
 import Fuse from "fuse.js";
 import * as path4 from "path";
 import fs3 from "fs-extra";
 async function suggestAuraComponents(input, maxResults = 3) {
-  const searchPaths = [
-    "force-app/main/default/aura",
-    "src/aura",
-    "aura",
-    "force-app/main/aura"
-  ];
-  const components3 = await scanDirectories(searchPaths, ".cmp");
+  const components3 = await scanDirectories(AURA_SEARCH_PATHS, ".cmp");
   return fuzzyMatch(input, components3, maxResults);
 }
 async function suggestVfPages(input, maxResults = 3) {
-  const searchPaths = [
-    "force-app/main/default/pages",
-    "force-app/main/default/components",
-    "src/pages",
-    "src/components",
-    "pages",
-    "components"
-  ];
-  const pages = await scanDirectories(searchPaths, ".page", ".component");
+  const pages = await scanDirectories([...VF_PAGE_SEARCH_PATHS, ...VF_COMPONENT_SEARCH_PATHS], ".page", ".component");
   return fuzzyMatch(input, pages, maxResults);
 }
 async function suggestApexControllers(input, maxResults = 3) {
-  const searchPaths = [
-    "force-app/main/default/classes",
-    "src/classes",
-    "classes",
-    "force-app/main/classes"
-  ];
-  const controllers = await scanDirectories(searchPaths, ".cls");
+  const controllers = await scanDirectories(APEX_SEARCH_PATHS, ".cls");
   return fuzzyMatch(input, controllers, maxResults);
 }
 async function scanDirectories(searchPaths, ...extensions) {
@@ -6837,6 +6884,7 @@ var init_fuzzy_suggest = __esm({
     "use strict";
     init_esm_shims();
     init_project_detector();
+    init_constants();
     FUSE_OPTIONS = {
       keys: ["name"],
       threshold: 0.4,
@@ -6994,7 +7042,8 @@ async function resolveApexPath(input) {
     contextualHelp
   };
 }
-async function searchForComponent(baseDir, componentName, extension) {
+async function searchForComponent(baseDir, componentName, extension, currentDepth = 0, maxDepth = 5) {
+  if (currentDepth >= maxDepth) return null;
   try {
     const entries = await fs4.readdir(baseDir, { withFileTypes: true });
     for (const entry of entries) {
@@ -7009,51 +7058,31 @@ async function searchForComponent(baseDir, componentName, extension) {
         const subResult = await searchForComponent(
           path5.join(baseDir, entry.name),
           componentName,
-          extension
+          extension,
+          currentDepth + 1,
+          maxDepth
         );
         if (subResult) {
           return subResult;
         }
       }
     }
-  } catch {
+  } catch (error) {
+    logger.debug(`Error searching ${baseDir}: ${error.message}`);
   }
   return null;
 }
 function formatSearchLocations(locations, cwd) {
   return locations.map((loc) => `  - ${path5.relative(cwd, loc) || loc}`).join("\n");
 }
-var AURA_SEARCH_PATHS, VF_PAGE_SEARCH_PATHS, VF_COMPONENT_SEARCH_PATHS, APEX_SEARCH_PATHS;
 var init_path_resolver = __esm({
   "src/utils/path-resolver.ts"() {
     "use strict";
     init_esm_shims();
     init_project_detector();
+    init_logger();
     init_fuzzy_suggest();
-    AURA_SEARCH_PATHS = [
-      "force-app/main/default/aura",
-      "src/aura",
-      "aura",
-      "force-app/main/aura"
-    ];
-    VF_PAGE_SEARCH_PATHS = [
-      "force-app/main/default/pages",
-      "src/pages",
-      "pages",
-      "force-app/main/pages"
-    ];
-    VF_COMPONENT_SEARCH_PATHS = [
-      "force-app/main/default/components",
-      "src/components",
-      "components",
-      "force-app/main/components"
-    ];
-    APEX_SEARCH_PATHS = [
-      "force-app/main/default/classes",
-      "src/classes",
-      "classes",
-      "force-app/main/classes"
-    ];
+    init_constants();
   }
 });
 
@@ -7061,7 +7090,7 @@ var init_path_resolver = __esm({
 import * as fs5 from "fs";
 import * as path6 from "path";
 import * as os from "os";
-var SESSIONS_BASE_DIR, ACTIVE_SESSION_FILE, SESSION_EXPIRY_MS, SessionStore, sessionStore;
+var SESSIONS_BASE_DIR, ACTIVE_SESSION_FILE, SESSION_EXPIRY_MS, MAX_PATTERN_LIBRARY_SIZE, SessionStore, sessionStore;
 var init_session_store = __esm({
   "src/utils/session-store.ts"() {
     "use strict";
@@ -7070,12 +7099,15 @@ var init_session_store = __esm({
     SESSIONS_BASE_DIR = path6.join(os.tmpdir(), "lwc-convert-sessions");
     ACTIVE_SESSION_FILE = path6.join(SESSIONS_BASE_DIR, "active-session.json");
     SESSION_EXPIRY_MS = 4 * 60 * 60 * 1e3;
+    MAX_PATTERN_LIBRARY_SIZE = 1e3;
     SessionStore = class {
       sessionId = "";
       sessionDir = "";
       conversions = [];
+      conversionIndex = /* @__PURE__ */ new Map();
       patternLibrary = /* @__PURE__ */ new Map();
       initialized = false;
+      initPromise = null;
       startedAt = /* @__PURE__ */ new Date();
       constructor() {
       }
@@ -7130,6 +7162,7 @@ var init_session_store = __esm({
               const record = JSON.parse(content);
               record.timestamp = new Date(record.timestamp);
               this.conversions.push(record);
+              this.conversionIndex.set(record.id, record);
               for (const pattern of record.patterns) {
                 this.updatePatternLibrary([pattern]);
               }
@@ -7183,17 +7216,22 @@ var init_session_store = __esm({
        */
       async init() {
         if (this.initialized) return;
-        try {
-          const loaded = await this.tryLoadExistingSession();
-          if (!loaded) {
-            await this.createNewSession();
+        if (this.initPromise) return this.initPromise;
+        this.initPromise = (async () => {
+          try {
+            const loaded = await this.tryLoadExistingSession();
+            if (!loaded) {
+              await this.createNewSession();
+            }
+            await this.updateActiveSessionFile();
+            this.initialized = true;
+            logger.debug(`Session store initialized: ${this.sessionDir}`);
+          } catch (error) {
+            logger.debug(`Failed to initialize session store: ${error.message}`);
+            this.initPromise = null;
           }
-          await this.updateActiveSessionFile();
-          this.initialized = true;
-          logger.debug(`Session store initialized: ${this.sessionDir}`);
-        } catch (error) {
-          logger.debug(`Failed to initialize session store: ${error.message}`);
-        }
+        })();
+        return this.initPromise;
       }
       /**
        * Get the session directory path
@@ -7233,6 +7271,7 @@ var init_session_store = __esm({
           success: true
         };
         this.conversions.push(record);
+        this.conversionIndex.set(record.id, record);
         this.updatePatternLibrary(record.patterns);
         try {
           const conversionFile = path6.join(this.sessionDir, "conversions", `${record.id}.json`);
@@ -7296,7 +7335,15 @@ var init_session_store = __esm({
           if (existing) {
             existing.frequency++;
             existing.successRate = (existing.successRate * (existing.frequency - 1) + pattern.successRate) / existing.frequency;
+            this.patternLibrary.delete(key);
+            this.patternLibrary.set(key, existing);
           } else {
+            if (this.patternLibrary.size >= MAX_PATTERN_LIBRARY_SIZE) {
+              const firstKey = this.patternLibrary.keys().next().value;
+              if (firstKey !== void 0) {
+                this.patternLibrary.delete(firstKey);
+              }
+            }
             this.patternLibrary.set(key, { ...pattern });
           }
         }
@@ -7333,13 +7380,13 @@ var init_session_store = __esm({
        * Get conversion by ID
        */
       getConversion(id) {
-        return this.conversions.find((c) => c.id === id);
+        return this.conversionIndex.get(id);
       }
       /**
        * Update test results for a conversion
        */
       async updateTestResults(conversionId, results) {
-        const conversion = this.conversions.find((c) => c.id === conversionId);
+        const conversion = this.conversionIndex.get(conversionId);
         if (!conversion) return;
         conversion.testResults = results;
         conversion.success = results.failed === 0;
@@ -7471,8 +7518,10 @@ All session data is stored in:
             await fs5.promises.unlink(ACTIVE_SESSION_FILE);
           }
           this.conversions = [];
+          this.conversionIndex.clear();
           this.patternLibrary.clear();
           this.initialized = false;
+          this.initPromise = null;
           logger.debug(`Cleaned up session: ${this.sessionId}`);
         } catch (error) {
           logger.debug(`Failed to cleanup session: ${error.message}`);
@@ -7513,6 +7562,13 @@ All session data is stored in:
 // src/utils/preview-generator.ts
 import fs6 from "fs-extra";
 import * as path7 from "path";
+import { execFile, spawn } from "child_process";
+function escapeHtml(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
+}
+function escapeCssContent(css) {
+  return css.replace(/<\/style/gi, "<\\/style");
+}
 function parseAttributes(tagContent) {
   const attrs = {};
   const attrRegex = /(\S+?)(?:=(?:"([^"]*)"|{([^}]*)})|(?=\s|>|$))/g;
@@ -7611,12 +7667,14 @@ function transformLwcToPreviewHtml(lwcHtml) {
 function generatePreviewHtml(bundle, componentCss) {
   const previewContent = transformLwcToPreviewHtml(bundle.html);
   const css = componentCss ?? bundle.css;
+  const safeName = escapeHtml(bundle.name);
+  const safeCss = css ? escapeCssContent(css) : "";
   return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>LWC Preview: ${bundle.name}</title>
+  <title>LWC Preview: ${safeName}</title>
 
   <!-- Salesforce Lightning Design System -->
   <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/design-system/2.24.2/styles/salesforce-lightning-design-system.min.css">
@@ -7778,7 +7836,7 @@ function generatePreviewHtml(bundle, componentCss) {
     }
 
     /* Component-specific CSS from conversion */
-    ${css || "/* No component CSS */"}
+    ${safeCss || "/* No component CSS */"}
 
     /* Legend */
     .preview-legend {
@@ -7836,7 +7894,7 @@ function generatePreviewHtml(bundle, componentCss) {
 <body>
   <div class="preview-container">
     <div class="preview-header">
-      <h1>${bundle.name}</h1>
+      <h1>${safeName}</h1>
       <div class="meta">LWC Preview &bull; Generated by lwc-convert</div>
     </div>
 
@@ -7911,20 +7969,21 @@ async function writePreviewFile(outputDir, bundle, dryRun = false) {
   return previewPath;
 }
 async function openPreview(previewPath) {
-  const { exec: exec2 } = await import("child_process");
-  const { promisify } = await import("util");
-  const execAsync = promisify(exec2);
   const platform3 = process.platform;
-  let command;
-  if (platform3 === "win32") {
-    command = `start "" "${previewPath}"`;
-  } else if (platform3 === "darwin") {
-    command = `open "${previewPath}"`;
-  } else {
-    command = `xdg-open "${previewPath}"`;
-  }
   try {
-    await execAsync(command);
+    if (platform3 === "win32") {
+      execFile("explorer", [previewPath], () => {
+      });
+    } else if (platform3 === "darwin") {
+      execFile("open", [previewPath], () => {
+      });
+    } else {
+      const child = spawn("xdg-open", [previewPath], {
+        detached: true,
+        stdio: "ignore"
+      });
+      child.unref();
+    }
     logger.success("Opened preview in default browser");
   } catch (error) {
     logger.warn(`Could not open preview automatically: ${error.message}`);
@@ -8288,31 +8347,38 @@ var open_folder_exports = {};
 __export(open_folder_exports, {
   openFolder: () => openFolder
 });
-import { exec } from "child_process";
+import { execFile as execFile2, spawn as spawn2 } from "child_process";
 import * as os2 from "os";
 function openFolder(folderPath) {
-  return new Promise((resolve8, _reject) => {
+  return new Promise((resolve10) => {
     const platform3 = os2.platform();
-    let command;
-    switch (platform3) {
-      case "win32":
-        command = `start "" "${folderPath}"`;
-        break;
-      case "darwin":
-        command = `open "${folderPath}"`;
-        break;
-      default:
-        command = `xdg-open "${folderPath}"`;
-        break;
-    }
-    exec(command, (error) => {
-      if (error) {
-        logger.warn(`Could not open folder: ${error.message}`);
-        resolve8();
+    try {
+      if (platform3 === "win32") {
+        execFile2("explorer", [folderPath], (error) => {
+          if (error) {
+            logger.warn(`Could not open folder: ${error.message}`);
+          }
+          resolve10();
+        });
+      } else if (platform3 === "darwin") {
+        execFile2("open", [folderPath], (error) => {
+          if (error) {
+            logger.warn(`Could not open folder: ${error.message}`);
+          }
+          resolve10();
+        });
       } else {
-        resolve8();
+        const child = spawn2("xdg-open", [folderPath], {
+          detached: true,
+          stdio: "ignore"
+        });
+        child.unref();
+        resolve10();
       }
-    });
+    } catch (error) {
+      logger.warn(`Could not open folder: ${error.message}`);
+      resolve10();
+    }
   });
 }
 var init_open_folder = __esm({
@@ -9633,6 +9699,8 @@ var init_grader = __esm({
     Grader = class {
       auraGrader;
       vfGrader;
+      /** Cache of grading results keyed by resolved file path */
+      gradeCache = /* @__PURE__ */ new Map();
       constructor() {
         this.auraGrader = new AuraGrader();
         this.vfGrader = new VfGrader();
@@ -9681,7 +9749,8 @@ var init_grader = __esm({
                 }
               }
             }
-          } catch {
+          } catch (error) {
+            logger.debug(`Error scanning ${dirPath}: ${error.message}`);
           }
         };
         await searchDir(basePath);
@@ -9697,29 +9766,48 @@ var init_grader = __esm({
           if (grade2) results.push(grade2);
         } else {
           const searchPaths = options.targetPath ? [options.targetPath] : await this.getStandardPaths(options.type);
+          const allFiles = [];
           for (const searchPath of searchPaths) {
             const found = await this.scanDirectory(searchPath, options.type);
-            for (const file of found) {
-              try {
-                const grade2 = await this.gradeSingle(file, options.type === "both" ? this.detectType(file) : options.type);
-                if (grade2) results.push(grade2);
-              } catch (err) {
-                logger.error(`Failed to grade ${file}: ${err.message}`);
+            allFiles.push(...found);
+          }
+          for (let idx = 0; idx < allFiles.length; idx++) {
+            const file = allFiles[idx];
+            if (allFiles.length > 5) {
+              logger.debug(`Grading ${idx + 1}/${allFiles.length}: ${path11.basename(file)}`);
+              if ((idx + 1) % 10 === 0 || idx === allFiles.length - 1) {
+                process.stdout.write(`\r  Grading components... ${idx + 1}/${allFiles.length}`);
               }
             }
+            try {
+              const grade2 = await this.gradeSingle(file, options.type === "both" ? this.detectType(file) : options.type);
+              if (grade2) results.push(grade2);
+            } catch (err) {
+              logger.error(`Failed to grade ${file}: ${err.message}`);
+            }
+          }
+          if (allFiles.length > 5) {
+            process.stdout.write("\r" + " ".repeat(60) + "\r");
           }
         }
         return results;
       }
       async gradeSingle(filePath, type) {
+        const resolvedPath = path11.resolve(filePath);
+        const cached = this.gradeCache.get(resolvedPath);
+        if (cached) return cached;
         const resolvedType = type === "both" ? this.detectType(filePath) : type;
+        let result = null;
         if (resolvedType === "aura") {
           const bundlePath = filePath.endsWith(".cmp") ? path11.dirname(filePath) : filePath;
-          return this.auraGrader.grade(bundlePath);
+          result = await this.auraGrader.grade(bundlePath);
         } else if (resolvedType === "vf") {
-          return this.vfGrader.grade(filePath);
+          result = await this.vfGrader.grade(filePath);
         }
-        return null;
+        if (result) {
+          this.gradeCache.set(resolvedPath, result);
+        }
+        return result;
       }
       detectType(filePath) {
         if (filePath.endsWith(".cmp") || filePath.includes("/aura/") || filePath.includes("\\aura\\")) return "aura";
@@ -10010,7 +10098,7 @@ var init_vf_controller_resolver = __esm({
 
 // src/utils/first-time.ts
 import fs14 from "fs-extra";
-import path15 from "path";
+import path16 from "path";
 import os4 from "os";
 function isFirstTimeSync() {
   try {
@@ -10059,8 +10147,8 @@ var init_first_time = __esm({
   "src/utils/first-time.ts"() {
     "use strict";
     init_esm_shims();
-    CONFIG_DIR = path15.join(os4.homedir(), ".lwc-convert");
-    FIRST_RUN_FILE = path15.join(CONFIG_DIR, ".first-run-complete");
+    CONFIG_DIR = path16.join(os4.homedir(), ".lwc-convert");
+    FIRST_RUN_FILE = path16.join(CONFIG_DIR, ".first-run-complete");
   }
 });
 
@@ -10070,7 +10158,7 @@ __export(interactive_exports, {
   runInteractiveTui: () => runInteractiveTui
 });
 import * as p from "@clack/prompts";
-import * as path16 from "path";
+import * as path17 from "path";
 import fs15 from "fs-extra";
 function showBreadcrumbs(currentStep, conversionType) {
   const breadcrumb = STEPS.map((step, i) => {
@@ -10098,16 +10186,16 @@ async function findAuraComponents() {
   const components3 = [];
   const cwd = process.cwd();
   for (const searchPath of searchPaths) {
-    const fullPath = path16.join(cwd, searchPath);
+    const fullPath = path17.join(cwd, searchPath);
     if (await fs15.pathExists(fullPath)) {
       try {
         const entries = await fs15.readdir(fullPath, { withFileTypes: true });
         for (const entry of entries) {
           if (entry.isDirectory()) {
-            const cmpFile = path16.join(fullPath, entry.name, `${entry.name}.cmp`);
+            const cmpFile = path17.join(fullPath, entry.name, `${entry.name}.cmp`);
             if (await fs15.pathExists(cmpFile)) {
               components3.push({
-                value: path16.join(searchPath, entry.name),
+                value: path17.join(searchPath, entry.name),
                 label: `\u26A1 ${entry.name}`,
                 hint: searchPath
               });
@@ -10129,14 +10217,14 @@ async function findVfPages() {
   const pages = [];
   const cwd = process.cwd();
   for (const searchPath of searchPaths) {
-    const fullPath = path16.join(cwd, searchPath);
+    const fullPath = path17.join(cwd, searchPath);
     if (await fs15.pathExists(fullPath)) {
       try {
         const entries = await fs15.readdir(fullPath, { withFileTypes: true });
         for (const entry of entries) {
           if (entry.isFile() && entry.name.endsWith(".page")) {
             pages.push({
-              value: path16.join(searchPath, entry.name),
+              value: path17.join(searchPath, entry.name),
               label: `\u{1F4C4} ${entry.name.replace(".page", "")}`,
               hint: searchPath
             });
@@ -10157,14 +10245,14 @@ async function findApexControllers() {
   const controllers = [];
   const cwd = process.cwd();
   for (const searchPath of searchPaths) {
-    const fullPath = path16.join(cwd, searchPath);
+    const fullPath = path17.join(cwd, searchPath);
     if (await fs15.pathExists(fullPath)) {
       try {
         const entries = await fs15.readdir(fullPath, { withFileTypes: true });
         for (const entry of entries) {
           if (entry.isFile() && entry.name.endsWith(".cls")) {
             controllers.push({
-              value: path16.join(searchPath, entry.name),
+              value: path17.join(searchPath, entry.name),
               label: `\u{1F4CB} ${entry.name.replace(".cls", "")}`
             });
           }
@@ -10418,7 +10506,7 @@ async function runInteractiveTui() {
     }
     while (currentStep === 2 && conversionType === "vf" && componentPath && action !== "grade") {
       showBreadcrumbs(currentStep, conversionType);
-      const resolvedPagePath = path16.resolve(componentPath);
+      const resolvedPagePath = path17.resolve(componentPath);
       if (await fs15.pathExists(resolvedPagePath)) {
         const s = p.spinner();
         s.start("Analyzing page for controller references...");
@@ -10472,7 +10560,7 @@ async function runInteractiveTui() {
           if (addMore) {
             const allControllers = await findApexControllers();
             const availableControllers = allControllers.filter(
-              (c) => !controllerPaths.includes(path16.resolve(c.value))
+              (c) => !controllerPaths.includes(path17.resolve(c.value))
             );
             if (availableControllers.length > 0) {
               const additional = await p.multiselect({
@@ -10481,7 +10569,7 @@ async function runInteractiveTui() {
                 required: false
               });
               if (!isCancel2(additional)) {
-                controllerPaths.push(...additional.map((c) => path16.resolve(c)));
+                controllerPaths.push(...additional.map((c) => path17.resolve(c)));
               }
             }
           }
@@ -10508,7 +10596,7 @@ async function runInteractiveTui() {
                 continue wizardLoop;
               }
               controllerPath = selected;
-              controllerPaths = [path16.resolve(controllerPath)];
+              controllerPaths = [path17.resolve(controllerPath)];
             }
           }
         }
@@ -10615,7 +10703,7 @@ async function runInteractiveTui() {
     if (controllerPaths.length > 0) {
       summaryLines.push(`${import_picocolors.default.dim("Controllers:")}  ${controllerPaths.length} selected`);
       controllerPaths.forEach((cp) => {
-        summaryLines.push(`               ${import_picocolors.default.dim("\u2022")} ${path16.basename(cp)}`);
+        summaryLines.push(`               ${import_picocolors.default.dim("\u2022")} ${path17.basename(cp)}`);
       });
     }
     summaryLines.push(`${import_picocolors.default.dim("Mode:")}         ${conversionMode === "full" ? "\u26A1 Full" : "\u{1F4DD} Scaffolding"}`);
@@ -10685,7 +10773,7 @@ var init_types = __esm({
 
 // src/tui/store/persistence.ts
 import fs16 from "fs-extra";
-import path17 from "path";
+import path18 from "path";
 import os5 from "os";
 async function savePreferences(prefs) {
   try {
@@ -10713,8 +10801,8 @@ var init_persistence = __esm({
     "use strict";
     init_esm_shims();
     init_types();
-    CONFIG_DIR2 = path17.join(os5.homedir(), ".lwc-convert");
-    PREFS_PATH = path17.join(CONFIG_DIR2, "preferences.json");
+    CONFIG_DIR2 = path18.join(os5.homedir(), ".lwc-convert");
+    PREFS_PATH = path18.join(CONFIG_DIR2, "preferences.json");
   }
 });
 
@@ -10724,7 +10812,7 @@ __export(discovery_exports, {
   discoverComponents: () => discoverComponents
 });
 import fs17 from "fs-extra";
-import path18 from "path";
+import path19 from "path";
 async function discoverComponents(projectPath) {
   const auraComponents = [];
   const vfComponents = [];
@@ -10737,7 +10825,7 @@ async function discoverComponents(projectPath) {
     "pages"
   ];
   for (const searchPath of searchPaths) {
-    const fullPath = path18.join(projectPath, searchPath);
+    const fullPath = path19.join(projectPath, searchPath);
     if (await fs17.pathExists(fullPath)) {
       if (searchPath.includes("aura")) {
         const components3 = await discoverAuraComponents(fullPath);
@@ -10754,7 +10842,7 @@ async function discoverComponents(projectPath) {
     "components"
   ];
   for (const searchPath of vfComponentPaths) {
-    const fullPath = path18.join(projectPath, searchPath);
+    const fullPath = path19.join(projectPath, searchPath);
     if (await fs17.pathExists(fullPath)) {
       const components3 = await discoverVfComponents(fullPath);
       vfComponents.push(...components3);
@@ -10778,7 +10866,7 @@ async function discoverAuraComponents(auraPath) {
     const entries = await fs17.readdir(auraPath, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.isDirectory()) {
-        const componentPath = path18.join(auraPath, entry.name);
+        const componentPath = path19.join(auraPath, entry.name);
         const files = await fs17.readdir(componentPath);
         const cmpFile = files.find((f) => f.endsWith(".cmp"));
         if (cmpFile) {
@@ -10807,10 +10895,10 @@ async function discoverVfPages(pagesPath) {
     for (const entry of entries) {
       if (entry.isFile() && entry.name.endsWith(".page")) {
         const name = entry.name.replace(".page", "");
-        const pagePath = path18.join(pagesPath, entry.name);
+        const pagePath = path19.join(pagesPath, entry.name);
         const relatedFiles = [entry.name];
         const metaFile = `${entry.name}-meta.xml`;
-        if (await fs17.pathExists(path18.join(pagesPath, metaFile))) {
+        if (await fs17.pathExists(path19.join(pagesPath, metaFile))) {
           relatedFiles.push(metaFile);
         }
         pages.push({
@@ -10836,7 +10924,7 @@ async function discoverVfComponents(componentsPath) {
     for (const entry of entries) {
       if (entry.isFile() && entry.name.endsWith(".component")) {
         const name = entry.name.replace(".component", "");
-        const componentPath = path18.join(componentsPath, entry.name);
+        const componentPath = path19.join(componentsPath, entry.name);
         components3.push({
           id: `vf-component-${name}`,
           name,
@@ -11071,8 +11159,8 @@ var init_store = __esm({
         }
       },
       // Project actions
-      setProjectPath: (path19) => {
-        set({ projectPath: path19 });
+      setProjectPath: (path20) => {
+        set({ projectPath: path20 });
       },
       setComponents: (aura, vf) => {
         set({ auraComponents: aura, vfComponents: vf });
@@ -14296,7 +14384,7 @@ function ConversionWizard() {
                 setSelectedComponentIndex(0);
                 setComponentListScrollOffset(0);
               },
-              onSourcePathChange: (path19) => updateWizardState({ sourcePath: path19 }),
+              onSourcePathChange: (path20) => updateWizardState({ sourcePath: path20 }),
               onComponentSelect: (component) => {
                 updateWizardState({ sourcePath: component.path });
               },
@@ -14786,7 +14874,7 @@ function ExportModal() {
       {
         label: "Output Path",
         value: options.outputPath,
-        onChange: (path19) => setOptions((o) => ({ ...o, outputPath: path19 })),
+        onChange: (path20) => setOptions((o) => ({ ...o, outputPath: path20 })),
         focus: focusedField === 4
       }
     ) }),
@@ -15137,9 +15225,14 @@ async function fetchLatestVersion() {
   }
 }
 function parseVersion(version) {
-  return version.replace(/^v/, "").split(".").map((n) => parseInt(n, 10) || 0);
+  const cleaned = version.replace(/^v/, "").replace(/[-+].*$/, "");
+  return cleaned.split(".").map((n) => parseInt(n, 10) || 0);
+}
+function isPreRelease(version) {
+  return /[-]/.test(version.replace(/^v/, ""));
 }
 function isNewerVersion(latest, current) {
+  if (isPreRelease(latest)) return false;
   const latestParts = parseVersion(latest);
   const currentParts = parseVersion(current);
   for (let i = 0; i < Math.max(latestParts.length, currentParts.length); i++) {
@@ -15190,10 +15283,15 @@ async function checkForUpdates() {
 }
 function formatUpdateMessage(latestVersion, currentVersion) {
   const versionText = `${currentVersion} \u2192 ${latestVersion}`;
-  return `\x1B[33m  \u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E
-  \u2502  Update available: ${versionText.padEnd(25)} \u2502
-  \u2502  Run \x1B[36mnpm i -g ${CLI_NAME}\x1B[33m to update       \u2502
-  \u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F\x1B[0m`;
+  const updateCmd = `npm i -g ${CLI_NAME}`;
+  const line1Content = `  Update available: ${versionText}  `;
+  const line2Content = `  Run ${updateCmd} to update  `;
+  const innerWidth = Math.max(line1Content.length, line2Content.length);
+  const border = "\u2500".repeat(innerWidth);
+  return `\x1B[33m  \u256D${border}\u256E
+  \u2502${line1Content.padEnd(innerWidth)}\u2502
+  \u2502  Run \x1B[36m${updateCmd}\x1B[33m to update${" ".repeat(innerWidth - line2Content.length)}  \u2502
+  \u2570${border}\u256F\x1B[0m`;
 }
 
 // src/cli/commands/grade.ts
@@ -15201,6 +15299,7 @@ init_esm_shims();
 init_logger();
 init_grader();
 init_path_resolver();
+import * as path12 from "path";
 import fs9 from "fs-extra";
 
 // src/cli/tui/grade-tui.ts
@@ -15499,7 +15598,7 @@ async function launchGradeTui(components3, summary) {
   process.stdin.setRawMode(true);
   hideCursor();
   render(state);
-  return new Promise((resolve8) => {
+  return new Promise((resolve10) => {
     const handleKeypress = (str, key) => {
       if (!key) return;
       if (state.isSearching) {
@@ -15522,7 +15621,7 @@ async function launchGradeTui(components3, summary) {
         showCursor();
         clearScreen();
         process.stdin.setRawMode(false);
-        resolve8();
+        resolve10();
         return;
       }
       if (state.viewMode === "detail") {
@@ -15674,6 +15773,7 @@ async function grade(target, options) {
     if (options.format === "json") {
       const output = { summary, components: filteredResults };
       if (options.output) {
+        await fs9.ensureDir(path12.dirname(path12.resolve(options.output)));
         await fs9.writeJson(options.output, output, { spaces: 2 });
         logger.success(`Results written to ${options.output}`);
       } else {
@@ -15682,6 +15782,7 @@ async function grade(target, options) {
     } else if (options.format === "csv") {
       const csvContent = generateCsvReport(filteredResults, summary);
       if (options.output) {
+        await fs9.ensureDir(path12.dirname(path12.resolve(options.output)));
         await fs9.writeFile(options.output, csvContent);
         logger.success(`CSV report written to ${options.output}`);
       } else {
@@ -15728,11 +15829,19 @@ function filterResults(results, filter) {
   if (filter.startsWith("score:")) {
     const condition = filter.substring(6);
     if (condition.startsWith("<")) {
-      const val = parseInt(condition.substring(1));
+      const val = parseInt(condition.substring(1), 10);
+      if (isNaN(val)) {
+        logger.warn(`Invalid score filter value: "${condition.substring(1)}". Expected a number.`);
+        return results;
+      }
       return results.filter((r) => r.overallScore < val);
     }
     if (condition.startsWith(">")) {
-      const val = parseInt(condition.substring(1));
+      const val = parseInt(condition.substring(1), 10);
+      if (isNaN(val)) {
+        logger.warn(`Invalid score filter value: "${condition.substring(1)}". Expected a number.`);
+        return results;
+      }
       return results.filter((r) => r.overallScore > val);
     }
   }
@@ -15828,7 +15937,7 @@ function generateCsvReport(results, summary) {
 init_esm_shims();
 init_logger();
 import fs12 from "fs-extra";
-import * as path14 from "path";
+import * as path15 from "path";
 
 // src/dependency-graph/analyzer.ts
 init_esm_shims();
@@ -15838,7 +15947,7 @@ init_logger();
 init_esm_shims();
 init_logger();
 import fs10 from "fs-extra";
-import * as path12 from "path";
+import * as path13 from "path";
 import * as htmlparser23 from "htmlparser2";
 import { DomHandler as DomHandler3 } from "domhandler";
 function extractMarkupDependencies(markup, includeBaseComponents) {
@@ -16016,7 +16125,7 @@ async function analyzeAuraComponent(bundlePath, includeBaseComponents = false) {
       logger.debug(`Not a directory: ${bundlePath}`);
       return null;
     }
-    const componentName = path12.basename(bundlePath);
+    const componentName = path13.basename(bundlePath);
     const files = await fs10.readdir(bundlePath);
     const cmpFile = files.find((f) => f.endsWith(".cmp"));
     if (!cmpFile) {
@@ -16026,18 +16135,18 @@ async function analyzeAuraComponent(bundlePath, includeBaseComponents = false) {
     const context = {
       markup: ""
     };
-    context.markup = await fs10.readFile(path12.join(bundlePath, cmpFile), "utf-8");
+    context.markup = await fs10.readFile(path13.join(bundlePath, cmpFile), "utf-8");
     const controllerFile = files.find((f) => f.endsWith("Controller.js"));
     if (controllerFile) {
       context.controllerJs = await fs10.readFile(
-        path12.join(bundlePath, controllerFile),
+        path13.join(bundlePath, controllerFile),
         "utf-8"
       );
     }
     const helperFile = files.find((f) => f.endsWith("Helper.js"));
     if (helperFile) {
       context.helperJs = await fs10.readFile(
-        path12.join(bundlePath, helperFile),
+        path13.join(bundlePath, helperFile),
         "utf-8"
       );
     }
@@ -16062,13 +16171,13 @@ async function analyzeAuraComponent(bundlePath, includeBaseComponents = false) {
   }
 }
 async function getPackageDirectories(rootPath) {
-  const sfdxProjectPath = path12.join(rootPath, "sfdx-project.json");
+  const sfdxProjectPath = path13.join(rootPath, "sfdx-project.json");
   if (await fs10.pathExists(sfdxProjectPath)) {
     try {
       const projectConfig = await fs10.readJson(sfdxProjectPath);
       if (projectConfig.packageDirectories && Array.isArray(projectConfig.packageDirectories)) {
         return projectConfig.packageDirectories.map(
-          (pkg) => path12.join(rootPath, pkg.path)
+          (pkg) => path13.join(rootPath, pkg.path)
         );
       }
     } catch (error) {
@@ -16085,7 +16194,7 @@ async function findAuraDirectories(basePath) {
       const entries = await fs10.readdir(dirPath, { withFileTypes: true });
       for (const entry of entries) {
         if (entry.isDirectory()) {
-          const fullPath = path12.join(dirPath, entry.name);
+          const fullPath = path13.join(dirPath, entry.name);
           if (entry.name === "aura") {
             auraDirectories.push(fullPath);
           } else if (!entry.name.startsWith(".") && entry.name !== "node_modules") {
@@ -16111,9 +16220,9 @@ async function scanAuraComponents(rootPath, includeBaseComponents = false) {
     logger.debug(`Found aura directories from sfdx-project.json: ${searchPaths.join(", ")}`);
   }
   const fallbackPaths = [
-    path12.join(rootPath, "force-app/main/default/aura"),
-    path12.join(rootPath, "src/aura"),
-    path12.join(rootPath, "aura")
+    path13.join(rootPath, "force-app/main/default/aura"),
+    path13.join(rootPath, "src/aura"),
+    path13.join(rootPath, "aura")
   ];
   for (const fallback of fallbackPaths) {
     if (!searchPaths.includes(fallback)) {
@@ -16142,7 +16251,7 @@ async function scanAuraComponents(rootPath, includeBaseComponents = false) {
           }
         } else {
           for (const item of files) {
-            const itemPath = path12.join(searchPath, item);
+            const itemPath = path13.join(searchPath, item);
             const itemStat = await fs10.stat(itemPath);
             if (itemStat.isDirectory()) {
               const result = await analyzeAuraComponent(itemPath, includeBaseComponents);
@@ -16167,7 +16276,7 @@ async function scanAuraComponents(rootPath, includeBaseComponents = false) {
 init_esm_shims();
 init_logger();
 import fs11 from "fs-extra";
-import * as path13 from "path";
+import * as path14 from "path";
 import * as htmlparser24 from "htmlparser2";
 import { DomHandler as DomHandler4 } from "domhandler";
 function extractVfDependencies(markup) {
@@ -16355,7 +16464,7 @@ async function analyzeVfPage(pagePath) {
           const files = await fs11.readdir(pagePath);
           const pageFile = files.find((f) => f.endsWith(".page"));
           if (pageFile) {
-            actualPath = path13.join(pagePath, pageFile);
+            actualPath = path14.join(pagePath, pageFile);
           } else {
             return null;
           }
@@ -16367,7 +16476,7 @@ async function analyzeVfPage(pagePath) {
       return null;
     }
     const markup = await fs11.readFile(actualPath, "utf-8");
-    const pageName = path13.basename(actualPath, ".page");
+    const pageName = path14.basename(actualPath, ".page");
     const dependencies = extractVfDependencies(markup);
     return {
       id: `vf:${pageName}`,
@@ -16391,7 +16500,7 @@ async function analyzeVfComponent(componentPath) {
           const files = await fs11.readdir(componentPath);
           const componentFile = files.find((f) => f.endsWith(".component"));
           if (componentFile) {
-            actualPath = path13.join(componentPath, componentFile);
+            actualPath = path14.join(componentPath, componentFile);
           } else {
             return null;
           }
@@ -16403,7 +16512,7 @@ async function analyzeVfComponent(componentPath) {
       return null;
     }
     const markup = await fs11.readFile(actualPath, "utf-8");
-    const componentName = path13.basename(actualPath, ".component");
+    const componentName = path14.basename(actualPath, ".component");
     const dependencies = extractVfDependencies(markup);
     return {
       id: `vf:${componentName}`,
@@ -16418,13 +16527,13 @@ async function analyzeVfComponent(componentPath) {
   }
 }
 async function getPackageDirectories2(rootPath) {
-  const sfdxProjectPath = path13.join(rootPath, "sfdx-project.json");
+  const sfdxProjectPath = path14.join(rootPath, "sfdx-project.json");
   if (await fs11.pathExists(sfdxProjectPath)) {
     try {
       const projectConfig = await fs11.readJson(sfdxProjectPath);
       if (projectConfig.packageDirectories && Array.isArray(projectConfig.packageDirectories)) {
         return projectConfig.packageDirectories.map(
-          (pkg) => path13.join(rootPath, pkg.path)
+          (pkg) => path14.join(rootPath, pkg.path)
         );
       }
     } catch (error) {
@@ -16442,7 +16551,7 @@ async function findVfDirectories(basePath) {
       const entries = await fs11.readdir(dirPath, { withFileTypes: true });
       for (const entry of entries) {
         if (entry.isDirectory()) {
-          const fullPath = path13.join(dirPath, entry.name);
+          const fullPath = path14.join(dirPath, entry.name);
           if (entry.name === "pages") {
             pagesDirectories.push(fullPath);
           } else if (entry.name === "components") {
@@ -16473,9 +16582,9 @@ async function scanVfPages(rootPath) {
     logger.debug(`Found components directories from sfdx-project.json: ${componentSearchPaths.join(", ")}`);
   }
   const fallbackPagePaths = [
-    path13.join(rootPath, "force-app/main/default/pages"),
-    path13.join(rootPath, "src/pages"),
-    path13.join(rootPath, "pages")
+    path14.join(rootPath, "force-app/main/default/pages"),
+    path14.join(rootPath, "src/pages"),
+    path14.join(rootPath, "pages")
   ];
   for (const fallback of fallbackPagePaths) {
     if (!pageSearchPaths.includes(fallback)) {
@@ -16483,9 +16592,9 @@ async function scanVfPages(rootPath) {
     }
   }
   const fallbackComponentPaths = [
-    path13.join(rootPath, "force-app/main/default/components"),
-    path13.join(rootPath, "src/components"),
-    path13.join(rootPath, "components")
+    path14.join(rootPath, "force-app/main/default/components"),
+    path14.join(rootPath, "src/components"),
+    path14.join(rootPath, "components")
   ];
   for (const fallback of fallbackComponentPaths) {
     if (!componentSearchPaths.includes(fallback)) {
@@ -16522,7 +16631,7 @@ async function scanVfPages(rootPath) {
         const files = await fs11.readdir(searchPath);
         for (const file of files) {
           if (file.endsWith(".page")) {
-            const result = await analyzeVfPage(path13.join(searchPath, file));
+            const result = await analyzeVfPage(path14.join(searchPath, file));
             if (result) {
               results.push(result);
             }
@@ -16543,7 +16652,7 @@ async function scanVfPages(rootPath) {
         const files = await fs11.readdir(searchPath);
         for (const file of files) {
           if (file.endsWith(".component")) {
-            const result = await analyzeVfComponent(path13.join(searchPath, file));
+            const result = await analyzeVfComponent(path14.join(searchPath, file));
             if (result) {
               results.push(result);
             }
@@ -17550,7 +17659,7 @@ function formatSimpleMermaidOutput(graph, maxNodes = 30) {
 // src/cli/commands/deps.ts
 async function analyzeDeps(target, options) {
   logger.setVerbose(options.verbose);
-  const targetPath = target ? path14.resolve(target) : process.cwd();
+  const targetPath = target ? path15.resolve(target) : process.cwd();
   logger.banner();
   logger.header("Dependency Graph Analysis");
   logger.info(`Analyzing: ${targetPath}`);
@@ -17600,14 +17709,6 @@ async function analyzeDeps(target, options) {
           console.log(output);
         }
         break;
-      case "html":
-        logger.warn("HTML format not yet implemented. Using console output.");
-        formatConsoleOutput(graph, conversionOrder, options.showOrphans);
-        break;
-      case "dot":
-        logger.warn("DOT format not yet implemented. Using console output.");
-        formatConsoleOutput(graph, conversionOrder, options.showOrphans);
-        break;
       case "console":
       default:
         formatConsoleOutput(graph, conversionOrder, options.showOrphans);
@@ -17626,8 +17727,8 @@ async function analyzeDeps(target, options) {
   }
 }
 async function writeOutput(filePath, content) {
-  const outputPath = path14.resolve(filePath);
-  const outputDir = path14.dirname(outputPath);
+  const outputPath = path15.resolve(filePath);
+  const outputDir = path15.dirname(outputPath);
   await fs12.ensureDir(outputDir);
   await fs12.writeFile(outputPath, content, "utf-8");
 }
@@ -17645,7 +17746,7 @@ program.name(CLI_NAME).description(CLI_DESCRIPTION).version(CLI_VERSION).hook("p
   } catch {
   }
 });
-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", DEFAULT_OUTPUT_DIR).option("--open", "Open output folder in file explorer after conversion", false).option("--preview", "Generate and open HTML preview of converted component", false).option("--dry-run", "Preview conversion without writing files", false).option("--verbose", "Show detailed conversion logs", false).action(async (bundlePath, options) => {
+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", DEFAULT_OUTPUT_DIR).option("--api-version <version>", "Salesforce API version for meta.xml", DEFAULT_API_VERSION).option("--open", "Open output folder in file explorer after conversion", false).option("--preview", "Generate and open HTML preview of converted component", false).option("--dry-run", "Preview conversion without writing files", false).option("--verbose", "Show detailed conversion logs", false).action(async (bundlePath, options) => {
   logger.setVerbose(options.verbose);
   await convertAura(bundlePath, {
     output: options.output,
@@ -17653,10 +17754,11 @@ program.command("aura <path>").description("Convert an Aura component bundle to
     dryRun: options.dryRun,
     verbose: options.verbose,
     open: options.open,
-    preview: options.preview
+    preview: options.preview,
+    apiVersion: options.apiVersion
   });
 });
-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", DEFAULT_OUTPUT_DIR).option("--controller <path>", "Include Apex controller file for analysis").option("--open", "Open output folder in file explorer after conversion", false).option("--preview", "Generate and open HTML preview of converted component", false).option("--dry-run", "Preview conversion without writing files", false).option("--verbose", "Show detailed conversion logs", false).action(async (pagePath, options) => {
+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", DEFAULT_OUTPUT_DIR).option("--api-version <version>", "Salesforce API version for meta.xml", DEFAULT_API_VERSION).option("--controller <path>", "Include Apex controller file for analysis").option("--open", "Open output folder in file explorer after conversion", false).option("--preview", "Generate and open HTML preview of converted component", false).option("--dry-run", "Preview conversion without writing files", false).option("--verbose", "Show detailed conversion logs", false).action(async (pagePath, options) => {
   logger.setVerbose(options.verbose);
   await convertVf(pagePath, {
     output: options.output,
@@ -17665,7 +17767,8 @@ program.command("vf <path>").description("Convert a Visualforce page to LWC").op
     verbose: options.verbose,
     controller: options.controller,
     open: options.open,
-    preview: options.preview
+    preview: options.preview,
+    apiVersion: options.apiVersion
   });
 });
 program.command("grade [target]").description("Assess conversion complexity of components").option("-t, --type <type>", "Component type (aura, vf, both)", "both").option("-o, --output <file>", "Output file for report").option("--format <format>", "Output format (json, csv, console)", "console").option("--detailed", "Show detailed breakdown", false).option("--sort-by <field>", "Sort by (score, complexity, name)").option("--filter <filter>", 'Filter results (e.g., "grade:D,F")').option("--dry-run", "Run without writing files", false).option("--verbose", "Show detailed logs", false).action(async (target, options) => {