@salesforce/angular-plugin-ui-bundle 12.3.13 → 12.4.1

package/dist/index.d.ts

@@ -3,11 +3,11 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-export type { SalesforceOptions, Middleware } from "./types.ts";
+export type { SalesforceOptions, Middleware, SiteOptions } from "./types.ts";
 export type { ApiVersionResult } from "./plugins/api-version.ts";
 export { createApiVersionPlugin } from "./plugins/api-version.ts";
 export { createGraphQLCodegenPlugin } from "./plugins/graphql-codegen.ts";
 export { DEFAULT_API_VERSION, DEFAULT_PORT, getPort } from "./utils.ts";
 export { createProxyMiddleware } from "./middleware/proxy.ts";
-export { createHtmlMiddleware } from "./middleware/html.ts";
+export { createHtmlMiddleware, createSiteHtmlMiddleware } from "./middleware/html.ts";
 //# 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;AAEH,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -7,4 +7,4 @@ export { createApiVersionPlugin } from "./plugins/api-version.js";
 export { createGraphQLCodegenPlugin } from "./plugins/graphql-codegen.js";
 export { DEFAULT_API_VERSION, DEFAULT_PORT, getPort } from "./utils.js";
 export { createProxyMiddleware } from "./middleware/proxy.js";
-export { createHtmlMiddleware } from "./middleware/html.js";
+export { createHtmlMiddleware, createSiteHtmlMiddleware } from "./middleware/html.js";

package/dist/middleware/html.d.ts

@@ -3,6 +3,58 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-import type { Middleware, SalesforceOptions } from "../types.ts";
-export declare function createHtmlMiddleware(options?: SalesforceOptions): Promise<Middleware>;
+/**
+ * HTML injection middleware for ng serve.
+ * Intercepts SPA navigation responses and injects the Live Preview script,
+ * SFDC_ENV global, and base href. Skips static files and /services/ paths.
+ * In design mode (SF_DESIGN_MODE) it also injects the runtime <script> tag
+ * (proxy.ts serves that script).
+ *
+ * Runs BEFORE the proxy middleware (wrapping must happen first).
+ *
+ * Split into a pure createIndexHtmlTransformer (string→string, unit-testable)
+ * and createHtmlMiddleware (req/res plumbing). The transformer is not public API.
+ *
+ * The optional `hooks.resolveRequest` callback enables per-request basePath and
+ * language injection — used by the site middleware (`/site` subpath) for
+ * language-prefixed URL support.
+ */
+import type { IncomingMessage } from "node:http";
+import type { Middleware, SalesforceOptions, SiteOptions } from "../types.ts";
+/**
+ * Per-request context returned by a `RequestResolver`. When provided, these
+ * values override the static basePath resolved at startup.
+ */
+export interface RequestContext {
+    /** The basePath to inject into `<base href>` and `SFDC_ENV.basePath`. */
+    basePath: string;
+    /** The language to inject into `SFDC_ENV.language` (omitted when undefined). */
+    language?: string;
+}
+/**
+ * A per-request hook that resolves basePath and language from the incoming
+ * request. May also mutate `req.url` (e.g., strip a language segment).
+ */
+export type RequestResolver = (req: IncomingMessage) => RequestContext;
+export interface HtmlMiddlewareHooks {
+    resolveRequest?: RequestResolver;
+}
+export declare function createHtmlMiddleware(options?: SalesforceOptions, hooks?: HtmlMiddlewareHooks): Promise<Middleware>;
+/**
+ * Site-aware HTML middleware for Angular apps with language-prefixed URLs.
+ *
+ * Thin wrapper around `createHtmlMiddleware` that supplies a per-request
+ * `resolveRequest` hook. On each request the hook:
+ *
+ * 1. Resolves the active language from the leading URL path segment.
+ * 2. Strips the language segment from `req.url` so Angular's SPA routing
+ *    sees `/accounts/1` instead of `/fr/accounts/1`.
+ * 3. Returns `{ basePath, language }` so the HTML transform injects the
+ *    correct per-request `SFDC_ENV.language` and `SFDC_ENV.basePath`.
+ *
+ * When languages are empty, the feature is absent (CodeBuilder), or in
+ * production mode, the middleware degrades to the generic `createHtmlMiddleware`
+ * (no hook supplied — identity behavior).
+ */
+export declare function createSiteHtmlMiddleware(options?: SiteOptions): Promise<Middleware>;
 //# sourceMappingURL=html.d.ts.map

