@salesforce/vite-plugin-ui-bundle 11.55.1 → 11.56.0

package/README.md

@@ -1,3 +1,52 @@
 # @salesforce/vite-plugin-ui-bundle
 
 Vite plugin for Salesforce UI Bundles
+
+## Entry points
+
+This package ships two plugins from one versioned artifact:
+
+| Import                                   | Use for                                                                                                     | basePath / language                                                           |
+| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
+| `@salesforce/vite-plugin-ui-bundle`      | **the default** — every bundle, unless something below applies                                              | `basePath` always `/`; no language folding                                    |
+| `@salesforce/vite-plugin-ui-bundle/site` | site bundles that need site-specific local-dev handling (today: the language-switcher feature is installed) | per-request `basePath = /<lang>` + `SFDC_ENV.language`, driven by `languages` |
+
+Most bundles use the generic import. The language-switcher feature's setup swaps
+a bundle to `./site` and passes its `LANGUAGES`; you rarely edit this by hand.
+
+```ts
+// Generic bundle
+import uiBundlePlugin from "@salesforce/vite-plugin-ui-bundle";
+export default defineConfig({ plugins: [uiBundlePlugin()] });
+
+// Site bundle (language switching in local preview)
+import siteUiBundlePlugin from "@salesforce/vite-plugin-ui-bundle/site";
+export default defineConfig({
+  plugins: [siteUiBundlePlugin({ languages: ["en_US", "zh_CN", "fr"] })],
+});
+```
+
+The site plugin composes the same core as the generic plugin (proxying, org
+info, API-version bake-in, design mode, HMR are identical); it only adds
+site-specific base-path management. With no `languages` (or an empty array) the
+site plugin behaves identically to the generic one.
+
+### How the site entry works (local dev only)
+
+On a deployed Experience site the platform injects `globalThis.SFDC_ENV.language`
+and folds the active language into `SFDC_ENV.basePath` (e.g. `/shop/fr`),
+recomputed from the request URL on every load. The generic dev server does
+neither. The site entry mirrors this for local dev, per request:
+
+- A leading URL segment matching a **non-default** supported language is stripped
+  before Vite's router sees it, so `/fr/property/1` is served exactly like
+  `/property/1` (SPA fallback).
+- `SFDC_ENV.language` and `basePath` are recomputed from the URL: a non-default
+  segment → `language="<lang>"`, `basePath="/<lang>"`; no segment (or the
+  default, which is the **first** entry of `languages`) → `language="<default>"`,
+  `basePath="/"`.
+- `apiPath` stays `/` (never folded), so the `/services/*` GraphQL proxy still
+  resolves — the language lives in `basePath` only.
+
+All of this is gated to non-production, non-CodeBuilder, and a non-empty
+`languages` list, so a deployed build and every generic bundle are untouched.

package/dist/core/createCorePlugins.d.ts

@@ -0,0 +1,26 @@
+import { Plugin } from 'vite';
+import { DesignPluginOptions } from './design';
+import { BasePathResolver } from './env';
+export interface CorePluginOptions extends DesignPluginOptions {
+    /** Salesforce org alias */
+    orgAlias?: string;
+    /** Enable verbose logging */
+    debug?: boolean;
+}
+/**
+ * Optional hooks a specialized entry (e.g. `./site`) can inject into the shared
+ * core. `resolveBasePath` runs per index.html request to fold a language into
+ * `basePath` and inject `SFDC_ENV.language`; the generic entry omits it and the
+ * core uses the identity resolver (today's behavior, byte-for-byte).
+ */
+export interface CoreHooks {
+    resolveBasePath?: BasePathResolver;
+}
+/**
+ * Assemble the shared UI-bundle plugins ([design, core]) both the generic and
+ * site entries build on. All plumbing — proxy handler, org info, API-version
+ * bake-in, design mode, HMR, and the `<base href>` + `SFDC_ENV` injection —
+ * lives here. The only seam is {@link CoreHooks.resolveBasePath}.
+ */
+export declare function createCorePlugins(options?: CorePluginOptions, hooks?: CoreHooks): Plugin[];
+//# sourceMappingURL=createCorePlugins.d.ts.map

