@salesforce/vite-plugin-webapp-experimental 1.81.0 → 1.82.0

package/dist/babel/reactDesignTimeLocatorBabelPlugin.d.ts

@@ -19,7 +19,7 @@
 declare const reactDesignTimeLocatorBabelPlugin: (api: object, options: Record<string, any> | null | undefined, dirname: string) => {
     name: string;
     visitor: {
-        JSXElement(this: import("@babel/core").PluginPass, path: any, state: any): void;
+        JSXElement(this: import('@babel/core').PluginPass, path: any, state: any): void;
     };
 };
 export default reactDesignTimeLocatorBabelPlugin;

package/dist/index.d.ts

@@ -1,9 +1,4 @@
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
-import type { Plugin } from "vite";
+import { Plugin } from 'vite';
 export interface PluginOptions {
     /** Salesforce org alias */
     orgAlias?: string;

package/dist/index.js

@@ -1,203 +1,312 @@
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
 import { loadManifest, getOrgInfo } from "@salesforce/webapp-experimental/app";
 import { getDesignModeScriptContent } from "@salesforce/webapp-experimental/design";
 import { createProxyHandler, injectLivePreviewScript } from "@salesforce/webapp-experimental/proxy";
-import reactDesignTimeLocatorBabelPlugin from "./babel/reactDesignTimeLocatorBabelPlugin.js";
-import { getBasePath, getCodeBuilderBasePath, getPort, getDevServerTarget, DEFAULT_API_VERSION, DEFAULT_PORT, } from "./utils.js";
+import { declare } from "@babel/helper-plugin-utils";
+import { readdirSync } from "node:fs";
+import { basename } from "node:path";
+const reactDesignTimeLocatorBabelPlugin = declare((api) => {
+  api.assertVersion(7);
+  const t = api.types;
+  function isReactFragmentName(nameNode) {
+    if (t.isJSXIdentifier(nameNode) && nameNode.name === "Fragment") return true;
+    if (t.isJSXMemberExpression(nameNode) && t.isJSXIdentifier(nameNode.object, { name: "React" }) && t.isJSXIdentifier(nameNode.property, { name: "Fragment" })) {
+      return true;
+    }
+    return false;
+  }
+  function hasAttr(openingElement, name) {
+    return openingElement.attributes.some((attr) => {
+      return t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === name;
+    });
+  }
+  function addAttr(openingElement, name, value) {
+    if (hasAttr(openingElement, name)) return;
+    openingElement.attributes.push(
+      t.jsxAttribute(t.jsxIdentifier(name), t.stringLiteral(String(value)))
+    );
+  }
+  return {
+    name: "babel-plugin-react-design-time-locator",
+    visitor: {
+      JSXElement(path, state) {
+        const openingElement = path.node.openingElement;
+        if (isReactFragmentName(openingElement.name)) return;
+        if (!t.isJSXIdentifier(openingElement.name) && !t.isJSXMemberExpression(openingElement.name)) {
+          return;
+        }
+        let tagHead = "";
+        if (t.isJSXIdentifier(openingElement.name)) {
+          tagHead = openingElement.name.name;
+        } else if (t.isJSXMemberExpression(openingElement.name)) {
+          tagHead = openingElement.name.property?.name ?? "";
+        }
+        if (!tagHead) return;
+        const filename = state?.file?.opts?.filename;
+        if (!filename || filename.includes("node_modules")) return;
+        const excludePaths = state.opts?.excludePaths ?? [];
+        if (excludePaths.some((p) => filename.includes(p))) return;
+        const children = path.node.children ?? [];
+        const relevantChildren = children.filter((child) => {
+          return !(t.isJSXText(child) && child.value.trim() === "");
+        });
+        let textType = "none";
+        if (relevantChildren.length === 1) {
+          const child = relevantChildren[0];
+          if (t.isJSXText(child)) {
+            textType = "static";
+          } else if (t.isJSXExpressionContainer(child)) {
+            textType = "dynamic";
+          } else {
+            textType = "element";
+          }
+        } else if (relevantChildren.length > 1) {
+          textType = "mixed";
+        }
+        const loc = path.node.loc;
+        if (loc?.start) {
+          const source = `${filename}:${loc.start.line}:${loc.start.column}`;
+          addAttr(openingElement, "data-source-file", source);
+        }
+        addAttr(openingElement, "data-text-type", textType);
+      }
+    }
+  };
+});
+const DEFAULT_PORT = 5173;
+const DEFAULT_API_VERSION = "65.0";
+const DEFAULT_NAMESPACE = "c";
+function getAppName(rootPath) {
+  try {
+    const files = readdirSync(rootPath);
+    const metaFile = files.find((f) => f.endsWith(".webapplication-meta.xml"));
+    if (metaFile) {
+      return metaFile.replace(".webapplication-meta.xml", "");
+    }
+  } catch {
+  }
+  return basename(rootPath);
+}
+function getNamespace() {
+  return DEFAULT_NAMESPACE;
+}
+function buildProdBasePath(namespace, appName) {
+  return `/lwr/application/ai/${namespace}-${appName}`;
+}
+function getCodeBuilderBasePath(proxyUri, port) {
+  try {
+    const url = new URL(proxyUri.replace("{{port}}", port.toString()));
+    return url.pathname;
+  } catch (error) {
+    console.error("Failed to parse CODE_BUILDER_FRAMEWORK_PROXY_URI:", error);
+    return `/absproxy/${port}`;
+  }
+}
+function getBasePath(mode, codeBuilderProxyUrl2, port, rootPath) {
+  const isProd = mode === "production";
+  if (isProd) {
+    const appName = getAppName(rootPath);
+    const namespace = getNamespace();
+    return buildProdBasePath(namespace, appName);
+  }
+  if (!codeBuilderProxyUrl2) {
+    return "";
+  }
+  return getCodeBuilderBasePath(codeBuilderProxyUrl2, port);
+}
+function getDevServerTarget(codeBuilderProxyUrl2, port) {
+  if (codeBuilderProxyUrl2) {
+    return getCodeBuilderBasePath(codeBuilderProxyUrl2, port);
+  }
+  return `http://localhost:${port}`;
+}
+function getPort() {
+  return parseInt(process.env.SF_WEBAPP_PORT || DEFAULT_PORT.toString(), 10);
+}
 const codeBuilderProxyUrl = process.env.CODE_BUILDER_FRAMEWORK_PROXY_URI;
-export default function webappsPlugin(options = {}) {
-    const proxyOptions = {
-        debug: options.debug ?? false,
-    };
-    let orgInfo;
-    let manifest;
-    let proxyHandler;
-    // Allow tests or callers to force design mode without needing to run the `config` hook.
-    let designModeEnabled = options.designMode ?? false;
-    const corePlugin = {
-        name: "@salesforce/vite-plugin-webapp-experimental:core",
-        enforce: "pre",
-        async config(config, env) {
-            const rootPath = config.root ?? process.cwd();
-            // Note: At this stage we may not have the correct manifest path yet,
-            // so we only load the org info to get the API version
-            let version = DEFAULT_API_VERSION;
-            try {
-                orgInfo = await getOrgInfo(options.orgAlias);
-                version = orgInfo?.apiVersion || DEFAULT_API_VERSION;
-                if (options.debug) {
-                    console.log(`[webapps-plugin] Using Salesforce API version: ${version}`);
-                }
-            }
-            catch {
-                version = DEFAULT_API_VERSION;
-            }
-            const isCodeBuilder = !!codeBuilderProxyUrl;
-            const define = {
-                __SF_API_VERSION__: JSON.stringify(version),
-                __SF_SERVER_BASE_PATH__: JSON.stringify(""),
-            };
-            if (isCodeBuilder && env.mode !== "production") {
-                const basePath = getCodeBuilderBasePath(codeBuilderProxyUrl, getPort());
-                define["__SF_SERVER_BASE_PATH__"] = JSON.stringify(basePath);
-            }
-            return {
-                define,
-                base: getBasePath(env.mode, codeBuilderProxyUrl, getPort(), rootPath),
-                server: {
-                    port: getPort(),
-                    // Code Builder specific configuration
-                    ...(isCodeBuilder && {
-                        allowedHosts: true,
-                        strictPort: true,
-                    }),
-                },
-            };
-        },
-        async configResolved(config) {
-            try {
-                const rootPath = config.root ?? process.cwd();
-                manifest = await loadManifest(`${rootPath}/webapplication.json`);
-                const target = getDevServerTarget(codeBuilderProxyUrl, config.server.port ?? DEFAULT_PORT);
-                const basePath = getBasePath(config.mode, codeBuilderProxyUrl, getPort(), rootPath);
-                proxyHandler = createProxyHandler(manifest, orgInfo, target, basePath, proxyOptions);
-            }
-            catch (error) {
-                console.error(`[webapps-plugin] Initialization failed:`, error);
-            }
-        },
-        configureServer(server) {
-            // Must run BEFORE Vite's internal middlewares (hence not returning a post-hook function)
-            server.middlewares.use(async (req, res, next) => {
-                if (proxyHandler) {
-                    try {
-                        await proxyHandler(req, res, next);
-                    }
-                    catch (error) {
-                        console.error("[webapps-plugin] Proxy handler error:", error);
-                        next();
-                    }
-                }
-                else {
-                    if (req.url?.startsWith("/services")) {
-                        res.writeHead(503, { "Content-Type": "application/json" });
-                        res.end(JSON.stringify({
-                            error: "SERVICE_UNAVAILABLE",
-                            message: "Proxy not initialized.",
-                        }));
-                        return;
-                    }
-                    next();
-                }
-            });
-        },
-        async handleHotUpdate({ file, server }) {
-            if (file.endsWith("webapplication.json")) {
-                const updatedManifest = await loadManifest(file);
-                if (updatedManifest) {
-                    manifest = updatedManifest;
-                    const rootPath = server.config.root ?? process.cwd();
-                    const target = getDevServerTarget(codeBuilderProxyUrl, server.config.server.port ?? DEFAULT_PORT);
-                    const basePath = getBasePath(server.config.mode, codeBuilderProxyUrl, getPort(), rootPath);
-                    proxyHandler = createProxyHandler(manifest, orgInfo, target, basePath, proxyOptions);
-                    server.ws.send({
-                        type: "full-reload",
-                        path: "*",
-                    });
-                }
-            }
-        },
-    };
-    const designPlugin = {
-        name: "@salesforce/vite-plugin-webapp-experimental:design",
-        enforce: "pre",
-        config(_config, env) {
-            designModeEnabled = options.designMode ?? env.mode === "design";
-        },
-        configureServer(server) {
-            // Intercepts design-mode script requests before the core proxy middleware.
-            server.middlewares.use(async (req, res, next) => {
-                if (!designModeEnabled) {
-                    next();
-                    return;
-                }
-                const urlPath = stripUrlQuery(req.url);
-                if (urlPath === "/_sfdc/design-mode-interactions.js") {
-                    try {
-                        const script = getDesignModeScriptContent();
-                        if (script !== null) {
-                            res.setHeader("Content-Type", "application/javascript");
-                            res.setHeader("Cache-Control", "no-cache");
-                            res.end(script);
-                            return;
-                        }
-                        console.error(`[webapps-plugin] Design mode script not found. Run 'npm run build:design' in @salesforce/webapp-experimental.`);
-                        res.writeHead(404);
-                        res.end("Design mode script not found");
-                        return;
-                    }
-                    catch (error) {
-                        console.error("[webapps-plugin] Error serving design mode script:", error);
-                        res.writeHead(500);
-                        res.end("Error loading design mode script");
-                        return;
-                    }
-                }
-                next();
-            });
-        },
-        async transform(code, id) {
-            if (!designModeEnabled)
-                return null;
-            // Strip Vite query string (e.g. ?import, ?v=hash)
-            const filepath = id.split("?", 1)[0] ?? id;
-            // Best-effort: only handle React source files where JSX loc info matters.
-            const isTsx = filepath.endsWith(".tsx");
-            const isJsx = filepath.endsWith(".jsx");
-            if (!isTsx && !isJsx)
-                return null;
-            if (filepath.includes("node_modules"))
-                return null;
-            const excludePaths = options.designModeExcludePaths ?? ["/components/ui/"];
-            if (excludePaths.some((p) => filepath.includes(p)))
-                return null;
-            const { transformAsync } = await import("@babel/core");
-            const result = await transformAsync(code, {
-                filename: filepath,
-                babelrc: false,
-                configFile: false,
-                sourceMaps: true,
-                parserOpts: {
-                    sourceType: "module",
-                    plugins: isTsx ? ["jsx", "typescript"] : ["jsx"],
-                },
-                plugins: [[reactDesignTimeLocatorBabelPlugin, { excludePaths }]],
-            });
-            if (!result?.code)
-                return null;
-            return { code: result.code, map: result.map };
-        },
-        transformIndexHtml(html) {
-            // Inject Live Preview script (error handling, copy/paste, postMessage bridge)
-            html = injectLivePreviewScript(html);
-            if (designModeEnabled) {
-                const designScriptTag = '<script src="/_sfdc/design-mode-interactions.js"></script>';
-                return html.replace("</body>", `${designScriptTag}\n</body>`);
+function webappsPlugin(options = {}) {
+  const proxyOptions = {
+    debug: options.debug ?? false
+  };
+  let orgInfo;
+  let manifest;
+  let proxyHandler;
+  let designModeEnabled = options.designMode ?? false;
+  const corePlugin = {
+    name: "@salesforce/vite-plugin-webapp-experimental:core",
+    enforce: "pre",
+    async config(config, env) {
+      const rootPath = config.root ?? process.cwd();
+      let version = DEFAULT_API_VERSION;
+      try {
+        orgInfo = await getOrgInfo(options.orgAlias);
+        version = orgInfo?.apiVersion || DEFAULT_API_VERSION;
+        if (options.debug) {
+          console.log(`[webapps-plugin] Using Salesforce API version: ${version}`);
+        }
+      } catch {
+        version = DEFAULT_API_VERSION;
+      }
+      const isCodeBuilder = !!codeBuilderProxyUrl;
+      const define = {
+        __SF_API_VERSION__: JSON.stringify(version),
+        __SF_SERVER_BASE_PATH__: JSON.stringify("")
+      };
+      if (isCodeBuilder && env.mode !== "production") {
+        const basePath = getCodeBuilderBasePath(codeBuilderProxyUrl, getPort());
+        define["__SF_SERVER_BASE_PATH__"] = JSON.stringify(basePath);
+      }
+      return {
+        define,
+        base: getBasePath(env.mode, codeBuilderProxyUrl, getPort(), rootPath),
+        server: {
+          port: getPort(),
+          // Code Builder specific configuration
+          ...isCodeBuilder && {
+            allowedHosts: true,
+            strictPort: true
+          }
+        }
+      };
+    },
+    async configResolved(config) {
+      try {
+        const rootPath = config.root ?? process.cwd();
+        manifest = await loadManifest(`${rootPath}/webapplication.json`);
+        const target = getDevServerTarget(codeBuilderProxyUrl, config.server.port ?? DEFAULT_PORT);
+        const basePath = getBasePath(config.mode, codeBuilderProxyUrl, getPort(), rootPath);
+        proxyHandler = createProxyHandler(manifest, orgInfo, target, basePath, proxyOptions);
+      } catch (error) {
+        console.error(`[webapps-plugin] Initialization failed:`, error);
+      }
+    },
+    configureServer(server) {
+      server.middlewares.use(async (req, res, next) => {
+        if (proxyHandler) {
+          try {
+            await proxyHandler(req, res, next);
+          } catch (error) {
+            console.error("[webapps-plugin] Proxy handler error:", error);
+            next();
+          }
+        } else {
+          if (req.url?.startsWith("/services")) {
+            res.writeHead(503, { "Content-Type": "application/json" });
+            res.end(
+              JSON.stringify({
+                error: "SERVICE_UNAVAILABLE",
+                message: "Proxy not initialized."
+              })
+            );
+            return;
+          }
+          next();
+        }
+      });
+    },
+    async handleHotUpdate({ file, server }) {
+      if (file.endsWith("webapplication.json")) {
+        const updatedManifest = await loadManifest(file);
+        if (updatedManifest) {
+          manifest = updatedManifest;
+          const rootPath = server.config.root ?? process.cwd();
+          const target = getDevServerTarget(
+            codeBuilderProxyUrl,
+            server.config.server.port ?? DEFAULT_PORT
+          );
+          const basePath = getBasePath(
+            server.config.mode,
+            codeBuilderProxyUrl,
+            getPort(),
+            rootPath
+          );
+          proxyHandler = createProxyHandler(manifest, orgInfo, target, basePath, proxyOptions);
+          server.ws.send({
+            type: "full-reload",
+            path: "*"
+          });
+        }
+      }
+    }
+  };
+  const designPlugin = {
+    name: "@salesforce/vite-plugin-webapp-experimental:design",
+    enforce: "pre",
+    config(_config, env) {
+      designModeEnabled = options.designMode ?? env.mode === "design";
+    },
+    configureServer(server) {
+      server.middlewares.use(async (req, res, next) => {
+        if (!designModeEnabled) {
+          next();
+          return;
+        }
+        const urlPath = stripUrlQuery(req.url);
+        if (urlPath === "/_sfdc/design-mode-interactions.js") {
+          try {
+            const script = getDesignModeScriptContent();
+            if (script !== null) {
+              res.setHeader("Content-Type", "application/javascript");
+              res.setHeader("Cache-Control", "no-cache");
+              res.end(script);
+              return;
             }
-            return html;
+            console.error(
+              `[webapps-plugin] Design mode script not found. Run 'npm run build:design' in @salesforce/webapp-experimental.`
+            );
+            res.writeHead(404);
+            res.end("Design mode script not found");
+            return;
+          } catch (error) {
+            console.error("[webapps-plugin] Error serving design mode script:", error);
+            res.writeHead(500);
+            res.end("Error loading design mode script");
+            return;
+          }
+        }
+        next();
+      });
+    },
+    async transform(code, id) {
+      if (!designModeEnabled) return null;
+      const filepath = id.split("?", 1)[0] ?? id;
+      const isTsx = filepath.endsWith(".tsx");
+      const isJsx = filepath.endsWith(".jsx");
+      if (!isTsx && !isJsx) return null;
+      if (filepath.includes("node_modules")) return null;
+      const excludePaths = options.designModeExcludePaths ?? ["/components/ui/"];
+      if (excludePaths.some((p) => filepath.includes(p))) return null;
+      const { transformAsync } = await import("@babel/core");
+      const result = await transformAsync(code, {
+        filename: filepath,
+        babelrc: false,
+        configFile: false,
+        sourceMaps: true,
+        parserOpts: {
+          sourceType: "module",
+          plugins: isTsx ? ["jsx", "typescript"] : ["jsx"]
         },
-    };
-    // Design plugin is listed first so its middleware intercepts design-mode
-    // script requests before the core proxy middleware.
-    return [designPlugin, corePlugin];
+        plugins: [[reactDesignTimeLocatorBabelPlugin, { excludePaths }]]
+      });
+      if (!result?.code) return null;
+      return { code: result.code, map: result.map };
+    },
+    transformIndexHtml(html) {
+      html = injectLivePreviewScript(html);
+      if (designModeEnabled) {
+        const designScriptTag = '<script src="/_sfdc/design-mode-interactions.js"><\/script>';
+        return html.replace("</body>", `${designScriptTag}
+</body>`);
+      }
+      return html;
+    }
+  };
+  return [designPlugin, corePlugin];
 }
 function stripUrlQuery(url) {
-    if (!url)
-        return "";
-    const queryIndex = url.indexOf("?");
-    return queryIndex === -1 ? url : url.slice(0, queryIndex);
+  if (!url) return "";
+  const queryIndex = url.indexOf("?");
+  return queryIndex === -1 ? url : url.slice(0, queryIndex);
 }
+export {
+  webappsPlugin as default
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/vite-plugin-webapp-experimental",
   "description": "[experimental] Vite plugin for Salesforce Web Applications",
-  "version": "1.81.0",
+  "version": "1.82.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,9 +18,9 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc --build",
-    "clean": "rm -rf dist tsconfig.tsbuildinfo",
-    "dev": "tsc --build --watch",
+    "build": "vite build",
+    "clean": "rm -rf dist",
+    "dev": "vite build --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage"
@@ -28,12 +28,13 @@
   "dependencies": {
     "@babel/core": "^7.28.4",
     "@babel/helper-plugin-utils": "^7.28.3",
-    "@salesforce/webapp-experimental": "^1.81.0"
+    "@salesforce/webapp-experimental": "^1.82.0"
   },
   "devDependencies": {
     "@types/babel__core": "^7.20.5",
     "@types/babel__helper-plugin-utils": "^7.10.3",
     "vite": "^7.0.0",
+    "vite-plugin-dts": "^4.5.4",
     "vitest": "^4.0.6"
   },
   "peerDependencies": {

package/dist/babel/reactDesignTimeLocatorBabelPlugin.js

@@ -1,117 +0,0 @@
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
-/* eslint-disable @typescript-eslint/no-explicit-any */
-import { declare } from "@babel/helper-plugin-utils";
-/**
- * React design-time Babel plugin.
- *
- * Injects DOM-locating and text metadata attributes into HTML JSX elements at compile-time.
- *
- * Attributes injected (when location is available):
- * - data-source-file="<file_path>:<line>:<col>"
- *
- * Optional text metadata:
- * - data-text-type: none | static | dynamic | mixed | element
- *
- * NOTE: This is a Babel plugin. In this repo it's run via a Vite `transform` hook.
- */
-const reactDesignTimeLocatorBabelPlugin = declare((api) => {
-    api.assertVersion(7);
-    const t = api.types;
-    function isReactFragmentName(nameNode) {
-        // <Fragment> or <React.Fragment>
-        if (t.isJSXIdentifier(nameNode) && nameNode.name === "Fragment")
-            return true;
-        if (t.isJSXMemberExpression(nameNode) &&
-            t.isJSXIdentifier(nameNode.object, { name: "React" }) &&
-            t.isJSXIdentifier(nameNode.property, { name: "Fragment" })) {
-            return true;
-        }
-        return false;
-    }
-    function hasAttr(openingElement, name) {
-        return openingElement.attributes.some((attr) => {
-            return t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === name;
-        });
-    }
-    function addAttr(openingElement, name, value) {
-        if (hasAttr(openingElement, name))
-            return;
-        openingElement.attributes.push(t.jsxAttribute(t.jsxIdentifier(name), t.stringLiteral(String(value))));
-    }
-    return {
-        name: "babel-plugin-react-design-time-locator",
-        visitor: {
-            JSXElement(path, state) {
-                const openingElement = path.node.openingElement;
-                // Ignore fragments (they don't render a DOM node).
-                if (isReactFragmentName(openingElement.name))
-                    return;
-                // Only support common JSX name node types:
-                // - <div> (JSXIdentifier)
-                // - <Button> (JSXIdentifier)
-                // - <React.Suspense> / <Mui.Button> (JSXMemberExpression)
-                if (!t.isJSXIdentifier(openingElement.name) &&
-                    !t.isJSXMemberExpression(openingElement.name)) {
-                    return;
-                }
-                // Decide whether this is a native DOM element or a component usage.
-                // We tag BOTH:
-                // - DOM elements are tagged directly (always works)
-                // - Components are tagged via props (works when the component forwards props, e.g. many MUI components)
-                let tagHead = "";
-                if (t.isJSXIdentifier(openingElement.name)) {
-                    tagHead = openingElement.name.name;
-                }
-                else if (t.isJSXMemberExpression(openingElement.name)) {
-                    // Member expressions are always components in React (e.g. <Foo.Bar>)
-                    tagHead = openingElement.name.property?.name ?? "";
-                }
-                if (!tagHead)
-                    return;
-                const filename = state?.file?.opts?.filename;
-                if (!filename || filename.includes("node_modules"))
-                    return;
-                // Skip files matching excludePaths (e.g. shadcn components/ui/) so their
-                // internal elements don't get data-source-file. The root element still
-                // receives it from the usage site via props spread.
-                const excludePaths = state.opts?.excludePaths ?? [];
-                if (excludePaths.some((p) => filename.includes(p)))
-                    return;
-                // Analyze children for text metadata
-                const children = path.node.children ?? [];
-                const relevantChildren = children.filter((child) => {
-                    return !(t.isJSXText(child) && child.value.trim() === "");
-                });
-                let textType = "none"; // none | static | dynamic | mixed | element
-                if (relevantChildren.length === 1) {
-                    const child = relevantChildren[0];
-                    if (t.isJSXText(child)) {
-                        textType = "static";
-                    }
-                    else if (t.isJSXExpressionContainer(child)) {
-                        textType = "dynamic";
-                    }
-                    else {
-                        textType = "element";
-                    }
-                }
-                else if (relevantChildren.length > 1) {
-                    textType = "mixed";
-                }
-                // Inject location info (best-effort)
-                const loc = path.node.loc;
-                if (loc?.start) {
-                    const source = `${filename}:${loc.start.line}:${loc.start.column}`;
-                    addAttr(openingElement, "data-source-file", source);
-                }
-                // Inject text metadata
-                addAttr(openingElement, "data-text-type", textType);
-            },
-        },
-    };
-});
-export default reactDesignTimeLocatorBabelPlugin;

package/dist/utils.js

@@ -1,106 +0,0 @@
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
-import { readdirSync } from "node:fs";
-import { basename } from "node:path";
-export const DEFAULT_PORT = 5173;
-export const DEFAULT_API_VERSION = "65.0";
-export const DEFAULT_NAMESPACE = "c";
-/**
- * Get the app name from a *.webapplication-meta.xml file in the root path.
- * Falls back to the directory name if no matching file is found.
- *
- * @param rootPath - The root directory to search for the webapplication-meta.xml file
- * @returns The app name
- */
-export function getAppName(rootPath) {
-    try {
-        const files = readdirSync(rootPath);
-        const metaFile = files.find((f) => f.endsWith(".webapplication-meta.xml"));
-        if (metaFile) {
-            // Extract name from "myapp.webapplication-meta.xml" -> "myapp"
-            return metaFile.replace(".webapplication-meta.xml", "");
-        }
-    }
-    catch {
-        // Fall through to directory name
-    }
-    return basename(rootPath);
-}
-/**
- * Get the namespace for the app.
- * Currently returns the default namespace ("c") since rootPath points to the
- * webapp directory (where vite.config lives), not the sfdx project root.
- *
- * @returns The namespace (currently always "c")
- */
-export function getNamespace() {
-    // TODO: In the future, we could traverse up from rootPath to find sfdx-project.json
-    return DEFAULT_NAMESPACE;
-}
-/**
- * Build the production base path from namespace and app name.
- *
- * @param namespace - The Salesforce namespace (e.g., "c")
- * @param appName - The app name (e.g., "myapp")
- * @returns The production base path (e.g., "/lwr/application/ai/c-myapp")
- */
-export function buildProdBasePath(namespace, appName) {
-    return `/lwr/application/ai/${namespace}-${appName}`;
-}
-/**
- * Calculate the code builder base path from the proxy URI (CODE_BUILDER_FRAMEWORK_PROXY_URI) and dev server port
- * @param proxyUri - The full proxy URI (e.g., https://name.iad.001.sf.code-builder.platform.salesforce.com/absproxy/{{port}})
- * @param port - The port number to replace {{port}} with (e.g., "5173")
- * @returns The parsed path with port (e.g., /absproxy/5173/)
- */
-export function getCodeBuilderBasePath(proxyUri, port) {
-    try {
-        const url = new URL(proxyUri.replace("{{port}}", port.toString()));
-        return url.pathname;
-    }
-    catch (error) {
-        console.error("Failed to parse CODE_BUILDER_FRAMEWORK_PROXY_URI:", error);
-        return `/absproxy/${port}`; // Default code builder proxy path
-    }
-}
-/**
- * Get the base path for the webapp based on mode and environment.
- *
- * For production mode, resolves the app name and namespace from the rootPath
- * and returns a path like "/lwr/application/ai/{namespace}-{appName}".
- *
- * For development mode with Code Builder, returns the proxy path.
- * For local development, returns an empty string.
- *
- * @param mode - The Vite mode ("production", "development", etc.)
- * @param codeBuilderProxyUrl - The Code Builder proxy URL (if running in Code Builder)
- * @param port - The dev server port
- * @param rootPath - The project root path (used to resolve app name and namespace)
- * @returns The base path
- */
-export function getBasePath(mode, codeBuilderProxyUrl, port, rootPath) {
-    const isProd = mode === "production";
-    if (isProd) {
-        const appName = getAppName(rootPath);
-        const namespace = getNamespace();
-        return buildProdBasePath(namespace, appName);
-    }
-    // Development mode
-    if (!codeBuilderProxyUrl) {
-        return "";
-    }
-    // A4V / Code Builder: extract path from proxy URI and include port
-    return getCodeBuilderBasePath(codeBuilderProxyUrl, port);
-}
-export function getDevServerTarget(codeBuilderProxyUrl, port) {
-    if (codeBuilderProxyUrl) {
-        return getCodeBuilderBasePath(codeBuilderProxyUrl, port);
-    }
-    return `http://localhost:${port}`;
-}
-export function getPort() {
-    return parseInt(process.env.SF_WEBAPP_PORT || DEFAULT_PORT.toString(), 10);
-}