package/dist/middleware/html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/middleware/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA4FjE,wBAAsB,oBAAoB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+E/F"}
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/middleware/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI9E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,cAAc,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IACnC,cAAc,CAAC,EAAE,eAAe,CAAC;CACjC;AAiGD,wBAAsB,oBAAoB,CACzC,OAAO,GAAE,iBAAsB,EAC/B,KAAK,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,UAAU,CAAC,CAmFrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4B7F"}

package/dist/middleware/html.js

@@ -3,33 +3,23 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-/**
- * HTML injection middleware for ng serve.
- * Intercepts SPA navigation responses and injects the Live Preview script,
- * SFDC_ENV global, and base href. Skips static files and /services/ paths.
- * In design mode (SF_DESIGN_MODE) it also injects the runtime <script> tag
- * (proxy.ts serves that script).
- *
- * Runs BEFORE the proxy middleware (wrapping must happen first).
- *
- * Split into a pure createIndexHtmlTransformer (string→string, unit-testable)
- * and createHtmlMiddleware (req/res plumbing). The transformer is not public API.
- */
 import { getOrgInfo } from "@salesforce/ui-bundle/app";
 import { injectLivePreviewScript } from "@salesforce/ui-bundle/proxy";
 import { DESIGN_MODE_HYDRATE_PATH, DESIGN_MODE_SCRIPT_PATH } from "./proxy.js";
 import { getAppName, getCodeBuilderBasePath, getNamespace, getPort } from "../utils.js";