package/dist/core/createCorePlugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCorePlugins.d.ts","sourceRoot":"","sources":["../../src/core/createCorePlugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAA6B,MAAM,EAAiB,MAAM,MAAM,CAAC;AAU7E,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAkC,KAAK,gBAAgB,EAAoB,MAAM,OAAO,CAAC;AAEhG,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC7D,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACzB,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,GAAE,iBAAsB,EAC/B,KAAK,GAAE,SAAc,GACnB,MAAM,EAAE,CAuKV"}

package/dist/core/design.d.ts

@@ -0,0 +1,26 @@
+import { Plugin } from 'vite';
+/** Options consumed by the design-mode plugin. */
+export interface DesignPluginOptions {
+    /**
+     * Enable design-time features (inject `data-source-file`, serve & inject
+     * design interactions script).
+     *
+     * Defaults to enabled when Vite `mode` is `"design"` (e.g. `vite --mode design`).
+     */
+    designMode?: boolean;
+    /**
+     * File path segments to exclude from design-time `data-source-file` injection.
+     * Files whose path contains any of these strings will be skipped entirely.
+     *
+     * @default ["/components/ui/"]
+     */
+    designModeExcludePaths?: string[];
+}
+/**
+ * The design-mode plugin: injects source-locator attributes into JSX/TSX,
+ * serves the design-mode interactions runtime script, and injects a `<script>`
+ * to load it. Moved verbatim from the original single plugin — shared by both
+ * the generic and site entries.
+ */
+export declare function createDesignPlugin(options?: DesignPluginOptions): Plugin;
+//# sourceMappingURL=design.d.ts.map

package/dist/core/design.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design.d.ts","sourceRoot":"","sources":["../../src/core/design.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAqB,MAAM,EAAiB,MAAM,MAAM,CAAC;AAErE,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IACnC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAwG5E"}

package/dist/core/env.d.ts

@@ -0,0 +1,42 @@
+import { HtmlTagDescriptor } from 'vite';
+/**
+ * The local-dev runtime environment injected into the page as
+ * `globalThis.SFDC_ENV` (and mirrored by the `<base href>` tag). Populated only
+ * in non-production; see the `config` / `configResolved` hooks in
+ * {@link createCorePlugins}.
+ */
+export interface Environment {
+    basePath: string;
+    apiPath: string;
+    orgUrl?: string;
+    namespace?: string;
+    appName?: string;
+}
+/**
+ * Per-request resolution of the effective `basePath` (+ optional `language`)
+ * from the request URL.
+ *
+ * The generic entry passes the {@link identityResolver}, which returns the
+ * configured `basePath` unchanged and no language — today's behavior. The site
+ * entry supplies a resolver that folds a supported language segment into
+ * `basePath`. Returning a `language` causes `SFDC_ENV.language` to be injected,
+ * matching the platform, which always sets it on a deployed site.
+ */
+export type BasePathResolver = (originalUrl: string | undefined, env: Environment) => {
+    basePath: string;
+    language?: string;
+};
+/** The generic resolver: configured `basePath`, no language. */
+export declare const identityResolver: BasePathResolver;
+/**
+ * Build the `<base href>` + `SFDC_ENV` tags for a single index.html request.
+ *
+ * `resolveBasePath` runs per request so the site entry can recompute `basePath`
+ * and `language` from `originalUrl` on every reload; the generic entry passes
+ * {@link identityResolver} and this collapses to today's behavior.
+ */
+export declare function buildEnvTags(html: string, env: Environment, originalUrl: string | undefined, resolveBasePath?: BasePathResolver): {
+    html: string;
+    tags: HtmlTagDescriptor[];
+};
+//# sourceMappingURL=env.d.ts.map

package/dist/core/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/core/env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,GAAG,EAAE,WAAW,KACZ;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,EAAE,gBAA8D,CAAC;AAE9F;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC3B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,eAAe,GAAE,gBAAmC,GAClD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAoC7C"}

package/dist/createCorePlugins-C2ODv7o-.js

@@ -0,0 +1,308 @@
+import { loadManifest, getOrgInfo } from "@salesforce/ui-bundle/app";
+import { injectLivePreviewScript, createProxyHandler } from "@salesforce/ui-bundle/proxy";
+import fs, { existsSync, readFileSync, readdirSync } from "node:fs";
+import { dirname, join, basename } from "node:path";
+import { getRuntimeScriptContent } from "@salesforce/ui-design-mode/runtime";
+import reactDesignTimeLocatorBabelPlugin from "@salesforce/ui-design-mode/source-locator/react";
+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(".uibundle-meta.xml"));
+    if (metaFile) {
+      return metaFile.replace(".uibundle-meta.xml", "");
+    }
+  } catch {
+  }
+  return basename(rootPath);
+}
+function getNamespace(startDir) {
+  let dir = startDir;
+  for (let parent = dirname(dir); ; dir = parent, parent = dirname(dir)) {
+    const sfdxProjectPath = join(dir, "sfdx-project.json");
+    if (existsSync(sfdxProjectPath)) {
+      try {
+        const namespace = JSON.parse(readFileSync(sfdxProjectPath, "utf-8")).namespace;
+        if (typeof namespace === "string" && namespace.trim()) {
+          return namespace.trim();
+        }
+      } catch {
+      }
+      return DEFAULT_NAMESPACE;
+    }
+    if (parent === dir) {
+      break;
+    }
+  }
+  return DEFAULT_NAMESPACE;
+}
+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 getDevServerTarget(codeBuilderProxyUrl, port) {
+  if (codeBuilderProxyUrl) {
+    return getCodeBuilderBasePath(codeBuilderProxyUrl, port);
+  }
+  return `http://localhost:${port}`;
+}
+function getPort() {
+  return parseInt(process.env.SF_UIBUNDLE_PORT || DEFAULT_PORT.toString(), 10);
+}
+function createDesignPlugin(options = {}) {
+  let designModeEnabled = options.designMode ?? false;
+  return {
+    name: "@salesforce/vite-plugin-ui-bundle: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.endsWith("/_sfdc/design-mode-interactions.js")) {
+          try {
+            const script = getRuntimeScriptContent();
+            if (script !== null) {
+              res.setHeader("Content-Type", "application/javascript");
+              res.setHeader("Cache-Control", "no-cache");
+              res.end(script);
+              return;
+            }
+            console.error(
+              `[ui-bundle-plugin] Design mode runtime script not found. Run 'npm run build' in @salesforce/ui-design-mode.`
+            );
+            res.writeHead(404);
+            res.end("Design mode script not found");
+            return;
+          } catch (error) {
+            console.error("[ui-bundle-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;
+      let originalSource;
+      try {
+        originalSource = fs.readFileSync(filepath, "utf-8");
+      } catch {
+      }
+      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, originalSource }]]
+      });
+      if (!result?.code) return null;
+      return { code: result.code, map: result.map };
+    },
+    transformIndexHtml: {
+      order: "pre",
+      handler(html) {
+        const tags = [];
+        if (designModeEnabled) {
+          tags.push({
+            tag: "script",
+            attrs: { src: "/_sfdc/design-mode-interactions.js" },
+            injectTo: "body"
+          });
+        }
+        return { html, tags };
+      }
+    }
+  };
+}
+function stripUrlQuery(url) {
+  if (!url) return "";
+  const queryIndex = url.indexOf("?");
+  return queryIndex === -1 ? url : url.slice(0, queryIndex);
+}
+const identityResolver = (_url, env) => ({ basePath: env.basePath });
+function buildEnvTags(html, env, originalUrl, resolveBasePath = identityResolver) {
+  html = injectLivePreviewScript(html);
+  const { basePath, language } = resolveBasePath(originalUrl, env);
+  const tags = [];
+  const baseHref = basePath.endsWith("/") ? basePath : `${basePath}/`;
+  tags.push({
+    tag: "base",
+    attrs: { href: baseHref },
+    injectTo: "head-prepend"
+  });
+  const sfdcEnv = {
+    basePath,
+    apiPath: env.apiPath
+  };
+  if (env.orgUrl) sfdcEnv.orgUrl = env.orgUrl;
+  if (env.namespace) sfdcEnv.namespace = env.namespace;
+  if (env.appName) sfdcEnv.appName = env.appName;
+  if (language) sfdcEnv.language = language;
+  const sfdcEnvLiteral = JSON.stringify(sfdcEnv).replace(/</g, "\\u003c");
+  tags.push({
+    tag: "script",
+    children: `(function() { globalThis.SFDC_ENV = ${sfdcEnvLiteral}; })();`,
+    injectTo: "body"
+  });
+  return { html, tags };
+}
+function createCorePlugins(options = {}, hooks = {}) {
+  const resolveBasePath = hooks.resolveBasePath ?? identityResolver;
+  const proxyOptions = {
+    debug: options.debug ?? false
+  };
+  let orgInfo;
+  let manifest;
+  let environment;
+  let proxyHandler;
+  let codeBuilderProxyUrl;
+  const corePlugin = {
+    name: "@salesforce/vite-plugin-ui-bundle:core",
+    enforce: "pre",
+    async config(_config, env) {
+      let version;
+      try {
+        orgInfo = await getOrgInfo(options.orgAlias);
+        version = orgInfo?.apiVersion || DEFAULT_API_VERSION;
+        if (options.debug) {
+          console.log(`[ui-bundle-plugin] Using Salesforce API version: ${version}`);
+        }
+      } catch {
+        version = DEFAULT_API_VERSION;
+      }
+      codeBuilderProxyUrl = process.env.CODE_BUILDER_FRAMEWORK_PROXY_URI;
+      const isCodeBuilder = !!codeBuilderProxyUrl;
+      const define = {
+        __SF_API_VERSION__: JSON.stringify(version)
+      };
+      let base = "./";
+      if (env.mode !== "production") {
+        const basePath = isCodeBuilder ? getCodeBuilderBasePath(codeBuilderProxyUrl, getPort()) : "/";
+        environment = { basePath, apiPath: basePath, orgUrl: orgInfo?.instanceUrl };
+        if (isCodeBuilder) {
+          base = basePath;
+        }
+      }
+      return {
+        define,
+        base,
+        server: {
+          port: getPort(),
+          // Code Builder specific configuration
+          ...isCodeBuilder && {
+            allowedHosts: true,
+            strictPort: true
+          }
+        }
+      };
+    },
+    async configResolved(config) {
+      try {
+        const rootPath = config.root ?? process.cwd();
+        if (environment) {
+          environment.namespace = getNamespace(rootPath);
+          environment.appName = getAppName(rootPath);
+        }
+        manifest = await loadManifest(`${rootPath}/ui-bundle.json`);
+        const target = getDevServerTarget(codeBuilderProxyUrl, config.server.port ?? DEFAULT_PORT);
+        proxyHandler = createProxyHandler(
+          manifest,
+          orgInfo,
+          target,
+          environment?.basePath,
+          proxyOptions
+        );
+      } catch (error) {
+        console.error(`[ui-bundle-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("[ui-bundle-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("ui-bundle.json")) {
+        const updatedManifest = await loadManifest(file);
+        if (updatedManifest) {
+          manifest = updatedManifest;
+          const target = getDevServerTarget(
+            codeBuilderProxyUrl,
+            server.config.server.port ?? DEFAULT_PORT
+          );
+          proxyHandler = createProxyHandler(
+            manifest,
+            orgInfo,
+            target,
+            environment?.basePath,
+            proxyOptions
+          );
+          server.ws.send({
+            type: "full-reload",
+            path: "*"
+          });
+        }
+      }
+    },
+    transformIndexHtml: {
+      order: "pre",
+      handler(html, ctx) {
+        if (!environment) {
+          return { html, tags: [] };
+        }
+        return buildEnvTags(html, environment, ctx?.originalUrl, resolveBasePath);
+      }
+    }
+  };
+  const designPlugin = createDesignPlugin(options);
+  return [designPlugin, corePlugin];
+}
+export {
+  createCorePlugins as c
+};

package/dist/index.d.ts

@@ -1,23 +1,18 @@
 import { Plugin } from 'vite';
-export interface PluginOptions {
-    /** Salesforce org alias */
-    orgAlias?: string;
-    /** Enable verbose logging */
-    debug?: boolean;
-    /**
-     * Enable design-time features (inject `data-source-file`, serve & inject design interactions script).
-     *
-     * Defaults to:
-     * - enabled when Vite `mode` is `"design"` (e.g. `vite --mode design`)
-     */
-    designMode?: boolean;
-    /**
-     * File path segments to exclude from design-time `data-source-file` injection.
-     * Files whose path contains any of these strings will be skipped entirely.
-     *
-     * @default ["/components/ui/"]
-     */
-    designModeExcludePaths?: string[];
-}
+import { CorePluginOptions } from './core/createCorePlugins';
+export type { BasePathResolver, Environment } from './core/env';
+export type { CorePluginOptions, CoreHooks } from './core/createCorePlugins';
+/**
+ * Options for the generic UI-bundle plugin: `orgAlias`, `debug`, `designMode`,
+ * and `designModeExcludePaths`.
+ */
+export type PluginOptions = CorePluginOptions;
+/**
+ * Generic UI-bundle Vite plugin.
+ *
+ * `basePath` is always `/` (or the CodeBuilder proxy path) and no language is
+ * folded in — the default for every bundle. Site bundles that need per-request
+ * language folding import `@salesforce/vite-plugin-ui-bundle/site` instead.
+ */
 export default function uiBundlePlugin(options?: PluginOptions): Plugin[];
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAqB,MAAM,EAAiB,MAAM,MAAM,CAAC;AAWrE,MAAM,WAAW,aAAa;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,EAAE,CAwS5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAErF,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE7E;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,EAAE,CAG5E"}

package/dist/index.js

@@ -1,298 +1,6 @@
-import fs, { existsSync, readFileSync, readdirSync } from "node:fs";
-import { loadManifest, getOrgInfo } from "@salesforce/ui-bundle/app";
-import { createProxyHandler, injectLivePreviewScript } from "@salesforce/ui-bundle/proxy";
-import { getRuntimeScriptContent } from "@salesforce/ui-design-mode/runtime";
-import reactDesignTimeLocatorBabelPlugin from "@salesforce/ui-design-mode/source-locator/react";
-import { dirname, join, basename } from "node:path";
-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(".uibundle-meta.xml"));
-    if (metaFile) {
-      return metaFile.replace(".uibundle-meta.xml", "");
-    }
-  } catch {
-  }
-  return basename(rootPath);
-}
-function getNamespace(startDir) {
-  let dir = startDir;
-  for (let parent = dirname(dir); ; dir = parent, parent = dirname(dir)) {
-    const sfdxProjectPath = join(dir, "sfdx-project.json");
-    if (existsSync(sfdxProjectPath)) {
-      try {
-        const namespace = JSON.parse(readFileSync(sfdxProjectPath, "utf-8")).namespace;
-        if (typeof namespace === "string" && namespace.trim()) {
-          return namespace.trim();
-        }
-      } catch {
-      }
-      return DEFAULT_NAMESPACE;
-    }
-    if (parent === dir) {
-      break;
-    }
-  }
-  return DEFAULT_NAMESPACE;
-}
-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 getDevServerTarget(codeBuilderProxyUrl, port) {
-  if (codeBuilderProxyUrl) {
-    return getCodeBuilderBasePath(codeBuilderProxyUrl, port);
-  }
-  return `http://localhost:${port}`;
-}
-function getPort() {
-  return parseInt(process.env.SF_UIBUNDLE_PORT || DEFAULT_PORT.toString(), 10);
-}
+import { c as createCorePlugins } from "./createCorePlugins-C2ODv7o-.js";
 function uiBundlePlugin(options = {}) {
-  const proxyOptions = {
-    debug: options.debug ?? false
-  };
-  let orgInfo;
-  let manifest;
-  let environment;
-  let proxyHandler;
-  let designModeEnabled = options.designMode ?? false;
-  let codeBuilderProxyUrl;
-  const corePlugin = {
-    name: "@salesforce/vite-plugin-ui-bundle:core",
-    enforce: "pre",
-    async config(_config, env) {
-      let version;
-      try {
-        orgInfo = await getOrgInfo(options.orgAlias);
-        version = orgInfo?.apiVersion || DEFAULT_API_VERSION;
-        if (options.debug) {
-          console.log(`[ui-bundle-plugin] Using Salesforce API version: ${version}`);
-        }
-      } catch {
-        version = DEFAULT_API_VERSION;
-      }
-      codeBuilderProxyUrl = process.env.CODE_BUILDER_FRAMEWORK_PROXY_URI;
-      const isCodeBuilder = !!codeBuilderProxyUrl;
-      const define = {
-        __SF_API_VERSION__: JSON.stringify(version)
-      };
-      let base = "./";
-      if (env.mode !== "production") {
-        const basePath = isCodeBuilder ? getCodeBuilderBasePath(codeBuilderProxyUrl, getPort()) : "/";
-        environment = { basePath, apiPath: basePath, orgUrl: orgInfo?.instanceUrl };
-        if (isCodeBuilder) {
-          base = basePath;
-        }
-      }
-      return {
-        define,
-        base,
-        server: {
-          port: getPort(),
-          // Code Builder specific configuration
-          ...isCodeBuilder && {
-            allowedHosts: true,
-            strictPort: true
-          }
-        }
-      };
-    },
-    async configResolved(config) {
-      try {
-        const rootPath = config.root ?? process.cwd();
-        if (environment) {
-          environment.namespace = getNamespace(rootPath);
-          environment.appName = getAppName(rootPath);
-        }
-        manifest = await loadManifest(`${rootPath}/ui-bundle.json`);
-        const target = getDevServerTarget(codeBuilderProxyUrl, config.server.port ?? DEFAULT_PORT);
-        proxyHandler = createProxyHandler(
-          manifest,
-          orgInfo,
-          target,
-          environment?.basePath,
-          proxyOptions
-        );
-      } catch (error) {
-        console.error(`[ui-bundle-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("[ui-bundle-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("ui-bundle.json")) {
-        const updatedManifest = await loadManifest(file);
-        if (updatedManifest) {
-          manifest = updatedManifest;
-          const target = getDevServerTarget(
-            codeBuilderProxyUrl,
-            server.config.server.port ?? DEFAULT_PORT
-          );
-          proxyHandler = createProxyHandler(
-            manifest,
-            orgInfo,
-            target,
-            environment?.basePath,
-            proxyOptions
-          );
-          server.ws.send({
-            type: "full-reload",
-            path: "*"
-          });
-        }
-      }
-    },
-    transformIndexHtml: {
-      order: "pre",
-      handler(html) {
-        if (environment) {
-          html = injectLivePreviewScript(html);
-        }
-        const tags = [];
-        if (environment) {
-          const baseHref = environment.basePath.endsWith("/") ? environment.basePath : `${environment.basePath}/`;
-          tags.push({
-            tag: "base",
-            attrs: { href: baseHref },
-            injectTo: "head-prepend"
-          });
-          const sfdcEnv = {
-            basePath: environment.basePath,
-            apiPath: environment.apiPath
-          };
-          if (environment.orgUrl) sfdcEnv.orgUrl = environment.orgUrl;
-          if (environment.namespace) sfdcEnv.namespace = environment.namespace;
-          if (environment.appName) sfdcEnv.appName = environment.appName;
-          const sfdcEnvLiteral = JSON.stringify(sfdcEnv).replace(/</g, "\\u003c");
-          tags.push({
-            tag: "script",
-            children: `(function() { globalThis.SFDC_ENV = ${sfdcEnvLiteral}; })();`,
-            injectTo: "body"
-          });
-        }
-        return { html, tags };
-      }
-    }
-  };
-  const designPlugin = {
-    name: "@salesforce/vite-plugin-ui-bundle: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.endsWith("/_sfdc/design-mode-interactions.js")) {
-          try {
-            const script = getRuntimeScriptContent();
-            if (script !== null) {
-              res.setHeader("Content-Type", "application/javascript");
-              res.setHeader("Cache-Control", "no-cache");
-              res.end(script);
-              return;
-            }
-            console.error(
-              `[ui-bundle-plugin] Design mode runtime script not found. Run 'npm run build' in @salesforce/ui-design-mode.`
-            );
-            res.writeHead(404);
-            res.end("Design mode script not found");
-            return;
-          } catch (error) {
-            console.error("[ui-bundle-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;
-      let originalSource;
-      try {
-        originalSource = fs.readFileSync(filepath, "utf-8");
-      } catch {
-      }
-      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, originalSource }]]
-      });
-      if (!result?.code) return null;
-      return { code: result.code, map: result.map };
-    },
-    transformIndexHtml: {
-      order: "pre",
-      handler(html) {
-        const tags = [];
-        if (designModeEnabled) {
-          tags.push({
-            tag: "script",
-            attrs: { src: "/_sfdc/design-mode-interactions.js" },
-            injectTo: "body"
-          });
-        }
-        return { html, tags };
-      }
-    }
-  };
-  return [designPlugin, corePlugin];
-}
-function stripUrlQuery(url) {
-  if (!url) return "";
-  const queryIndex = url.indexOf("?");
-  return queryIndex === -1 ? url : url.slice(0, queryIndex);
+  return createCorePlugins(options);
 }
 export {
   uiBundlePlugin as default

package/dist/site/index.d.ts

@@ -0,0 +1,21 @@
+import { Plugin } from 'vite';
+import { SitePluginOptions } from './site-plugin';
+import { CorePluginOptions } from '../core/createCorePlugins';
+export type { SitePluginOptions } from './site-plugin';
+export { resolveLanguageFromUrl, normalizeLanguages } from './languages';
+/** Options for {@link siteUiBundlePlugin}: the core options plus `languages`. */
+export type SiteUiBundlePluginOptions = CorePluginOptions & SitePluginOptions;
+/**
+ * Site UI-bundle Vite plugin.
+ *
+ * Everything the generic plugin does (proxy, org info, API-version bake-in,
+ * design mode, HMR), plus — for local dev only — per-request `basePath` +
+ * `SFDC_ENV.language` folding driven by `languages`, and serving
+ * language-prefixed paths (SPA fallback). Selected by importing
+ * `@salesforce/vite-plugin-ui-bundle/site` in a site bundle's `vite.config.ts`.
+ *
+ * With no `languages` (or an empty array) it behaves identically to the generic
+ * plugin.
+ */
+export default function siteUiBundlePlugin(options?: SiteUiBundlePluginOptions): Plugin[];
+//# sourceMappingURL=index.d.ts.map

package/dist/site/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/site/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEtF,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEzE,iFAAiF;AACjF,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,MAAM,EAAE,CAO5F"}

package/dist/site/index.js

@@ -0,0 +1,58 @@
+import { c as createCorePlugins } from "../createCorePlugins-C2ODv7o-.js";
+function resolveLanguageFromUrl(url, supported) {
+  const [defaultLang, ...nonDefault] = supported;
+  if (defaultLang === void 0) return void 0;
+  const path = (url ?? "").split("?")[0] ?? "";
+  const [first] = path.replace(/^\/+/, "").split("/");
+  if (first && nonDefault.includes(first)) {
+    return { language: first, segment: first };
+  }
+  return { language: defaultLang };
+}
+function normalizeLanguages(languages) {
+  return languages.map((s) => s.trim().replace(/_/g, "-")).filter(Boolean);
+}
+function createSitePlugin(options = {}) {
+  const supported = normalizeLanguages(options.languages ?? []);
+  let enabled = false;
+  const resolveBasePath = (originalUrl, env) => {
+    if (!enabled) return { basePath: env.basePath };
+    const resolved = resolveLanguageFromUrl(originalUrl, supported);
+    if (!resolved) return { basePath: env.basePath };
+    const basePath = resolved.segment && env.basePath === "/" ? `/${resolved.segment}` : env.basePath;
+    return { basePath, language: resolved.language };
+  };
+  const plugin = {
+    name: "@salesforce/vite-plugin-ui-bundle:site",
+    enforce: "pre",
+    config(_config, envConfig) {
+      const isCodeBuilder = !!process.env.CODE_BUILDER_FRAMEWORK_PROXY_URI;
+      enabled = envConfig.mode !== "production" && !isCodeBuilder && supported.length > 0;
+    },
+    configureServer(server) {
+      server.middlewares.use((req, _res, next) => {
+        if (enabled && req.url) {
+          const seg = resolveLanguageFromUrl(req.url, supported)?.segment;
+          if (seg) {
+            const rest = req.url.slice(`/${seg}`.length);
+            req.url = rest.startsWith("/") ? rest : `/${rest}`;
+          }
+        }
+        next();
+      });
+    }
+  };
+  return { plugin, resolveBasePath };
+}
+function siteUiBundlePlugin(options = {}) {
+  const { plugin: sitePlugin, resolveBasePath } = createSitePlugin({
+    languages: options.languages
+  });
+  const core = createCorePlugins(options, { resolveBasePath });
+  return [sitePlugin, ...core];
+}
+export {
+  siteUiBundlePlugin as default,
+  normalizeLanguages,
+  resolveLanguageFromUrl
+};

package/dist/site/languages.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Resolve the active language for a request, in hyphenated URL form.
+ *
+ * The default language (the FIRST supported entry) is served un-prefixed, so:
+ *   - a leading URL segment matching a NON-DEFAULT supported language -> that
+ *     language (it carries a "/<lang>" segment);
+ *   - no segment, or a segment equal to the default -> the default language.
+ *
+ * Returns `undefined` only when there are no supported languages (feature
+ * absent), so `SFDC_ENV.language` is otherwise ALWAYS set — matching production,
+ * which sets it even for the default at the root.
+ *
+ * Detection is anchored to the exact supported set, so a real route segment
+ * (e.g. a page named like a locale) is never mistaken for a language.
+ *
+ * @param url       The request URL (may include a query string) or `undefined`.
+ * @param supported Supported languages in hyphenated form; first entry is default.
+ * @returns The resolved `language` and, when present, the leading `segment`.
+ */
+export declare function resolveLanguageFromUrl(url: string | undefined, supported: string[]): {
+    language: string;
+    segment?: string;
+} | undefined;
+/**
+ * Normalize the feature's `LANGUAGES` codes to hyphenated URL form
+ * (`en_US` -> `en-US`), dropping blanks. This mirrors how the switcher's client
+ * code (`buildLanguageUrl`) and the platform both use hyphens in URL segments.
+ */
+export declare function normalizeLanguages(languages: string[]): string[];
+//# sourceMappingURL=languages.d.ts.map

package/dist/site/languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../src/site/languages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,SAAS,EAAE,MAAM,EAAE,GACjB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CASpD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEhE"}

package/dist/site/site-plugin.d.ts

@@ -0,0 +1,23 @@
+import { Plugin } from 'vite';
+import { BasePathResolver } from '../core/env';
+export interface SitePluginOptions {
+    /**
+     * Supported languages, from the language-switcher feature's `LANGUAGES`. The
+     * FIRST entry is the default (served un-prefixed at `/`). Codes may be in
+     * underscore (`en_US`) or hyphen (`en-US`) form; they are normalized to the
+     * hyphenated URL form the switcher and platform use. Empty/omitted -> the
+     * plugin is a no-op and behaves identically to the generic plugin.
+     */
+    languages?: string[];
+}
+/**
+ * Build the site plugin plus the {@link BasePathResolver} the core threads into
+ * its `transformIndexHtml`. Returning both from one factory keeps the resolver
+ * and the request-URL strip middleware sharing the same `enabled`/`supported`
+ * state without leaking an internal property onto the plugin object.
+ */
+export declare function createSitePlugin(options?: SitePluginOptions): {
+    plugin: Plugin;
+    resolveBasePath: BasePathResolver;
+};
+//# sourceMappingURL=site-plugin.d.ts.map

package/dist/site/site-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-plugin.d.ts","sourceRoot":"","sources":["../../src/site/site-plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAElD,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,aAAa,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IACjC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,gBAAgB,CAAC;CAClC,CAiDA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/vite-plugin-ui-bundle",
   "description": "Vite plugin for Salesforce UI Bundles",
-  "version": "11.55.1",
+  "version": "11.56.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,6 +12,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./site": {
+      "types": "./dist/site/index.d.ts",
+      "import": "./dist/site/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -27,8 +31,8 @@
   },
   "dependencies": {
     "@babel/core": "^7.29.6",
-    "@salesforce/ui-bundle": "^11.55.1",
-    "@salesforce/ui-design-mode": "11.55.1"
+    "@salesforce/ui-bundle": "^11.56.0",
+    "@salesforce/ui-design-mode": "11.56.0"
   },
   "devDependencies": {
     "@types/babel__core": "^7.20.5",