+import { normalizeLanguages, resolveLanguageFromUrl } from "../utils.js";
 /**
- * Builds a pure HTML transform bound to the current env (basePath resolved once
- * from CODE_BUILDER_FRAMEWORK_PROXY_URI or "/"). Only the ng serve middleware
- * calls it, so it always injects.
+ * Builds a pure HTML transform. When `ctx` is provided (per-request overrides),
+ * its `basePath` and `language` are used; otherwise the static basePath resolved
+ * at startup is used. The transform injects Live Preview, <base href>,
+ * SFDC_ENV global, and (optionally) design-mode scripts.
  */
 async function createIndexHtmlTransformer(options = {}) {
     const port = getPort();
     const codeBuilderProxyUrl = process.env.CODE_BUILDER_FRAMEWORK_PROXY_URI;
     const isCodeBuilder = !!codeBuilderProxyUrl;
-    const basePath = isCodeBuilder ? getCodeBuilderBasePath(codeBuilderProxyUrl, port) : "/";
-    const apiPath = basePath;
+    const staticBasePath = isCodeBuilder ? getCodeBuilderBasePath(codeBuilderProxyUrl, port) : "/";
+    const staticApiPath = staticBasePath;
     // App identity for SFDC_ENV (namespace + appName). Resolved from the app root
     // (cwd — where ng serve runs), matching the server injector so local dev sees
     // the same values a deployed bundle would.
@@ -47,9 +37,12 @@ async function createIndexHtmlTransformer(options = {}) {
         orgUrl = undefined;
     }
     if (options.debug) {
-        console.log(`[angular-plugin-ui-bundle] HTML transformer: basePath="${basePath}", isCodeBuilder=${isCodeBuilder}, port=${port}, orgUrl=${orgUrl}`);
+        console.log(`[angular-plugin-ui-bundle] HTML transformer: basePath="${staticBasePath}", isCodeBuilder=${isCodeBuilder}, port=${port}, orgUrl=${orgUrl}`);
     }
-    return (html) => {
+    return (html, ctx) => {
+        // Resolve per-request basePath or fall back to static
+        const basePath = ctx?.basePath ?? staticBasePath;
+        const apiPath = staticApiPath;
         // 1. Live Preview script (enables VS Code extension communication)
         html = injectLivePreviewScript(html);
         // 2. <base href>: replace an existing tag, else inject after <head>.
@@ -61,13 +54,15 @@ async function createIndexHtmlTransformer(options = {}) {
         else if (/<head(\s[^>]*)?>/i.test(html)) {
             html = html.replace(/<head(\s[^>]*)?>/i, (match) => `${match}\n  <base href="${baseHref}">`);
         }
-        // 3. SFDC_ENV global (basePath + apiPath + orgUrl + app identity).
+        // 3. SFDC_ENV global (basePath + apiPath + orgUrl + app identity + language).
         //    JSON.stringify escapes quotes/backslashes in every value (e.g. an
         //    appName derived from a dir name), so no single field can break the
         //    emitted SFDC_ENV object. It does NOT escape `<`, so we also escape it
         //    to `<` to prevent a `</script>` in a value from closing this
         //    inline <script> element early.
         const sfdcEnv = { basePath, apiPath };
+        if (ctx?.language)
+            sfdcEnv.language = ctx.language;
         if (orgUrl)
             sfdcEnv.orgUrl = orgUrl;
         if (namespace)
@@ -96,9 +91,12 @@ async function createIndexHtmlTransformer(options = {}) {
         return html;
     };
 }
-export async function createHtmlMiddleware(options = {}) {
+export async function createHtmlMiddleware(options = {}, hooks) {
     const htmlTransformer = await createIndexHtmlTransformer(options);
     return (req, res, next) => {
+        // Call the resolver hook BEFORE checking for static files — the hook may
+        // mutate req.url (e.g., strip a language segment).
+        const ctx = hooks?.resolveRequest?.(req);
         // Skip static files (.js, .css, .ico) and internal paths
         const url = req.url?.split("?")[0] ?? "/";
         const hasExtension = url.lastIndexOf(".") > url.lastIndexOf("/");
@@ -132,7 +130,7 @@ export async function createHtmlMiddleware(options = {}) {
             }
             const html = body.toString("utf8");
             try {
-                const transformedResult = htmlTransformer(html);
+                const transformedResult = htmlTransformer(html, ctx);
                 Promise.resolve(transformedResult)
                     .then((finalHtml) => {
                     if (options.debug) {
@@ -168,3 +166,43 @@ export async function createHtmlMiddleware(options = {}) {
             next();
     };
 }
+/**
+ * Site-aware HTML middleware for Angular apps with language-prefixed URLs.
+ *
+ * Thin wrapper around `createHtmlMiddleware` that supplies a per-request
+ * `resolveRequest` hook. On each request the hook:
+ *
+ * 1. Resolves the active language from the leading URL path segment.
+ * 2. Strips the language segment from `req.url` so Angular's SPA routing
+ *    sees `/accounts/1` instead of `/fr/accounts/1`.
+ * 3. Returns `{ basePath, language }` so the HTML transform injects the
+ *    correct per-request `SFDC_ENV.language` and `SFDC_ENV.basePath`.
+ *
+ * When languages are empty, the feature is absent (CodeBuilder), or in
+ * production mode, the middleware degrades to the generic `createHtmlMiddleware`
+ * (no hook supplied — identity behavior).
+ */
+export async function createSiteHtmlMiddleware(options = {}) {
+    const supported = normalizeLanguages(options.languages ?? []);
+    const defaultLang = options.defaultLanguage
+        ? normalizeLanguages([options.defaultLanguage])[0]
+        : supported[0];
+    const isCodeBuilder = !!process.env.CODE_BUILDER_FRAMEWORK_PROXY_URI;
+    const siteEnabled = supported.length > 0 && !isCodeBuilder && !!defaultLang;
+    const resolveRequest = siteEnabled
+        ? (req) => {
+            const rawUrl = req.url ?? "/";
+            const resolved = resolveLanguageFromUrl(rawUrl, supported, defaultLang);
+            if (resolved?.segment) {
+                // Non-default language: strip the segment from req.url so
+                // Angular's SPA routing sees the path without it.
+                const rest = rawUrl.slice(`/${resolved.segment}`.length);
+                req.url = rest.startsWith("/") ? rest : `/${rest}`;
+                return { basePath: `/${resolved.segment}`, language: resolved.language };
+            }
+            // Default language or no match: un-prefixed
+            return { basePath: "/", language: resolved?.language };
+        }
+        : undefined;
+    return createHtmlMiddleware(options, resolveRequest ? { resolveRequest } : undefined);
+}

package/dist/types.d.ts

@@ -9,4 +9,17 @@ export interface SalesforceOptions {
     debug?: boolean;
 }
 export type Middleware = (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
+export interface SiteOptions extends SalesforceOptions {
+    /**
+     * Supported language codes (e.g. `["en_US", "fr", "es"]`).
+     * Codes are normalized from underscores to hyphens for URL use.
+     * When empty or omitted, site features are disabled.
+     */
+    languages?: string[];
+    /**
+     * The default language code (served un-prefixed at `/`).
+     * When omitted, the first entry in `languages` is used.
+     */
+    defaultLanguage?: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,CACxB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,KACzB,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,CACxB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,KACzB,IAAI,CAAC;AAEV,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACrD;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/utils.d.ts

@@ -30,4 +30,34 @@ export declare function getAppName(rootPath: string): string;
  * @returns The registered namespace, or "c" when none is found
  */
 export declare function getNamespace(startDir: string): string;
+/**
+ * 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.
+ * @param defaultLanguage The default language code (served un-prefixed at `/`).
+ * @returns The resolved `language` and, when present, the leading `segment`.
+ */
+export declare function resolveLanguageFromUrl(url: string | undefined, supported: string[], defaultLanguage: 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=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,qFAAqF;AACrF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ7E;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAwBrD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,qFAAqF;AACrF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ7E;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAwBrD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,SAAS,EAAE,MAAM,EAAE,EACnB,eAAe,EAAE,MAAM,GACrB;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/utils.js

@@ -81,3 +81,42 @@ export function getNamespace(startDir) {
     }
     return DEFAULT_NAMESPACE;
 }
+/**
+ * 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.
+ * @param defaultLanguage The default language code (served un-prefixed at `/`).
+ * @returns The resolved `language` and, when present, the leading `segment`.
+ */
+export function resolveLanguageFromUrl(url, supported, defaultLanguage) {
+    if (supported.length === 0)
+        return undefined;
+    const nonDefault = supported.filter((lang) => lang !== defaultLanguage);
+    const path = (url ?? "").split("?")[0] ?? "";
+    const [first] = path.replace(/^\/+/, "").split("/");
+    if (first && nonDefault.includes(first)) {
+        return { language: first, segment: first };
+    }
+    return { language: defaultLanguage }; // no segment (or the default): un-prefixed
+}
+/**
+ * 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 function normalizeLanguages(languages) {
+    return languages.map((s) => s.trim().replace(/_/g, "-")).filter(Boolean);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/angular-plugin-ui-bundle",
   "description": "Angular CLI plugin for Salesforce UI Bundles",
-  "version": "12.3.13",
+  "version": "12.4.1",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,8 +29,8 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@salesforce/ui-bundle": "^12.3.13",
-    "@salesforce/ui-design-mode": "^12.3.13",
+    "@salesforce/ui-bundle": "^12.4.1",
+    "@salesforce/ui-design-mode": "^12.4.1",
     "chokidar": "^4.0.0"
   },
   "devDependencies": {